[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78CSH8P22QAVQWSY6J4D8FQ":3,"skill-same:01M78CSH8P22QAVQWSY6J4D8FQ":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":40,"repositoryHtmlUrl":41,"repositoryHomepageUrl":42,"ownerHtmlUrl":43,"ownerBlogUrl":44,"ownerDescription":45,"updatedAt":46,"install":47,"resources":60},"01M78CSH8P22QAVQWSY6J4D8FQ","solid-layers",null,"SolidJS adapter for @stainless-code\u002Fsolid-layers; open UI from anywhere and manage ordered, named stacks with typed or fire-and-forget `open`","stainless-code\u002Flayers","stainless-code","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F188862219?v=4","01M7826VYMCF2NTQWQZRWQ454T","STAINLESS CODE","01M78CPK4PDPTTAGE6Q5TPCM3M",4,"MIT","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fsolid\u002Fskills\u002Fsolid-layers\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: solid-layers\ndescription: SolidJS adapter for @stainless-code\u002Fsolid-layers; open UI from anywhere and manage ordered, named stacks with typed or fire-and-forget `open`\nlicense: MIT\nkeywords:\n  - tanstack-intent\n  - solid\n  - modal\n  - dialog\n  - stack\n  - typescript\nmetadata:\n  library: \"@stainless-code\u002Fsolid-layers\"\n  library_version: \"0.2.4\"\n  framework: \"solid\"\nsources:\n  - https:\u002F\u002Fstainless-code.com\u002Flayers\u002Fadapters\u002Fsolid\n  - https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fdocs\u002Farchitecture.md\n---\n\n# Solid layer\u002Fstack UI with @stainless-code\u002Fsolid-layers\n\nOpen any layer from anywhere and manage modal, dialog, drawer, popover, or toast UI as an ordered, named stack. `@stainless-code\u002Fsolid-layers` is the SolidJS adapter for `@stainless-code\u002Flayers`; awaiting a typed result is optional, and fire-and-forget invocation (`void client.open(...)`) is equally first-class.\n\nNamed stacks, singletons with `upsert` and live `update`, serial queues, nested stacks, transitions, dismissal blockers, payload validation, and headless rendering each provide standalone value. The package re-exports `@stainless-code\u002Flayers`, so adapter and core APIs share one import path. For engine internals, use the [`layers` core skill](https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fskills\u002Flayers\u002FSKILL.md).\n\n## When to use this skill\n\n- Reach for `@stainless-code\u002Fsolid-layers` to open overlay UI imperatively from anywhere—components, effects, route guards, or non-UI code—and manage it as an ordered, named stack instead of prop-drilling, lifting state, or threading callbacks.\n- It fits when you need any of: open\u002Fclose from anywhere; await a typed result or fire-and-forget (both first-class); named\u002Fordered stacks, singletons (`upsert`) with live `update`, or one-at-a-time queues; nested stacks (`useLayerGroup`), enter\u002Fexit animations, dismissal guards (blockers), payload validation, or headless rendering (`useStackHandles`).\n\n**Skip it only when:** you have a single, always-local overlay opened from one component, with no return, stacking, queue, animation, or guard needs and no wish for a global registry.\n\nFull fit matrix: [When to use Layers](https:\u002F\u002Fstainless-code.com\u002Flayers\u002Fconcepts\u002Fwhen-to-use).\n\n## Install\n\n```bash\nbun add @stainless-code\u002Fsolid-layers\n```\n\nCore is included. `solid-js` (`>=1.6`) is a required peer; install it separately if the app does not provide it.\n\n## Declare → Mount → Call\n\n```tsx\n\u002F\u002F 1. Declare a layer\nimport {\n  layerOptions,\n  type LayerComponentProps,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nexport type ConfirmPayload = { title: string };\nexport type ConfirmResponse = boolean;\n\nfunction ConfirmDialog(\n  props: LayerComponentProps\u003CConfirmPayload, ConfirmResponse>,\n) {\n  return (\n    \u003Cdiv role=\"dialog\">\n      \u003Ch2>{props.payload.title}\u003C\u002Fh2>\n      \u003Cbutton type=\"button\" onClick={() => void props.call.end(true)}>\n        Yes\n      \u003C\u002Fbutton>\n      \u003Cbutton type=\"button\" onClick={() => void props.call.end(false)}>\n        No\n      \u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n\nexport const confirm = layerOptions\u003CConfirmPayload, ConfirmResponse>({\n  stack: \"confirm\",\n  key: [\"confirm\", \"remove\"],\n  component: ConfirmDialog,\n  exitingDelay: 200,\n});\n```\n\n```tsx\n\u002F\u002F 2. Mount the stack outlet once, high in the tree\nimport {\n  LayerClient,\n  LayerClientContext,\n  StackOutlet,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nconst client = new LayerClient();\n\nfunction App() {\n  return (\n    \u003CLayerClientContext.Provider value={client}>\n      \u003CStackOutlet stack=\"confirm\" \u002F>\n    \u003C\u002FLayerClientContext.Provider>\n  );\n}\n```\n\n```tsx\n\u002F\u002F 3. Call & await\nimport { useLayer } from \"@stainless-code\u002Fsolid-layers\";\nimport { confirm } from \".\u002Fconfirm\";\n\nfunction Opener() {\n  const c = useLayer(confirm);\n  return (\n    \u003Cbutton\n      type=\"button\"\n      onClick={async () => {\n        const ok = await c.open({ title: \"Remove?\" });\n        if (ok) deleteItem();\n      }}\n    >\n      Remove\n    \u003C\u002Fbutton>\n  );\n}\n```\n\nLow-level bag-form: `useLayerClient()` + `client.open({ ...confirm, payload })`. Idiomatic `create*` aliases for observe\u002Fstack hooks (`createStack`, `createLayerState`, `createQueuedStack`, `createLayerQueuedState`). Wired handle stays `useLayer`; headless factory is core `createLayer`.\n\n## The `call` context\n\nEach layer component receives `call` (`end`\u002F`dismiss`\u002F`update`\u002F`setRunning`\u002F`settle`\u002F`ended`\u002F`index`\u002F`stackSize`\u002F`root`\u002F`stackId`\u002F`layerId`\u002F`addBlocker`), `payload`, `data`, `error`, `phase`, `transition`, `actionStatus`, and `dismissing`. Use `await call.end(response)` to resolve the caller's `await` and dismiss the layer (`Promise\u003Cboolean>` — `false` if a blocker vetoes). When `undefined extends R` (e.g. void toasts), omit the arg — `call.end()` \u002F `call.dismiss()`. `setRunning(true|false)` flips `actionStatus` manually; `useMutationFlow` (below) wraps `setRunning` + `end` for the common save-then-close case.\n\n**Key vs id:** `key` is the logical identity (`find`\u002F`upsert`\u002F`gcTime`); each mount gets a unique instance `id`. `StackOutlet` keys by `id` so state changes update props in place; `parallel` stacks may hold multiple same-key layers.\n\n## Wired handle: useLayer\n\n```tsx\nconst c = useLayer(confirm);\nawait c.open({ title: \"Remove?\" });\n\u002F\u002F c.state() \u002F c.queued() \u002F c.top() — accessors\n```\n\n## Subscribing to stacks\n\nOptions-bag + optional trailing `client`; `select` (not `selector`). Call accessors inside JSX or `createEffect`.\n\n### useStack \u002F useQueuedStack\n\n```tsx\nconst states = useStack({ stack: \"confirm\" });\nconst count = useStack({ stack: \"confirm\", select: (s) => s.length });\nconst queued = useQueuedStack({ stack: \"confirm\" });\n```\n\n### useLayerState \u002F useLayerQueuedState\n\nObserve-only; `Accessor\u003CLayerState[]>` for all same-key instances:\n\n```tsx\nconst states = useLayerState({ key: confirm.key, stack: \"confirm\" });\nconst top = () => states().at(-1);\n```\n\n### StackSubscribe\n\nIsolate a subscription in a render-prop component; `children` receives an `Accessor\u003CT>`:\n\n```tsx\nimport { StackSubscribe } from \"@stainless-code\u002Fsolid-layers\";\n\n\u003CStackSubscribe stack=\"confirm\" selector={(s) => s.length}>\n  {(count) => \u003Cspan>{count()} open\u003C\u002Fspan>}\n\u003C\u002FStackSubscribe>;\n```\n\n## Rendering layers\n\n`StackOutlet` is the default host. It maps each state to its registered `component` with full props (`call`, `payload`, `data`, `error`, `phase`, `transition`, `actionStatus`, `dismissing`). Layers are keyed by `id` so state changes update props in place without remounting. A missing component renders nothing and warns in development.\n\n`StackOutlet` renders inline. Wrap it in `Portal` from `solid-js\u002Fweb` when you need a specific DOM target.\n\n### Headless: useStackHandles\n\nWhen you need custom hosts (switch by key, your own wrappers, alternate DOM slots):\n\n```tsx\nimport { useStackHandles } from \"@stainless-code\u002Fsolid-layers\";\nimport { For } from \"solid-js\";\n\nfunction CustomHost() {\n  const { states, getCall } = useStackHandles(\"modal\");\n  return (\n    \u003CFor each={states()}>\n      {(s) =>\n        s.key[0] === \"sheet\" ? (\n          \u003CSheet call={getCall(s)} payload={s.payload} \u002F>\n        ) : (\n          \u003CDialog call={getCall(s)} payload={s.payload} \u002F>\n        )\n      }\n    \u003C\u002FFor>\n  );\n}\n```\n\n## Nested layers\n\nInside a layer component, `useLayerGroup(call)` owns a child stack scoped to the parent's lifetime — parent dismiss \u002F unmount `cancelAll`s it (`LayerCancelledError`).\n\n```tsx\nimport {\n  useLayerGroup,\n  layerOptions,\n  type LayerComponentProps,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nconst nested = layerOptions\u003C{ label: string }>({\n  stack: \"settings-nested\",\n  key: [\"settings\", \"advanced\"],\n  component: AdvancedPanel,\n});\n\nfunction SettingsDrawer(\n  props: LayerComponentProps\u003C{ title: string }, boolean>,\n) {\n  const group = useLayerGroup(props.call);\n  return (\n    \u003Cdiv role=\"dialog\" aria-label={props.payload.title}>\n      \u003Cbutton\n        type=\"button\"\n        onClick={() =>\n          void group.open({ ...nested, payload: { label: \"Advanced\" } })\n        }\n      >\n        Open nested\n      \u003C\u002Fbutton>\n      \u003Cgroup.Outlet \u002F>\n      \u003Cbutton type=\"button\" onClick={() => void props.call.dismiss(false)}>\n        Close\n      \u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\nReturns `{ open, dismissAll, states, Outlet, stackId }`. `open` pre-binds the child `stack` id; `states` is an `Accessor\u003CLayerState[]>`.\n\n## Async actions\n\nDrive a layer's `actionStatus` while an async mutation runs, then end the layer on success:\n\n```tsx\nimport {\n  useMutationFlow,\n  type LayerComponentProps,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nfunction ConfirmSave(props: LayerComponentProps\u003C{ name: string }, boolean>) {\n  const flow = useMutationFlow(props.call);\n  return (\n    \u003Cdiv role=\"dialog\">\n      \u003Cp>Save {props.payload.name}?\u003C\u002Fp>\n      \u003Cbutton\n        type=\"button\"\n        disabled={flow.pending()}\n        onClick={() =>\n          void flow\n            .run(async () => {\n              await saveToServer(props.payload.name);\n            })\n            .orEnd(true)\n        }\n      >\n        {flow.pending() ? \"Saving…\" : \"Save\"}\n      \u003C\u002Fbutton>\n      \u003Cbutton type=\"button\" onClick={() => void props.call.end(false)}>\n        Cancel\n      \u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\nIf the mutation throws, `orEnd` restores the idle status, leaves the layer open, and rethrows.\n\n## App chrome: createStackHook\n\nBind a stack id, optional client, and optional host wrapper once:\n\n```tsx\nimport {\n  createStackHook,\n  type LayerComponentProps,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nconst { StackProvider, useAppStack, AppHost, AppLayer } = createStackHook({\n  stack: \"modal\",\n});\n\nfunction SettingsDialog(props: LayerComponentProps) {\n  return (\n    \u003Cdiv role=\"dialog\" aria-label=\"Settings\">\n      \u003Cbutton type=\"button\" onClick={() => void props.call.dismiss()}>\n        Close\n      \u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n\nfunction App() {\n  return (\n    \u003CStackProvider>\n      \u003CAppHost \u002F>\n      \u003CModalTrigger \u002F>\n    \u003C\u002FStackProvider>\n  );\n}\n\nfunction ModalTrigger() {\n  const { open } = useAppStack();\n  return (\n    \u003Cbutton\n      type=\"button\"\n      onClick={() =>\n        void open({\n          key: [\"modal\", \"settings\"],\n          component: SettingsDialog,\n        })\n      }\n    >\n      Open settings\n    \u003C\u002Fbutton>\n  );\n}\n```\n\n- **`useAppStack()`** — `{ open, dismissAll, states }` with `stack` pre-bound. `states` is an `Accessor\u003CLayerState[]>`.\n- **`AppHost`** — renders `StackOutlet` for the bound stack. Its props become `rootProps`; an optional configured `Host` receives the same props and wraps the outlet.\n- **`AppLayer`** — controlled open\u002Fclose via props (`open`, `payload`, `options`, `onResolved`):\n\n```tsx\nfunction ControlledSettings(props: { open: boolean; onClose: () => void }) {\n  return (\n    \u003CAppLayer\n      options={settingsOpts}\n      open={props.open}\n      payload={{ title: \"Settings\" }}\n      onResolved={() => props.onClose()}\n    \u002F>\n  );\n}\n```\n\n## Adapter API\n\n| Kind      | Name                   | Signature \u002F shape                                                         |\n| --------- | ---------------------- | ------------------------------------------------------------------------- |\n| Context   | `LayerClientContext`   | `Context\u003CLayerClient \\| undefined>`                                       |\n| Hook      | `useLayerClient`       | `() => LayerClient`                                                       |\n| Hook      | `useLayer`             | `(options, client?) => WiredLayerHandle accessors + state\u002Fqueued\u002Ftop`     |\n| Hook      | `useLayerState`        | `({ key, stack?, select?, compare? }, client?) => Accessor\u003CLayerState[]>` |\n| Hook      | `useLayerQueuedState`  | `({ key, stack?, select?, compare? }, client?) => Accessor\u003CLayerState[]>` |\n| Hook      | `useStack`             | `({ stack?, select?, compare? }, client?) => Accessor\u003CT>`                 |\n| Hook      | `useQueuedStack`       | `({ stack?, select?, compare? }, client?) => Accessor\u003CT>`                 |\n| Hook      | `useStackHandles`      | `(stack?, rootProps?) => StackHandles`                                    |\n| Component | `StackOutlet`          | `{ stack?, rootProps? }`                                                  |\n| Component | `StackSubscribe`       | `{ stack?, selector, children: (value: Accessor\u003CT>) => JSX }`             |\n| Hook      | `useMutationFlow`      | `\u003CP, R, RootProps?>(call) => MutationFlow\u003CR>`                             |\n| Hook      | `useLayerGroup`        | `\u003CP, R, RootProps?>(call, options?) => LayerGroup`                        |\n| Factory   | `createStackHook`      | `\u003CHostProps>({ stack?, client?, Host? }) => StackHook\u003CHostProps>`         |\n| Type      | `StackHandles`         | `{ states: Accessor\u003CLayerState[]>, getCall }`                             |\n| Type      | `MutationRun\u003CR>`       | `{ orEnd(response) }`                                                     |\n| Type      | `MutationFlow\u003CR>`      | `{ pending: Accessor\u003Cboolean>, run }`                                     |\n| Type      | `ScopedOpen`           | `open` with `stack` pre-bound                                             |\n| Type      | `LayerGroup`           | `{ open, dismissAll, states, Outlet, stackId }`                           |\n| Type      | `AppStack`             | `{ open, dismissAll, states }`                                            |\n| Type      | `AppLayerProps\u003CP, R>`  | `{ options, open, payload, onResolved? }`                                 |\n| Type      | `StackHook\u003CHostProps>` | `{ StackProvider, useAppStack, AppHost, AppLayer }`                       |\n\n## Core re-exports (same import path)\n\nCore exports are available from `@stainless-code\u002Fsolid-layers`, including `LayerClient`, `LayerStack`, `layerOptions`, `layerKey`, `LayerState`, `LayerComponentProps`, `LayerCallContext`, `createLayerGroup`, `DataTag`, `ResponseOf`, and `ErrorOf`:\n\n- **Key inference:** `layerOptions` \u002F `layerKey` `DataTag` branding — `await client.open(...)` infers `R`.\n- **Singleton + live updates:** `upsert: true` on `open`; `client.getStack(id).update(layer, patch)`.\n- **Serial scope:** `new LayerClient({ defaultStackOptions: { confirm: { scope: { strategy: \"serial\" } } } })`.\n- **Validation:** `validate` on `layerOptions` or `open`; narrow `PayloadValidationError` via `isPayloadValidationError`.\n- **Blockers:** `call.addBlocker` \u002F `stack.addBlocker`; `dismissing` flag; `dismissAll` modes.\n\nSee the [`layers`](https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fskills\u002Flayers\u002FSKILL.md) skill for full engine coverage (transitions, blockers, validation, serial scope, multi-stack).\n","# Solid layer\u002Fstack UI with @stainless-code\u002Fsolid-layers\n\nOpen any layer from anywhere and manage modal, dialog, drawer, popover, or toast UI as an ordered, named stack. `@stainless-code\u002Fsolid-layers` is the SolidJS adapter for `@stainless-code\u002Flayers`; awaiting a typed result is optional, and fire-and-forget invocation (`void client.open(...)`) is equally first-class.\n\nNamed stacks, singletons with `upsert` and live `update`, serial queues, nested stacks, transitions, dismissal blockers, payload validation, and headless rendering each provide standalone value. The package re-exports `@stainless-code\u002Flayers`, so adapter and core APIs share one import path. For engine internals, use the [`layers` core skill](https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fskills\u002Flayers\u002FSKILL.md).\n\n## When to use this skill\n\n- Reach for `@stainless-code\u002Fsolid-layers` to open overlay UI imperatively from anywhere—components, effects, route guards, or non-UI code—and manage it as an ordered, named stack instead of prop-drilling, lifting state, or threading callbacks.\n- It fits when you need any of: open\u002Fclose from anywhere; await a typed result or fire-and-forget (both first-class); named\u002Fordered stacks, singletons (`upsert`) with live `update`, or one-at-a-time queues; nested stacks (`useLayerGroup`), enter\u002Fexit animations, dismissal guards (blockers), payload validation, or headless rendering (`useStackHandles`).\n\n**Skip it only when:** you have a single, always-local overlay opened from one component, with no return, stacking, queue, animation, or guard needs and no wish for a global registry.\n\nFull fit matrix: [When to use Layers](https:\u002F\u002Fstainless-code.com\u002Flayers\u002Fconcepts\u002Fwhen-to-use).\n\n## Install\n\n```bash\nbun add @stainless-code\u002Fsolid-layers\n```\n\nCore is included. `solid-js` (`>=1.6`) is a required peer; install it separately if the app does not provide it.\n\n## Declare → Mount → Call\n\n```tsx\n\u002F\u002F 1. Declare a layer\nimport {\n  layerOptions,\n  type LayerComponentProps,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nexport type ConfirmPayload = { title: string };\nexport type ConfirmResponse = boolean;\n\nfunction ConfirmDialog(\n  props: LayerComponentProps\u003CConfirmPayload, ConfirmResponse>,\n) {\n  return (\n    \u003Cdiv role=\"dialog\">\n      \u003Ch2>{props.payload.title}\u003C\u002Fh2>\n      \u003Cbutton type=\"button\" onClick={() => void props.call.end(true)}>\n        Yes\n      \u003C\u002Fbutton>\n      \u003Cbutton type=\"button\" onClick={() => void props.call.end(false)}>\n        No\n      \u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n\nexport const confirm = layerOptions\u003CConfirmPayload, ConfirmResponse>({\n  stack: \"confirm\",\n  key: [\"confirm\", \"remove\"],\n  component: ConfirmDialog,\n  exitingDelay: 200,\n});\n```\n\n```tsx\n\u002F\u002F 2. Mount the stack outlet once, high in the tree\nimport {\n  LayerClient,\n  LayerClientContext,\n  StackOutlet,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nconst client = new LayerClient();\n\nfunction App() {\n  return (\n    \u003CLayerClientContext.Provider value={client}>\n      \u003CStackOutlet stack=\"confirm\" \u002F>\n    \u003C\u002FLayerClientContext.Provider>\n  );\n}\n```\n\n```tsx\n\u002F\u002F 3. Call & await\nimport { useLayer } from \"@stainless-code\u002Fsolid-layers\";\nimport { confirm } from \".\u002Fconfirm\";\n\nfunction Opener() {\n  const c = useLayer(confirm);\n  return (\n    \u003Cbutton\n      type=\"button\"\n      onClick={async () => {\n        const ok = await c.open({ title: \"Remove?\" });\n        if (ok) deleteItem();\n      }}\n    >\n      Remove\n    \u003C\u002Fbutton>\n  );\n}\n```\n\nLow-level bag-form: `useLayerClient()` + `client.open({ ...confirm, payload })`. Idiomatic `create*` aliases for observe\u002Fstack hooks (`createStack`, `createLayerState`, `createQueuedStack`, `createLayerQueuedState`). Wired handle stays `useLayer`; headless factory is core `createLayer`.\n\n## The `call` context\n\nEach layer component receives `call` (`end`\u002F`dismiss`\u002F`update`\u002F`setRunning`\u002F`settle`\u002F`ended`\u002F`index`\u002F`stackSize`\u002F`root`\u002F`stackId`\u002F`layerId`\u002F`addBlocker`), `payload`, `data`, `error`, `phase`, `transition`, `actionStatus`, and `dismissing`. Use `await call.end(response)` to resolve the caller's `await` and dismiss the layer (`Promise\u003Cboolean>` — `false` if a blocker vetoes). When `undefined extends R` (e.g. void toasts), omit the arg — `call.end()` \u002F `call.dismiss()`. `setRunning(true|false)` flips `actionStatus` manually; `useMutationFlow` (below) wraps `setRunning` + `end` for the common save-then-close case.\n\n**Key vs id:** `key` is the logical identity (`find`\u002F`upsert`\u002F`gcTime`); each mount gets a unique instance `id`. `StackOutlet` keys by `id` so state changes update props in place; `parallel` stacks may hold multiple same-key layers.\n\n## Wired handle: useLayer\n\n```tsx\nconst c = useLayer(confirm);\nawait c.open({ title: \"Remove?\" });\n\u002F\u002F c.state() \u002F c.queued() \u002F c.top() — accessors\n```\n\n## Subscribing to stacks\n\nOptions-bag + optional trailing `client`; `select` (not `selector`). Call accessors inside JSX or `createEffect`.\n\n### useStack \u002F useQueuedStack\n\n```tsx\nconst states = useStack({ stack: \"confirm\" });\nconst count = useStack({ stack: \"confirm\", select: (s) => s.length });\nconst queued = useQueuedStack({ stack: \"confirm\" });\n```\n\n### useLayerState \u002F useLayerQueuedState\n\nObserve-only; `Accessor\u003CLayerState[]>` for all same-key instances:\n\n```tsx\nconst states = useLayerState({ key: confirm.key, stack: \"confirm\" });\nconst top = () => states().at(-1);\n```\n\n### StackSubscribe\n\nIsolate a subscription in a render-prop component; `children` receives an `Accessor\u003CT>`:\n\n```tsx\nimport { StackSubscribe } from \"@stainless-code\u002Fsolid-layers\";\n\n\u003CStackSubscribe stack=\"confirm\" selector={(s) => s.length}>\n  {(count) => \u003Cspan>{count()} open\u003C\u002Fspan>}\n\u003C\u002FStackSubscribe>;\n```\n\n## Rendering layers\n\n`StackOutlet` is the default host. It maps each state to its registered `component` with full props (`call`, `payload`, `data`, `error`, `phase`, `transition`, `actionStatus`, `dismissing`). Layers are keyed by `id` so state changes update props in place without remounting. A missing component renders nothing and warns in development.\n\n`StackOutlet` renders inline. Wrap it in `Portal` from `solid-js\u002Fweb` when you need a specific DOM target.\n\n### Headless: useStackHandles\n\nWhen you need custom hosts (switch by key, your own wrappers, alternate DOM slots):\n\n```tsx\nimport { useStackHandles } from \"@stainless-code\u002Fsolid-layers\";\nimport { For } from \"solid-js\";\n\nfunction CustomHost() {\n  const { states, getCall } = useStackHandles(\"modal\");\n  return (\n    \u003CFor each={states()}>\n      {(s) =>\n        s.key[0] === \"sheet\" ? (\n          \u003CSheet call={getCall(s)} payload={s.payload} \u002F>\n        ) : (\n          \u003CDialog call={getCall(s)} payload={s.payload} \u002F>\n        )\n      }\n    \u003C\u002FFor>\n  );\n}\n```\n\n## Nested layers\n\nInside a layer component, `useLayerGroup(call)` owns a child stack scoped to the parent's lifetime — parent dismiss \u002F unmount `cancelAll`s it (`LayerCancelledError`).\n\n```tsx\nimport {\n  useLayerGroup,\n  layerOptions,\n  type LayerComponentProps,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nconst nested = layerOptions\u003C{ label: string }>({\n  stack: \"settings-nested\",\n  key: [\"settings\", \"advanced\"],\n  component: AdvancedPanel,\n});\n\nfunction SettingsDrawer(\n  props: LayerComponentProps\u003C{ title: string }, boolean>,\n) {\n  const group = useLayerGroup(props.call);\n  return (\n    \u003Cdiv role=\"dialog\" aria-label={props.payload.title}>\n      \u003Cbutton\n        type=\"button\"\n        onClick={() =>\n          void group.open({ ...nested, payload: { label: \"Advanced\" } })\n        }\n      >\n        Open nested\n      \u003C\u002Fbutton>\n      \u003Cgroup.Outlet \u002F>\n      \u003Cbutton type=\"button\" onClick={() => void props.call.dismiss(false)}>\n        Close\n      \u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\nReturns `{ open, dismissAll, states, Outlet, stackId }`. `open` pre-binds the child `stack` id; `states` is an `Accessor\u003CLayerState[]>`.\n\n## Async actions\n\nDrive a layer's `actionStatus` while an async mutation runs, then end the layer on success:\n\n```tsx\nimport {\n  useMutationFlow,\n  type LayerComponentProps,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nfunction ConfirmSave(props: LayerComponentProps\u003C{ name: string }, boolean>) {\n  const flow = useMutationFlow(props.call);\n  return (\n    \u003Cdiv role=\"dialog\">\n      \u003Cp>Save {props.payload.name}?\u003C\u002Fp>\n      \u003Cbutton\n        type=\"button\"\n        disabled={flow.pending()}\n        onClick={() =>\n          void flow\n            .run(async () => {\n              await saveToServer(props.payload.name);\n            })\n            .orEnd(true)\n        }\n      >\n        {flow.pending() ? \"Saving…\" : \"Save\"}\n      \u003C\u002Fbutton>\n      \u003Cbutton type=\"button\" onClick={() => void props.call.end(false)}>\n        Cancel\n      \u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n```\n\nIf the mutation throws, `orEnd` restores the idle status, leaves the layer open, and rethrows.\n\n## App chrome: createStackHook\n\nBind a stack id, optional client, and optional host wrapper once:\n\n```tsx\nimport {\n  createStackHook,\n  type LayerComponentProps,\n} from \"@stainless-code\u002Fsolid-layers\";\n\nconst { StackProvider, useAppStack, AppHost, AppLayer } = createStackHook({\n  stack: \"modal\",\n});\n\nfunction SettingsDialog(props: LayerComponentProps) {\n  return (\n    \u003Cdiv role=\"dialog\" aria-label=\"Settings\">\n      \u003Cbutton type=\"button\" onClick={() => void props.call.dismiss()}>\n        Close\n      \u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  );\n}\n\nfunction App() {\n  return (\n    \u003CStackProvider>\n      \u003CAppHost \u002F>\n      \u003CModalTrigger \u002F>\n    \u003C\u002FStackProvider>\n  );\n}\n\nfunction ModalTrigger() {\n  const { open } = useAppStack();\n  return (\n    \u003Cbutton\n      type=\"button\"\n      onClick={() =>\n        void open({\n          key: [\"modal\", \"settings\"],\n          component: SettingsDialog,\n        })\n      }\n    >\n      Open settings\n    \u003C\u002Fbutton>\n  );\n}\n```\n\n- **`useAppStack()`** — `{ open, dismissAll, states }` with `stack` pre-bound. `states` is an `Accessor\u003CLayerState[]>`.\n- **`AppHost`** — renders `StackOutlet` for the bound stack. Its props become `rootProps`; an optional configured `Host` receives the same props and wraps the outlet.\n- **`AppLayer`** — controlled open\u002Fclose via props (`open`, `payload`, `options`, `onResolved`):\n\n```tsx\nfunction ControlledSettings(props: { open: boolean; onClose: () => void }) {\n  return (\n    \u003CAppLayer\n      options={settingsOpts}\n      open={props.open}\n      payload={{ title: \"Settings\" }}\n      onResolved={() => props.onClose()}\n    \u002F>\n  );\n}\n```\n\n## Adapter API\n\n| Kind      | Name                   | Signature \u002F shape                                                         |\n| --------- | ---------------------- | ------------------------------------------------------------------------- |\n| Context   | `LayerClientContext`   | `Context\u003CLayerClient \\| undefined>`                                       |\n| Hook      | `useLayerClient`       | `() => LayerClient`                                                       |\n| Hook      | `useLayer`             | `(options, client?) => WiredLayerHandle accessors + state\u002Fqueued\u002Ftop`     |\n| Hook      | `useLayerState`        | `({ key, stack?, select?, compare? }, client?) => Accessor\u003CLayerState[]>` |\n| Hook      | `useLayerQueuedState`  | `({ key, stack?, select?, compare? }, client?) => Accessor\u003CLayerState[]>` |\n| Hook      | `useStack`             | `({ stack?, select?, compare? }, client?) => Accessor\u003CT>`                 |\n| Hook      | `useQueuedStack`       | `({ stack?, select?, compare? }, client?) => Accessor\u003CT>`                 |\n| Hook      | `useStackHandles`      | `(stack?, rootProps?) => StackHandles`                                    |\n| Component | `StackOutlet`          | `{ stack?, rootProps? }`                                                  |\n| Component | `StackSubscribe`       | `{ stack?, selector, children: (value: Accessor\u003CT>) => JSX }`             |\n| Hook      | `useMutationFlow`      | `\u003CP, R, RootProps?>(call) => MutationFlow\u003CR>`                             |\n| Hook      | `useLayerGroup`        | `\u003CP, R, RootProps?>(call, options?) => LayerGroup`                        |\n| Factory   | `createStackHook`      | `\u003CHostProps>({ stack?, client?, Host? }) => StackHook\u003CHostProps>`         |\n| Type      | `StackHandles`         | `{ states: Accessor\u003CLayerState[]>, getCall }`                             |\n| Type      | `MutationRun\u003CR>`       | `{ orEnd(response) }`                                                     |\n| Type      | `MutationFlow\u003CR>`      | `{ pending: Accessor\u003Cboolean>, run }`                                     |\n| Type      | `ScopedOpen`           | `open` with `stack` pre-bound                                             |\n| Type      | `LayerGroup`           | `{ open, dismissAll, states, Outlet, stackId }`                           |\n| Type      | `AppStack`             | `{ open, dismissAll, states }`                                            |\n| Type      | `AppLayerProps\u003CP, R>`  | `{ options, open, payload, onResolved? }`                                 |\n| Type      | `StackHook\u003CHostProps>` | `{ StackProvider, useAppStack, AppHost, AppLayer }`                       |\n\n## Core re-exports (same import path)\n\nCore exports are available from `@stainless-code\u002Fsolid-layers`, including `LayerClient`, `LayerStack`, `layerOptions`, `layerKey`, `LayerState`, `LayerComponentProps`, `LayerCallContext`, `createLayerGroup`, `DataTag`, `ResponseOf`, and `ErrorOf`:\n\n- **Key inference:** `layerOptions` \u002F `layerKey` `DataTag` branding — `await client.open(...)` infers `R`.\n- **Singleton + live updates:** `upsert: true` on `open`; `client.getStack(id).update(layer, patch)`.\n- **Serial scope:** `new LayerClient({ defaultStackOptions: { confirm: { scope: { strategy: \"serial\" } } } })`.\n- **Validation:** `validate` on `layerOptions` or `open`; narrow `PayloadValidationError` via `isPayloadValidationError`.\n- **Blockers:** `call.addBlocker` \u002F `stack.addBlocker`; `dismissing` flag; `dismissAll` modes.\n\nSee the [`layers`](https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fskills\u002Flayers\u002FSKILL.md) skill for full engine coverage (transitions, blockers, validation, serial scope, multi-stack).\n",{"name":5,"license":15,"sources":24,"keywords":27,"metadata":34,"description":7},[25,26],"https:\u002F\u002Fstainless-code.com\u002Flayers\u002Fadapters\u002Fsolid","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fdocs\u002Farchitecture.md",[28,29,30,31,32,33],"tanstack-intent","solid","modal","dialog","stack","typescript",{"library":35,"framework":29,"library_version":36},"@stainless-code\u002Fsolid-layers","0.2.4","main","48cb8dae2773a543acd30d0e1af92f9cda91b35a","packages\u002Fsolid\u002Fskills\u002Fsolid-layers",0,"https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers","https:\u002F\u002Fstainless-code.com\u002Flayers","https:\u002F\u002Fgithub.com\u002Fstainless-code","https:\u002F\u002Fstainless-code.com\u002F","Open-source tooling for JS\u002FTS and AI agents.","2026-11-01 20:56:20",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add stainless-code\u002Flayers --skill solid-layers",{"tool":53,"command":54},"bunx","bunx skills add stainless-code\u002Flayers --skill solid-layers",{"tool":56,"command":57},"pnpm","pnpm dlx skills add stainless-code\u002Flayers --skill solid-layers","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fsolid\u002Fskills\u002Fsolid-layers\u002FSKILL.md",true,[],[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M78CSV0ENFT6T2C1KN4J76HN","vue-layers","Vue adapter for @stainless-code\u002Fvue-layers; open UI from anywhere and manage ordered, named stacks with typed or fire-and-forget `open`","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fvue\u002Fskills\u002Fvue-layers\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M78CSPDPYQ02J822EZNJ0KS6","svelte-layers","Svelte bindings for @stainless-code\u002Fsvelte-layers (runes + stores). Use to open overlay UI imperatively from anywhere, manage ordered named stacks, choose the Svelte 5.7+ runes or Svelte 3+ stores entry, and wire layer context or stack outlets.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fsvelte\u002Fskills\u002Fsvelte-layers\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M78CSCQE83B2VEM4JAW5FAFP","react-layers","React adapter for @stainless-code\u002Freact-layers; open UI from anywhere and manage ordered, named stacks with typed or fire-and-forget `open`","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Freact\u002Fskills\u002Freact-layers\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M78CS7RYJ25PK8ASR150R8QS","preact-layers","Preact adapter for @stainless-code\u002Fpreact-layers — use for awaitable confirm flows, singleton toasts, nested drawers, stack subscriptions, and custom layer hosts","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fpreact\u002Fskills\u002Fpreact-layers\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M78CS44RJHSXYT13KZKQPNY3","lit-layers","Lit adapter for @stainless-code\u002Flit-layers; open UI from anywhere and manage ordered, named stacks with typed or fire-and-forget `open` via Reactive Controllers and custom elements","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Flit\u002Fskills\u002Flit-layers\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M78CRZC6TG14ZG5MJ4JQMRT1","layers","UI-agnostic layer stack engine for @stainless-code\u002Flayers. Use for opening layers imperatively from anywhere, ordered named stacks, typed await or fire-and-forget calls, lifecycle control, blockers, validation, singleton updates, serial or nested layers, multi-stack orchestration, or building a library\u002Fframework adapter.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Flayers\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fskills\u002Flayers\u002FSKILL.md",[],[]]