@jfdevelops/react-layout 1.3.0 → 1.4.0

package/dist/create-config/index.d.cts

@@ -11,4 +11,5 @@ import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceL
 import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapOptions, CreateViewMapRenderStatesOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayout, DefinedResourceLayoutWithShell, LayoutDefinition, LayoutIncludeProps, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./define-layout.cjs";
 import { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates } from "./lazy-resource-layout.cjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-defined-resource-layout.cjs";
-import { ResourceLayoutShellPublisher } from "./shell-context.cjs";
+import { ResourceLayoutShellPublisher } from "./shell-context.cjs";
+import { LayoutPreviewProps, defineLayoutPreview } from "./preview.cjs";

package/dist/create-config/index.d.mts

@@ -11,4 +11,5 @@ import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceL
 import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, CreateResourceLayoutWithLayoutOptions, CreateViewMapBuiltInRenderStatesOptions, CreateViewMapFunctionRenderOptions, CreateViewMapInlineRenderStatesOptions, CreateViewMapOptions, CreateViewMapRenderStatesOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, DefineResourceLayoutWithLayoutFn, DefineResourcesFn, DefinedResourceLayout, DefinedResourceLayoutWithShell, LayoutDefinition, LayoutIncludeProps, LayoutRenderResourcesAccessor, LayoutResourcesAccessor, ResourceLayoutProvider, ResourceLayoutProviderProps, ResourceLayoutShellComponent, ResourceLayoutShellProps, ResourceSelection, ShellLayoutDefinition, ShellRenderContext, TypedBuiltInRenderStates, TypedInlineRenderState, defineResourceLayout } from "./define-layout.mjs";
 import { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates } from "./lazy-resource-layout.mjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-defined-resource-layout.mjs";
-import { ResourceLayoutShellPublisher } from "./shell-context.mjs";
+import { ResourceLayoutShellPublisher } from "./shell-context.mjs";
+import { LayoutPreviewProps, defineLayoutPreview } from "./preview.mjs";

package/dist/create-config/inspection.cjs

@@ -2,12 +2,13 @@ let react = require("react");
 let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
 
 //#region src/create-config/inspection.ts
-function inspectDefinition(resources) {
+function inspectDefinition(resources, source) {
 	const store = (0, _jfdevelops_react_layout_devtools_core.createInspectionStore)();
 	const definition = store.node({
 		id: (0, _jfdevelops_react_layout_devtools_core.inspectionId)("definition"),
 		kind: "definition",
-		label: "Layout definition"
+		label: "Layout definition",
+		source
 	});
 	const resourceIds = /* @__PURE__ */ new Map();
 	function visit(items, parent, prefix = "") {
@@ -18,6 +19,7 @@ function inspectDefinition(resources) {
 				id: (0, _jfdevelops_react_layout_devtools_core.inspectionId)("resource"),
 				kind: "resource",
 				label: path,
+				source,
 				details: { path }
 			});
 			resourceIds.set(path, id);

package/dist/create-config/inspection.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.cjs","names":[],"sources":["../../src/create-config/inspection.ts"],"sourcesContent":["import {\n  createElement,\n  forwardRef,\n  useLayoutEffect,\n  type ComponentType,\n} from 'react';\nimport {\n  createInspectionStore,\n  inspectionId,\n  type InspectionStore,\n} from '@jfdevelops/react-layout-devtools-core';\nimport type { ResourceDefinition } from '../resource';\nexport function inspectDefinition(resources: readonly ResourceDefinition[]) {\n  const store = createInspectionStore();\n  const definition = store.node({\n    id: inspectionId('definition'),\n    kind: 'definition',\n    label: 'Layout definition',\n  });\n  const resourceIds = new Map<string, string>();\n  function visit(\n    items: readonly ResourceDefinition[],\n    parent: string,\n    prefix = ''\n  ) {\n    for (const item of items) {\n      const slug = typeof item === 'string' ? item : item.value;\n      const path = prefix ? `${prefix}.${slug}` : slug;\n      const id = store.node({\n        id: inspectionId('resource'),\n        kind: 'resource',\n        label: path,\n        details: { path },\n      });\n      resourceIds.set(path, id);\n      store.edge(parent, id, 'contains');\n      if (typeof item !== 'string') visit(item.subResources, id, path);\n    }\n  }\n  visit(resources, definition);\n  return { store, definition, resourceIds };\n}\nexport interface ActiveInspection {\n  store: InspectionStore;\n  layout: string;\n  resource?: string;\n  state: string;\n}\n\n/** Preserve composable metadata while measuring committed React instances, not declarations. */\nexport function trackComposable<T extends object>(\n  component: T,\n  store: InspectionStore,\n  id: string\n): T {\n  const Tracked = forwardRef<unknown, Record<string, unknown>>(\n    function InspectedComposable(props, ref) {\n      useLayoutEffect(() => store.mount(id), [store, id]);\n      return createElement(\n        component as ComponentType<Record<string, unknown>>,\n        ref == null ? props : { ...props, ref }\n      );\n    }\n  );\n  for (const key of Reflect.ownKeys(component)) {\n    if (\n      typeof key === 'string' &&\n      [\n        'name',\n        'length',\n        'prototype',\n        'caller',\n        'arguments',\n        '$$typeof',\n        'render',\n        'compare',\n        'type',\n      ].includes(key)\n    )\n      continue;\n    const descriptor = Object.getOwnPropertyDescriptor(component, key);\n    if (descriptor) Object.defineProperty(Tracked, key, descriptor);\n  }\n  return Tracked as unknown as T;\n}\n"],"mappings":";;;;AAYA,SAAgB,kBAAkB,WAA0C;CAC1E,MAAM,0EAA8B;CACpC,MAAM,aAAa,MAAM,KAAK;EAC5B,6DAAiB,YAAY;EAC7B,MAAM;EACN,OAAO;CACT,CAAC;CACD,MAAM,8BAAc,IAAI,IAAoB;CAC5C,SAAS,MACP,OACA,QACA,SAAS,IACT;EACA,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK;GACpD,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,SAAS;GAC5C,MAAM,KAAK,MAAM,KAAK;IACpB,6DAAiB,UAAU;IAC3B,MAAM;IACN,OAAO;IACP,SAAS,EAAE,KAAK;GAClB,CAAC;GACD,YAAY,IAAI,MAAM,EAAE;GACxB,MAAM,KAAK,QAAQ,IAAI,UAAU;GACjC,IAAI,OAAO,SAAS,UAAU,MAAM,KAAK,cAAc,IAAI,IAAI;EACjE;CACF;CACA,MAAM,WAAW,UAAU;CAC3B,OAAO;EAAE;EAAO;EAAY;CAAY;AAC1C;;AASA,SAAgB,gBACd,WACA,OACA,IACG;CACH,MAAM,gCACJ,SAAS,oBAAoB,OAAO,KAAK;EACvC,iCAAsB,MAAM,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;EAClD,gCACE,WACA,OAAO,OAAO,QAAQ;GAAE,GAAG;GAAO;EAAI,CACxC;CACF,CACF;CACA,KAAK,MAAM,OAAO,QAAQ,QAAQ,SAAS,GAAG;EAC5C,IACE,OAAO,QAAQ,YACf;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,EAAE,SAAS,GAAG,GAEd;EACF,MAAM,aAAa,OAAO,yBAAyB,WAAW,GAAG;EACjE,IAAI,YAAY,OAAO,eAAe,SAAS,KAAK,UAAU;CAChE;CACA,OAAO;AACT"}
+{"version":3,"file":"inspection.cjs","names":[],"sources":["../../src/create-config/inspection.ts"],"sourcesContent":["import {\n  createElement,\n  forwardRef,\n  useLayoutEffect,\n  type ComponentType,\n} from 'react';\nimport {\n  createInspectionStore,\n  inspectionId,\n  type InspectionStore,\n  type SourceLocation,\n} from '@jfdevelops/react-layout-devtools-core';\nimport type { ResourceDefinition } from '../resource';\n\nexport function inspectDefinition(\n  resources: readonly ResourceDefinition[],\n  source?: SourceLocation\n) {\n  const store = createInspectionStore();\n  const definition = store.node({\n    id: inspectionId('definition'),\n    kind: 'definition',\n    label: 'Layout definition',\n    source,\n  });\n  const resourceIds = new Map<string, string>();\n\n  function visit(\n    items: readonly ResourceDefinition[],\n    parent: string,\n    prefix = ''\n  ) {\n    for (const item of items) {\n      const slug = typeof item === 'string' ? item : item.value;\n      const path = prefix ? `${prefix}.${slug}` : slug;\n      const id = store.node({\n        id: inspectionId('resource'),\n        kind: 'resource',\n        label: path,\n        source,\n        details: { path },\n      });\n\n      resourceIds.set(path, id);\n\n      store.edge(parent, id, 'contains');\n\n      if (typeof item !== 'string') visit(item.subResources, id, path);\n    }\n  }\n\n  visit(resources, definition);\n\n  return { store, definition, resourceIds };\n}\n\nexport interface ActiveInspection {\n  store: InspectionStore;\n  layout: string;\n  resource?: string;\n  state: string;\n}\n\n/** Preserve composable metadata while measuring committed React instances, not declarations. */\nexport function trackComposable<T extends object>(\n  component: T,\n  store: InspectionStore,\n  id: string\n): T {\n  const Tracked = forwardRef<unknown, Record<string, unknown>>(\n    function InspectedComposable(props, ref) {\n      useLayoutEffect(() => store.mount(id), [store, id]);\n\n      return createElement(\n        component as ComponentType<Record<string, unknown>>,\n        ref == null ? props : { ...props, ref }\n      );\n    }\n  );\n\n  for (const key of Reflect.ownKeys(component)) {\n    if (\n      typeof key === 'string' &&\n      [\n        'name',\n        'length',\n        'prototype',\n        'caller',\n        'arguments',\n        '$$typeof',\n        'render',\n        'compare',\n        'type',\n      ].includes(key)\n    )\n      continue;\n\n    const descriptor = Object.getOwnPropertyDescriptor(component, key);\n\n    if (descriptor) Object.defineProperty(Tracked, key, descriptor);\n  }\n\n  return Tracked as unknown as T;\n}\n"],"mappings":";;;;AAcA,SAAgB,kBACd,WACA,QACA;CACA,MAAM,0EAA8B;CACpC,MAAM,aAAa,MAAM,KAAK;EAC5B,6DAAiB,YAAY;EAC7B,MAAM;EACN,OAAO;EACP;CACF,CAAC;CACD,MAAM,8BAAc,IAAI,IAAoB;CAE5C,SAAS,MACP,OACA,QACA,SAAS,IACT;EACA,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK;GACpD,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,SAAS;GAC5C,MAAM,KAAK,MAAM,KAAK;IACpB,6DAAiB,UAAU;IAC3B,MAAM;IACN,OAAO;IACP;IACA,SAAS,EAAE,KAAK;GAClB,CAAC;GAED,YAAY,IAAI,MAAM,EAAE;GAExB,MAAM,KAAK,QAAQ,IAAI,UAAU;GAEjC,IAAI,OAAO,SAAS,UAAU,MAAM,KAAK,cAAc,IAAI,IAAI;EACjE;CACF;CAEA,MAAM,WAAW,UAAU;CAE3B,OAAO;EAAE;EAAO;EAAY;CAAY;AAC1C;;AAUA,SAAgB,gBACd,WACA,OACA,IACG;CACH,MAAM,gCACJ,SAAS,oBAAoB,OAAO,KAAK;EACvC,iCAAsB,MAAM,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;EAElD,gCACE,WACA,OAAO,OAAO,QAAQ;GAAE,GAAG;GAAO;EAAI,CACxC;CACF,CACF;CAEA,KAAK,MAAM,OAAO,QAAQ,QAAQ,SAAS,GAAG;EAC5C,IACE,OAAO,QAAQ,YACf;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,EAAE,SAAS,GAAG,GAEd;EAEF,MAAM,aAAa,OAAO,yBAAyB,WAAW,GAAG;EAEjE,IAAI,YAAY,OAAO,eAAe,SAAS,KAAK,UAAU;CAChE;CAEA,OAAO;AACT"}

package/dist/create-config/inspection.mjs

@@ -2,12 +2,13 @@ import { createElement, forwardRef, useLayoutEffect } from "react";
 import { createInspectionStore, inspectionId } from "@jfdevelops/react-layout-devtools-core";
 
 //#region src/create-config/inspection.ts
-function inspectDefinition(resources) {
+function inspectDefinition(resources, source) {
 	const store = createInspectionStore();
 	const definition = store.node({
 		id: inspectionId("definition"),
 		kind: "definition",
-		label: "Layout definition"
+		label: "Layout definition",
+		source
 	});
 	const resourceIds = /* @__PURE__ */ new Map();
 	function visit(items, parent, prefix = "") {
@@ -18,6 +19,7 @@ function inspectDefinition(resources) {
 				id: inspectionId("resource"),
 				kind: "resource",
 				label: path,
+				source,
 				details: { path }
 			});
 			resourceIds.set(path, id);

package/dist/create-config/inspection.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.mjs","names":[],"sources":["../../src/create-config/inspection.ts"],"sourcesContent":["import {\n  createElement,\n  forwardRef,\n  useLayoutEffect,\n  type ComponentType,\n} from 'react';\nimport {\n  createInspectionStore,\n  inspectionId,\n  type InspectionStore,\n} from '@jfdevelops/react-layout-devtools-core';\nimport type { ResourceDefinition } from '../resource';\nexport function inspectDefinition(resources: readonly ResourceDefinition[]) {\n  const store = createInspectionStore();\n  const definition = store.node({\n    id: inspectionId('definition'),\n    kind: 'definition',\n    label: 'Layout definition',\n  });\n  const resourceIds = new Map<string, string>();\n  function visit(\n    items: readonly ResourceDefinition[],\n    parent: string,\n    prefix = ''\n  ) {\n    for (const item of items) {\n      const slug = typeof item === 'string' ? item : item.value;\n      const path = prefix ? `${prefix}.${slug}` : slug;\n      const id = store.node({\n        id: inspectionId('resource'),\n        kind: 'resource',\n        label: path,\n        details: { path },\n      });\n      resourceIds.set(path, id);\n      store.edge(parent, id, 'contains');\n      if (typeof item !== 'string') visit(item.subResources, id, path);\n    }\n  }\n  visit(resources, definition);\n  return { store, definition, resourceIds };\n}\nexport interface ActiveInspection {\n  store: InspectionStore;\n  layout: string;\n  resource?: string;\n  state: string;\n}\n\n/** Preserve composable metadata while measuring committed React instances, not declarations. */\nexport function trackComposable<T extends object>(\n  component: T,\n  store: InspectionStore,\n  id: string\n): T {\n  const Tracked = forwardRef<unknown, Record<string, unknown>>(\n    function InspectedComposable(props, ref) {\n      useLayoutEffect(() => store.mount(id), [store, id]);\n      return createElement(\n        component as ComponentType<Record<string, unknown>>,\n        ref == null ? props : { ...props, ref }\n      );\n    }\n  );\n  for (const key of Reflect.ownKeys(component)) {\n    if (\n      typeof key === 'string' &&\n      [\n        'name',\n        'length',\n        'prototype',\n        'caller',\n        'arguments',\n        '$$typeof',\n        'render',\n        'compare',\n        'type',\n      ].includes(key)\n    )\n      continue;\n    const descriptor = Object.getOwnPropertyDescriptor(component, key);\n    if (descriptor) Object.defineProperty(Tracked, key, descriptor);\n  }\n  return Tracked as unknown as T;\n}\n"],"mappings":";;;;AAYA,SAAgB,kBAAkB,WAA0C;CAC1E,MAAM,QAAQ,sBAAsB;CACpC,MAAM,aAAa,MAAM,KAAK;EAC5B,IAAI,aAAa,YAAY;EAC7B,MAAM;EACN,OAAO;CACT,CAAC;CACD,MAAM,8BAAc,IAAI,IAAoB;CAC5C,SAAS,MACP,OACA,QACA,SAAS,IACT;EACA,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK;GACpD,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,SAAS;GAC5C,MAAM,KAAK,MAAM,KAAK;IACpB,IAAI,aAAa,UAAU;IAC3B,MAAM;IACN,OAAO;IACP,SAAS,EAAE,KAAK;GAClB,CAAC;GACD,YAAY,IAAI,MAAM,EAAE;GACxB,MAAM,KAAK,QAAQ,IAAI,UAAU;GACjC,IAAI,OAAO,SAAS,UAAU,MAAM,KAAK,cAAc,IAAI,IAAI;EACjE;CACF;CACA,MAAM,WAAW,UAAU;CAC3B,OAAO;EAAE;EAAO;EAAY;CAAY;AAC1C;;AASA,SAAgB,gBACd,WACA,OACA,IACG;CACH,MAAM,UAAU,WACd,SAAS,oBAAoB,OAAO,KAAK;EACvC,sBAAsB,MAAM,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;EAClD,OAAO,cACL,WACA,OAAO,OAAO,QAAQ;GAAE,GAAG;GAAO;EAAI,CACxC;CACF,CACF;CACA,KAAK,MAAM,OAAO,QAAQ,QAAQ,SAAS,GAAG;EAC5C,IACE,OAAO,QAAQ,YACf;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,EAAE,SAAS,GAAG,GAEd;EACF,MAAM,aAAa,OAAO,yBAAyB,WAAW,GAAG;EACjE,IAAI,YAAY,OAAO,eAAe,SAAS,KAAK,UAAU;CAChE;CACA,OAAO;AACT"}
+{"version":3,"file":"inspection.mjs","names":[],"sources":["../../src/create-config/inspection.ts"],"sourcesContent":["import {\n  createElement,\n  forwardRef,\n  useLayoutEffect,\n  type ComponentType,\n} from 'react';\nimport {\n  createInspectionStore,\n  inspectionId,\n  type InspectionStore,\n  type SourceLocation,\n} from '@jfdevelops/react-layout-devtools-core';\nimport type { ResourceDefinition } from '../resource';\n\nexport function inspectDefinition(\n  resources: readonly ResourceDefinition[],\n  source?: SourceLocation\n) {\n  const store = createInspectionStore();\n  const definition = store.node({\n    id: inspectionId('definition'),\n    kind: 'definition',\n    label: 'Layout definition',\n    source,\n  });\n  const resourceIds = new Map<string, string>();\n\n  function visit(\n    items: readonly ResourceDefinition[],\n    parent: string,\n    prefix = ''\n  ) {\n    for (const item of items) {\n      const slug = typeof item === 'string' ? item : item.value;\n      const path = prefix ? `${prefix}.${slug}` : slug;\n      const id = store.node({\n        id: inspectionId('resource'),\n        kind: 'resource',\n        label: path,\n        source,\n        details: { path },\n      });\n\n      resourceIds.set(path, id);\n\n      store.edge(parent, id, 'contains');\n\n      if (typeof item !== 'string') visit(item.subResources, id, path);\n    }\n  }\n\n  visit(resources, definition);\n\n  return { store, definition, resourceIds };\n}\n\nexport interface ActiveInspection {\n  store: InspectionStore;\n  layout: string;\n  resource?: string;\n  state: string;\n}\n\n/** Preserve composable metadata while measuring committed React instances, not declarations. */\nexport function trackComposable<T extends object>(\n  component: T,\n  store: InspectionStore,\n  id: string\n): T {\n  const Tracked = forwardRef<unknown, Record<string, unknown>>(\n    function InspectedComposable(props, ref) {\n      useLayoutEffect(() => store.mount(id), [store, id]);\n\n      return createElement(\n        component as ComponentType<Record<string, unknown>>,\n        ref == null ? props : { ...props, ref }\n      );\n    }\n  );\n\n  for (const key of Reflect.ownKeys(component)) {\n    if (\n      typeof key === 'string' &&\n      [\n        'name',\n        'length',\n        'prototype',\n        'caller',\n        'arguments',\n        '$$typeof',\n        'render',\n        'compare',\n        'type',\n      ].includes(key)\n    )\n      continue;\n\n    const descriptor = Object.getOwnPropertyDescriptor(component, key);\n\n    if (descriptor) Object.defineProperty(Tracked, key, descriptor);\n  }\n\n  return Tracked as unknown as T;\n}\n"],"mappings":";;;;AAcA,SAAgB,kBACd,WACA,QACA;CACA,MAAM,QAAQ,sBAAsB;CACpC,MAAM,aAAa,MAAM,KAAK;EAC5B,IAAI,aAAa,YAAY;EAC7B,MAAM;EACN,OAAO;EACP;CACF,CAAC;CACD,MAAM,8BAAc,IAAI,IAAoB;CAE5C,SAAS,MACP,OACA,QACA,SAAS,IACT;EACA,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK;GACpD,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,SAAS;GAC5C,MAAM,KAAK,MAAM,KAAK;IACpB,IAAI,aAAa,UAAU;IAC3B,MAAM;IACN,OAAO;IACP;IACA,SAAS,EAAE,KAAK;GAClB,CAAC;GAED,YAAY,IAAI,MAAM,EAAE;GAExB,MAAM,KAAK,QAAQ,IAAI,UAAU;GAEjC,IAAI,OAAO,SAAS,UAAU,MAAM,KAAK,cAAc,IAAI,IAAI;EACjE;CACF;CAEA,MAAM,WAAW,UAAU;CAE3B,OAAO;EAAE;EAAO;EAAY;CAAY;AAC1C;;AAUA,SAAgB,gBACd,WACA,OACA,IACG;CACH,MAAM,UAAU,WACd,SAAS,oBAAoB,OAAO,KAAK;EACvC,sBAAsB,MAAM,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;EAElD,OAAO,cACL,WACA,OAAO,OAAO,QAAQ;GAAE,GAAG;GAAO;EAAI,CACxC;CACF,CACF;CAEA,KAAK,MAAM,OAAO,QAAQ,QAAQ,SAAS,GAAG;EAC5C,IACE,OAAO,QAAQ,YACf;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,EAAE,SAAS,GAAG,GAEd;EAEF,MAAM,aAAa,OAAO,yBAAyB,WAAW,GAAG;EAEjE,IAAI,YAAY,OAAO,eAAe,SAAS,KAAK,UAAU;CAChE;CAEA,OAAO;AACT"}

package/dist/create-config/lazy-resource-layout.cjs

@@ -2,8 +2,8 @@ const require_layout_configuration_error = require('../errors/layout-configurati
 const require_resource_state_error = require('../errors/resource-state-error.cjs');
 const require_render_state = require('./render-state.cjs');
 let react = require("react");
-let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-validator");
 let react_jsx_runtime = require("react/jsx-runtime");
+let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-validator");
 
 //#region src/create-config/lazy-resource-layout.tsx
 var LazyResourceErrorBoundary = class extends react.Component {

package/dist/create-config/lazy-resource-layout.mjs

@@ -2,8 +2,8 @@ import { LayoutConfigurationError } from "../errors/layout-configuration-error.m
 import { ResourceModuleLoadError } from "../errors/resource-state-error.mjs";
 import { definedResourceLayoutComponentSymbol } from "./render-state.mjs";
 import { Component, Suspense, lazy, useReducer, useRef } from "react";
-import { componentPropDefinitionsSymbol } from "@jfdevelops/react-layout-validator";
 import { jsx } from "react/jsx-runtime";
+import { componentPropDefinitionsSymbol } from "@jfdevelops/react-layout-validator";
 
 //#region src/create-config/lazy-resource-layout.tsx
 var LazyResourceErrorBoundary = class extends Component {

package/dist/create-config/preview.cjs

@@ -0,0 +1,62 @@
+let react = require("react");
+let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
+let react_jsx_runtime = require("react/jsx-runtime");
+
+//#region src/create-config/preview.tsx
+/** Typed, partial props used only while an opted-in development preview is forced. */
+function defineLayoutPreview(layout, fixtures) {
+	const root = "Root" in layout ? layout.Root : layout;
+	Object.defineProperty(root, _jfdevelops_react_layout_devtools_core.layoutPreviewFixtures, {
+		value: fixtures,
+		configurable: true
+	});
+	return layout;
+}
+var PreviewBoundary = class extends react.Component {
+	state = {};
+	static getDerivedStateFromError(error) {
+		return { error: error instanceof Error ? error.message : String(error) };
+	}
+	componentDidCatch(error) {
+		this.props.onError(error.message);
+	}
+	render() {
+		return this.state.error ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			role: "alert",
+			children: [
+				"Unable to preview this render state: ",
+				this.state.error,
+				". Supply preview props or return to Auto in React Layout Devtools."
+			]
+		}) : this.props.children;
+	}
+};
+function createPreviewComponent(automatic, options) {
+	function PreviewableLayout(props) {
+		const [id] = (0, react.useState)(() => (0, _jfdevelops_react_layout_devtools_core.inspectionId)("instance"));
+		const [forced, setForced] = (0, react.useState)();
+		(0, react.useLayoutEffect)(() => options.store.registerPreview({
+			id,
+			layout: options.layout,
+			state: options.state,
+			states: [...options.states.values()]
+		}, setForced), [id]);
+		if (!forced) return (0, react.createElement)(automatic, props);
+		const name = [...options.states].find(([, state]) => state === forced)?.[0];
+		const target = name && options.components[name];
+		if (!target) return (0, react.createElement)(automatic, props);
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PreviewBoundary, {
+			onError: (message) => options.store.previewError(id, message),
+			children: (0, react.createElement)(target, {
+				...props,
+				...options.fixtures()?.[name]
+			})
+		}, forced);
+	}
+	return Object.assign(PreviewableLayout, automatic);
+}
+
+//#endregion
+exports.createPreviewComponent = createPreviewComponent;
+exports.defineLayoutPreview = defineLayoutPreview;
+//# sourceMappingURL=preview.cjs.map

package/dist/create-config/preview.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.cjs","names":["layoutPreviewFixtures","Component"],"sources":["../../src/create-config/preview.tsx"],"sourcesContent":["import {\n  Component,\n  createElement,\n  useLayoutEffect,\n  useState,\n  type ComponentType,\n  type ReactNode,\n} from 'react';\nimport {\n  inspectionId,\n  layoutPreviewFixtures,\n  type InspectionStore,\n} from '@jfdevelops/react-layout-devtools-core';\n\ntype PropsOf<T> = T extends (props: infer P, ...rest: never[]) => unknown\n  ? Partial<P>\n  : never;\n\nexport type LayoutPreviewProps<T> = {\n  [K in keyof T as K extends 'Root' | 'makeComposable'\n    ? never\n    : T[K] extends (...args: never[]) => unknown\n    ? K\n    : never]?: PropsOf<T[K]>;\n} & { default?: PropsOf<T extends { Root: infer R } ? R : T> };\n\n/** Typed, partial props used only while an opted-in development preview is forced. */\nexport function defineLayoutPreview<T extends object>(\n  layout: T,\n  fixtures: LayoutPreviewProps<T>\n): T {\n  const root = 'Root' in layout ? layout.Root : layout;\n\n  Object.defineProperty(root, layoutPreviewFixtures, {\n    value: fixtures,\n    configurable: true,\n  });\n\n  return layout;\n}\n\nclass PreviewBoundary extends Component<\n  { children: ReactNode; onError: (message: string) => void },\n  { error?: string }\n> {\n  state: { error?: string } = {};\n\n  static getDerivedStateFromError(error: unknown) {\n    return { error: error instanceof Error ? error.message : String(error) };\n  }\n\n  componentDidCatch(error: Error) {\n    this.props.onError(error.message);\n  }\n\n  render() {\n    return this.state.error ? (\n      <div role=\"alert\">\n        Unable to preview this render state: {this.state.error}. Supply preview\n        props or return to Auto in React Layout Devtools.\n      </div>\n    ) : (\n      this.props.children\n    );\n  }\n}\n\nexport function createPreviewComponent(\n  automatic: ComponentType<Record<string, unknown>>,\n  options: {\n    store: InspectionStore;\n    layout: string;\n    state: string;\n    states: ReadonlyMap<string, string>;\n    components: Record<string, ComponentType<Record<string, unknown>>>;\n    fixtures: () => Record<string, Record<string, unknown>> | undefined;\n  }\n) {\n  function PreviewableLayout(props: Record<string, unknown>) {\n    const [id] = useState(() => inspectionId('instance'));\n    const [forced, setForced] = useState<string>();\n\n    useLayoutEffect(\n      () =>\n        options.store.registerPreview(\n          {\n            id,\n            layout: options.layout,\n            state: options.state,\n            states: [...options.states.values()],\n          },\n          setForced\n        ),\n      [id]\n    );\n\n    if (!forced) return createElement(automatic, props);\n\n    const name = [...options.states].find(([, state]) => state === forced)?.[0];\n    const target = name && options.components[name];\n\n    if (!target) return createElement(automatic, props);\n\n    return (\n      <PreviewBoundary\n        key={forced}\n        onError={(message) => options.store.previewError(id, message)}\n      >\n        {createElement(target, { ...props, ...options.fixtures()?.[name] })}\n      </PreviewBoundary>\n    );\n  }\n\n  return Object.assign(PreviewableLayout, automatic);\n}\n"],"mappings":";;;;;;AA2BA,SAAgB,oBACd,QACA,UACG;CACH,MAAM,OAAO,UAAU,SAAS,OAAO,OAAO;CAE9C,OAAO,eAAe,MAAMA,8DAAuB;EACjD,OAAO;EACP,cAAc;CAChB,CAAC;CAED,OAAO;AACT;AAEA,IAAM,kBAAN,cAA8BC,gBAG5B;CACA,QAA4B,CAAC;CAE7B,OAAO,yBAAyB,OAAgB;EAC9C,OAAO,EAAE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;CACzE;CAEA,kBAAkB,OAAc;EAC9B,KAAK,MAAM,QAAQ,MAAM,OAAO;CAClC;CAEA,SAAS;EACP,OAAO,KAAK,MAAM,QAChB,4CAAC,OAAD;GAAK,MAAK;aAAV;IAAkB;IACsB,KAAK,MAAM;IAAM;GAEpD;OAEL,KAAK,MAAM;CAEf;AACF;AAEA,SAAgB,uBACd,WACA,SAQA;CACA,SAAS,kBAAkB,OAAgC;EACzD,MAAM,CAAC,yFAAkC,UAAU,CAAC;EACpD,MAAM,CAAC,QAAQ,iCAA8B;EAE7C,iCAEI,QAAQ,MAAM,gBACZ;GACE;GACA,QAAQ,QAAQ;GAChB,OAAO,QAAQ;GACf,QAAQ,CAAC,GAAG,QAAQ,OAAO,OAAO,CAAC;EACrC,GACA,SACF,GACF,CAAC,EAAE,CACL;EAEA,IAAI,CAAC,QAAQ,gCAAqB,WAAW,KAAK;EAElD,MAAM,OAAO,CAAC,GAAG,QAAQ,MAAM,EAAE,MAAM,GAAG,WAAW,UAAU,MAAM,IAAI;EACzE,MAAM,SAAS,QAAQ,QAAQ,WAAW;EAE1C,IAAI,CAAC,QAAQ,gCAAqB,WAAW,KAAK;EAElD,OACE,2CAAC,iBAAD;GAEE,UAAU,YAAY,QAAQ,MAAM,aAAa,IAAI,OAAO;sCAE7C,QAAQ;IAAE,GAAG;IAAO,GAAG,QAAQ,SAAS,IAAI;GAAM,CAAC;EACnD,GAJV,MAIU;CAErB;CAEA,OAAO,OAAO,OAAO,mBAAmB,SAAS;AACnD"}

package/dist/create-config/preview.d.cts

@@ -0,0 +1,13 @@
+import { ComponentType } from "react";
+//#region src/create-config/preview.d.ts
+type PropsOf<T> = T extends ((props: infer P, ...rest: never[]) => unknown) ? Partial<P> : never;
+type LayoutPreviewProps<T> = { [K in keyof T as K extends 'Root' | 'makeComposable' ? never : T[K] extends ((...args: never[]) => unknown) ? K : never]?: PropsOf<T[K]> } & {
+  default?: PropsOf<T extends {
+    Root: infer R;
+  } ? R : T>;
+};
+/** Typed, partial props used only while an opted-in development preview is forced. */
+declare function defineLayoutPreview<T extends object>(layout: T, fixtures: LayoutPreviewProps<T>): T;
+//#endregion
+export { LayoutPreviewProps, defineLayoutPreview };
+//# sourceMappingURL=preview.d.cts.map

package/dist/create-config/preview.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.cts","names":[],"sources":["../../src/create-config/preview.tsx"],"mappings":";;KAcK,OAAA,MAAa,CAAA,WAAW,KAAA,cAAmB,IAAA,yBAC5C,OAAA,CAAQ,CAAA;AAAA,KAGA,kBAAA,oBACE,CAAA,IAAK,CAAA,6CAEb,CAAA,CAAE,CAAA,eAAe,IAAA,yBACjB,CAAA,YACS,OAAA,CAAQ,CAAA,CAAE,CAAA;EACnB,OAAA,GAAU,OAAA,CAAQ,CAAA;IAAY,IAAA;EAAA,IAAkB,CAAA,GAAI,CAAA;AAAA;;iBAG1C,mBAAA,mBACd,MAAA,EAAQ,CAAA,EACR,QAAA,EAAU,kBAAA,CAAmB,CAAA,IAC5B,CAAA"}

package/dist/create-config/preview.d.mts

@@ -0,0 +1,13 @@
+import { ComponentType } from "react";
+//#region src/create-config/preview.d.ts
+type PropsOf<T> = T extends ((props: infer P, ...rest: never[]) => unknown) ? Partial<P> : never;
+type LayoutPreviewProps<T> = { [K in keyof T as K extends 'Root' | 'makeComposable' ? never : T[K] extends ((...args: never[]) => unknown) ? K : never]?: PropsOf<T[K]> } & {
+  default?: PropsOf<T extends {
+    Root: infer R;
+  } ? R : T>;
+};
+/** Typed, partial props used only while an opted-in development preview is forced. */
+declare function defineLayoutPreview<T extends object>(layout: T, fixtures: LayoutPreviewProps<T>): T;
+//#endregion
+export { LayoutPreviewProps, defineLayoutPreview };
+//# sourceMappingURL=preview.d.mts.map

package/dist/create-config/preview.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.mts","names":[],"sources":["../../src/create-config/preview.tsx"],"mappings":";;KAcK,OAAA,MAAa,CAAA,WAAW,KAAA,cAAmB,IAAA,yBAC5C,OAAA,CAAQ,CAAA;AAAA,KAGA,kBAAA,oBACE,CAAA,IAAK,CAAA,6CAEb,CAAA,CAAE,CAAA,eAAe,IAAA,yBACjB,CAAA,YACS,OAAA,CAAQ,CAAA,CAAE,CAAA;EACnB,OAAA,GAAU,OAAA,CAAQ,CAAA;IAAY,IAAA;EAAA,IAAkB,CAAA,GAAI,CAAA;AAAA;;iBAG1C,mBAAA,mBACd,MAAA,EAAQ,CAAA,EACR,QAAA,EAAU,kBAAA,CAAmB,CAAA,IAC5B,CAAA"}

package/dist/create-config/preview.mjs

@@ -0,0 +1,61 @@
+import { Component, createElement, useLayoutEffect, useState } from "react";
+import { inspectionId, layoutPreviewFixtures } from "@jfdevelops/react-layout-devtools-core";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/create-config/preview.tsx
+/** Typed, partial props used only while an opted-in development preview is forced. */
+function defineLayoutPreview(layout, fixtures) {
+	const root = "Root" in layout ? layout.Root : layout;
+	Object.defineProperty(root, layoutPreviewFixtures, {
+		value: fixtures,
+		configurable: true
+	});
+	return layout;
+}
+var PreviewBoundary = class extends Component {
+	state = {};
+	static getDerivedStateFromError(error) {
+		return { error: error instanceof Error ? error.message : String(error) };
+	}
+	componentDidCatch(error) {
+		this.props.onError(error.message);
+	}
+	render() {
+		return this.state.error ? /* @__PURE__ */ jsxs("div", {
+			role: "alert",
+			children: [
+				"Unable to preview this render state: ",
+				this.state.error,
+				". Supply preview props or return to Auto in React Layout Devtools."
+			]
+		}) : this.props.children;
+	}
+};
+function createPreviewComponent(automatic, options) {
+	function PreviewableLayout(props) {
+		const [id] = useState(() => inspectionId("instance"));
+		const [forced, setForced] = useState();
+		useLayoutEffect(() => options.store.registerPreview({
+			id,
+			layout: options.layout,
+			state: options.state,
+			states: [...options.states.values()]
+		}, setForced), [id]);
+		if (!forced) return createElement(automatic, props);
+		const name = [...options.states].find(([, state]) => state === forced)?.[0];
+		const target = name && options.components[name];
+		if (!target) return createElement(automatic, props);
+		return /* @__PURE__ */ jsx(PreviewBoundary, {
+			onError: (message) => options.store.previewError(id, message),
+			children: createElement(target, {
+				...props,
+				...options.fixtures()?.[name]
+			})
+		}, forced);
+	}
+	return Object.assign(PreviewableLayout, automatic);
+}
+
+//#endregion
+export { createPreviewComponent, defineLayoutPreview };
+//# sourceMappingURL=preview.mjs.map

package/dist/create-config/preview.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.mjs","names":[],"sources":["../../src/create-config/preview.tsx"],"sourcesContent":["import {\n  Component,\n  createElement,\n  useLayoutEffect,\n  useState,\n  type ComponentType,\n  type ReactNode,\n} from 'react';\nimport {\n  inspectionId,\n  layoutPreviewFixtures,\n  type InspectionStore,\n} from '@jfdevelops/react-layout-devtools-core';\n\ntype PropsOf<T> = T extends (props: infer P, ...rest: never[]) => unknown\n  ? Partial<P>\n  : never;\n\nexport type LayoutPreviewProps<T> = {\n  [K in keyof T as K extends 'Root' | 'makeComposable'\n    ? never\n    : T[K] extends (...args: never[]) => unknown\n    ? K\n    : never]?: PropsOf<T[K]>;\n} & { default?: PropsOf<T extends { Root: infer R } ? R : T> };\n\n/** Typed, partial props used only while an opted-in development preview is forced. */\nexport function defineLayoutPreview<T extends object>(\n  layout: T,\n  fixtures: LayoutPreviewProps<T>\n): T {\n  const root = 'Root' in layout ? layout.Root : layout;\n\n  Object.defineProperty(root, layoutPreviewFixtures, {\n    value: fixtures,\n    configurable: true,\n  });\n\n  return layout;\n}\n\nclass PreviewBoundary extends Component<\n  { children: ReactNode; onError: (message: string) => void },\n  { error?: string }\n> {\n  state: { error?: string } = {};\n\n  static getDerivedStateFromError(error: unknown) {\n    return { error: error instanceof Error ? error.message : String(error) };\n  }\n\n  componentDidCatch(error: Error) {\n    this.props.onError(error.message);\n  }\n\n  render() {\n    return this.state.error ? (\n      <div role=\"alert\">\n        Unable to preview this render state: {this.state.error}. Supply preview\n        props or return to Auto in React Layout Devtools.\n      </div>\n    ) : (\n      this.props.children\n    );\n  }\n}\n\nexport function createPreviewComponent(\n  automatic: ComponentType<Record<string, unknown>>,\n  options: {\n    store: InspectionStore;\n    layout: string;\n    state: string;\n    states: ReadonlyMap<string, string>;\n    components: Record<string, ComponentType<Record<string, unknown>>>;\n    fixtures: () => Record<string, Record<string, unknown>> | undefined;\n  }\n) {\n  function PreviewableLayout(props: Record<string, unknown>) {\n    const [id] = useState(() => inspectionId('instance'));\n    const [forced, setForced] = useState<string>();\n\n    useLayoutEffect(\n      () =>\n        options.store.registerPreview(\n          {\n            id,\n            layout: options.layout,\n            state: options.state,\n            states: [...options.states.values()],\n          },\n          setForced\n        ),\n      [id]\n    );\n\n    if (!forced) return createElement(automatic, props);\n\n    const name = [...options.states].find(([, state]) => state === forced)?.[0];\n    const target = name && options.components[name];\n\n    if (!target) return createElement(automatic, props);\n\n    return (\n      <PreviewBoundary\n        key={forced}\n        onError={(message) => options.store.previewError(id, message)}\n      >\n        {createElement(target, { ...props, ...options.fixtures()?.[name] })}\n      </PreviewBoundary>\n    );\n  }\n\n  return Object.assign(PreviewableLayout, automatic);\n}\n"],"mappings":";;;;;;AA2BA,SAAgB,oBACd,QACA,UACG;CACH,MAAM,OAAO,UAAU,SAAS,OAAO,OAAO;CAE9C,OAAO,eAAe,MAAM,uBAAuB;EACjD,OAAO;EACP,cAAc;CAChB,CAAC;CAED,OAAO;AACT;AAEA,IAAM,kBAAN,cAA8B,UAG5B;CACA,QAA4B,CAAC;CAE7B,OAAO,yBAAyB,OAAgB;EAC9C,OAAO,EAAE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;CACzE;CAEA,kBAAkB,OAAc;EAC9B,KAAK,MAAM,QAAQ,MAAM,OAAO;CAClC;CAEA,SAAS;EACP,OAAO,KAAK,MAAM,QAChB,qBAAC,OAAD;GAAK,MAAK;aAAV;IAAkB;IACsB,KAAK,MAAM;IAAM;GAEpD;OAEL,KAAK,MAAM;CAEf;AACF;AAEA,SAAgB,uBACd,WACA,SAQA;CACA,SAAS,kBAAkB,OAAgC;EACzD,MAAM,CAAC,MAAM,eAAe,aAAa,UAAU,CAAC;EACpD,MAAM,CAAC,QAAQ,aAAa,SAAiB;EAE7C,sBAEI,QAAQ,MAAM,gBACZ;GACE;GACA,QAAQ,QAAQ;GAChB,OAAO,QAAQ;GACf,QAAQ,CAAC,GAAG,QAAQ,OAAO,OAAO,CAAC;EACrC,GACA,SACF,GACF,CAAC,EAAE,CACL;EAEA,IAAI,CAAC,QAAQ,OAAO,cAAc,WAAW,KAAK;EAElD,MAAM,OAAO,CAAC,GAAG,QAAQ,MAAM,EAAE,MAAM,GAAG,WAAW,UAAU,MAAM,IAAI;EACzE,MAAM,SAAS,QAAQ,QAAQ,WAAW;EAE1C,IAAI,CAAC,QAAQ,OAAO,cAAc,WAAW,KAAK;EAElD,OACE,oBAAC,iBAAD;GAEE,UAAU,YAAY,QAAQ,MAAM,aAAa,IAAI,OAAO;aAE3D,cAAc,QAAQ;IAAE,GAAG;IAAO,GAAG,QAAQ,SAAS,IAAI;GAAM,CAAC;EACnD,GAJV,MAIU;CAErB;CAEA,OAAO,OAAO,OAAO,mBAAmB,SAAS;AACnD"}

package/dist/create-config/render-state.cjs

@@ -1,6 +1,7 @@
 const require_layout_configuration_error = require('../errors/layout-configuration-error.cjs');
 const require_state_composable = require('./state-composable.cjs');
 let _jfdevelops_react_layout_composables = require("@jfdevelops/react-layout-composables");
+let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
 
 //#region src/create-config/render-state.ts
 const deferredRenderStateSymbol = Symbol("deferredRenderState");
@@ -30,7 +31,12 @@ function toFragment(definition) {
 */
 function createRenderStateBuilder(_arguments) {
 	function createRenderState(input) {
-		return toFragment(normalizeDefinition(input));
+		const definition = normalizeDefinition(input);
+		const debug = (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(input);
+		return toFragment(debug ? {
+			...definition,
+			[_jfdevelops_react_layout_devtools_core.layoutDebug]: debug
+		} : definition);
 	}
 	createRenderState.fromState = (input) => {
 		const entry = isLazyRenderState(input.ref) ? input.ref : Object.values(input.ref)[0];
@@ -61,6 +67,7 @@ function createRenderStateBuilder(_arguments) {
 			}]))
 		}).filter(([key]) => !(key in custom)));
 		return toFragment({
+			[_jfdevelops_react_layout_devtools_core.layoutDebug]: (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(input),
 			state: input.state ?? "default",
 			props: {
 				custom,
@@ -104,7 +111,13 @@ function createRenderStateBuilder(_arguments) {
 	};
 	createRenderState.defer = (input) => {
 		const definition = normalizeDefinition(input);
-		const deferred = { [deferredRenderStateSymbol]: definition };
+		const deferred = {
+			[deferredRenderStateSymbol]: {
+				...definition,
+				[_jfdevelops_react_layout_devtools_core.layoutDebug]: (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(input)
+			},
+			[_jfdevelops_react_layout_devtools_core.layoutDebug]: (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(input)
+		};
 		const fragment = { [definition.state ?? "default"]: deferred };
 		Object.defineProperty(fragment, definedRenderStateSymbol, { value: definition });
 		return require_state_composable.withStateComposable(fragment, {
@@ -113,7 +126,10 @@ function createRenderStateBuilder(_arguments) {
 		});
 	};
 	createRenderState.lazy = (load) => {
-		const lazyState = { [lazyRenderStateSymbol]: load };
+		const lazyState = {
+			[lazyRenderStateSymbol]: load,
+			[_jfdevelops_react_layout_devtools_core.layoutDebug]: (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(load)
+		};
 		return require_state_composable.withStateComposable(lazyState, {
 			input: lazyState,
 			name: "lazy"

package/dist/create-config/render-state.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"render-state.cjs","names":["withStateComposable","LayoutConfigurationError","createStateComposable","composablePresetMetaKey"],"sources":["../../src/create-config/render-state.ts"],"sourcesContent":["import type { MergeContract } from './define-layout';\nimport type { JSX } from 'react';\nimport { collectComposablePresetEntries, composablePresetMetaKey, type MergePresetProps, type ComposablePresetMeta } from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport { createStateComposable, withStateComposable, type StateComposable, type StateComposableHandle } from './state-composable';\nimport type { ResolveProps } from '@jfdevelops/react-layout-validator';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '../props';\nimport type {\n  IncludedProps,\n  InPropsDefinition,\n  LayoutRenderProps,\n  MergedLayoutInProps,\n  ResolvedIncludedComponentProps,\n  ResolvedIncludedProps,\n} from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport type { LayoutRenderResourcesAccessor } from './define-layout';\n\nexport const deferredRenderStateSymbol: unique symbol = Symbol(\n  'deferredRenderState',\n) as never;\nexport const lazyRenderStateSymbol: unique symbol = Symbol(\n  'lazyRenderState',\n) as never;\nexport const definedRenderStateSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/render-state',\n) as never;\nexport const definedResourceLayoutComponentSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/resource-layout-component',\n) as never;\n\n/** Runtime-compatible render-state shape used when inspecting lazy modules. */\nexport type AnyRenderStateDefinition = {\n  composables?: (create: CreateLayoutComposable<any>, states: any) => ComposableComponents;\n  props?: {\n    include?: Record<string, unknown>;\n    custom?: InPropsObject;\n  };\n  render: (props: any, context: any) => JSX.Element;\n  state?: string;\n};\n\n/** An inline state whose first render is scheduled through `React.lazy`. */\nexport type DeferredRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [deferredRenderStateSymbol]: Definition;\n};\n\n/** A state definition supplied by a separately imported module. */\nexport type LazyRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [lazyRenderStateSymbol]: () => Promise<Record<string, unknown>>;\n  readonly definition?: Definition;\n};\n\n/**\n * State names accepted by `createRenderState`. Built-in states are suggested by\n * autocomplete while any other string still creates a custom compound state.\n */\nexport type RenderStateName =\n  | 'default'\n  | 'Loading'\n  | 'Error'\n  | 'NotFound'\n  | (string & {});\n\n/** Callback shorthand for a render state with no local configuration. */\nexport type RenderStateCallback = (props: any, context: any) => JSX.Element;\n\n/**\n * Defines state-local composable components with a `create` helper narrowed to\n * the resources bound to the surrounding builder.\n */\nexport type RenderStateComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n  States = {},\n> = (\n  create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  states: States,\n) => Composables;\n\n/**\n * Defines reusable layout-level composables while preserving their inferred\n * names, props, and bound resource union.\n */\nexport type LayoutComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = RenderStateComposablesDefinition<Resources, Composables>;\n\ntype BuilderRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\n/** Values available as the second argument of a created state's `render`. */\nexport type RenderStateContext<\n  Composables extends ComposableComponents,\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n> = {\n  resources: LayoutRenderResourcesAccessor<Resources>;\n  composables: BuilderRenderComposables<Composables>;\n  retry?: () => void;\n};\n\n/**\n * Resolves one state's custom props and explicitly included option/composable\n * props to the values received by its render callback.\n */\nexport type RenderStateProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, Composables>\n  >,\n  CustomProps extends InPropsObject,\n> = LayoutRenderProps<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps\n>;\n\ntype TypedRenderStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  State extends string,\n  CustomProps extends InPropsObject,\n  SharedComposables extends ComposableComponents,\n  StateComposables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables\n    >\n  >,\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> = {\n  composables?: RenderStateComposablesDefinition<Resources, StateComposables>;\n  props?: {\n    include?: IncludeProps;\n    custom?: CustomProps;\n  };\n  render: (\n    props: RenderStateProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables,\n      MergeContract<SharedInclude, IncludeProps>,\n      MergeContract<SharedCustom, CustomProps>\n    >,\n    context: RenderStateContext<SharedComposables & StateComposables, Resources>,\n  ) => JSX.Element;\n  state: State;\n};\n\n/**\n * Callback shorthand for a created state, typed with the bound resources,\n * options, and shared composables.\n */\nexport type TypedRenderStateCallback<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> = (\n  props: RenderStateProps<Resources, Options, SharedComposables, SharedInclude, SharedCustom>,\n  context: RenderStateContext<SharedComposables, Resources>,\n) => JSX.Element;\n\ntype NormalizeRenderStateDefinition<Input> =\n  Input extends LazyRenderState<infer Definition>\n    ? Definition\n    : Input extends DeferredRenderState<infer Definition>\n    ? Definition\n    : Input extends RenderStateCallback\n      ? { render: Input; state: 'default' }\n      : Input extends AnyRenderStateDefinition\n        ? Input\n        : never;\n\ntype StateName<Definition> = Definition extends DeferredRenderState<\n  infer DeferredDefinition\n>\n  ? StateName<DeferredDefinition>\n  : Definition extends { state?: infer State extends string }\n    ? State\n    : 'default';\n\n/**\n * A spreadable state entry keyed by its literal state name. Spreading this into\n * `layout.render` is what creates compound members such as `Users.Loading`.\n */\nexport type RenderStateFragment<Definition, CallProps extends object = ResolveProps<StateCustomProps<Definition>>> = {\n  [State in StateName<NormalizeRenderStateDefinition<Definition>>]: Definition;\n} & {\n  readonly [definedRenderStateSymbol]: NormalizeRenderStateDefinition<Definition>;\n} & StateComposableHandle<CallProps>;\n\ntype StateCustomProps<Input> = NormalizeStateInput<Input> extends {\n  props?: { custom?: infer Props extends InPropsObject };\n} ? Props : {};\n\ntype StateIncludes<Input> = NormalizeStateInput<Input> extends {\n  props?: { include?: infer Includes };\n} ? Includes : {};\n\ntype NormalizeStateInput<Input> = Input extends DeferredRenderState<infer Definition>\n  ? Definition\n  : Input extends LazyRenderState<infer Definition> ? Definition : Input;\n\ntype StateLocalComposables<Input> = NormalizeStateInput<Input> extends {\n  composables?: (...args: any[]) => infer Components extends ComposableComponents;\n} ? Components : {};\n\n/**\n * A composables callback cannot infer its own return value into its arguments.\n * Preserve the declared call-site contract for props supplied by local presets,\n * even when their value types are not yet available in the callback context.\n */\ntype UnresolvedStateComponentProps<Props, Includes> = {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends {\n    visibility: 'required'; passthrough: 'component';\n  } ? Key : never]: unknown;\n} & {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends\n    | 'optional'\n    | { visibility: 'optional'; passthrough: 'component' }\n    ? Key : never]?: unknown;\n};\n\ntype StateComponentProps<Props extends InPropsObject, Includes> =\n  ResolvedIncludedComponentProps<Props,\n    Pick<Includes, Extract<keyof Includes, keyof Props>> extends infer Known extends IncludedProps<Props>\n      ? Known : {}\n  > & UnresolvedStateComponentProps<Props, Includes>;\n\n/** Call-site props of a referenced state; creation-time options stay bound. */\nexport type RenderStateCallProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Input,\n> = ResolveProps<StateCustomProps<Input>> & StateComponentProps<\n  MergedLayoutInProps<Resources, Options, Composables & StateLocalComposables<Input>>,\n  StateIncludes<Input>\n>;\n\n/** Typed references to all the states declared in an inline render map. */\nexport type RenderStateReferences<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  States,\n> = {\n  readonly [State in keyof States & string]: StateComposable<\n    RenderStateCallProps<Resources, Options, Composables, States[State]>\n  >;\n};\n\ntype BoundRenderStateFragment<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Definition,\n> = RenderStateFragment<Definition, RenderStateCallProps<\n  Resources, Options, Composables, Definition\n>>;\n\ntype DefinedRenderStateFromModule<Module> = Extract<\n  Module[keyof Module],\n  { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n>[typeof definedRenderStateSymbol];\n\n/** Wraps a state definition in the deferred marker when `Deferred` is `true`. */\ntype RenderStateEntry<Definition, Deferred extends boolean> = Deferred extends true\n  ? DeferredRenderState<NormalizeRenderStateDefinition<Definition>>\n  : Definition;\n\n/**\n * Overloads shared by `createRenderState` and `createRenderState.defer`. Each\n * accepts a full definition, a definition without `state`, or a render\n * callback; `Deferred` decides whether the returned entry is deferred.\n */\nexport interface RenderStateOverloads<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  Deferred extends boolean,\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> {\n  <\n    const State extends RenderStateName,\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: TypedRenderStateDefinition<\n      Resources,\n      Options,\n      State,\n      CustomProps,\n      SharedComposables,\n      StateComposables,\n      IncludeProps,\n      SharedInclude,\n      SharedCustom\n    >,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        State,\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n      SharedInclude,\n      SharedCustom\n      >,\n      Deferred\n    >\n  >;\n  <\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {},\n  >(\n    definition: Omit<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n      SharedInclude,\n      SharedCustom\n      >,\n      'state'\n    >,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n      SharedInclude,\n      SharedCustom\n      >,\n      Deferred\n    >\n  >;\n  (\n    render: TypedRenderStateCallback<Resources, Options, SharedComposables, SharedInclude, SharedCustom>,\n  ): BoundRenderStateFragment<Resources, Options, SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateCallback<Resources, Options, SharedComposables, SharedInclude, SharedCustom>,\n      Deferred\n    >\n  >;\n}\n\ntype RenderStateReference = (\n  | { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n  | LazyRenderState<AnyRenderStateDefinition>\n) & StateComposableHandle<any>;\n\ntype ReferenceDefinition<Ref extends RenderStateReference> =\n  Ref extends LazyRenderState<infer Definition> ? Definition\n    : Ref extends { readonly [definedRenderStateSymbol]: infer Definition extends AnyRenderStateDefinition }\n      ? Definition : never;\n\ntype FromStateEntry<Ref extends RenderStateReference, Definition extends AnyRenderStateDefinition> =\n  Ref extends LazyRenderState<AnyRenderStateDefinition> ? LazyRenderState<Definition>\n    : Extract<Ref[Exclude<keyof Ref, 'asComposable' | typeof definedRenderStateSymbol>], LazyRenderState<AnyRenderStateDefinition>> extends never\n      ? Definition : LazyRenderState<Definition>;\ntype ReferenceSchemas<Ref extends RenderStateReference> =\n  StateCustomProps<ReferenceDefinition<Ref>> & MergePresetProps<StateLocalComposables<ReferenceDefinition<Ref>>>;\n\ntype DefaultReferenceIncludes<Ref extends RenderStateReference, CustomProps> =\n  Omit<StateIncludes<ReferenceDefinition<Ref>>, keyof CustomProps | keyof StateCustomProps<ReferenceDefinition<Ref>>> & {\n    [Key in Exclude<keyof StateCustomProps<ReferenceDefinition<Ref>>, keyof CustomProps>]: {\n      visibility: StateCustomProps<ReferenceDefinition<Ref>>[Key] extends { visibility: infer Visibility }\n        ? Visibility : 'required';\n      passthrough: 'component';\n    };\n  };\n\ntype ReferenceIncludes<Ref extends RenderStateReference, CustomProps, Include> =\n  Include extends object ? Include : DefaultReferenceIncludes<Ref, CustomProps>;\n\ntype FromStateInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Local extends ComposableComponents,\n> = (MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local> &\n  StateCustomProps<ReferenceDefinition<Ref>>) extends infer Props extends InPropsObject ? Props : {};\n\ntype SelectedReferenceSchemas<Ref extends RenderStateReference, Include> =\n  Pick<ReferenceSchemas<Ref>, Extract<keyof Include, keyof ReferenceSchemas<Ref>>> extends infer Selected extends InPropsObject\n    ? Selected : {};\n\ntype ReferenceCarriedProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Include,\n> = Pick<FromStateInProps<Resources, Options, Shared, Ref, {}>,\n  Extract<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, {}>>\n> extends infer Selected extends InPropsObject ? ResolveProps<Selected> : {};\n\ntype ReferenceRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n> = RenderStateProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>,\n  StateIncludes<ReferenceDefinition<Ref>> extends infer Include extends IncludedProps<MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>>> ? Include : {},\n  StateCustomProps<ReferenceDefinition<Ref>>>;\n\ntype FromStateComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Local extends ComposableComponents,\n  Include,\n> = Local & {\n  Ref: StateComposable<\n    ReferenceRenderProps<Resources, Options, Shared, Ref>,\n    Extract<keyof ReferenceCarriedProps<Resources, Options, Shared, Ref, Include>, keyof ReferenceRenderProps<Resources, Options, Shared, Ref>>\n  > & { [composablePresetMetaKey]: ComposablePresetMeta<SelectedReferenceSchemas<Ref, Include>> };\n};\n\ntype FromStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  State extends string,\n  CustomProps extends InPropsObject,\n  Local extends ComposableComponents,\n  Include,\n> = {\n  state: State;\n  props?: { custom?: CustomProps; include?: ReferenceIncludes<Ref, CustomProps, Include> };\n  composables: RenderStateComposablesDefinition<Resources,\n    FromStateComposables<Resources, Options, Shared, Ref, Local, ReferenceIncludes<Ref, CustomProps, Include>>>;\n  render: (\n    props: ResolveProps<CustomProps> & ResolvedIncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>,\n      ReferenceIncludes<Ref, CustomProps, Include> extends infer Selected extends IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>> ? Selected : {}>,\n    context: RenderStateContext<Shared & FromStateComposables<Resources, Options, Shared, Ref, Local, ReferenceIncludes<Ref, CustomProps, Include>>, Resources>,\n  ) => JSX.Element;\n};\n\n/** Creates a state with inherited props and a composable reference to its source. */\nexport type CreateRenderStateFromState<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n> = <\n  const Ref extends RenderStateReference,\n  const State extends RenderStateName = 'default',\n  const CustomProps extends InPropsObject = {},\n  const Local extends ComposableComponents = {},\n  const Include extends IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>> | undefined = undefined,\n>(definition: {\n  ref: Ref;\n  /** Defer Ref rendering through React.lazy. Defaults to false. */\n  lazy?: boolean;\n  state?: State;\n  props?: {\n    custom?: CustomProps;\n    include?: Include & Record<Exclude<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, Local>>, never>;\n  };\n  composables?: (create: CreateLayoutComposable<LayoutResourceKey<Resources>>, states: {}) => Local & { Ref?: never };\n  render: FromStateDefinition<Resources, Options, Shared, Ref, State, CustomProps, Local, Include>['render'];\n}) => BoundRenderStateFragment<Resources, Options, Shared,\n  FromStateEntry<Ref, FromStateDefinition<Resources, Options, Shared, Ref, State, CustomProps, Local, Include>>>;\n\n/**\n * Creates independently typed render-state fragments.\n *\n * - Calling it directly creates an eager state.\n * - `.defer(...)` schedules an inline definition through `React.lazy`, but\n *   does not create a separate JavaScript chunk.\n * - `.lazy(() => import(...))` imports a complete named state definition as a\n *   separate chunk.\n * - `.fromState({ ref, ... })` inherits a state's props and exposes it as `Ref`.\n */\nexport interface CreateRenderState<\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> extends RenderStateOverloads<Resources, Options, SharedComposables, false, SharedInclude, SharedCustom> {\n  fromState: CreateRenderStateFromState<Resources, Options, SharedComposables>;\n  defer: RenderStateOverloads<Resources, Options, SharedComposables, true, SharedInclude, SharedCustom>;\n  lazy<Module extends Record<string, unknown>>(\n    load: () => Promise<Module>,\n  ): LazyRenderState<DefinedRenderStateFromModule<Module>> & StateComposableHandle<\n    RenderStateCallProps<Resources, Options, SharedComposables, DefinedRenderStateFromModule<Module>>\n  >;\n}\n\nfunction normalizeDefinition(\n  input: AnyRenderStateDefinition | RenderStateCallback,\n): AnyRenderStateDefinition {\n  return typeof input === 'function'\n    ? { render: input, state: 'default' }\n    : input;\n}\n\nfunction toFragment<Definition extends AnyRenderStateDefinition>(\n  definition: Definition,\n) {\n  const fragment = {\n    [definition.state ?? 'default']: definition,\n  } as RenderStateFragment<Definition>;\n\n  Object.defineProperty(fragment, definedRenderStateSymbol, {\n    enumerable: false,\n    value: definition,\n  });\n\n  return withStateComposable(fragment, { input: definition, name: definition.state ?? 'default' });\n}\n\n/** Inputs used internally to bind resource and option types to a state builder. */\nexport type CreateRenderStateBuilderArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> = {\n  props?: { include?: SharedInclude; custom?: SharedCustom };\n  /** Shared composables whose components and preset props every state can use. */\n  composables?: LayoutComposablesDefinition<Resources, SharedComposables>;\n  /** Option props that individual states can expose through `props.include`. */\n  options: Options;\n  /** Resources used to constrain composable names and resource-specific props. */\n  resources: Resources;\n};\n\n/** The state factory produced for a particular resource and option definition. */\nexport type CreateRenderStateBuilderResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n> = CreateRenderState<Resources, Options, SharedComposables, SharedInclude, SharedCustom>;\n\n/**\n * Creates a state factory whose `props.include` keys are constrained by the\n * supplied resources and options.\n */\nexport function createRenderStateBuilder<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<MergedLayoutInProps<Resources, Options, SharedComposables>> = {},\n  SharedCustom extends InPropsObject = {},\n>(\n  _arguments: CreateRenderStateBuilderArguments<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >,\n): CreateRenderStateBuilderResult<Resources, Options, SharedComposables, SharedInclude, SharedCustom> {\n  function createRenderState(\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) {\n    return toFragment(normalizeDefinition(input));\n  }\n\n  createRenderState.fromState = (input: {\n    ref: RenderStateReference;\n    lazy?: boolean;\n    state?: string;\n    props?: AnyRenderStateDefinition['props'];\n    composables?: AnyRenderStateDefinition['composables'];\n    render: AnyRenderStateDefinition['render'];\n  }): object => {\n    const entry = isLazyRenderState(input.ref) ? input.ref : Object.values(input.ref)[0];\n    if (isLazyRenderState(entry)) {\n      const lazyState = {\n        [lazyRenderStateSymbol]: async () => {\n          const source = await findDefinedRenderState(await entry[lazyRenderStateSymbol]());\n          return { Derived: createRenderState.fromState({ ...input, ref: toFragment(source) }) };\n        },\n      };\n      const name = input.state ?? 'default';\n      const fragment = { [name]: lazyState };\n      Object.defineProperty(fragment, definedRenderStateSymbol, { value: lazyState });\n      return withStateComposable(fragment, { input: lazyState, name });\n    }\n    const source = isDeferredRenderState(entry)\n      ? entry[deferredRenderStateSymbol]\n      : definedRenderStateSymbol in input.ref ? input.ref[definedRenderStateSymbol] : undefined;\n    if (!source || typeof source.render !== 'function') {\n      throw new LayoutConfigurationError('fromState requires a created render state');\n    }\n    const custom = input.props?.custom ?? {};\n    const includes = input.props?.include ?? Object.fromEntries(\n      Object.entries({\n        ...source.props?.include,\n        ...Object.fromEntries(Object.entries(source.props?.custom ?? {}).map(([key, prop]) => [\n          key, { visibility: prop.visibility, passthrough: 'component' },\n        ])),\n      }).filter(([key]) => !(key in custom)),\n    );\n    return toFragment({\n      state: input.state ?? 'default',\n      props: { custom, include: includes },\n      composables: (create, states) => {\n        const inherited = source.composables?.(create, states) ?? {};\n        const local = input.composables?.(create, states) ?? {};\n        if (Object.prototype.hasOwnProperty.call(local, 'Ref')) {\n          throw new LayoutConfigurationError('Composable name \"Ref\" is reserved by fromState');\n        }\n        const schemas = Object.assign({},\n          ...collectComposablePresetEntries(inherited).map(({ props }) => props),\n          source.props?.custom,\n        ) as InPropsObject;\n        const selected = Object.fromEntries(Object.entries(schemas).filter(([key]) => key in includes));\n        const referenceSource = {\n          ...source,\n          props: {\n            ...source.props,\n            include: Object.fromEntries(Object.entries(source.props?.include ?? {}).map(([key, behavior]) => [\n              key, {\n                visibility: behavior === 'optional' || (typeof behavior === 'object' && behavior !== null && 'visibility' in behavior && behavior.visibility === 'optional')\n                  ? 'optional' : 'required',\n                passthrough: 'component',\n              },\n            ])),\n          },\n        };\n        const Ref = createStateComposable({\n          input: input.lazy || isDeferredRenderState(entry) ? { [deferredRenderStateSymbol]: referenceSource } : referenceSource,\n          name: source.state ?? 'default',\n          fallbackStateName: input.state,\n        }, {\n          props: { include: Object.fromEntries(Object.keys(includes).map((key) => [key, true as const])) },\n          normalizeIncludedKeys: true,\n        });\n        Object.defineProperty(Ref, composablePresetMetaKey, {\n          value: { key: 'Ref', props: selected },\n        });\n        return { ...local, Ref };\n      },\n      render: input.render,\n    });\n  };\n\n  createRenderState.defer = (\n    input: AnyRenderStateDefinition | RenderStateCallback,\n  ) => {\n    const definition = normalizeDefinition(input);\n\n    const deferred = { [deferredRenderStateSymbol]: definition };\n    const fragment = { [definition.state ?? 'default']: deferred };\n    Object.defineProperty(fragment, definedRenderStateSymbol, { value: definition });\n    return withStateComposable(fragment, {\n      input: deferred, name: definition.state ?? 'default',\n    });\n  };\n  createRenderState.lazy = (\n    load: () => Promise<Record<string, unknown>>,\n  ) => {\n    const lazyState = { [lazyRenderStateSymbol]: load };\n    return withStateComposable(lazyState, { input: lazyState, name: 'lazy' });\n  };\n\n  return createRenderState as unknown as CreateRenderStateBuilderResult<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >;\n}\n\n/** Type guard for states created with `createRenderState.defer(...)`. */\nexport function isDeferredRenderState(\n  value: unknown,\n): value is DeferredRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    deferredRenderStateSymbol in value\n  );\n}\n\n/** Type guard for states created with `createRenderState.lazy(...)`. */\nexport function isLazyRenderState(\n  value: unknown,\n): value is LazyRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' && value !== null && lazyRenderStateSymbol in value\n  );\n}\n\n/**\n * Resolves the single state exported by a lazy module, including derived lazy\n * states. Throws when a module exports none or more than one.\n */\nexport async function findDefinedRenderState(\n  module: Record<string, unknown>,\n): Promise<AnyRenderStateDefinition> {\n  const definitions = Object.values(module).filter(\n    (value) =>\n      typeof value === 'object' && value !== null && definedRenderStateSymbol in value,\n  ) as Array<Record<typeof definedRenderStateSymbol, AnyRenderStateDefinition>>;\n\n  if (definitions.length !== 1) {\n    throw new Error(\n      `A lazy render-state module must export exactly one defined render state; received ${definitions.length}.`,\n    );\n  }\n\n  const definition = definitions[0][definedRenderStateSymbol];\n  return isLazyRenderState(definition)\n    ? findDefinedRenderState(await definition[lazyRenderStateSymbol]())\n    : definition;\n}\n\n/** Identity helper that contextually types a reusable composables callback. */\nexport type DefineLayoutComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <const Composables extends ComposableComponents>(\n  definition: LayoutComposablesDefinition<Resources, Composables>,\n) => LayoutComposablesDefinition<Resources, Composables>;\n\n/** Public cross-file building blocks returned by a defined layout builder. */\nexport type CreateLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = {\n  composables: DefineLayoutComposables<Resources>;\n  createRenderState: CreateRenderState<Resources, Options>;\n};\n\n/** Resource and option bindings used to create layout building blocks. */\nexport type CreateLayoutBuildingBlocksArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateRenderStateBuilderArguments<Resources, Options>;\n\n/** Layout helpers produced for the supplied resource and option bindings. */\nexport type CreateLayoutBuildingBlocksResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = CreateLayoutBuildingBlocks<Resources, Options>;\n\n/**\n * Creates the reusable `composables` and `createRenderState` helpers without\n * introducing an identity wrapper around the layout object itself.\n */\nexport function createLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n>(\n  arguments_: CreateLayoutBuildingBlocksArguments<Resources, Options>,\n): CreateLayoutBuildingBlocksResult<Resources, Options> {\n  function composables<const Composables extends ComposableComponents>(\n    definition: LayoutComposablesDefinition<Resources, Composables>,\n  ): LayoutComposablesDefinition<Resources, Composables> {\n    return definition;\n  }\n\n  return {\n    composables,\n    createRenderState: createRenderStateBuilder(arguments_),\n  };\n}\n\n/** Preserves a bound resource tuple for consumers that need to re-export it. */\nexport type BoundResources<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = Resources;\n"],"mappings":";;;;;AAsBA,MAAa,4BAA2C,OACtD,qBACF;AACA,MAAa,wBAAuC,OAClD,iBACF;AACA,MAAa,2BAA0C,OAAO,IAC5D,uCACF;AACA,MAAa,uCAAsD,OAAO,IACxE,oDACF;AAyfA,SAAS,oBACP,OAC0B;CAC1B,OAAO,OAAO,UAAU,aACpB;EAAE,QAAQ;EAAO,OAAO;CAAU,IAClC;AACN;AAEA,SAAS,WACP,YACA;CACA,MAAM,WAAW,GACd,WAAW,SAAS,YAAY,WACnC;CAEA,OAAO,eAAe,UAAU,0BAA0B;EACxD,YAAY;EACZ,OAAO;CACT,CAAC;CAED,OAAOA,6CAAoB,UAAU;EAAE,OAAO;EAAY,MAAM,WAAW,SAAS;CAAU,CAAC;AACjG;;;;;AAgCA,SAAgB,yBAOd,YAOoG;CACpG,SAAS,kBACP,OACA;EACA,OAAO,WAAW,oBAAoB,KAAK,CAAC;CAC9C;CAEA,kBAAkB,aAAa,UAOjB;EACZ,MAAM,QAAQ,kBAAkB,MAAM,GAAG,IAAI,MAAM,MAAM,OAAO,OAAO,MAAM,GAAG,EAAE;EAClF,IAAI,kBAAkB,KAAK,GAAG;GAC5B,MAAM,YAAY,GACf,wBAAwB,YAAY;IACnC,MAAM,SAAS,MAAM,uBAAuB,MAAM,MAAM,uBAAuB,CAAC;IAChF,OAAO,EAAE,SAAS,kBAAkB,UAAU;KAAE,GAAG;KAAO,KAAK,WAAW,MAAM;IAAE,CAAC,EAAE;GACvF,EACF;GACA,MAAM,OAAO,MAAM,SAAS;GAC5B,MAAM,WAAW,GAAG,OAAO,UAAU;GACrC,OAAO,eAAe,UAAU,0BAA0B,EAAE,OAAO,UAAU,CAAC;GAC9E,OAAOA,6CAAoB,UAAU;IAAE,OAAO;IAAW;GAAK,CAAC;EACjE;EACA,MAAM,SAAS,sBAAsB,KAAK,IACtC,MAAM,6BACN,4BAA4B,MAAM,MAAM,MAAM,IAAI,4BAA4B;EAClF,IAAI,CAAC,UAAU,OAAO,OAAO,WAAW,YACtC,MAAM,IAAIC,4DAAyB,2CAA2C;EAEhF,MAAM,SAAS,MAAM,OAAO,UAAU,CAAC;EACvC,MAAM,WAAW,MAAM,OAAO,WAAW,OAAO,YAC9C,OAAO,QAAQ;GACb,GAAG,OAAO,OAAO;GACjB,GAAG,OAAO,YAAY,OAAO,QAAQ,OAAO,OAAO,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,UAAU,CACpF,KAAK;IAAE,YAAY,KAAK;IAAY,aAAa;GAAY,CAC/D,CAAC,CAAC;EACJ,CAAC,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,OAAO,CACvC;EACA,OAAO,WAAW;GAChB,OAAO,MAAM,SAAS;GACtB,OAAO;IAAE;IAAQ,SAAS;GAAS;GACnC,cAAc,QAAQ,WAAW;IAC/B,MAAM,YAAY,OAAO,cAAc,QAAQ,MAAM,KAAK,CAAC;IAC3D,MAAM,QAAQ,MAAM,cAAc,QAAQ,MAAM,KAAK,CAAC;IACtD,IAAI,OAAO,UAAU,eAAe,KAAK,OAAO,KAAK,GACnD,MAAM,IAAIA,4DAAyB,kDAAgD;IAErF,MAAM,UAAU,OAAO,OAAO,CAAC,GAC7B,4EAAkC,SAAS,EAAE,KAAK,EAAE,YAAY,KAAK,GACrE,OAAO,OAAO,MAChB;IACA,MAAM,WAAW,OAAO,YAAY,OAAO,QAAQ,OAAO,EAAE,QAAQ,CAAC,SAAS,OAAO,QAAQ,CAAC;IAC9F,MAAM,kBAAkB;KACtB,GAAG;KACH,OAAO;MACL,GAAG,OAAO;MACV,SAAS,OAAO,YAAY,OAAO,QAAQ,OAAO,OAAO,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,cAAc,CAC/F,KAAK;OACH,YAAY,aAAa,cAAe,OAAO,aAAa,YAAY,aAAa,QAAQ,gBAAgB,YAAY,SAAS,eAAe,aAC7I,aAAa;OACjB,aAAa;MACf,CACF,CAAC,CAAC;KACJ;IACF;IACA,MAAM,MAAMC,+CAAsB;KAChC,OAAO,MAAM,QAAQ,sBAAsB,KAAK,IAAI,GAAG,4BAA4B,gBAAgB,IAAI;KACvG,MAAM,OAAO,SAAS;KACtB,mBAAmB,MAAM;IAC3B,GAAG;KACD,OAAO,EAAE,SAAS,OAAO,YAAY,OAAO,KAAK,QAAQ,EAAE,KAAK,QAAQ,CAAC,KAAK,IAAa,CAAC,CAAC,EAAE;KAC/F,uBAAuB;IACzB,CAAC;IACD,OAAO,eAAe,KAAKC,8DAAyB,EAClD,OAAO;KAAE,KAAK;KAAO,OAAO;IAAS,EACvC,CAAC;IACD,OAAO;KAAE,GAAG;KAAO;IAAI;GACzB;GACA,QAAQ,MAAM;EAChB,CAAC;CACH;CAEA,kBAAkB,SAChB,UACG;EACH,MAAM,aAAa,oBAAoB,KAAK;EAE5C,MAAM,WAAW,GAAG,4BAA4B,WAAW;EAC3D,MAAM,WAAW,GAAG,WAAW,SAAS,YAAY,SAAS;EAC7D,OAAO,eAAe,UAAU,0BAA0B,EAAE,OAAO,WAAW,CAAC;EAC/E,OAAOH,6CAAoB,UAAU;GACnC,OAAO;GAAU,MAAM,WAAW,SAAS;EAC7C,CAAC;CACH;CACA,kBAAkB,QAChB,SACG;EACH,MAAM,YAAY,GAAG,wBAAwB,KAAK;EAClD,OAAOA,6CAAoB,WAAW;GAAE,OAAO;GAAW,MAAM;EAAO,CAAC;CAC1E;CAEA,OAAO;AAOT;;AAGA,SAAgB,sBACd,OACwD;CACxD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,6BAA6B;AAEjC;;AAGA,SAAgB,kBACd,OACoD;CACpD,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,yBAAyB;AAE5E;;;;;AAMA,eAAsB,uBACpB,QACmC;CACnC,MAAM,cAAc,OAAO,OAAO,MAAM,EAAE,QACvC,UACC,OAAO,UAAU,YAAY,UAAU,QAAQ,4BAA4B,KAC/E;CAEA,IAAI,YAAY,WAAW,GACzB,MAAM,IAAI,MACR,qFAAqF,YAAY,OAAO,EAC1G;CAGF,MAAM,aAAa,YAAY,GAAG;CAClC,OAAO,kBAAkB,UAAU,IAC/B,uBAAuB,MAAM,WAAW,uBAAuB,CAAC,IAChE;AACN"}
+{"version":3,"file":"render-state.cjs","names":["withStateComposable","layoutDebug","LayoutConfigurationError","createStateComposable","composablePresetMetaKey"],"sources":["../../src/create-config/render-state.ts"],"sourcesContent":["import {\n  getLayoutDebug,\n  layoutDebug,\n} from '@jfdevelops/react-layout-devtools-core';\nimport type { MergeContract } from './define-layout';\nimport type { JSX } from 'react';\nimport {\n  collectComposablePresetEntries,\n  composablePresetMetaKey,\n  type MergePresetProps,\n  type ComposablePresetMeta,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport {\n  createStateComposable,\n  withStateComposable,\n  type StateComposable,\n  type StateComposableHandle,\n} from './state-composable';\nimport type { ResolveProps } from '@jfdevelops/react-layout-validator';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '../props';\nimport type {\n  IncludedProps,\n  InPropsDefinition,\n  LayoutRenderProps,\n  MergedLayoutInProps,\n  ResolvedIncludedComponentProps,\n  ResolvedIncludedProps,\n} from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport type { LayoutRenderResourcesAccessor } from './define-layout';\n\nexport const deferredRenderStateSymbol: unique symbol = Symbol(\n  'deferredRenderState'\n);\n\nexport const lazyRenderStateSymbol: unique symbol = Symbol(\n  'lazyRenderState'\n);\n\nexport const definedRenderStateSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/render-state'\n);\n\nexport const definedResourceLayoutComponentSymbol: unique symbol = Symbol.for(\n  '@jfdevelops/react-layout/resource-layout-component'\n);\n\n/** Runtime-compatible render-state shape used when inspecting lazy modules. */\nexport type AnyRenderStateDefinition = {\n  composables?: (\n    create: CreateLayoutComposable<any>,\n    states: any\n  ) => ComposableComponents;\n  props?: {\n    include?: Record<string, unknown>;\n    custom?: InPropsObject;\n  };\n  render: (props: any, context: any) => JSX.Element;\n  state?: string;\n};\n\n/** An inline state whose first render is scheduled through `React.lazy`. */\nexport type DeferredRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [deferredRenderStateSymbol]: Definition;\n};\n\n/** A state definition supplied by a separately imported module. */\nexport type LazyRenderState<Definition extends AnyRenderStateDefinition> = {\n  readonly [lazyRenderStateSymbol]: () => Promise<Record<string, unknown>>;\n  readonly definition?: Definition;\n};\n\n/**\n * State names accepted by `createRenderState`. Built-in states are suggested by\n * autocomplete while any other string still creates a custom compound state.\n */\nexport type RenderStateName =\n  | 'default'\n  | 'Loading'\n  | 'Error'\n  | 'NotFound'\n  | (string & {});\n\n/** Callback shorthand for a render state with no local configuration. */\nexport type RenderStateCallback = (props: any, context: any) => JSX.Element;\n\n/**\n * Defines state-local composable components with a `create` helper narrowed to\n * the resources bound to the surrounding builder.\n */\nexport type RenderStateComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n  States = {}\n> = (\n  create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n  states: States\n) => Composables;\n\n/**\n * Defines reusable layout-level composables while preserving their inferred\n * names, props, and bound resource union.\n */\nexport type LayoutComposablesDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents\n> = RenderStateComposablesDefinition<Resources, Composables>;\n\ntype BuilderRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables\n] extends [never]\n  ? undefined\n  : Composables;\n\n/** Values available as the second argument of a created state's `render`. */\nexport type RenderStateContext<\n  Composables extends ComposableComponents,\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>\n> = {\n  resources: LayoutRenderResourcesAccessor<Resources>;\n  composables: BuilderRenderComposables<Composables>;\n  retry?: () => void;\n};\n\n/**\n * Resolves one state's custom props and explicitly included option/composable\n * props to the values received by its render callback.\n */\nexport type RenderStateProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, Composables>\n  >,\n  CustomProps extends InPropsObject\n> = LayoutRenderProps<\n  Resources,\n  Options,\n  Composables,\n  IncludeProps,\n  CustomProps\n>;\n\ntype TypedRenderStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  State extends string,\n  CustomProps extends InPropsObject,\n  SharedComposables extends ComposableComponents,\n  StateComposables extends ComposableComponents,\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables\n    >\n  >,\n  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = {\n  composables?: RenderStateComposablesDefinition<Resources, StateComposables>;\n  props?: {\n    include?: IncludeProps;\n    custom?: CustomProps;\n  };\n  render: (\n    props: RenderStateProps<\n      Resources,\n      Options,\n      SharedComposables & StateComposables,\n      MergeContract<SharedInclude, IncludeProps>,\n      MergeContract<SharedCustom, CustomProps>\n    >,\n    context: RenderStateContext<SharedComposables & StateComposables, Resources>\n  ) => JSX.Element;\n  state: State;\n};\n\n/**\n * Callback shorthand for a created state, typed with the bound resources,\n * options, and shared composables.\n */\nexport type TypedRenderStateCallback<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = (\n  props: RenderStateProps<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >,\n  context: RenderStateContext<SharedComposables, Resources>\n) => JSX.Element;\n\ntype NormalizeRenderStateDefinition<Input> = Input extends LazyRenderState<\n  infer Definition\n>\n  ? Definition\n  : Input extends DeferredRenderState<infer Definition>\n  ? Definition\n  : Input extends RenderStateCallback\n  ? { render: Input; state: 'default' }\n  : Input extends AnyRenderStateDefinition\n  ? Input\n  : never;\n\ntype StateName<Definition> = Definition extends DeferredRenderState<\n  infer DeferredDefinition\n>\n  ? StateName<DeferredDefinition>\n  : Definition extends { state?: infer State extends string }\n  ? State\n  : 'default';\n\n/**\n * A spreadable state entry keyed by its literal state name. Spreading this into\n * `layout.render` is what creates compound members such as `Users.Loading`.\n */\nexport type RenderStateFragment<\n  Definition,\n  CallProps extends object = ResolveProps<StateCustomProps<Definition>>\n> = {\n  [State in StateName<NormalizeRenderStateDefinition<Definition>>]: Definition;\n} & {\n  readonly [definedRenderStateSymbol]: NormalizeRenderStateDefinition<Definition>;\n} & StateComposableHandle<CallProps>;\n\ntype StateCustomProps<Input> = NormalizeStateInput<Input> extends {\n  props?: { custom?: infer Props extends InPropsObject };\n}\n  ? Props\n  : {};\n\ntype StateIncludes<Input> = NormalizeStateInput<Input> extends {\n  props?: { include?: infer Includes };\n}\n  ? Includes\n  : {};\n\ntype NormalizeStateInput<Input> = Input extends DeferredRenderState<\n  infer Definition\n>\n  ? Definition\n  : Input extends LazyRenderState<infer Definition>\n  ? Definition\n  : Input;\n\ntype StateLocalComposables<Input> = NormalizeStateInput<Input> extends {\n  composables?: (\n    ...args: any[]\n  ) => infer Components extends ComposableComponents;\n}\n  ? Components\n  : {};\n\n/**\n * A composables callback cannot infer its own return value into its arguments.\n * Preserve the declared call-site contract for props supplied by local presets,\n * even when their value types are not yet available in the callback context.\n */\ntype UnresolvedStateComponentProps<Props, Includes> = {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends {\n    visibility: 'required';\n    passthrough: 'component';\n  }\n    ? Key\n    : never]: unknown;\n} & {\n  [Key in Exclude<keyof Includes, keyof Props> as Includes[Key] extends\n    | 'optional'\n    | { visibility: 'optional'; passthrough: 'component' }\n    ? Key\n    : never]?: unknown;\n};\n\ntype StateComponentProps<\n  Props extends InPropsObject,\n  Includes\n> = ResolvedIncludedComponentProps<\n  Props,\n  Pick<\n    Includes,\n    Extract<keyof Includes, keyof Props>\n  > extends infer Known extends IncludedProps<Props>\n    ? Known\n    : {}\n> &\n  UnresolvedStateComponentProps<Props, Includes>;\n\n/** Call-site props of a referenced state; creation-time options stay bound. */\nexport type RenderStateCallProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Input\n> = ResolveProps<StateCustomProps<Input>> &\n  StateComponentProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      Composables & StateLocalComposables<Input>\n    >,\n    StateIncludes<Input>\n  >;\n\n/** Typed references to all the states declared in an inline render map. */\nexport type RenderStateReferences<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  States\n> = {\n  readonly [State in keyof States & string]: StateComposable<\n    RenderStateCallProps<Resources, Options, Composables, States[State]>\n  >;\n};\n\ntype BoundRenderStateFragment<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  Definition\n> = RenderStateFragment<\n  Definition,\n  RenderStateCallProps<Resources, Options, Composables, Definition>\n>;\n\ntype DefinedRenderStateFromModule<Module> = Extract<\n  Module[keyof Module],\n  { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n>[typeof definedRenderStateSymbol];\n\n/** Wraps a state definition in the deferred marker when `Deferred` is `true`. */\ntype RenderStateEntry<\n  Definition,\n  Deferred extends boolean\n> = Deferred extends true\n  ? DeferredRenderState<NormalizeRenderStateDefinition<Definition>>\n  : Definition;\n\n/**\n * Overloads shared by `createRenderState` and `createRenderState.defer`. Each\n * accepts a full definition, a definition without `state`, or a render\n * callback; `Deferred` decides whether the returned entry is deferred.\n */\nexport interface RenderStateOverloads<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents,\n  Deferred extends boolean,\n  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> {\n  <\n    const State extends RenderStateName,\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {}\n  >(\n    definition: TypedRenderStateDefinition<\n      Resources,\n      Options,\n      State,\n      CustomProps,\n      SharedComposables,\n      StateComposables,\n      IncludeProps,\n      SharedInclude,\n      SharedCustom\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        State,\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n        SharedInclude,\n        SharedCustom\n      >,\n      Deferred\n    >\n  >;\n  <\n    const CustomProps extends InPropsObject = {},\n    const StateComposables extends ComposableComponents = {},\n    const IncludeProps extends IncludedProps<\n      MergedLayoutInProps<\n        Resources,\n        Options,\n        SharedComposables & StateComposables\n      >\n    > = {}\n  >(\n    definition: Omit<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n        SharedInclude,\n        SharedCustom\n      >,\n      'state'\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateDefinition<\n        Resources,\n        Options,\n        'default',\n        CustomProps,\n        SharedComposables,\n        StateComposables,\n        IncludeProps,\n        SharedInclude,\n        SharedCustom\n      >,\n      Deferred\n    >\n  >;\n  (\n    render: TypedRenderStateCallback<\n      Resources,\n      Options,\n      SharedComposables,\n      SharedInclude,\n      SharedCustom\n    >\n  ): BoundRenderStateFragment<\n    Resources,\n    Options,\n    SharedComposables,\n    RenderStateEntry<\n      TypedRenderStateCallback<\n        Resources,\n        Options,\n        SharedComposables,\n        SharedInclude,\n        SharedCustom\n      >,\n      Deferred\n    >\n  >;\n}\n\ntype RenderStateReference = (\n  | { readonly [definedRenderStateSymbol]: AnyRenderStateDefinition }\n  | LazyRenderState<AnyRenderStateDefinition>\n) &\n  StateComposableHandle<any>;\n\ntype ReferenceDefinition<Ref extends RenderStateReference> =\n  Ref extends LazyRenderState<infer Definition>\n    ? Definition\n    : Ref extends {\n        readonly [definedRenderStateSymbol]: infer Definition extends AnyRenderStateDefinition;\n      }\n    ? Definition\n    : never;\n\ntype FromStateEntry<\n  Ref extends RenderStateReference,\n  Definition extends AnyRenderStateDefinition\n> = Ref extends LazyRenderState<AnyRenderStateDefinition>\n  ? LazyRenderState<Definition>\n  : Extract<\n      Ref[Exclude<keyof Ref, 'asComposable' | typeof definedRenderStateSymbol>],\n      LazyRenderState<AnyRenderStateDefinition>\n    > extends never\n  ? Definition\n  : LazyRenderState<Definition>;\n\ntype ReferenceSchemas<Ref extends RenderStateReference> = StateCustomProps<\n  ReferenceDefinition<Ref>\n> &\n  MergePresetProps<StateLocalComposables<ReferenceDefinition<Ref>>>;\n\ntype DefaultReferenceIncludes<\n  Ref extends RenderStateReference,\n  CustomProps\n> = Omit<\n  StateIncludes<ReferenceDefinition<Ref>>,\n  keyof CustomProps | keyof StateCustomProps<ReferenceDefinition<Ref>>\n> & {\n  [Key in Exclude<\n    keyof StateCustomProps<ReferenceDefinition<Ref>>,\n    keyof CustomProps\n  >]: {\n    visibility: StateCustomProps<ReferenceDefinition<Ref>>[Key] extends {\n      visibility: infer Visibility;\n    }\n      ? Visibility\n      : 'required';\n    passthrough: 'component';\n  };\n};\n\ntype ReferenceIncludes<\n  Ref extends RenderStateReference,\n  CustomProps,\n  Include\n> = Include extends object\n  ? Include\n  : DefaultReferenceIncludes<Ref, CustomProps>;\n\ntype FromStateInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Local extends ComposableComponents\n> = MergedLayoutInProps<\n  Resources,\n  Options,\n  Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local\n> &\n  StateCustomProps<\n    ReferenceDefinition<Ref>\n  > extends infer Props extends InPropsObject\n  ? Props\n  : {};\n\ntype SelectedReferenceSchemas<Ref extends RenderStateReference, Include> = Pick<\n  ReferenceSchemas<Ref>,\n  Extract<keyof Include, keyof ReferenceSchemas<Ref>>\n> extends infer Selected extends InPropsObject\n  ? Selected\n  : {};\n\ntype ReferenceCarriedProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Include\n> = Pick<\n  FromStateInProps<Resources, Options, Shared, Ref, {}>,\n  Extract<\n    keyof Include,\n    keyof FromStateInProps<Resources, Options, Shared, Ref, {}>\n  >\n> extends infer Selected extends InPropsObject\n  ? ResolveProps<Selected>\n  : {};\n\ntype ReferenceRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference\n> = RenderStateProps<\n  Resources,\n  Options,\n  Shared & StateLocalComposables<ReferenceDefinition<Ref>>,\n  StateIncludes<\n    ReferenceDefinition<Ref>\n  > extends infer Include extends IncludedProps<\n    MergedLayoutInProps<\n      Resources,\n      Options,\n      Shared & StateLocalComposables<ReferenceDefinition<Ref>>\n    >\n  >\n    ? Include\n    : {},\n  StateCustomProps<ReferenceDefinition<Ref>>\n>;\n\ntype FromStateComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  Local extends ComposableComponents,\n  Include\n> = Local & {\n  Ref: StateComposable<\n    ReferenceRenderProps<Resources, Options, Shared, Ref>,\n    Extract<\n      keyof ReferenceCarriedProps<Resources, Options, Shared, Ref, Include>,\n      keyof ReferenceRenderProps<Resources, Options, Shared, Ref>\n    >\n  > & {\n    [composablePresetMetaKey]: ComposablePresetMeta<\n      SelectedReferenceSchemas<Ref, Include>\n    >;\n  };\n};\n\ntype FromStateDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents,\n  Ref extends RenderStateReference,\n  State extends string,\n  CustomProps extends InPropsObject,\n  Local extends ComposableComponents,\n  Include\n> = {\n  state: State;\n  props?: {\n    custom?: CustomProps;\n    include?: ReferenceIncludes<Ref, CustomProps, Include>;\n  };\n  composables: RenderStateComposablesDefinition<\n    Resources,\n    FromStateComposables<\n      Resources,\n      Options,\n      Shared,\n      Ref,\n      Local,\n      ReferenceIncludes<Ref, CustomProps, Include>\n    >\n  >;\n  render: (\n    props: ResolveProps<CustomProps> &\n      ResolvedIncludedProps<\n        FromStateInProps<Resources, Options, Shared, Ref, Local>,\n        ReferenceIncludes<\n          Ref,\n          CustomProps,\n          Include\n        > extends infer Selected extends IncludedProps<\n          FromStateInProps<Resources, Options, Shared, Ref, Local>\n        >\n          ? Selected\n          : {}\n      >,\n    context: RenderStateContext<\n      Shared &\n        FromStateComposables<\n          Resources,\n          Options,\n          Shared,\n          Ref,\n          Local,\n          ReferenceIncludes<Ref, CustomProps, Include>\n        >,\n      Resources\n    >\n  ) => JSX.Element;\n};\n\n/** Creates a state with inherited props and a composable reference to its source. */\nexport type CreateRenderStateFromState<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Shared extends ComposableComponents\n> = <\n  const Ref extends RenderStateReference,\n  const State extends RenderStateName = 'default',\n  const CustomProps extends InPropsObject = {},\n  const Local extends ComposableComponents = {},\n  const Include extends\n    | IncludedProps<FromStateInProps<Resources, Options, Shared, Ref, Local>>\n    | undefined = undefined\n>(definition: {\n  ref: Ref;\n  /** Defer Ref rendering through React.lazy. Defaults to false. */\n  lazy?: boolean;\n  state?: State;\n  props?: {\n    custom?: CustomProps;\n    include?: Include &\n      Record<\n        Exclude<\n          keyof Include,\n          keyof FromStateInProps<Resources, Options, Shared, Ref, Local>\n        >,\n        never\n      >;\n  };\n  composables?: (\n    create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n    states: {}\n  ) => Local & { Ref?: never };\n  render: FromStateDefinition<\n    Resources,\n    Options,\n    Shared,\n    Ref,\n    State,\n    CustomProps,\n    Local,\n    Include\n  >['render'];\n}) => BoundRenderStateFragment<\n  Resources,\n  Options,\n  Shared,\n  FromStateEntry<\n    Ref,\n    FromStateDefinition<\n      Resources,\n      Options,\n      Shared,\n      Ref,\n      State,\n      CustomProps,\n      Local,\n      Include\n    >\n  >\n>;\n\n/**\n * Creates independently typed render-state fragments.\n *\n * - Calling it directly creates an eager state.\n * - `.defer(...)` schedules an inline definition through `React.lazy`, but\n *   does not create a separate JavaScript chunk.\n * - `.lazy(() => import(...))` imports a complete named state definition as a\n *   separate chunk.\n * - `.fromState({ ref, ... })` inherits a state's props and exposes it as `Ref`.\n */\nexport interface CreateRenderState<\n  Resources extends ReadonlyArray<ResourceDefinition> = ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources> = {},\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> extends RenderStateOverloads<\n    Resources,\n    Options,\n    SharedComposables,\n    false,\n    SharedInclude,\n    SharedCustom\n  > {\n  fromState: CreateRenderStateFromState<Resources, Options, SharedComposables>;\n  defer: RenderStateOverloads<\n    Resources,\n    Options,\n    SharedComposables,\n    true,\n    SharedInclude,\n    SharedCustom\n  >;\n  lazy<Module extends Record<string, unknown>>(\n    load: () => Promise<Module>\n  ): LazyRenderState<DefinedRenderStateFromModule<Module>> &\n    StateComposableHandle<\n      RenderStateCallProps<\n        Resources,\n        Options,\n        SharedComposables,\n        DefinedRenderStateFromModule<Module>\n      >\n    >;\n}\n\nfunction normalizeDefinition(\n  input: AnyRenderStateDefinition | RenderStateCallback\n): AnyRenderStateDefinition {\n  return typeof input === 'function'\n    ? { render: input, state: 'default' }\n    : input;\n}\n\nfunction toFragment<Definition extends AnyRenderStateDefinition>(\n  definition: Definition\n) {\n  const fragment = {\n    [definition.state ?? 'default']: definition,\n  } as RenderStateFragment<Definition>;\n\n  Object.defineProperty(fragment, definedRenderStateSymbol, {\n    enumerable: false,\n    value: definition,\n  });\n\n  return withStateComposable(fragment, {\n    input: definition,\n    name: definition.state ?? 'default',\n  });\n}\n\n/** Inputs used internally to bind resource and option types to a state builder. */\nexport type CreateRenderStateBuilderArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = {\n  props?: { include?: SharedInclude; custom?: SharedCustom };\n  /** Shared composables whose components and preset props every state can use. */\n  composables?: LayoutComposablesDefinition<Resources, SharedComposables>;\n  /** Option props that individual states can expose through `props.include`. */\n  options: Options;\n  /** Resources used to constrain composable names and resource-specific props. */\n  resources: Resources;\n};\n\n/** The state factory produced for a particular resource and option definition. */\nexport type CreateRenderStateBuilderResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n> = CreateRenderState<\n  Resources,\n  Options,\n  SharedComposables,\n  SharedInclude,\n  SharedCustom\n>;\n\n/**\n * Creates a state factory whose `props.include` keys are constrained by the\n * supplied resources and options.\n */\nexport function createRenderStateBuilder<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  SharedComposables extends ComposableComponents = {},\n  SharedInclude extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, SharedComposables>\n  > = {},\n  SharedCustom extends InPropsObject = {}\n>(\n  _arguments: CreateRenderStateBuilderArguments<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >\n): CreateRenderStateBuilderResult<\n  Resources,\n  Options,\n  SharedComposables,\n  SharedInclude,\n  SharedCustom\n> {\n  function createRenderState(\n    input: AnyRenderStateDefinition | RenderStateCallback\n  ) {\n    const definition = normalizeDefinition(input);\n    const debug = getLayoutDebug(input);\n\n    return toFragment(\n      debug ? { ...definition, [layoutDebug]: debug } : definition\n    );\n  }\n\n  createRenderState.fromState = (input: {\n    ref: RenderStateReference;\n    lazy?: boolean;\n    state?: string;\n    props?: AnyRenderStateDefinition['props'];\n    composables?: AnyRenderStateDefinition['composables'];\n    render: AnyRenderStateDefinition['render'];\n  }): object => {\n    const entry = isLazyRenderState(input.ref)\n      ? input.ref\n      : Object.values(input.ref)[0];\n\n    if (isLazyRenderState(entry)) {\n      const lazyState = {\n        [lazyRenderStateSymbol]: async () => {\n          const source = await findDefinedRenderState(\n            await entry[lazyRenderStateSymbol]()\n          );\n\n          return {\n            Derived: createRenderState.fromState({\n              ...input,\n              ref: toFragment(source),\n            }),\n          };\n        },\n      };\n      const name = input.state ?? 'default';\n      const fragment = { [name]: lazyState };\n\n      Object.defineProperty(fragment, definedRenderStateSymbol, {\n        value: lazyState,\n      });\n\n      return withStateComposable(fragment, { input: lazyState, name });\n    }\n\n    const source = isDeferredRenderState(entry)\n      ? entry[deferredRenderStateSymbol]\n      : definedRenderStateSymbol in input.ref\n      ? input.ref[definedRenderStateSymbol]\n      : undefined;\n\n    if (!source || typeof source.render !== 'function') {\n      throw new LayoutConfigurationError(\n        'fromState requires a created render state'\n      );\n    }\n\n    const custom = input.props?.custom ?? {};\n    const includes =\n      input.props?.include ??\n      Object.fromEntries(\n        Object.entries({\n          ...source.props?.include,\n          ...Object.fromEntries(\n            Object.entries(source.props?.custom ?? {}).map(([key, prop]) => [\n              key,\n              { visibility: prop.visibility, passthrough: 'component' },\n            ])\n          ),\n        }).filter(([key]) => !(key in custom))\n      );\n\n    return toFragment({\n      [layoutDebug]: getLayoutDebug(input),\n      state: input.state ?? 'default',\n      props: { custom, include: includes },\n      composables: (create, states) => {\n        const inherited = source.composables?.(create, states) ?? {};\n        const local = input.composables?.(create, states) ?? {};\n\n        if (Object.prototype.hasOwnProperty.call(local, 'Ref')) {\n          throw new LayoutConfigurationError(\n            'Composable name \"Ref\" is reserved by fromState'\n          );\n        }\n\n        const schemas = Object.assign(\n          {},\n          ...collectComposablePresetEntries(inherited).map(\n            ({ props }) => props\n          ),\n          source.props?.custom\n        ) as InPropsObject;\n        const selected = Object.fromEntries(\n          Object.entries(schemas).filter(([key]) => key in includes)\n        );\n        const referenceSource = {\n          ...source,\n          props: {\n            ...source.props,\n            include: Object.fromEntries(\n              Object.entries(source.props?.include ?? {}).map(\n                ([key, behavior]) => [\n                  key,\n                  {\n                    visibility:\n                      behavior === 'optional' ||\n                      (typeof behavior === 'object' &&\n                        behavior !== null &&\n                        'visibility' in behavior &&\n                        behavior.visibility === 'optional')\n                        ? 'optional'\n                        : 'required',\n                    passthrough: 'component',\n                  },\n                ]\n              )\n            ),\n          },\n        };\n        const Ref = createStateComposable(\n          {\n            input:\n              input.lazy || isDeferredRenderState(entry)\n                ? { [deferredRenderStateSymbol]: referenceSource }\n                : referenceSource,\n            name: source.state ?? 'default',\n            fallbackStateName: input.state,\n          },\n          {\n            props: {\n              include: Object.fromEntries(\n                Object.keys(includes).map((key) => [key, true as const])\n              ),\n            },\n            normalizeIncludedKeys: true,\n          }\n        );\n\n        Object.defineProperty(Ref, composablePresetMetaKey, {\n          value: { key: 'Ref', props: selected },\n        });\n\n        return { ...local, Ref };\n      },\n      render: input.render,\n    });\n  };\n\n  createRenderState.defer = (\n    input: AnyRenderStateDefinition | RenderStateCallback\n  ) => {\n    const definition = normalizeDefinition(input);\n\n    const deferred = {\n      [deferredRenderStateSymbol]: {\n        ...definition,\n        [layoutDebug]: getLayoutDebug(input),\n      },\n      [layoutDebug]: getLayoutDebug(input),\n    };\n    const fragment = { [definition.state ?? 'default']: deferred };\n\n    Object.defineProperty(fragment, definedRenderStateSymbol, {\n      value: definition,\n    });\n\n    return withStateComposable(fragment, {\n      input: deferred,\n      name: definition.state ?? 'default',\n    });\n  };\n\n  createRenderState.lazy = (load: () => Promise<Record<string, unknown>>) => {\n    const lazyState = {\n      [lazyRenderStateSymbol]: load,\n      [layoutDebug]: getLayoutDebug(load),\n    };\n\n    return withStateComposable(lazyState, { input: lazyState, name: 'lazy' });\n  };\n\n  return createRenderState as unknown as CreateRenderStateBuilderResult<\n    Resources,\n    Options,\n    SharedComposables,\n    SharedInclude,\n    SharedCustom\n  >;\n}\n\n/** Type guard for states created with `createRenderState.defer(...)`. */\nexport function isDeferredRenderState(\n  value: unknown\n): value is DeferredRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    deferredRenderStateSymbol in value\n  );\n}\n\n/** Type guard for states created with `createRenderState.lazy(...)`. */\nexport function isLazyRenderState(\n  value: unknown\n): value is LazyRenderState<AnyRenderStateDefinition> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    lazyRenderStateSymbol in value\n  );\n}\n\n/**\n * Resolves the single state exported by a lazy module, including derived lazy\n * states. Throws when a module exports none or more than one.\n */\nexport async function findDefinedRenderState(\n  module: Record<string, unknown>\n): Promise<AnyRenderStateDefinition> {\n  const definitions = Object.values(module).filter(\n    (value) =>\n      typeof value === 'object' &&\n      value !== null &&\n      definedRenderStateSymbol in value\n  ) as Array<Record<typeof definedRenderStateSymbol, AnyRenderStateDefinition>>;\n\n  if (definitions.length !== 1) {\n    throw new Error(\n      `A lazy render-state module must export exactly one defined render state; received ${definitions.length}.`\n    );\n  }\n\n  const definition = definitions[0][definedRenderStateSymbol];\n\n  return isLazyRenderState(definition)\n    ? findDefinedRenderState(await definition[lazyRenderStateSymbol]())\n    : definition;\n}\n\n/** Identity helper that contextually types a reusable composables callback. */\nexport type DefineLayoutComposables<\n  Resources extends ReadonlyArray<ResourceDefinition>\n> = <const Composables extends ComposableComponents>(\n  definition: LayoutComposablesDefinition<Resources, Composables>\n) => LayoutComposablesDefinition<Resources, Composables>;\n\n/** Public cross-file building blocks returned by a defined layout builder. */\nexport type CreateLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>\n> = {\n  composables: DefineLayoutComposables<Resources>;\n  createRenderState: CreateRenderState<Resources, Options>;\n};\n\n/** Resource and option bindings used to create layout building blocks. */\nexport type CreateLayoutBuildingBlocksArguments<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>\n> = CreateRenderStateBuilderArguments<Resources, Options>;\n\n/** Layout helpers produced for the supplied resource and option bindings. */\nexport type CreateLayoutBuildingBlocksResult<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>\n> = CreateLayoutBuildingBlocks<Resources, Options>;\n\n/**\n * Creates the reusable `composables` and `createRenderState` helpers without\n * introducing an identity wrapper around the layout object itself.\n */\nexport function createLayoutBuildingBlocks<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>\n>(\n  arguments_: CreateLayoutBuildingBlocksArguments<Resources, Options>\n): CreateLayoutBuildingBlocksResult<Resources, Options> {\n  function composables<const Composables extends ComposableComponents>(\n    definition: LayoutComposablesDefinition<Resources, Composables>\n  ): LayoutComposablesDefinition<Resources, Composables> {\n    return definition;\n  }\n\n  return {\n    composables,\n    createRenderState: createRenderStateBuilder(arguments_),\n  };\n}\n\n/** Preserves a bound resource tuple for consumers that need to re-export it. */\nexport type BoundResources<\n  Resources extends ReadonlyArray<ResourceDefinition>\n> = Resources;\n"],"mappings":"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"}

package/dist/create-config/render-state.d.cts

@@ -149,7 +149,7 @@ type DefaultReferenceIncludes<Ref extends RenderStateReference, CustomProps> = O
   passthrough: 'component';
 } };
 type ReferenceIncludes<Ref extends RenderStateReference, CustomProps, Include> = Include extends object ? Include : DefaultReferenceIncludes<Ref, CustomProps>;
-type FromStateInProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference, Local extends ComposableComponents> = (MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local> & StateCustomProps<ReferenceDefinition<Ref>>) extends infer Props extends InPropsObject ? Props : {};
+type FromStateInProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference, Local extends ComposableComponents> = MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>> & Local> & StateCustomProps<ReferenceDefinition<Ref>> extends infer Props extends InPropsObject ? Props : {};
 type SelectedReferenceSchemas<Ref extends RenderStateReference, Include> = Pick<ReferenceSchemas<Ref>, Extract<keyof Include, keyof ReferenceSchemas<Ref>>> extends infer Selected extends InPropsObject ? Selected : {};
 type ReferenceCarriedProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference, Include> = Pick<FromStateInProps<Resources, Options, Shared, Ref, {}>, Extract<keyof Include, keyof FromStateInProps<Resources, Options, Shared, Ref, {}>>> extends infer Selected extends InPropsObject ? ResolveProps<Selected> : {};
 type ReferenceRenderProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Shared extends ComposableComponents, Ref extends RenderStateReference> = RenderStateProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>, StateIncludes<ReferenceDefinition<Ref>> extends infer Include extends IncludedProps<MergedLayoutInProps<Resources, Options, Shared & StateLocalComposables<ReferenceDefinition<Ref>>>> ? Include : {}, StateCustomProps<ReferenceDefinition<Ref>>>;