@jfdevelops/react-layout 1.4.1 → 1.5.1

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

@@ -6,34 +6,6 @@ const require_lazy_resource_layout = require('./lazy-resource-layout.cjs');
 let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
 
 //#region src/create-config/create-defined-resource-layout.ts
-/**
-* Creates type-linked layout helpers from one shared configuration. The returned
-* `defineResourceLayout` accepts the layout directly, while `createRenderState`
-* carries the same resource and option types across file boundaries.
-*
-* @param configuration - Resources and optional shared props/composables to
-* bind to every returned helper.
-* @returns Helpers that share the configuration's inferred literal types.
-*
-* @example
-* ```tsx
-* const { createRenderState, defineResourceLayout } =
-*   createDefinedResourceLayout({
-*     resources: ['users'],
-*     options: { title: createProp.string() },
-*   });
-*
-* const Loading = createRenderState({
-*   state: 'Loading',
-*   props: { include: { title: true } },
-*   render: ({ title }) => <p>Loading {title}</p>,
-* });
-*
-* export const usersLayout = defineResourceLayout({
-*   render: { default: () => <Users />, ...Loading },
-* });
-* ```
-*/
 function createDefinedResourceLayout(configuration) {
 	const { resources, options = {}, composables } = configuration;
 	const defineBoundLayout = require_define_layout.defineResourceLayout.forResources(...resources);

package/dist/create-config/create-defined-resource-layout.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-defined-resource-layout.cjs","names":["defineResourceLayout","LayoutConfigurationError","layoutDebug","mergeLayoutProps","createLazyResourceLayout","layoutInspection","createRenderStateBuilder","createLayoutResourcesAccessor"],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import {\n  getLayoutDebug,\n  layoutDebug,\n  createInspectionStore,\n  inspectionId,\n  layoutInspection,\n  getInspectionSource,\n} from '@jfdevelops/react-layout-devtools-core';\nimport { mergeLayoutProps } from './merge-layout-props';\nimport type { LayoutNameInput } from './layout-name';\nimport type { MergeContract } from './define-layout';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport type { InPropsDefinition, InPropsObject } from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport {\n  type CreateViewMapFunctionRenderOptions,\n  type DefinedResourceLayout,\n  defineResourceLayout,\n  type LayoutIncludeProps,\n  type LayoutResourcesAccessor,\n  type CreateViewMapRenderStatesOptions,\n  type DefinedResourceLayoutFromStates,\n  createLayoutResourcesAccessor,\n} from './define-layout';\nimport {\n  createLazyResourceLayout,\n  type LazyResourceLayoutOptions,\n  type LazyResourceStates,\n} from './lazy-resource-layout';\nimport {\n  createRenderStateBuilder,\n  type CreateRenderState,\n  type RenderStateReferences,\n  type LayoutComposablesDefinition,\n} from './render-state';\n\n/** A resource tuple with at least one entry, preserving literal and nested paths. */\nexport type NonEmptyResources = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[]\n];\n\n/** Configuration shared by every layout created from one defined-layout factory. */\nexport type CreateDefinedResourceLayoutOptions<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  namespace?: DefaultNamespace;\n  /** Default naming convention; explicit definition and component names override it. */\n  name?: DefaultNaming;\n  /** Shared prop contracts, merged by key with layout and state contracts. */\n  props?: {\n    include?: LayoutIncludeProps<Resources, Options, Composables> & SharedInclude;\n    custom?: SharedCustom;\n  };\n  /** Resources supported by every layout created from this factory. */\n  resources: Resources;\n  /** Props that render states can opt into through `props.include`. */\n  options?: Options;\n  /** Layout-wide composables available to every render state. */\n  composables?: LayoutComposablesDefinition<Resources, Composables>;\n};\n\n/** The flat layout definition accepted after shared configuration is bound. */\nexport type DefinedResourceLayoutInput<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n  Render,\n  Namespace extends boolean = false\n> = Omit<\n  CreateViewMapFunctionRenderOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >['layout'],\n  'composables' | 'render'\n> & { render: Render; namespace?: Namespace };\n\ntype BoundLayoutComposables<\n  Shared extends ComposableComponents,\n  Local extends ComposableComponents\n> = Omit<Shared, keyof Local> & Local;\n\n/** Flattens a definition's layout while preserving its namespace setting. */\ntype BoundLayoutInput<\n  Definition extends { layout: unknown; namespace?: boolean }\n> = Definition['layout'] &\n  Pick<Definition, 'namespace'> &\n  (Definition extends { name?: infer Name } ? { name?: Name } : {});\n\n/** A `defineResourceLayout` function with its shared configuration pre-bound. */\nexport type BoundDefineResourceLayout<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /**\n   * Defines a layout whose `render` map contains the required `default` state\n   * and any built-in or custom compound component states.\n   * Keep this overload first so incomplete render objects suggest state keys.\n   * Use `createRenderState` for state-local `composables(create)` callbacks;\n   * the helper infers their render context independently of the enclosing map.\n   */\n  <\n    const Render extends { default: unknown } & Record<string, unknown>,\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    const Naming extends\n      | LayoutNameInput<\n          LayoutResourceKey<Resources>,\n          ('default' | keyof Render) & string\n        >\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapRenderStatesOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Render,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: RenderStateReferences<Resources, Options, Composables, Render>\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayoutFromStates<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    Render,\n    Namespace,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    Naming\n  >;\n  /** Defines a layout whose `render` value is a single default-state callback. */\n  <\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const Naming extends\n      | LayoutNameInput<LayoutResourceKey<Resources>, 'default'>\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapFunctionRenderOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: {}\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayout<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    {},\n    Namespace,\n    Naming\n  >;\n  /**\n   * Creates a lazy proxy for the single library-defined component exported by\n   * a resource module.\n   *\n   * @param options - Resource path and named-module import callback.\n   */\n  lazy<Module extends Record<string, unknown>>(\n    options: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;\n};\n\n/** Registers loading and module-error components used by lazy layouts. */\nexport type DefineLazyDefaults = {\n  /**\n   * Sets defaults once, before the factory creates its first lazy layout.\n   *\n   * @param defaults - Shared components for pending module loads and failures.\n   */\n  (defaults: LazyResourceStates): void;\n};\n\n/** Reusable helpers produced by {@link createDefinedResourceLayout}. */\nexport type CreateDefinedResourceLayoutResult<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /** Creates eager, deferred, or separately imported render-state fragments. */\n  createRenderState: CreateRenderState<\n    Resources,\n    Options,\n    Composables,\n    SharedInclude,\n    SharedCustom\n  >;\n  /** Sets the shared loading and module-error UI used by lazy layouts. */\n  defineLazyDefaults: DefineLazyDefaults;\n  /** Defines a layout using the resources, options, and composables already bound. */\n  defineResourceLayout: BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n  /** Reads, selects, or validates the resources bound to this factory. */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\n/**\n * Creates type-linked layout helpers from one shared configuration. The returned\n * `defineResourceLayout` accepts the layout directly, while `createRenderState`\n * carries the same resource and option types across file boundaries.\n *\n * @param configuration - Resources and optional shared props/composables to\n * bind to every returned helper.\n * @returns Helpers that share the configuration's inferred literal types.\n *\n * @example\n * ```tsx\n * const { createRenderState, defineResourceLayout } =\n *   createDefinedResourceLayout({\n *     resources: ['users'],\n *     options: { title: createProp.string() },\n *   });\n *\n * const Loading = createRenderState({\n *   state: 'Loading',\n *   props: { include: { title: true } },\n *   render: ({ title }) => <p>Loading {title}</p>,\n * });\n *\n * export const usersLayout = defineResourceLayout({\n *   render: { default: () => <Users />, ...Loading },\n * });\n * ```\n */\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefaultNaming\n> {\n  const { resources, options = {} as Options, composables } = configuration;\n  const defineBoundLayout = defineResourceLayout.forResources(...resources);\n  const inspection = createInspectionStore();\n  let lazyDefaults: LazyResourceStates = {};\n  let lazyDefaultsDefined = false;\n  let lazyLayoutCreated = false;\n\n  function defineLazyDefaults(defaults: LazyResourceStates): void {\n    if (lazyDefaultsDefined) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults can only be defined once.'\n      );\n    }\n\n    if (lazyLayoutCreated) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults must be defined before creating a lazy resource layout.'\n      );\n    }\n\n    lazyDefaults = defaults;\n\n    lazyDefaultsDefined = true;\n  }\n\n  const boundDefineResourceLayout = ((layout: Record<string, unknown>) => {\n    const localComposables = layout.composables as\n      | LayoutComposablesDefinition<Resources, ComposableComponents>\n      | undefined;\n    const definition = defineBoundLayout({\n      [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),\n      options,\n      name: layout.name ?? configuration.name,\n      namespace: layout.namespace ?? configuration.namespace,\n      layout: {\n        ...layout,\n        props: mergeLayoutProps(\n          configuration.props,\n          layout.props as { include?: object; custom?: object }\n        ),\n        composables:\n          composables || localComposables\n            ? (\n                create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n                states: {}\n              ) => ({\n                ...composables?.(create, states),\n                ...localComposables?.(create, states),\n              })\n            : undefined,\n      },\n    } as never);\n\n    inspection.connect(definition);\n\n    return definition;\n  }) as unknown as BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n\n  boundDefineResourceLayout.lazy = <Module extends Record<string, unknown>>(\n    lazyOptions: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>> => {\n    lazyLayoutCreated = true;\n\n    const id = inspectionId('lazy');\n    const label = (lazyOptions as unknown as { resource: string }).resource;\n\n    inspection.node({ id, kind: 'lazy', label, unresolved: true });\n\n    return createLazyResourceLayout(\n      {\n        ...lazyOptions,\n        load: async () => {\n          const module: Record<string, unknown> = await lazyOptions.load();\n\n          for (const entry of Object.values(module)) {\n            const component =\n              entry && typeof entry === 'object' && 'Root' in entry\n                ? entry.Root\n                : entry;\n\n            if (\n              ((typeof component === 'object' && component !== null) ||\n                typeof component === 'function') &&\n              layoutInspection in component\n            ) {\n              inspection.connect(component);\n\n              const target = getInspectionSource(component)\n                .getSnapshot()\n                .nodes.find(\n                  (n) =>\n                    n.kind === 'layout' &&\n                    n.label ===\n                      (component as { displayName?: string }).displayName\n                );\n\n              if (target) inspection.edge(id, target.id, 'references');\n            }\n          }\n\n          inspection.node({ id, kind: 'lazy', label, unresolved: false });\n\n          return module as Module;\n        },\n      },\n      lazyDefaults\n    );\n  };\n\n  return inspection.attach({\n    createRenderState: createRenderStateBuilder({\n      props: configuration.props,\n      composables,\n      options,\n      resources,\n    }),\n    defineLazyDefaults,\n    defineResourceLayout: boundDefineResourceLayout,\n    resources: createLayoutResourcesAccessor(resources),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwUA,SAAgB,4BAed,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoBA,2CAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,+EAAmC;CACzC,IAAI,eAAmC,CAAC;CACxC,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBAAmB,UAAoC;EAC9D,IAAI,qBACF,MAAM,IAAIC,4DACR,kDACF;EAGF,IAAI,mBACF,MAAM,IAAIA,4DACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClCC,gHAA6B,MAAM,gEAAoB,aAAa;GACrE;GACA,MAAM,OAAO,QAAQ,cAAc;GACnC,WAAW,OAAO,aAAa,cAAc;GAC7C,QAAQ;IACN,GAAG;IACH,OAAOC,4CACL,cAAc,OACd,OAAO,KACT;IACA,aACE,eAAe,oBAET,QACA,YACI;KACJ,GAAG,cAAc,QAAQ,MAAM;KAC/B,GAAG,mBAAmB,QAAQ,MAAM;IACtC,KACA;GACR;EACF,CAAU;EAEV,WAAW,QAAQ,UAAU;EAE7B,OAAO;CACT;CAUA,0BAA0B,QACxB,gBACmE;EACnE,oBAAoB;EAEpB,MAAM,8DAAkB,MAAM;EAC9B,MAAM,QAAS,YAAgD;EAE/D,WAAW,KAAK;GAAE;GAAI,MAAM;GAAQ;GAAO,YAAY;EAAK,CAAC;EAE7D,OAAOC,sDACL;GACE,GAAG;GACH,MAAM,YAAY;IAChB,MAAM,SAAkC,MAAM,YAAY,KAAK;IAE/D,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;KACzC,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,MAAM,OACN;KAEN,KACI,OAAO,cAAc,YAAY,cAAc,QAC/C,OAAO,cAAc,eACvBC,2DAAoB,WACpB;MACA,WAAW,QAAQ,SAAS;MAE5B,MAAM,yEAA6B,SAAS,EACzC,YAAY,EACZ,MAAM,MACJ,MACC,EAAE,SAAS,YACX,EAAE,UACC,UAAuC,WAC9C;MAEF,IAAI,QAAQ,WAAW,KAAK,IAAI,OAAO,IAAI,YAAY;KACzD;IACF;IAEA,WAAW,KAAK;KAAE;KAAI,MAAM;KAAQ;KAAO,YAAY;IAAM,CAAC;IAE9D,OAAO;GACT;EACF,GACA,YACF;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmBC,8CAAyB;GAC1C,OAAO,cAAc;GACrB;GACA;GACA;EACF,CAAC;EACD;EACA,sBAAsB;EACtB,WAAWC,oDAA8B,SAAS;CACpD,CAAC;AACH"}
+{"version":3,"file":"create-defined-resource-layout.cjs","names":["defineResourceLayout","LayoutConfigurationError","layoutDebug","mergeLayoutProps","createLazyResourceLayout","layoutInspection","createRenderStateBuilder","createLayoutResourcesAccessor"],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import {\n  getLayoutDebug,\n  layoutDebug,\n  createInspectionStore,\n  inspectionId,\n  layoutInspection,\n  getInspectionSource,\n} from '@jfdevelops/react-layout-devtools-core';\nimport { mergeLayoutProps } from './merge-layout-props';\nimport type { LayoutNameContext, LayoutNameInput } from './layout-name';\nimport type { MergeContract } from './define-layout';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport type { InPropsDefinition, InPropsObject } from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport {\n  type CreateViewMapFunctionRenderOptions,\n  type DefinedResourceLayout,\n  defineResourceLayout,\n  type LayoutIncludeProps,\n  type LayoutResourcesAccessor,\n  type CreateViewMapRenderStatesOptions,\n  type DefinedResourceLayoutFromStates,\n  createLayoutResourcesAccessor,\n} from './define-layout';\nimport {\n  createLazyResourceLayout,\n  type LazyResourceLayoutOptions,\n  type LazyResourceStates,\n} from './lazy-resource-layout';\nimport {\n  createRenderStateBuilder,\n  type CreateRenderState,\n  type RenderStateReferences,\n  type LayoutComposablesDefinition,\n} from './render-state';\n\n/** A resource tuple with at least one entry, preserving literal and nested paths. */\nexport type NonEmptyResources = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[]\n];\n\n/** Configuration shared by every layout created from one defined-layout factory. */\nexport type CreateDefinedResourceLayoutOptions<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  namespace?: DefaultNamespace;\n  /** Default naming convention; explicit definition and component names override it. */\n  name?: DefaultNaming;\n  /** Shared prop contracts, merged by key with layout and state contracts. */\n  props?: {\n    include?: LayoutIncludeProps<Resources, Options, Composables> & SharedInclude;\n    custom?: SharedCustom;\n  };\n  /** Resources supported by every layout created from this factory. */\n  resources: Resources;\n  /** Props that render states can opt into through `props.include`. */\n  options?: Options;\n  /** Layout-wide composables available to every render state. */\n  composables?: LayoutComposablesDefinition<Resources, Composables>;\n};\n\n/** The flat layout definition accepted after shared configuration is bound. */\nexport type DefinedResourceLayoutInput<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n  Render,\n  Namespace extends boolean = false\n> = Omit<\n  CreateViewMapFunctionRenderOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >['layout'],\n  'composables' | 'render'\n> & { render: Render; namespace?: Namespace };\n\ntype BoundLayoutComposables<\n  Shared extends ComposableComponents,\n  Local extends ComposableComponents\n> = Omit<Shared, keyof Local> & Local;\n\n/** Flattens a definition's layout while preserving its namespace setting. */\ntype BoundLayoutInput<\n  Definition extends { layout: unknown; namespace?: boolean }\n> = Definition['layout'] &\n  Pick<Definition, 'namespace'> &\n  (Definition extends { name?: infer Name } ? { name?: Name } : {});\n\n/** A `defineResourceLayout` function with its shared configuration pre-bound. */\nexport type BoundDefineResourceLayout<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /**\n   * Defines a layout whose `render` map contains the required `default` state\n   * and any built-in or custom compound component states.\n   * Keep this overload first so incomplete render objects suggest state keys.\n   * Use `createRenderState` for state-local `composables(create)` callbacks;\n   * the helper infers their render context independently of the enclosing map.\n   */\n  <\n    const Render extends { default: unknown } & Record<string, unknown>,\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    const Naming extends\n      | LayoutNameInput<\n          LayoutResourceKey<Resources>,\n          ('default' | keyof Render) & string\n        >\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapRenderStatesOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Render,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: RenderStateReferences<Resources, Options, Composables, Render>\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayoutFromStates<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    Render,\n    Namespace,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    Naming\n  >;\n  /** Defines a layout whose `render` value is a single default-state callback. */\n  <\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const Naming extends\n      | LayoutNameInput<LayoutResourceKey<Resources>, 'default'>\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapFunctionRenderOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: {}\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayout<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    {},\n    Namespace,\n    Naming\n  >;\n  /**\n   * Creates a lazy proxy for the single library-defined component exported by\n   * a resource module.\n   *\n   * @param options - Resource path and named-module import callback.\n   */\n  lazy<Module extends Record<string, unknown>>(\n    options: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;\n};\n\n/** Registers loading and module-error components used by lazy layouts. */\nexport type DefineLazyDefaults = {\n  /**\n   * Sets defaults once, before the factory creates its first lazy layout.\n   *\n   * @param defaults - Shared components for pending module loads and failures.\n   */\n  (defaults: LazyResourceStates): void;\n};\n\n/** Reusable helpers produced by {@link createDefinedResourceLayout}. */\nexport type CreateDefinedResourceLayoutResult<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /** Creates eager, deferred, or separately imported render-state fragments. */\n  createRenderState: CreateRenderState<\n    Resources,\n    Options,\n    Composables,\n    SharedInclude,\n    SharedCustom\n  >;\n  /** Sets the shared loading and module-error UI used by lazy layouts. */\n  defineLazyDefaults: DefineLazyDefaults;\n  /** Defines a layout using the resources, options, and composables already bound. */\n  defineResourceLayout: BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n  /** Reads, selects, or validates the resources bound to this factory. */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\n/**\n * Creates type-linked layout helpers from one shared configuration. The returned\n * `defineResourceLayout` accepts the layout directly, while `createRenderState`\n * carries the same resource and option types across file boundaries.\n *\n * @param configuration - Resources and optional shared props/composables to\n * bind to every returned helper.\n * @returns Helpers that share the configuration's inferred literal types.\n *\n * Callback names have a dedicated overload so their resource context is typed\n * before dependent composable and prop contracts are inferred. The fallback\n * overload preserves string names and the requirement for explicit names when\n * no factory default is supplied.\n *\n * @example\n * ```tsx\n * const { createRenderState, defineResourceLayout } =\n *   createDefinedResourceLayout({\n *     resources: ['users'],\n *     options: { title: createProp.string() },\n *   });\n *\n * const Loading = createRenderState({\n *   state: 'Loading',\n *   props: { include: { title: true } },\n *   render: ({ title }) => <p>Loading {title}</p>,\n * });\n *\n * export const usersLayout = defineResourceLayout({\n *   render: { default: () => <Users />, ...Loading },\n * });\n * ```\n */\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Naming extends (\n    context: LayoutNameContext<LayoutResourceKey<Resources>>\n  ) => string,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {}\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    Naming\n  > & { name: Naming }\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  Naming\n>;\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefaultNaming\n>;\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefaultNaming\n> {\n  const { resources, options = {} as Options, composables } = configuration;\n  const defineBoundLayout = defineResourceLayout.forResources(...resources);\n  const inspection = createInspectionStore();\n  let lazyDefaults: LazyResourceStates = {};\n  let lazyDefaultsDefined = false;\n  let lazyLayoutCreated = false;\n\n  function defineLazyDefaults(defaults: LazyResourceStates): void {\n    if (lazyDefaultsDefined) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults can only be defined once.'\n      );\n    }\n\n    if (lazyLayoutCreated) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults must be defined before creating a lazy resource layout.'\n      );\n    }\n\n    lazyDefaults = defaults;\n\n    lazyDefaultsDefined = true;\n  }\n\n  const boundDefineResourceLayout = ((layout: Record<string, unknown>) => {\n    const localComposables = layout.composables as\n      | LayoutComposablesDefinition<Resources, ComposableComponents>\n      | undefined;\n    const definition = defineBoundLayout({\n      [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),\n      options,\n      name: layout.name ?? configuration.name,\n      namespace: layout.namespace ?? configuration.namespace,\n      layout: {\n        ...layout,\n        props: mergeLayoutProps(\n          configuration.props,\n          layout.props as { include?: object; custom?: object }\n        ),\n        composables:\n          composables || localComposables\n            ? (\n                create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n                states: {}\n              ) => ({\n                ...composables?.(create, states),\n                ...localComposables?.(create, states),\n              })\n            : undefined,\n      },\n    } as never);\n\n    inspection.connect(definition);\n\n    return definition;\n  }) as unknown as BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n\n  boundDefineResourceLayout.lazy = <Module extends Record<string, unknown>>(\n    lazyOptions: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>> => {\n    lazyLayoutCreated = true;\n\n    const id = inspectionId('lazy');\n    const label = (lazyOptions as unknown as { resource: string }).resource;\n\n    inspection.node({ id, kind: 'lazy', label, unresolved: true });\n\n    return createLazyResourceLayout(\n      {\n        ...lazyOptions,\n        load: async () => {\n          const module: Record<string, unknown> = await lazyOptions.load();\n\n          for (const entry of Object.values(module)) {\n            const component =\n              entry && typeof entry === 'object' && 'Root' in entry\n                ? entry.Root\n                : entry;\n\n            if (\n              ((typeof component === 'object' && component !== null) ||\n                typeof component === 'function') &&\n              layoutInspection in component\n            ) {\n              inspection.connect(component);\n\n              const target = getInspectionSource(component)\n                .getSnapshot()\n                .nodes.find(\n                  (n) =>\n                    n.kind === 'layout' &&\n                    n.label ===\n                      (component as { displayName?: string }).displayName\n                );\n\n              if (target) inspection.edge(id, target.id, 'references');\n            }\n          }\n\n          inspection.node({ id, kind: 'lazy', label, unresolved: false });\n\n          return module as Module;\n        },\n      },\n      lazyDefaults\n    );\n  };\n\n  return inspection.attach({\n    createRenderState: createRenderStateBuilder({\n      props: configuration.props,\n      composables,\n      options,\n      resources,\n    }),\n    defineLazyDefaults,\n    defineResourceLayout: boundDefineResourceLayout,\n    resources: createLayoutResourcesAccessor(resources),\n  });\n}\n"],"mappings":";;;;;;;;AAuYA,SAAgB,4BAWd,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoBA,2CAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,+EAAmC;CACzC,IAAI,eAAmC,CAAC;CACxC,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBAAmB,UAAoC;EAC9D,IAAI,qBACF,MAAM,IAAIC,4DACR,kDACF;EAGF,IAAI,mBACF,MAAM,IAAIA,4DACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClCC,gHAA6B,MAAM,gEAAoB,aAAa;GACrE;GACA,MAAM,OAAO,QAAQ,cAAc;GACnC,WAAW,OAAO,aAAa,cAAc;GAC7C,QAAQ;IACN,GAAG;IACH,OAAOC,4CACL,cAAc,OACd,OAAO,KACT;IACA,aACE,eAAe,oBAET,QACA,YACI;KACJ,GAAG,cAAc,QAAQ,MAAM;KAC/B,GAAG,mBAAmB,QAAQ,MAAM;IACtC,KACA;GACR;EACF,CAAU;EAEV,WAAW,QAAQ,UAAU;EAE7B,OAAO;CACT;CAUA,0BAA0B,QACxB,gBACmE;EACnE,oBAAoB;EAEpB,MAAM,8DAAkB,MAAM;EAC9B,MAAM,QAAS,YAAgD;EAE/D,WAAW,KAAK;GAAE;GAAI,MAAM;GAAQ;GAAO,YAAY;EAAK,CAAC;EAE7D,OAAOC,sDACL;GACE,GAAG;GACH,MAAM,YAAY;IAChB,MAAM,SAAkC,MAAM,YAAY,KAAK;IAE/D,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;KACzC,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,MAAM,OACN;KAEN,KACI,OAAO,cAAc,YAAY,cAAc,QAC/C,OAAO,cAAc,eACvBC,2DAAoB,WACpB;MACA,WAAW,QAAQ,SAAS;MAE5B,MAAM,yEAA6B,SAAS,EACzC,YAAY,EACZ,MAAM,MACJ,MACC,EAAE,SAAS,YACX,EAAE,UACC,UAAuC,WAC9C;MAEF,IAAI,QAAQ,WAAW,KAAK,IAAI,OAAO,IAAI,YAAY;KACzD;IACF;IAEA,WAAW,KAAK;KAAE;KAAI,MAAM;KAAQ;KAAO,YAAY;IAAM,CAAC;IAE9D,OAAO;GACT;EACF,GACA,YACF;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmBC,8CAAyB;GAC1C,OAAO,cAAc;GACrB;GACA;GACA;EACF,CAAC;EACD;EACA,sBAAsB;EACtB,WAAWC,oDAA8B,SAAS;CACpD,CAAC;AACH"}

package/dist/create-config/create-defined-resource-layout.d.cts

@@ -1,7 +1,7 @@
 import { LayoutResourceKey, ResourceDefinition } from "../resource.cjs";
 import { InPropsDefinition, InPropsObject } from "../props.cjs";
 import { CreateRenderState, LayoutComposablesDefinition, RenderStateReferences } from "./render-state.cjs";
-import { LayoutNameInput } from "./layout-name.cjs";
+import { LayoutNameContext, LayoutNameInput } from "./layout-name.cjs";
 import { CreateViewMapFunctionRenderOptions, CreateViewMapRenderStatesOptions, DefinedResourceLayout, DefinedResourceLayoutFromStates, LayoutIncludeProps, LayoutResourcesAccessor, MergeContract } from "./define-layout.cjs";
 import { LazyResourceLayoutOptions, LazyResourceStates, createLazyResourceLayout } from "./lazy-resource-layout.cjs";
 import { ComposableComponents, CreateLayoutComposable } from "@jfdevelops/react-layout-composables";
@@ -96,6 +96,11 @@ type CreateDefinedResourceLayoutResult<Resources extends NonEmptyResources, Opti
  * bind to every returned helper.
  * @returns Helpers that share the configuration's inferred literal types.
  *
+ * Callback names have a dedicated overload so their resource context is typed
+ * before dependent composable and prop contracts are inferred. The fallback
+ * overload preserves string names and the requirement for explicit names when
+ * no factory default is supplied.
+ *
  * @example
  * ```tsx
  * const { createRenderState, defineResourceLayout } =
@@ -115,7 +120,10 @@ type CreateDefinedResourceLayoutResult<Resources extends NonEmptyResources, Opti
  * });
  * ```
  */
-declare function createDefinedResourceLayout<const Resources extends NonEmptyResources, const Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, DefaultNamespace extends boolean = false, const SharedInclude extends LayoutIncludeProps<Resources, Options, Composables> = {}, const SharedCustom extends InPropsObject = {}, const DefaultNaming extends LayoutNameInput<LayoutResourceKey<Resources>> | undefined = undefined>(configuration: CreateDefinedResourceLayoutOptions<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>): CreateDefinedResourceLayoutResult<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>;
+declare function createDefinedResourceLayout<const Resources extends NonEmptyResources, const Naming extends (context: LayoutNameContext<LayoutResourceKey<Resources>>) => string, const Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, DefaultNamespace extends boolean = false, const SharedInclude extends object = {}, const SharedCustom extends InPropsObject = {}>(configuration: CreateDefinedResourceLayoutOptions<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, Naming> & {
+  name: Naming;
+}): CreateDefinedResourceLayoutResult<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, Naming>;
+declare function createDefinedResourceLayout<const Resources extends NonEmptyResources, const Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, DefaultNamespace extends boolean = false, const SharedInclude extends object = {}, const SharedCustom extends InPropsObject = {}, const DefaultNaming extends LayoutNameInput<LayoutResourceKey<Resources>> | undefined = undefined>(configuration: CreateDefinedResourceLayoutOptions<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>): CreateDefinedResourceLayoutResult<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>;
 //#endregion
 export { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout };
 //# sourceMappingURL=create-defined-resource-layout.d.cts.map

package/dist/create-config/create-defined-resource-layout.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"create-defined-resource-layout.d.cts","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"mappings":"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"}
+{"version":3,"file":"create-defined-resource-layout.d.cts","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"mappings":"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"}

package/dist/create-config/create-defined-resource-layout.d.mts

@@ -1,7 +1,7 @@
 import { LayoutResourceKey, ResourceDefinition } from "../resource.mjs";
 import { InPropsDefinition, InPropsObject } from "../props.mjs";
 import { CreateRenderState, LayoutComposablesDefinition, RenderStateReferences } from "./render-state.mjs";
-import { LayoutNameInput } from "./layout-name.mjs";
+import { LayoutNameContext, LayoutNameInput } from "./layout-name.mjs";
 import { CreateViewMapFunctionRenderOptions, CreateViewMapRenderStatesOptions, DefinedResourceLayout, DefinedResourceLayoutFromStates, LayoutIncludeProps, LayoutResourcesAccessor, MergeContract } from "./define-layout.mjs";
 import { LazyResourceLayoutOptions, LazyResourceStates, createLazyResourceLayout } from "./lazy-resource-layout.mjs";
 import { ComposableComponents, CreateLayoutComposable } from "@jfdevelops/react-layout-composables";
@@ -96,6 +96,11 @@ type CreateDefinedResourceLayoutResult<Resources extends NonEmptyResources, Opti
  * bind to every returned helper.
  * @returns Helpers that share the configuration's inferred literal types.
  *
+ * Callback names have a dedicated overload so their resource context is typed
+ * before dependent composable and prop contracts are inferred. The fallback
+ * overload preserves string names and the requirement for explicit names when
+ * no factory default is supplied.
+ *
  * @example
  * ```tsx
  * const { createRenderState, defineResourceLayout } =
@@ -115,7 +120,10 @@ type CreateDefinedResourceLayoutResult<Resources extends NonEmptyResources, Opti
  * });
  * ```
  */
-declare function createDefinedResourceLayout<const Resources extends NonEmptyResources, const Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, DefaultNamespace extends boolean = false, const SharedInclude extends LayoutIncludeProps<Resources, Options, Composables> = {}, const SharedCustom extends InPropsObject = {}, const DefaultNaming extends LayoutNameInput<LayoutResourceKey<Resources>> | undefined = undefined>(configuration: CreateDefinedResourceLayoutOptions<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>): CreateDefinedResourceLayoutResult<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>;
+declare function createDefinedResourceLayout<const Resources extends NonEmptyResources, const Naming extends (context: LayoutNameContext<LayoutResourceKey<Resources>>) => string, const Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, DefaultNamespace extends boolean = false, const SharedInclude extends object = {}, const SharedCustom extends InPropsObject = {}>(configuration: CreateDefinedResourceLayoutOptions<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, Naming> & {
+  name: Naming;
+}): CreateDefinedResourceLayoutResult<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, Naming>;
+declare function createDefinedResourceLayout<const Resources extends NonEmptyResources, const Options extends InPropsDefinition<Resources> = {}, Composables extends ComposableComponents = {}, DefaultNamespace extends boolean = false, const SharedInclude extends object = {}, const SharedCustom extends InPropsObject = {}, const DefaultNaming extends LayoutNameInput<LayoutResourceKey<Resources>> | undefined = undefined>(configuration: CreateDefinedResourceLayoutOptions<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>): CreateDefinedResourceLayoutResult<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>;
 //#endregion
 export { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout };
 //# sourceMappingURL=create-defined-resource-layout.d.mts.map

package/dist/create-config/create-defined-resource-layout.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"create-defined-resource-layout.d.mts","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"mappings":"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"}
+{"version":3,"file":"create-defined-resource-layout.d.mts","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"mappings":"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"}

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

@@ -6,34 +6,6 @@ import { createLazyResourceLayout } from "./lazy-resource-layout.mjs";
 import { createInspectionStore, getInspectionSource, getLayoutDebug, inspectionId, layoutDebug, layoutInspection } from "@jfdevelops/react-layout-devtools-core";
 
 //#region src/create-config/create-defined-resource-layout.ts
-/**
-* Creates type-linked layout helpers from one shared configuration. The returned
-* `defineResourceLayout` accepts the layout directly, while `createRenderState`
-* carries the same resource and option types across file boundaries.
-*
-* @param configuration - Resources and optional shared props/composables to
-* bind to every returned helper.
-* @returns Helpers that share the configuration's inferred literal types.
-*
-* @example
-* ```tsx
-* const { createRenderState, defineResourceLayout } =
-*   createDefinedResourceLayout({
-*     resources: ['users'],
-*     options: { title: createProp.string() },
-*   });
-*
-* const Loading = createRenderState({
-*   state: 'Loading',
-*   props: { include: { title: true } },
-*   render: ({ title }) => <p>Loading {title}</p>,
-* });
-*
-* export const usersLayout = defineResourceLayout({
-*   render: { default: () => <Users />, ...Loading },
-* });
-* ```
-*/
 function createDefinedResourceLayout(configuration) {
 	const { resources, options = {}, composables } = configuration;
 	const defineBoundLayout = defineResourceLayout.forResources(...resources);

package/dist/create-config/create-defined-resource-layout.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-defined-resource-layout.mjs","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import {\n  getLayoutDebug,\n  layoutDebug,\n  createInspectionStore,\n  inspectionId,\n  layoutInspection,\n  getInspectionSource,\n} from '@jfdevelops/react-layout-devtools-core';\nimport { mergeLayoutProps } from './merge-layout-props';\nimport type { LayoutNameInput } from './layout-name';\nimport type { MergeContract } from './define-layout';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport type { InPropsDefinition, InPropsObject } from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport {\n  type CreateViewMapFunctionRenderOptions,\n  type DefinedResourceLayout,\n  defineResourceLayout,\n  type LayoutIncludeProps,\n  type LayoutResourcesAccessor,\n  type CreateViewMapRenderStatesOptions,\n  type DefinedResourceLayoutFromStates,\n  createLayoutResourcesAccessor,\n} from './define-layout';\nimport {\n  createLazyResourceLayout,\n  type LazyResourceLayoutOptions,\n  type LazyResourceStates,\n} from './lazy-resource-layout';\nimport {\n  createRenderStateBuilder,\n  type CreateRenderState,\n  type RenderStateReferences,\n  type LayoutComposablesDefinition,\n} from './render-state';\n\n/** A resource tuple with at least one entry, preserving literal and nested paths. */\nexport type NonEmptyResources = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[]\n];\n\n/** Configuration shared by every layout created from one defined-layout factory. */\nexport type CreateDefinedResourceLayoutOptions<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  namespace?: DefaultNamespace;\n  /** Default naming convention; explicit definition and component names override it. */\n  name?: DefaultNaming;\n  /** Shared prop contracts, merged by key with layout and state contracts. */\n  props?: {\n    include?: LayoutIncludeProps<Resources, Options, Composables> & SharedInclude;\n    custom?: SharedCustom;\n  };\n  /** Resources supported by every layout created from this factory. */\n  resources: Resources;\n  /** Props that render states can opt into through `props.include`. */\n  options?: Options;\n  /** Layout-wide composables available to every render state. */\n  composables?: LayoutComposablesDefinition<Resources, Composables>;\n};\n\n/** The flat layout definition accepted after shared configuration is bound. */\nexport type DefinedResourceLayoutInput<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n  Render,\n  Namespace extends boolean = false\n> = Omit<\n  CreateViewMapFunctionRenderOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >['layout'],\n  'composables' | 'render'\n> & { render: Render; namespace?: Namespace };\n\ntype BoundLayoutComposables<\n  Shared extends ComposableComponents,\n  Local extends ComposableComponents\n> = Omit<Shared, keyof Local> & Local;\n\n/** Flattens a definition's layout while preserving its namespace setting. */\ntype BoundLayoutInput<\n  Definition extends { layout: unknown; namespace?: boolean }\n> = Definition['layout'] &\n  Pick<Definition, 'namespace'> &\n  (Definition extends { name?: infer Name } ? { name?: Name } : {});\n\n/** A `defineResourceLayout` function with its shared configuration pre-bound. */\nexport type BoundDefineResourceLayout<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /**\n   * Defines a layout whose `render` map contains the required `default` state\n   * and any built-in or custom compound component states.\n   * Keep this overload first so incomplete render objects suggest state keys.\n   * Use `createRenderState` for state-local `composables(create)` callbacks;\n   * the helper infers their render context independently of the enclosing map.\n   */\n  <\n    const Render extends { default: unknown } & Record<string, unknown>,\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    const Naming extends\n      | LayoutNameInput<\n          LayoutResourceKey<Resources>,\n          ('default' | keyof Render) & string\n        >\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapRenderStatesOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Render,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: RenderStateReferences<Resources, Options, Composables, Render>\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayoutFromStates<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    Render,\n    Namespace,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    Naming\n  >;\n  /** Defines a layout whose `render` value is a single default-state callback. */\n  <\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const Naming extends\n      | LayoutNameInput<LayoutResourceKey<Resources>, 'default'>\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapFunctionRenderOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: {}\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayout<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    {},\n    Namespace,\n    Naming\n  >;\n  /**\n   * Creates a lazy proxy for the single library-defined component exported by\n   * a resource module.\n   *\n   * @param options - Resource path and named-module import callback.\n   */\n  lazy<Module extends Record<string, unknown>>(\n    options: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;\n};\n\n/** Registers loading and module-error components used by lazy layouts. */\nexport type DefineLazyDefaults = {\n  /**\n   * Sets defaults once, before the factory creates its first lazy layout.\n   *\n   * @param defaults - Shared components for pending module loads and failures.\n   */\n  (defaults: LazyResourceStates): void;\n};\n\n/** Reusable helpers produced by {@link createDefinedResourceLayout}. */\nexport type CreateDefinedResourceLayoutResult<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /** Creates eager, deferred, or separately imported render-state fragments. */\n  createRenderState: CreateRenderState<\n    Resources,\n    Options,\n    Composables,\n    SharedInclude,\n    SharedCustom\n  >;\n  /** Sets the shared loading and module-error UI used by lazy layouts. */\n  defineLazyDefaults: DefineLazyDefaults;\n  /** Defines a layout using the resources, options, and composables already bound. */\n  defineResourceLayout: BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n  /** Reads, selects, or validates the resources bound to this factory. */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\n/**\n * Creates type-linked layout helpers from one shared configuration. The returned\n * `defineResourceLayout` accepts the layout directly, while `createRenderState`\n * carries the same resource and option types across file boundaries.\n *\n * @param configuration - Resources and optional shared props/composables to\n * bind to every returned helper.\n * @returns Helpers that share the configuration's inferred literal types.\n *\n * @example\n * ```tsx\n * const { createRenderState, defineResourceLayout } =\n *   createDefinedResourceLayout({\n *     resources: ['users'],\n *     options: { title: createProp.string() },\n *   });\n *\n * const Loading = createRenderState({\n *   state: 'Loading',\n *   props: { include: { title: true } },\n *   render: ({ title }) => <p>Loading {title}</p>,\n * });\n *\n * export const usersLayout = defineResourceLayout({\n *   render: { default: () => <Users />, ...Loading },\n * });\n * ```\n */\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefaultNaming\n> {\n  const { resources, options = {} as Options, composables } = configuration;\n  const defineBoundLayout = defineResourceLayout.forResources(...resources);\n  const inspection = createInspectionStore();\n  let lazyDefaults: LazyResourceStates = {};\n  let lazyDefaultsDefined = false;\n  let lazyLayoutCreated = false;\n\n  function defineLazyDefaults(defaults: LazyResourceStates): void {\n    if (lazyDefaultsDefined) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults can only be defined once.'\n      );\n    }\n\n    if (lazyLayoutCreated) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults must be defined before creating a lazy resource layout.'\n      );\n    }\n\n    lazyDefaults = defaults;\n\n    lazyDefaultsDefined = true;\n  }\n\n  const boundDefineResourceLayout = ((layout: Record<string, unknown>) => {\n    const localComposables = layout.composables as\n      | LayoutComposablesDefinition<Resources, ComposableComponents>\n      | undefined;\n    const definition = defineBoundLayout({\n      [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),\n      options,\n      name: layout.name ?? configuration.name,\n      namespace: layout.namespace ?? configuration.namespace,\n      layout: {\n        ...layout,\n        props: mergeLayoutProps(\n          configuration.props,\n          layout.props as { include?: object; custom?: object }\n        ),\n        composables:\n          composables || localComposables\n            ? (\n                create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n                states: {}\n              ) => ({\n                ...composables?.(create, states),\n                ...localComposables?.(create, states),\n              })\n            : undefined,\n      },\n    } as never);\n\n    inspection.connect(definition);\n\n    return definition;\n  }) as unknown as BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n\n  boundDefineResourceLayout.lazy = <Module extends Record<string, unknown>>(\n    lazyOptions: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>> => {\n    lazyLayoutCreated = true;\n\n    const id = inspectionId('lazy');\n    const label = (lazyOptions as unknown as { resource: string }).resource;\n\n    inspection.node({ id, kind: 'lazy', label, unresolved: true });\n\n    return createLazyResourceLayout(\n      {\n        ...lazyOptions,\n        load: async () => {\n          const module: Record<string, unknown> = await lazyOptions.load();\n\n          for (const entry of Object.values(module)) {\n            const component =\n              entry && typeof entry === 'object' && 'Root' in entry\n                ? entry.Root\n                : entry;\n\n            if (\n              ((typeof component === 'object' && component !== null) ||\n                typeof component === 'function') &&\n              layoutInspection in component\n            ) {\n              inspection.connect(component);\n\n              const target = getInspectionSource(component)\n                .getSnapshot()\n                .nodes.find(\n                  (n) =>\n                    n.kind === 'layout' &&\n                    n.label ===\n                      (component as { displayName?: string }).displayName\n                );\n\n              if (target) inspection.edge(id, target.id, 'references');\n            }\n          }\n\n          inspection.node({ id, kind: 'lazy', label, unresolved: false });\n\n          return module as Module;\n        },\n      },\n      lazyDefaults\n    );\n  };\n\n  return inspection.attach({\n    createRenderState: createRenderStateBuilder({\n      props: configuration.props,\n      composables,\n      options,\n      resources,\n    }),\n    defineLazyDefaults,\n    defineResourceLayout: boundDefineResourceLayout,\n    resources: createLayoutResourcesAccessor(resources),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwUA,SAAgB,4BAed,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoB,qBAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,aAAa,sBAAsB;CACzC,IAAI,eAAmC,CAAC;CACxC,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBAAmB,UAAoC;EAC9D,IAAI,qBACF,MAAM,IAAI,yBACR,kDACF;EAGF,IAAI,mBACF,MAAM,IAAI,yBACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClC,cAAc,eAAe,MAAM,KAAK,eAAe,aAAa;GACrE;GACA,MAAM,OAAO,QAAQ,cAAc;GACnC,WAAW,OAAO,aAAa,cAAc;GAC7C,QAAQ;IACN,GAAG;IACH,OAAO,iBACL,cAAc,OACd,OAAO,KACT;IACA,aACE,eAAe,oBAET,QACA,YACI;KACJ,GAAG,cAAc,QAAQ,MAAM;KAC/B,GAAG,mBAAmB,QAAQ,MAAM;IACtC,KACA;GACR;EACF,CAAU;EAEV,WAAW,QAAQ,UAAU;EAE7B,OAAO;CACT;CAUA,0BAA0B,QACxB,gBACmE;EACnE,oBAAoB;EAEpB,MAAM,KAAK,aAAa,MAAM;EAC9B,MAAM,QAAS,YAAgD;EAE/D,WAAW,KAAK;GAAE;GAAI,MAAM;GAAQ;GAAO,YAAY;EAAK,CAAC;EAE7D,OAAO,yBACL;GACE,GAAG;GACH,MAAM,YAAY;IAChB,MAAM,SAAkC,MAAM,YAAY,KAAK;IAE/D,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;KACzC,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,MAAM,OACN;KAEN,KACI,OAAO,cAAc,YAAY,cAAc,QAC/C,OAAO,cAAc,eACvB,oBAAoB,WACpB;MACA,WAAW,QAAQ,SAAS;MAE5B,MAAM,SAAS,oBAAoB,SAAS,EACzC,YAAY,EACZ,MAAM,MACJ,MACC,EAAE,SAAS,YACX,EAAE,UACC,UAAuC,WAC9C;MAEF,IAAI,QAAQ,WAAW,KAAK,IAAI,OAAO,IAAI,YAAY;KACzD;IACF;IAEA,WAAW,KAAK;KAAE;KAAI,MAAM;KAAQ;KAAO,YAAY;IAAM,CAAC;IAE9D,OAAO;GACT;EACF,GACA,YACF;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmB,yBAAyB;GAC1C,OAAO,cAAc;GACrB;GACA;GACA;EACF,CAAC;EACD;EACA,sBAAsB;EACtB,WAAW,8BAA8B,SAAS;CACpD,CAAC;AACH"}
+{"version":3,"file":"create-defined-resource-layout.mjs","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import {\n  getLayoutDebug,\n  layoutDebug,\n  createInspectionStore,\n  inspectionId,\n  layoutInspection,\n  getInspectionSource,\n} from '@jfdevelops/react-layout-devtools-core';\nimport { mergeLayoutProps } from './merge-layout-props';\nimport type { LayoutNameContext, LayoutNameInput } from './layout-name';\nimport type { MergeContract } from './define-layout';\nimport type {\n  ComposableComponents,\n  CreateLayoutComposable,\n} from '@jfdevelops/react-layout-composables';\nimport { LayoutConfigurationError } from '../errors';\nimport type { InPropsDefinition, InPropsObject } from '../props';\nimport type { LayoutResourceKey, ResourceDefinition } from '../resource';\nimport {\n  type CreateViewMapFunctionRenderOptions,\n  type DefinedResourceLayout,\n  defineResourceLayout,\n  type LayoutIncludeProps,\n  type LayoutResourcesAccessor,\n  type CreateViewMapRenderStatesOptions,\n  type DefinedResourceLayoutFromStates,\n  createLayoutResourcesAccessor,\n} from './define-layout';\nimport {\n  createLazyResourceLayout,\n  type LazyResourceLayoutOptions,\n  type LazyResourceStates,\n} from './lazy-resource-layout';\nimport {\n  createRenderStateBuilder,\n  type CreateRenderState,\n  type RenderStateReferences,\n  type LayoutComposablesDefinition,\n} from './render-state';\n\n/** A resource tuple with at least one entry, preserving literal and nested paths. */\nexport type NonEmptyResources = readonly [\n  ResourceDefinition,\n  ...ResourceDefinition[]\n];\n\n/** Configuration shared by every layout created from one defined-layout factory. */\nexport type CreateDefinedResourceLayoutOptions<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  namespace?: DefaultNamespace;\n  /** Default naming convention; explicit definition and component names override it. */\n  name?: DefaultNaming;\n  /** Shared prop contracts, merged by key with layout and state contracts. */\n  props?: {\n    include?: LayoutIncludeProps<Resources, Options, Composables> & SharedInclude;\n    custom?: SharedCustom;\n  };\n  /** Resources supported by every layout created from this factory. */\n  resources: Resources;\n  /** Props that render states can opt into through `props.include`. */\n  options?: Options;\n  /** Layout-wide composables available to every render state. */\n  composables?: LayoutComposablesDefinition<Resources, Composables>;\n};\n\n/** The flat layout definition accepted after shared configuration is bound. */\nexport type DefinedResourceLayoutInput<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  IncludeProps extends LayoutIncludeProps<Resources, Options, Composables>,\n  CustomProps extends InPropsObject,\n  Render,\n  Namespace extends boolean = false\n> = Omit<\n  CreateViewMapFunctionRenderOptions<\n    Resources,\n    Options,\n    Composables,\n    IncludeProps,\n    CustomProps\n  >['layout'],\n  'composables' | 'render'\n> & { render: Render; namespace?: Namespace };\n\ntype BoundLayoutComposables<\n  Shared extends ComposableComponents,\n  Local extends ComposableComponents\n> = Omit<Shared, keyof Local> & Local;\n\n/** Flattens a definition's layout while preserving its namespace setting. */\ntype BoundLayoutInput<\n  Definition extends { layout: unknown; namespace?: boolean }\n> = Definition['layout'] &\n  Pick<Definition, 'namespace'> &\n  (Definition extends { name?: infer Name } ? { name?: Name } : {});\n\n/** A `defineResourceLayout` function with its shared configuration pre-bound. */\nexport type BoundDefineResourceLayout<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /**\n   * Defines a layout whose `render` map contains the required `default` state\n   * and any built-in or custom compound component states.\n   * Keep this overload first so incomplete render objects suggest state keys.\n   * Use `createRenderState` for state-local `composables(create)` callbacks;\n   * the helper infers their render context independently of the enclosing map.\n   */\n  <\n    const Render extends { default: unknown } & Record<string, unknown>,\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    const Naming extends\n      | LayoutNameInput<\n          LayoutResourceKey<Resources>,\n          ('default' | keyof Render) & string\n        >\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapRenderStatesOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Render,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: RenderStateReferences<Resources, Options, Composables, Render>\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayoutFromStates<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    Render,\n    Namespace,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    Naming\n  >;\n  /** Defines a layout whose `render` value is a single default-state callback. */\n  <\n    const IncludeProps extends LayoutIncludeProps<\n      Resources,\n      Options,\n      BoundLayoutComposables<Composables, LocalComposables>\n    > = {},\n    CustomProps extends InPropsObject = {},\n    LocalComposables extends ComposableComponents = {},\n    Namespace extends boolean = DefaultNamespace,\n    const Naming extends\n      | LayoutNameInput<LayoutResourceKey<Resources>, 'default'>\n      | undefined = DefaultNaming\n  >(\n    layout: Omit<\n      BoundLayoutInput<\n        CreateViewMapFunctionRenderOptions<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>,\n          MergeContract<SharedInclude, IncludeProps>,\n          MergeContract<SharedCustom, CustomProps>,\n          Namespace\n        >\n      >,\n      'composables' | 'name' | 'props'\n    > & {\n      name?: Naming;\n      props?: {\n        include?: LayoutIncludeProps<\n          Resources,\n          Options,\n          BoundLayoutComposables<Composables, LocalComposables>\n        > & IncludeProps;\n        custom?: CustomProps;\n      };\n      composables?: (\n        create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n        states: {}\n      ) => LocalComposables;\n    }\n  ): DefinedResourceLayout<\n    Resources,\n    Options,\n    BoundLayoutComposables<Composables, LocalComposables>,\n    MergeContract<SharedInclude, IncludeProps>,\n    MergeContract<SharedCustom, CustomProps>,\n    {},\n    Namespace,\n    Naming\n  >;\n  /**\n   * Creates a lazy proxy for the single library-defined component exported by\n   * a resource module.\n   *\n   * @param options - Resource path and named-module import callback.\n   */\n  lazy<Module extends Record<string, unknown>>(\n    options: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;\n};\n\n/** Registers loading and module-error components used by lazy layouts. */\nexport type DefineLazyDefaults = {\n  /**\n   * Sets defaults once, before the factory creates its first lazy layout.\n   *\n   * @param defaults - Shared components for pending module loads and failures.\n   */\n  (defaults: LazyResourceStates): void;\n};\n\n/** Reusable helpers produced by {@link createDefinedResourceLayout}. */\nexport type CreateDefinedResourceLayoutResult<\n  Resources extends NonEmptyResources,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n  DefaultNamespace extends boolean = false,\n  SharedInclude extends LayoutIncludeProps<\n    Resources,\n    Options,\n    Composables\n  > = {},\n  SharedCustom extends InPropsObject = {},\n  DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n> = {\n  /** Creates eager, deferred, or separately imported render-state fragments. */\n  createRenderState: CreateRenderState<\n    Resources,\n    Options,\n    Composables,\n    SharedInclude,\n    SharedCustom\n  >;\n  /** Sets the shared loading and module-error UI used by lazy layouts. */\n  defineLazyDefaults: DefineLazyDefaults;\n  /** Defines a layout using the resources, options, and composables already bound. */\n  defineResourceLayout: BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n  /** Reads, selects, or validates the resources bound to this factory. */\n  resources: LayoutResourcesAccessor<Resources>;\n};\n\n/**\n * Creates type-linked layout helpers from one shared configuration. The returned\n * `defineResourceLayout` accepts the layout directly, while `createRenderState`\n * carries the same resource and option types across file boundaries.\n *\n * @param configuration - Resources and optional shared props/composables to\n * bind to every returned helper.\n * @returns Helpers that share the configuration's inferred literal types.\n *\n * Callback names have a dedicated overload so their resource context is typed\n * before dependent composable and prop contracts are inferred. The fallback\n * overload preserves string names and the requirement for explicit names when\n * no factory default is supplied.\n *\n * @example\n * ```tsx\n * const { createRenderState, defineResourceLayout } =\n *   createDefinedResourceLayout({\n *     resources: ['users'],\n *     options: { title: createProp.string() },\n *   });\n *\n * const Loading = createRenderState({\n *   state: 'Loading',\n *   props: { include: { title: true } },\n *   render: ({ title }) => <p>Loading {title}</p>,\n * });\n *\n * export const usersLayout = defineResourceLayout({\n *   render: { default: () => <Users />, ...Loading },\n * });\n * ```\n */\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Naming extends (\n    context: LayoutNameContext<LayoutResourceKey<Resources>>\n  ) => string,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {}\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    Naming\n  > & { name: Naming }\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  Naming\n>;\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefaultNaming\n>;\nexport function createDefinedResourceLayout<\n  const Resources extends NonEmptyResources,\n  const Options extends InPropsDefinition<Resources> = {},\n  Composables extends ComposableComponents = {},\n  DefaultNamespace extends boolean = false,\n  const SharedInclude extends object = {},\n  const SharedCustom extends InPropsObject = {},\n  const DefaultNaming extends\n    | LayoutNameInput<LayoutResourceKey<Resources>>\n    | undefined = undefined\n>(\n  configuration: CreateDefinedResourceLayoutOptions<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >\n): CreateDefinedResourceLayoutResult<\n  Resources,\n  Options,\n  Composables,\n  DefaultNamespace,\n  SharedInclude,\n  SharedCustom,\n  DefaultNaming\n> {\n  const { resources, options = {} as Options, composables } = configuration;\n  const defineBoundLayout = defineResourceLayout.forResources(...resources);\n  const inspection = createInspectionStore();\n  let lazyDefaults: LazyResourceStates = {};\n  let lazyDefaultsDefined = false;\n  let lazyLayoutCreated = false;\n\n  function defineLazyDefaults(defaults: LazyResourceStates): void {\n    if (lazyDefaultsDefined) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults can only be defined once.'\n      );\n    }\n\n    if (lazyLayoutCreated) {\n      throw new LayoutConfigurationError(\n        'Lazy resource defaults must be defined before creating a lazy resource layout.'\n      );\n    }\n\n    lazyDefaults = defaults;\n\n    lazyDefaultsDefined = true;\n  }\n\n  const boundDefineResourceLayout = ((layout: Record<string, unknown>) => {\n    const localComposables = layout.composables as\n      | LayoutComposablesDefinition<Resources, ComposableComponents>\n      | undefined;\n    const definition = defineBoundLayout({\n      [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),\n      options,\n      name: layout.name ?? configuration.name,\n      namespace: layout.namespace ?? configuration.namespace,\n      layout: {\n        ...layout,\n        props: mergeLayoutProps(\n          configuration.props,\n          layout.props as { include?: object; custom?: object }\n        ),\n        composables:\n          composables || localComposables\n            ? (\n                create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n                states: {}\n              ) => ({\n                ...composables?.(create, states),\n                ...localComposables?.(create, states),\n              })\n            : undefined,\n      },\n    } as never);\n\n    inspection.connect(definition);\n\n    return definition;\n  }) as unknown as BoundDefineResourceLayout<\n    Resources,\n    Options,\n    Composables,\n    DefaultNamespace,\n    SharedInclude,\n    SharedCustom,\n    DefaultNaming\n  >;\n\n  boundDefineResourceLayout.lazy = <Module extends Record<string, unknown>>(\n    lazyOptions: LazyResourceLayoutOptions<Resources, Module>\n  ): ReturnType<typeof createLazyResourceLayout<Resources, Module>> => {\n    lazyLayoutCreated = true;\n\n    const id = inspectionId('lazy');\n    const label = (lazyOptions as unknown as { resource: string }).resource;\n\n    inspection.node({ id, kind: 'lazy', label, unresolved: true });\n\n    return createLazyResourceLayout(\n      {\n        ...lazyOptions,\n        load: async () => {\n          const module: Record<string, unknown> = await lazyOptions.load();\n\n          for (const entry of Object.values(module)) {\n            const component =\n              entry && typeof entry === 'object' && 'Root' in entry\n                ? entry.Root\n                : entry;\n\n            if (\n              ((typeof component === 'object' && component !== null) ||\n                typeof component === 'function') &&\n              layoutInspection in component\n            ) {\n              inspection.connect(component);\n\n              const target = getInspectionSource(component)\n                .getSnapshot()\n                .nodes.find(\n                  (n) =>\n                    n.kind === 'layout' &&\n                    n.label ===\n                      (component as { displayName?: string }).displayName\n                );\n\n              if (target) inspection.edge(id, target.id, 'references');\n            }\n          }\n\n          inspection.node({ id, kind: 'lazy', label, unresolved: false });\n\n          return module as Module;\n        },\n      },\n      lazyDefaults\n    );\n  };\n\n  return inspection.attach({\n    createRenderState: createRenderStateBuilder({\n      props: configuration.props,\n      composables,\n      options,\n      resources,\n    }),\n    defineLazyDefaults,\n    defineResourceLayout: boundDefineResourceLayout,\n    resources: createLayoutResourcesAccessor(resources),\n  });\n}\n"],"mappings":";;;;;;;;AAuYA,SAAgB,4BAWd,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoB,qBAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,aAAa,sBAAsB;CACzC,IAAI,eAAmC,CAAC;CACxC,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBAAmB,UAAoC;EAC9D,IAAI,qBACF,MAAM,IAAI,yBACR,kDACF;EAGF,IAAI,mBACF,MAAM,IAAI,yBACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClC,cAAc,eAAe,MAAM,KAAK,eAAe,aAAa;GACrE;GACA,MAAM,OAAO,QAAQ,cAAc;GACnC,WAAW,OAAO,aAAa,cAAc;GAC7C,QAAQ;IACN,GAAG;IACH,OAAO,iBACL,cAAc,OACd,OAAO,KACT;IACA,aACE,eAAe,oBAET,QACA,YACI;KACJ,GAAG,cAAc,QAAQ,MAAM;KAC/B,GAAG,mBAAmB,QAAQ,MAAM;IACtC,KACA;GACR;EACF,CAAU;EAEV,WAAW,QAAQ,UAAU;EAE7B,OAAO;CACT;CAUA,0BAA0B,QACxB,gBACmE;EACnE,oBAAoB;EAEpB,MAAM,KAAK,aAAa,MAAM;EAC9B,MAAM,QAAS,YAAgD;EAE/D,WAAW,KAAK;GAAE;GAAI,MAAM;GAAQ;GAAO,YAAY;EAAK,CAAC;EAE7D,OAAO,yBACL;GACE,GAAG;GACH,MAAM,YAAY;IAChB,MAAM,SAAkC,MAAM,YAAY,KAAK;IAE/D,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GAAG;KACzC,MAAM,YACJ,SAAS,OAAO,UAAU,YAAY,UAAU,QAC5C,MAAM,OACN;KAEN,KACI,OAAO,cAAc,YAAY,cAAc,QAC/C,OAAO,cAAc,eACvB,oBAAoB,WACpB;MACA,WAAW,QAAQ,SAAS;MAE5B,MAAM,SAAS,oBAAoB,SAAS,EACzC,YAAY,EACZ,MAAM,MACJ,MACC,EAAE,SAAS,YACX,EAAE,UACC,UAAuC,WAC9C;MAEF,IAAI,QAAQ,WAAW,KAAK,IAAI,OAAO,IAAI,YAAY;KACzD;IACF;IAEA,WAAW,KAAK;KAAE;KAAI,MAAM;KAAQ;KAAO,YAAY;IAAM,CAAC;IAE9D,OAAO;GACT;EACF,GACA,YACF;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmB,yBAAyB;GAC1C,OAAO,cAAc;GACrB;GACA;GACA;EACF,CAAC;EACD;EACA,sBAAsB;EACtB,WAAW,8BAA8B,SAAS;CACpD,CAAC;AACH"}

package/dist/create-config/define-layout.cjs

@@ -7,6 +7,7 @@ const require_state_composable = require('./state-composable.cjs');
 const require_merge_layout_props = require('./merge-layout-props.cjs');
 const require_preview = require('./preview.cjs');
 const require_inspection = require('./inspection.cjs');
+const require_props = require('../props.cjs');
 const require_resource = require('../resource.cjs');
 const require_utils = require('../utils.cjs');
 const require_component_keys = require('./component-keys.cjs');
@@ -82,21 +83,17 @@ function readLayoutOptionValue(includeKey, definition, sources) {
 	const layoutOptionKeys = isJSXElementDefinition(definition) ? [require_capitalize.capitalize(includeKey), includeKey] : [includeKey, require_capitalize.capitalize(includeKey)];
 	for (const key of layoutOptionKeys) if (key in sources) return sources[key];
 }
-function getIncludedPropBehavior(value) {
-	if (value !== null && typeof value === "object" && "visibility" in value && "passthrough" in value) return value;
-	return null;
-}
 function isIncludedPropRequired(value) {
-	return value === true || value === "required" || getIncludedPropBehavior(value)?.visibility === "required";
+	return value === true || value === "required" || require_props.getIncludedPropBehavior(value)?.visibility === "required";
 }
 function allowsConfigPassthrough(value) {
-	const behavior = getIncludedPropBehavior(value);
+	const behavior = require_props.getIncludedPropBehavior(value);
 	if (!behavior) return true;
 	if (behavior.passthrough === "config") return true;
 	return behavior.passthrough === "component" && behavior.visibility === "optional";
 }
 function allowsComponentPassthrough(value) {
-	const behavior = getIncludedPropBehavior(value);
+	const behavior = require_props.getIncludedPropBehavior(value);
 	return behavior ? behavior.passthrough === "component" : value === "optional";
 }
 function splitLayoutInProps(inProps) {