@jfdevelops/react-layout 1.6.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/dist/create-config/create-defined-resource-layout.cjs +18 -14
  2. package/dist/create-config/create-defined-resource-layout.cjs.map +1 -1
  3. package/dist/create-config/create-defined-resource-layout.d.cts +9 -5
  4. package/dist/create-config/create-defined-resource-layout.d.cts.map +1 -1
  5. package/dist/create-config/create-defined-resource-layout.d.mts +9 -5
  6. package/dist/create-config/create-defined-resource-layout.d.mts.map +1 -1
  7. package/dist/create-config/create-defined-resource-layout.mjs +19 -15
  8. package/dist/create-config/create-defined-resource-layout.mjs.map +1 -1
  9. package/dist/create-config/define-layout.cjs +66 -39
  10. package/dist/create-config/define-layout.cjs.map +1 -1
  11. package/dist/create-config/define-layout.d.cts +0 -5
  12. package/dist/create-config/define-layout.d.cts.map +1 -1
  13. package/dist/create-config/define-layout.d.mts +0 -5
  14. package/dist/create-config/define-layout.d.mts.map +1 -1
  15. package/dist/create-config/define-layout.mjs +67 -40
  16. package/dist/create-config/define-layout.mjs.map +1 -1
  17. package/dist/create-config/for-resources/create-component.d.cts +39 -21
  18. package/dist/create-config/for-resources/create-component.d.cts.map +1 -1
  19. package/dist/create-config/for-resources/create-component.d.mts +39 -21
  20. package/dist/create-config/for-resources/create-component.d.mts.map +1 -1
  21. package/dist/create-config/for-resources/create-for-resources.cjs +62 -7
  22. package/dist/create-config/for-resources/create-for-resources.cjs.map +1 -1
  23. package/dist/create-config/for-resources/create-for-resources.mjs +62 -7
  24. package/dist/create-config/for-resources/create-for-resources.mjs.map +1 -1
  25. package/dist/create-config/for-resources/scoped-render.cjs +1 -0
  26. package/dist/create-config/for-resources/scoped-render.cjs.map +1 -1
  27. package/dist/create-config/for-resources/scoped-render.d.cts.map +1 -1
  28. package/dist/create-config/for-resources/scoped-render.d.mts.map +1 -1
  29. package/dist/create-config/for-resources/scoped-render.mjs +1 -0
  30. package/dist/create-config/for-resources/scoped-render.mjs.map +1 -1
  31. package/dist/create-config/index.d.cts +2 -1
  32. package/dist/create-config/index.d.mts +2 -1
  33. package/dist/create-config/layout-name.cjs +36 -28
  34. package/dist/create-config/layout-name.cjs.map +1 -1
  35. package/dist/create-config/layout-name.d.cts +34 -28
  36. package/dist/create-config/layout-name.d.cts.map +1 -1
  37. package/dist/create-config/layout-name.d.mts +34 -28
  38. package/dist/create-config/layout-name.d.mts.map +1 -1
  39. package/dist/create-config/layout-name.mjs +36 -28
  40. package/dist/create-config/layout-name.mjs.map +1 -1
  41. package/dist/create-config/lazy-resource-layout.cjs +70 -86
  42. package/dist/create-config/lazy-resource-layout.cjs.map +1 -1
  43. package/dist/create-config/lazy-resource-layout.d.cts +9 -31
  44. package/dist/create-config/lazy-resource-layout.d.cts.map +1 -1
  45. package/dist/create-config/lazy-resource-layout.d.mts +9 -31
  46. package/dist/create-config/lazy-resource-layout.d.mts.map +1 -1
  47. package/dist/create-config/lazy-resource-layout.mjs +70 -86
  48. package/dist/create-config/lazy-resource-layout.mjs.map +1 -1
  49. package/dist/create-config/preview.cjs +1 -1
  50. package/dist/create-config/preview.d.cts +2 -0
  51. package/dist/create-config/preview.d.cts.map +1 -1
  52. package/dist/create-config/preview.d.mts +2 -0
  53. package/dist/create-config/preview.d.mts.map +1 -1
  54. package/dist/create-config/preview.mjs +1 -1
  55. package/dist/create-config/render-state.cjs +57 -18
  56. package/dist/create-config/render-state.cjs.map +1 -1
  57. package/dist/create-config/render-state.d.cts +18 -6
  58. package/dist/create-config/render-state.d.cts.map +1 -1
  59. package/dist/create-config/render-state.d.mts +18 -6
  60. package/dist/create-config/render-state.d.mts.map +1 -1
  61. package/dist/create-config/render-state.mjs +54 -18
  62. package/dist/create-config/render-state.mjs.map +1 -1
  63. package/dist/errors/lazy-resource-error.cjs +37 -0
  64. package/dist/errors/lazy-resource-error.cjs.map +1 -0
  65. package/dist/errors/lazy-resource-error.d.cts +26 -0
  66. package/dist/errors/lazy-resource-error.d.cts.map +1 -0
  67. package/dist/errors/lazy-resource-error.d.mts +26 -0
  68. package/dist/errors/lazy-resource-error.d.mts.map +1 -0
  69. package/dist/errors/lazy-resource-error.mjs +35 -0
  70. package/dist/errors/lazy-resource-error.mjs.map +1 -0
  71. package/dist/errors/react-layout-error.cjs +1 -1
  72. package/dist/errors/react-layout-error.mjs +1 -1
  73. package/dist/errors/resource-state-error.cjs +4 -1
  74. package/dist/errors/resource-state-error.cjs.map +1 -1
  75. package/dist/errors/resource-state-error.d.cts +1 -0
  76. package/dist/errors/resource-state-error.d.cts.map +1 -1
  77. package/dist/errors/resource-state-error.d.mts +1 -0
  78. package/dist/errors/resource-state-error.d.mts.map +1 -1
  79. package/dist/errors/resource-state-error.mjs +4 -1
  80. package/dist/errors/resource-state-error.mjs.map +1 -1
  81. package/dist/index.cjs +6 -2
  82. package/dist/index.d.cts +7 -4
  83. package/dist/index.d.mts +7 -4
  84. package/dist/index.mjs +4 -3
  85. package/dist/lazy/create-error-component.cjs +17 -0
  86. package/dist/lazy/create-error-component.cjs.map +1 -0
  87. package/dist/lazy/create-error-component.mjs +16 -0
  88. package/dist/lazy/create-error-component.mjs.map +1 -0
  89. package/dist/lazy/create-lazy-loader.cjs +78 -0
  90. package/dist/lazy/create-lazy-loader.cjs.map +1 -0
  91. package/dist/lazy/create-lazy-loader.d.cts +19 -0
  92. package/dist/lazy/create-lazy-loader.d.cts.map +1 -0
  93. package/dist/lazy/create-lazy-loader.d.mts +19 -0
  94. package/dist/lazy/create-lazy-loader.d.mts.map +1 -0
  95. package/dist/lazy/create-lazy-loader.mjs +78 -0
  96. package/dist/lazy/create-lazy-loader.mjs.map +1 -0
  97. package/dist/lazy/fallback-props.cjs +9 -0
  98. package/dist/lazy/fallback-props.cjs.map +1 -0
  99. package/dist/lazy/fallback-props.mjs +9 -0
  100. package/dist/lazy/fallback-props.mjs.map +1 -0
  101. package/dist/lazy/inspection.cjs +51 -0
  102. package/dist/lazy/inspection.cjs.map +1 -0
  103. package/dist/lazy/inspection.d.cts +28 -0
  104. package/dist/lazy/inspection.d.cts.map +1 -0
  105. package/dist/lazy/inspection.d.mts +28 -0
  106. package/dist/lazy/inspection.d.mts.map +1 -0
  107. package/dist/lazy/inspection.mjs +50 -0
  108. package/dist/lazy/inspection.mjs.map +1 -0
  109. package/dist/lazy/lazy-boundary.cjs +55 -0
  110. package/dist/lazy/lazy-boundary.cjs.map +1 -0
  111. package/dist/lazy/lazy-boundary.mjs +55 -0
  112. package/dist/lazy/lazy-boundary.mjs.map +1 -0
  113. package/dist/lazy/scoped-content.cjs +87 -0
  114. package/dist/lazy/scoped-content.cjs.map +1 -0
  115. package/dist/lazy/scoped-content.d.cts +19 -0
  116. package/dist/lazy/scoped-content.d.cts.map +1 -0
  117. package/dist/lazy/scoped-content.d.mts +19 -0
  118. package/dist/lazy/scoped-content.d.mts.map +1 -0
  119. package/dist/lazy/scoped-content.mjs +86 -0
  120. package/dist/lazy/scoped-content.mjs.map +1 -0
  121. package/dist/lazy/types.cjs +10 -0
  122. package/dist/lazy/types.cjs.map +1 -0
  123. package/dist/lazy/types.d.cts +39 -0
  124. package/dist/lazy/types.d.cts.map +1 -0
  125. package/dist/lazy/types.d.mts +39 -0
  126. package/dist/lazy/types.d.mts.map +1 -0
  127. package/dist/lazy/types.mjs +8 -0
  128. package/dist/lazy/types.mjs.map +1 -0
  129. package/dist/props.cjs +4 -2
  130. package/dist/props.cjs.map +1 -1
  131. package/dist/props.d.cts +6 -50
  132. package/dist/props.d.cts.map +1 -1
  133. package/dist/props.d.mts +6 -50
  134. package/dist/props.d.mts.map +1 -1
  135. package/dist/props.mjs +5 -2
  136. package/dist/props.mjs.map +1 -1
  137. package/dist/resource.cjs.map +1 -1
  138. package/dist/resource.d.cts +1 -1
  139. package/dist/resource.d.cts.map +1 -1
  140. package/dist/resource.d.mts +1 -1
  141. package/dist/resource.d.mts.map +1 -1
  142. package/dist/resource.mjs.map +1 -1
  143. package/package.json +2 -2
@@ -1,7 +1,10 @@
1
1
  const require_layout_configuration_error = require('../errors/layout-configuration-error.cjs');
2
+ const require_types = require('../lazy/types.cjs');
2
3
  const require_merge_layout_props = require('./merge-layout-props.cjs');
4
+ const require_inspection = require('../lazy/inspection.cjs');
3
5
  const require_render_state = require('./render-state.cjs');
4
6
  const require_define_layout = require('./define-layout.cjs');
7
+ const require_create_error_component = require('../lazy/create-error-component.cjs');
5
8
  const require_lazy_resource_layout = require('./lazy-resource-layout.cjs');
6
9
  let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
7
10
 
@@ -47,9 +50,15 @@ function createDefinedResourceLayout(configuration) {
47
50
  lazyDefaults = defaults;
48
51
  lazyDefaultsDefined = true;
49
52
  }
53
+ Object.defineProperty(defineLazyDefaults, "errors", {
54
+ value: void 0,
55
+ enumerable: false
56
+ });
57
+ defineLazyDefaults.createErrorComponent = require_create_error_component.createLazyErrorComponent;
50
58
  const boundDefineResourceLayout = ((layout) => {
51
59
  const localComposables = layout.composables;
52
60
  const definition = defineBoundLayout({
61
+ [require_types.lazyDefaultsSymbol]: () => lazyDefaults,
53
62
  [_jfdevelops_react_layout_devtools_core.layoutDebug]: (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(layout) ?? (0, _jfdevelops_react_layout_devtools_core.getLayoutDebug)(configuration),
54
63
  options,
55
64
  name: layout.name ?? configuration.name,
@@ -68,14 +77,9 @@ function createDefinedResourceLayout(configuration) {
68
77
  });
69
78
  boundDefineResourceLayout.lazy = (lazyOptions) => {
70
79
  lazyLayoutCreated = true;
71
- const id = (0, _jfdevelops_react_layout_devtools_core.inspectionId)("lazy");
72
80
  const label = lazyOptions.resource;
73
- inspection.node({
74
- id,
75
- kind: "lazy",
76
- label,
77
- unresolved: true
78
- });
81
+ const lazyInspection = require_inspection.inspectLazy(label, inspection);
82
+ const id = lazyInspection.id;
79
83
  return require_lazy_resource_layout.createLazyResourceLayout({
80
84
  ...lazyOptions,
81
85
  load: async () => {
@@ -88,15 +92,9 @@ function createDefinedResourceLayout(configuration) {
88
92
  if (target) inspection.edge(id, target.id, "references");
89
93
  }
90
94
  }
91
- inspection.node({
92
- id,
93
- kind: "lazy",
94
- label,
95
- unresolved: false
96
- });
97
95
  return module;
98
96
  }
99
- }, lazyDefaults);
97
+ }, lazyDefaults, lazyInspection.hooks);
100
98
  };
101
99
  return inspection.attach({
102
100
  createRenderState: require_render_state.createRenderStateBuilder({
@@ -104,6 +102,12 @@ function createDefinedResourceLayout(configuration) {
104
102
  composables,
105
103
  options,
106
104
  resources
105
+ }, {
106
+ store: inspection,
107
+ defaults: () => lazyDefaults,
108
+ onLazy: () => {
109
+ lazyLayoutCreated = true;
110
+ }
107
111
  }),
108
112
  defineLazyDefaults,
109
113
  defineResourceLayout: boundDefineResourceLayout,
@@ -1 +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 * A configuration that may omit its name cannot guarantee a naming default.\n */\ntype DefinedFactoryNaming<Naming> = undefined extends Naming ? undefined : Naming;\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 object = {},\n const SharedCustom extends InPropsObject = {},\n const DefaultNaming extends\n | LayoutNameInput<LayoutResourceKey<Resources>>\n | undefined = LayoutNameInput<LayoutResourceKey<Resources>> | 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 DefinedFactoryNaming<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 DefinedFactoryNaming<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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6UA,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"}
1
+ {"version":3,"file":"create-defined-resource-layout.cjs","names":["defineResourceLayout","LayoutConfigurationError","createLazyErrorComponent","lazyDefaultsSymbol","layoutDebug","mergeLayoutProps","inspectLazy","createLazyResourceLayout","layoutInspection","createRenderStateBuilder","createLayoutResourcesAccessor"],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import { inspectLazy } from '../lazy/inspection';\nimport type { ResourcePath } from '../resource';\nimport { createLazyErrorComponent } from '../lazy/create-error-component';\nimport { lazyDefaultsSymbol, type CreateLazyErrorComponent } from '../lazy/types';\nimport type { LazyResourceError } from '../errors/lazy-resource-error';\nimport {\n getLayoutDebug,\n layoutDebug,\n createInspectionStore,\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<Resource = string> = {\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<Resource>): void;\n readonly errors: LazyResourceError;\n createErrorComponent: CreateLazyErrorComponent<Resource>;\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<ResourcePath<Resources>>;\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 * A configuration that may omit its name cannot guarantee a naming default.\n */\ntype DefinedFactoryNaming<Naming> = undefined extends Naming ? undefined : Naming;\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 object = {},\n const SharedCustom extends InPropsObject = {},\n const DefaultNaming extends\n | LayoutNameInput<LayoutResourceKey<Resources>>\n | undefined = LayoutNameInput<LayoutResourceKey<Resources>> | 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 DefinedFactoryNaming<DefaultNaming>\n> {\n const { resources, options = {} as Options, composables } = configuration;\n const defineBoundLayout = defineResourceLayout.forResources(...resources);\n const inspection = createInspectionStore();\n let lazyDefaults: LazyResourceStates<ResourcePath<Resources>> = {};\n let lazyDefaultsDefined = false;\n let lazyLayoutCreated = false;\n\n function defineLazyDefaults(\n defaults: LazyResourceStates<ResourcePath<Resources>>\n ): 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 Object.defineProperty(defineLazyDefaults, 'errors', {\n value: undefined,\n enumerable: false,\n });\n defineLazyDefaults.createErrorComponent = createLazyErrorComponent as CreateLazyErrorComponent<ResourcePath<Resources>>;\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 [lazyDefaultsSymbol]: () => lazyDefaults,\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 DefinedFactoryNaming<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 label = (lazyOptions as unknown as { resource: string }).resource;\n const lazyInspection = inspectLazy(label, inspection);\n const id = lazyInspection.id;\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 return module as Module;\n },\n },\n lazyDefaults,\n lazyInspection.hooks\n );\n };\n\n return inspection.attach({\n createRenderState: createRenderStateBuilder(\n {\n props: configuration.props,\n composables,\n options,\n resources,\n },\n {\n store: inspection,\n defaults: () => lazyDefaults as LazyResourceStates,\n onLazy: () => {\n lazyLayoutCreated = true;\n },\n }\n ),\n defineLazyDefaults: defineLazyDefaults as DefineLazyDefaults<\n ResourcePath<Resources>\n >,\n defineResourceLayout: boundDefineResourceLayout,\n resources: createLayoutResourcesAccessor(resources),\n });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmVA,SAAgB,4BAWd,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoBA,2CAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,+EAAmC;CACzC,IAAI,eAA4D,CAAC;CACjE,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBACP,UACM;EACN,IAAI,qBACF,MAAM,IAAIC,4DACR,kDACF;EAGF,IAAI,mBACF,MAAM,IAAIA,4DACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,OAAO,eAAe,oBAAoB,UAAU;EAClD,OAAO;EACP,YAAY;CACd,CAAC;CACD,mBAAmB,uBAAuBC;CAE1C,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClCC,yCAA2B;IAC3BC,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,QAAS,YAAgD;EAC/D,MAAM,iBAAiBC,+BAAY,OAAO,UAAU;EACpD,MAAM,KAAK,eAAe;EAE1B,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,OAAO;GACT;EACF,GACA,cACA,eAAe,KACjB;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmBC,8CACjB;GACE,OAAO,cAAc;GACrB;GACA;GACA;EACF,GACA;GACE,OAAO;GACP,gBAAgB;GAChB,cAAc;IACZ,oBAAoB;GACtB;EACF,CACF;EACoB;EAGpB,sBAAsB;EACtB,WAAWC,oDAA8B,SAAS;CACpD,CAAC;AACH"}
@@ -1,9 +1,11 @@
1
- import { LayoutResourceKey, ResourceDefinition } from "../resource.cjs";
1
+ import { LazyResourceError } from "../errors/lazy-resource-error.cjs";
2
+ import { CreateLazyErrorComponent, LazyResourceStates } from "../lazy/types.cjs";
3
+ import { LayoutResourceKey, ResourceDefinition, ResourcePath } from "../resource.cjs";
2
4
  import { InPropsDefinition, InPropsObject } from "../props.cjs";
3
5
  import { CreateRenderState, LayoutComposablesDefinition, RenderStateReferences } from "./render-state.cjs";
4
6
  import { LayoutNameInput } from "./layout-name.cjs";
5
7
  import { CreateViewMapFunctionRenderOptions, CreateViewMapRenderStatesOptions, DefinedResourceLayout, DefinedResourceLayoutFromStates, LayoutIncludeProps, LayoutResourcesAccessor, MergeContract } from "./define-layout.cjs";
6
- import { LazyResourceLayoutOptions, LazyResourceStates, createLazyResourceLayout } from "./lazy-resource-layout.cjs";
8
+ import { LazyResourceLayoutOptions, createLazyResourceLayout } from "./lazy-resource-layout.cjs";
7
9
  import { ComposableComponents, CreateLayoutComposable } from "@jfdevelops/react-layout-composables";
8
10
 
9
11
  //#region src/create-config/create-defined-resource-layout.d.ts
@@ -72,18 +74,20 @@ type BoundDefineResourceLayout<Resources extends NonEmptyResources, Options exte
72
74
  lazy<Module extends Record<string, unknown>>(options: LazyResourceLayoutOptions<Resources, Module>): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;
73
75
  };
74
76
  /** Registers loading and module-error components used by lazy layouts. */
75
- type DefineLazyDefaults = {
77
+ type DefineLazyDefaults<Resource = string> = {
76
78
  /**
77
79
  * Sets defaults once, before the factory creates its first lazy layout.
78
80
  *
79
81
  * @param defaults - Shared components for pending module loads and failures.
80
82
  */
81
- (defaults: LazyResourceStates): void;
83
+ (defaults: LazyResourceStates<Resource>): void;
84
+ readonly errors: LazyResourceError;
85
+ createErrorComponent: CreateLazyErrorComponent<Resource>;
82
86
  };
83
87
  /** Reusable helpers produced by {@link createDefinedResourceLayout}. */
84
88
  type CreateDefinedResourceLayoutResult<Resources extends NonEmptyResources, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents, DefaultNamespace extends boolean = false, SharedInclude extends LayoutIncludeProps<Resources, Options, Composables> = {}, SharedCustom extends InPropsObject = {}, DefaultNaming extends LayoutNameInput<LayoutResourceKey<Resources>> | undefined = undefined> = {
85
89
  /** Creates eager, deferred, or separately imported render-state fragments. */createRenderState: CreateRenderState<Resources, Options, Composables, SharedInclude, SharedCustom>; /** Sets the shared loading and module-error UI used by lazy layouts. */
86
- defineLazyDefaults: DefineLazyDefaults; /** Defines a layout using the resources, options, and composables already bound. */
90
+ defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>>; /** Defines a layout using the resources, options, and composables already bound. */
87
91
  defineResourceLayout: BoundDefineResourceLayout<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>; /** Reads, selects, or validates the resources bound to this factory. */
88
92
  resources: LayoutResourcesAccessor<Resources>;
89
93
  };
@@ -1 +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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"}
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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"}
@@ -1,9 +1,11 @@
1
- import { LayoutResourceKey, ResourceDefinition } from "../resource.mjs";
1
+ import { LazyResourceError } from "../errors/lazy-resource-error.mjs";
2
+ import { CreateLazyErrorComponent, LazyResourceStates } from "../lazy/types.mjs";
3
+ import { LayoutResourceKey, ResourceDefinition, ResourcePath } from "../resource.mjs";
2
4
  import { InPropsDefinition, InPropsObject } from "../props.mjs";
3
5
  import { CreateRenderState, LayoutComposablesDefinition, RenderStateReferences } from "./render-state.mjs";
4
6
  import { LayoutNameInput } from "./layout-name.mjs";
5
7
  import { CreateViewMapFunctionRenderOptions, CreateViewMapRenderStatesOptions, DefinedResourceLayout, DefinedResourceLayoutFromStates, LayoutIncludeProps, LayoutResourcesAccessor, MergeContract } from "./define-layout.mjs";
6
- import { LazyResourceLayoutOptions, LazyResourceStates, createLazyResourceLayout } from "./lazy-resource-layout.mjs";
8
+ import { LazyResourceLayoutOptions, createLazyResourceLayout } from "./lazy-resource-layout.mjs";
7
9
  import { ComposableComponents, CreateLayoutComposable } from "@jfdevelops/react-layout-composables";
8
10
 
9
11
  //#region src/create-config/create-defined-resource-layout.d.ts
@@ -72,18 +74,20 @@ type BoundDefineResourceLayout<Resources extends NonEmptyResources, Options exte
72
74
  lazy<Module extends Record<string, unknown>>(options: LazyResourceLayoutOptions<Resources, Module>): ReturnType<typeof createLazyResourceLayout<Resources, Module>>;
73
75
  };
74
76
  /** Registers loading and module-error components used by lazy layouts. */
75
- type DefineLazyDefaults = {
77
+ type DefineLazyDefaults<Resource = string> = {
76
78
  /**
77
79
  * Sets defaults once, before the factory creates its first lazy layout.
78
80
  *
79
81
  * @param defaults - Shared components for pending module loads and failures.
80
82
  */
81
- (defaults: LazyResourceStates): void;
83
+ (defaults: LazyResourceStates<Resource>): void;
84
+ readonly errors: LazyResourceError;
85
+ createErrorComponent: CreateLazyErrorComponent<Resource>;
82
86
  };
83
87
  /** Reusable helpers produced by {@link createDefinedResourceLayout}. */
84
88
  type CreateDefinedResourceLayoutResult<Resources extends NonEmptyResources, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents, DefaultNamespace extends boolean = false, SharedInclude extends LayoutIncludeProps<Resources, Options, Composables> = {}, SharedCustom extends InPropsObject = {}, DefaultNaming extends LayoutNameInput<LayoutResourceKey<Resources>> | undefined = undefined> = {
85
89
  /** Creates eager, deferred, or separately imported render-state fragments. */createRenderState: CreateRenderState<Resources, Options, Composables, SharedInclude, SharedCustom>; /** Sets the shared loading and module-error UI used by lazy layouts. */
86
- defineLazyDefaults: DefineLazyDefaults; /** Defines a layout using the resources, options, and composables already bound. */
90
+ defineLazyDefaults: DefineLazyDefaults<ResourcePath<Resources>>; /** Defines a layout using the resources, options, and composables already bound. */
87
91
  defineResourceLayout: BoundDefineResourceLayout<Resources, Options, Composables, DefaultNamespace, SharedInclude, SharedCustom, DefaultNaming>; /** Reads, selects, or validates the resources bound to this factory. */
88
92
  resources: LayoutResourcesAccessor<Resources>;
89
93
  };
@@ -1 +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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"}
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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"}
@@ -1,9 +1,12 @@
1
1
  import { LayoutConfigurationError } from "../errors/layout-configuration-error.mjs";
2
+ import { lazyDefaultsSymbol } from "../lazy/types.mjs";
2
3
  import { mergeLayoutProps } from "./merge-layout-props.mjs";
4
+ import { inspectLazy } from "../lazy/inspection.mjs";
3
5
  import { createRenderStateBuilder } from "./render-state.mjs";
4
6
  import { createLayoutResourcesAccessor, defineResourceLayout } from "./define-layout.mjs";
7
+ import { createLazyErrorComponent } from "../lazy/create-error-component.mjs";
5
8
  import { createLazyResourceLayout } from "./lazy-resource-layout.mjs";
6
- import { createInspectionStore, getInspectionSource, getLayoutDebug, inspectionId, layoutDebug, layoutInspection } from "@jfdevelops/react-layout-devtools-core";
9
+ import { createInspectionStore, getInspectionSource, getLayoutDebug, layoutDebug, layoutInspection } from "@jfdevelops/react-layout-devtools-core";
7
10
 
8
11
  //#region src/create-config/create-defined-resource-layout.ts
9
12
  /**
@@ -47,9 +50,15 @@ function createDefinedResourceLayout(configuration) {
47
50
  lazyDefaults = defaults;
48
51
  lazyDefaultsDefined = true;
49
52
  }
53
+ Object.defineProperty(defineLazyDefaults, "errors", {
54
+ value: void 0,
55
+ enumerable: false
56
+ });
57
+ defineLazyDefaults.createErrorComponent = createLazyErrorComponent;
50
58
  const boundDefineResourceLayout = ((layout) => {
51
59
  const localComposables = layout.composables;
52
60
  const definition = defineBoundLayout({
61
+ [lazyDefaultsSymbol]: () => lazyDefaults,
53
62
  [layoutDebug]: getLayoutDebug(layout) ?? getLayoutDebug(configuration),
54
63
  options,
55
64
  name: layout.name ?? configuration.name,
@@ -68,14 +77,9 @@ function createDefinedResourceLayout(configuration) {
68
77
  });
69
78
  boundDefineResourceLayout.lazy = (lazyOptions) => {
70
79
  lazyLayoutCreated = true;
71
- const id = inspectionId("lazy");
72
80
  const label = lazyOptions.resource;
73
- inspection.node({
74
- id,
75
- kind: "lazy",
76
- label,
77
- unresolved: true
78
- });
81
+ const lazyInspection = inspectLazy(label, inspection);
82
+ const id = lazyInspection.id;
79
83
  return createLazyResourceLayout({
80
84
  ...lazyOptions,
81
85
  load: async () => {
@@ -88,15 +92,9 @@ function createDefinedResourceLayout(configuration) {
88
92
  if (target) inspection.edge(id, target.id, "references");
89
93
  }
90
94
  }
91
- inspection.node({
92
- id,
93
- kind: "lazy",
94
- label,
95
- unresolved: false
96
- });
97
95
  return module;
98
96
  }
99
- }, lazyDefaults);
97
+ }, lazyDefaults, lazyInspection.hooks);
100
98
  };
101
99
  return inspection.attach({
102
100
  createRenderState: createRenderStateBuilder({
@@ -104,6 +102,12 @@ function createDefinedResourceLayout(configuration) {
104
102
  composables,
105
103
  options,
106
104
  resources
105
+ }, {
106
+ store: inspection,
107
+ defaults: () => lazyDefaults,
108
+ onLazy: () => {
109
+ lazyLayoutCreated = true;
110
+ }
107
111
  }),
108
112
  defineLazyDefaults,
109
113
  defineResourceLayout: boundDefineResourceLayout,
@@ -1 +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 * A configuration that may omit its name cannot guarantee a naming default.\n */\ntype DefinedFactoryNaming<Naming> = undefined extends Naming ? undefined : Naming;\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 object = {},\n const SharedCustom extends InPropsObject = {},\n const DefaultNaming extends\n | LayoutNameInput<LayoutResourceKey<Resources>>\n | undefined = LayoutNameInput<LayoutResourceKey<Resources>> | 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 DefinedFactoryNaming<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 DefinedFactoryNaming<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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6UA,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"}
1
+ {"version":3,"file":"create-defined-resource-layout.mjs","names":[],"sources":["../../src/create-config/create-defined-resource-layout.ts"],"sourcesContent":["import { inspectLazy } from '../lazy/inspection';\nimport type { ResourcePath } from '../resource';\nimport { createLazyErrorComponent } from '../lazy/create-error-component';\nimport { lazyDefaultsSymbol, type CreateLazyErrorComponent } from '../lazy/types';\nimport type { LazyResourceError } from '../errors/lazy-resource-error';\nimport {\n getLayoutDebug,\n layoutDebug,\n createInspectionStore,\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<Resource = string> = {\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<Resource>): void;\n readonly errors: LazyResourceError;\n createErrorComponent: CreateLazyErrorComponent<Resource>;\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<ResourcePath<Resources>>;\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 * A configuration that may omit its name cannot guarantee a naming default.\n */\ntype DefinedFactoryNaming<Naming> = undefined extends Naming ? undefined : Naming;\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 object = {},\n const SharedCustom extends InPropsObject = {},\n const DefaultNaming extends\n | LayoutNameInput<LayoutResourceKey<Resources>>\n | undefined = LayoutNameInput<LayoutResourceKey<Resources>> | 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 DefinedFactoryNaming<DefaultNaming>\n> {\n const { resources, options = {} as Options, composables } = configuration;\n const defineBoundLayout = defineResourceLayout.forResources(...resources);\n const inspection = createInspectionStore();\n let lazyDefaults: LazyResourceStates<ResourcePath<Resources>> = {};\n let lazyDefaultsDefined = false;\n let lazyLayoutCreated = false;\n\n function defineLazyDefaults(\n defaults: LazyResourceStates<ResourcePath<Resources>>\n ): 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 Object.defineProperty(defineLazyDefaults, 'errors', {\n value: undefined,\n enumerable: false,\n });\n defineLazyDefaults.createErrorComponent = createLazyErrorComponent as CreateLazyErrorComponent<ResourcePath<Resources>>;\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 [lazyDefaultsSymbol]: () => lazyDefaults,\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 DefinedFactoryNaming<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 label = (lazyOptions as unknown as { resource: string }).resource;\n const lazyInspection = inspectLazy(label, inspection);\n const id = lazyInspection.id;\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 return module as Module;\n },\n },\n lazyDefaults,\n lazyInspection.hooks\n );\n };\n\n return inspection.attach({\n createRenderState: createRenderStateBuilder(\n {\n props: configuration.props,\n composables,\n options,\n resources,\n },\n {\n store: inspection,\n defaults: () => lazyDefaults as LazyResourceStates,\n onLazy: () => {\n lazyLayoutCreated = true;\n },\n }\n ),\n defineLazyDefaults: defineLazyDefaults as DefineLazyDefaults<\n ResourcePath<Resources>\n >,\n defineResourceLayout: boundDefineResourceLayout,\n resources: createLayoutResourcesAccessor(resources),\n });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmVA,SAAgB,4BAWd,eAiBA;CACA,MAAM,EAAE,WAAW,UAAU,CAAC,GAAc,gBAAgB;CAC5D,MAAM,oBAAoB,qBAAqB,aAAa,GAAG,SAAS;CACxE,MAAM,aAAa,sBAAsB;CACzC,IAAI,eAA4D,CAAC;CACjE,IAAI,sBAAsB;CAC1B,IAAI,oBAAoB;CAExB,SAAS,mBACP,UACM;EACN,IAAI,qBACF,MAAM,IAAI,yBACR,kDACF;EAGF,IAAI,mBACF,MAAM,IAAI,yBACR,gFACF;EAGF,eAAe;EAEf,sBAAsB;CACxB;CAEA,OAAO,eAAe,oBAAoB,UAAU;EAClD,OAAO;EACP,YAAY;CACd,CAAC;CACD,mBAAmB,uBAAuB;CAE1C,MAAM,8BAA8B,WAAoC;EACtE,MAAM,mBAAmB,OAAO;EAGhC,MAAM,aAAa,kBAAkB;IAClC,2BAA2B;IAC3B,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,QAAS,YAAgD;EAC/D,MAAM,iBAAiB,YAAY,OAAO,UAAU;EACpD,MAAM,KAAK,eAAe;EAE1B,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,OAAO;GACT;EACF,GACA,cACA,eAAe,KACjB;CACF;CAEA,OAAO,WAAW,OAAO;EACvB,mBAAmB,yBACjB;GACE,OAAO,cAAc;GACrB;GACA;GACA;EACF,GACA;GACE,OAAO;GACP,gBAAgB;GAChB,cAAc;IACZ,oBAAoB;GACtB;EACF,CACF;EACoB;EAGpB,sBAAsB;EACtB,WAAW,8BAA8B,SAAS;CACpD,CAAC;AACH"}