@jfdevelops/react-layout 1.2.0 → 1.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"state-composable.cjs","names":["LayoutConfigurationError","capitalize"],"sources":["../../src/create-config/state-composable.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  useContext,\n  type ComponentType,\n  type JSX,\n} from 'react';\nimport { LayoutConfigurationError } from '../errors';\nimport type { IncludedProps } from '../props';\nimport { capitalize } from '../utils/capitalize';\n\n/** Props selected here are inherited from the containing state's render props. */\nexport type StateComposableOptions<\n  Props extends object,\n  Include extends IncludedProps<Props> = {},\n> = {\n  props?: {\n    include?: Include & { [Key in Exclude<keyof Include, keyof Props>]: never };\n  };\n};\n\ntype StateComposableCallProps<Props extends object, Carried extends keyof Props> =\n  Omit<Props, Carried> & Partial<Pick<Props, Carried>>;\n\n/** Non-enumerable state helpers; class methods stay out of object-spread types. */\nexport declare class StateComposableHandle<Props extends object> {\n  asComposable<const Include extends IncludedProps<Props> = {}>(\n    options?: StateComposableOptions<Props, Include>,\n  ): StateComposable<Props, keyof Include & keyof Props>;\n}\n\n/** A state component usable in a composables map, optionally inheriting props. */\nexport type StateComposable<\n  Props extends object,\n  Carried extends keyof Props = never,\n> = {\n  (props: StateComposableCallProps<Props, Carried>): JSX.Element;\n  displayName: string;\n  props: StateComposableCallProps<Props, Carried>;\n  asComposable: AsStateComposable<Props>;\n};\n\n/** Converts a state into a composable; unselected required props remain required. */\nexport type AsStateComposable<Props extends object> = <\n  const Include extends IncludedProps<Props> = {},\n>(\n  options?: StateComposableOptions<Props, Include>,\n) => StateComposable<Props, keyof Include & keyof Props>;\n\n/** @internal The definition is kept by identity so builder references need no registration. */\nexport type StateComposableSource = {\n  input: unknown;\n  name: string;\n  /** Fallback state that must not recursively render this reference. */\n  fallbackStateName?: string;\n};\n\n/** @internal Shared by all states in one created resource layout. */\nexport type RenderStateScope = {\n  states: Record<string, StateComposable<Record<string, unknown>>>;\n  resolve: (source: StateComposableSource) => ComponentType<Record<string, unknown>>;\n};\n\n/** @internal Each rendered state supplies its own resolved values for carry-over. */\nexport const StateComposableContext = createContext<{\n  scope: RenderStateScope;\n  props: Record<string, unknown>;\n  definitions: Record<string, unknown>;\n} | undefined>(undefined);\n\n/** @internal Defers state resolution until render, allowing forward references. */\nexport function createStateComposable(\n  source: StateComposableSource,\n  options: StateComposableOptions<Record<string, unknown>, IncludedProps<Record<string, unknown>>> & {\n    normalizeIncludedKeys?: boolean;\n  } = {},\n): StateComposable<Record<string, unknown>> {\n  function StateReference(callProps: Record<string, unknown>) {\n    const context = useContext(StateComposableContext);\n    if (!context) {\n      throw new LayoutConfigurationError(\n        `Render state \"${source.name}\" must be used inside a resource layout`,\n      );\n    }\n    const inherited = Object.fromEntries(\n      Object.keys(options.props?.include ?? {}).map((key) => {\n        const definition = context.definitions[key];\n        return options.normalizeIncludedKeys && typeof definition === 'function' &&\n          'type' in definition && definition.type === 'JSX.Element' ? capitalize(key) : key;\n      }).flatMap((key) =>\n        Object.prototype.hasOwnProperty.call(context.props, key) && context.props[key] !== undefined\n          ? [[key, context.props[key]]]\n          : [],\n      ),\n    );\n    return createElement(context.scope.resolve(source), {\n      ...inherited,\n      ...callProps,\n    });\n  }\n  return withStateComposable(Object.assign(StateReference, {\n    displayName: `State.${source.name}`,\n    props: undefined as unknown as Record<string, unknown>,\n  }), source) as StateComposable<Record<string, unknown>>;\n}\n\n/** @internal Keeps helper methods out of spreadable state maps. */\nexport function withStateComposable<Value extends object>(\n  value: Value,\n  source: StateComposableSource,\n): Value & { asComposable: AsStateComposable<Record<string, unknown>> } {\n  if (Object.prototype.hasOwnProperty.call(value, 'asComposable')) {\n    throw new LayoutConfigurationError(\n      'Render state name \"asComposable\" is reserved',\n    );\n  }\n  Object.defineProperty(value, 'asComposable', {\n    enumerable: false,\n    value: (options?: StateComposableOptions<Record<string, unknown>, IncludedProps<Record<string, unknown>>>) =>\n      createStateComposable(source, options),\n  });\n  return value as Value & { asComposable: AsStateComposable<Record<string, unknown>> };\n}\n\n/** @internal References are descriptors, so reading them never constructs a layout. */\nexport function createStateReferences(states: Record<string, unknown>) {\n  return Object.fromEntries(Object.entries(states).map(([name, input]) => [\n    name, createStateComposable({ input, name }),\n  ]));\n}\n"],"mappings":";;;;;;AAgEA,MAAa,kDAIE,MAAS;;AAGxB,SAAgB,sBACd,QACA,UAEI,CAAC,GACqC;CAC1C,SAAS,eAAe,WAAoC;EAC1D,MAAM,gCAAqB,sBAAsB;EACjD,IAAI,CAAC,SACH,MAAM,IAAIA,4DACR,iBAAiB,OAAO,KAAK,wCAC/B;EAEF,MAAM,YAAY,OAAO,YACvB,OAAO,KAAK,QAAQ,OAAO,WAAW,CAAC,CAAC,EAAE,KAAK,QAAQ;GACrD,MAAM,aAAa,QAAQ,YAAY;GACvC,OAAO,QAAQ,yBAAyB,OAAO,eAAe,cAC5D,UAAU,cAAc,WAAW,SAAS,gBAAgBC,8BAAW,GAAG,IAAI;EAClF,CAAC,EAAE,SAAS,QACV,OAAO,UAAU,eAAe,KAAK,QAAQ,OAAO,GAAG,KAAK,QAAQ,MAAM,SAAS,SAC/E,CAAC,CAAC,KAAK,QAAQ,MAAM,IAAI,CAAC,IAC1B,CAAC,CACP,CACF;EACA,gCAAqB,QAAQ,MAAM,QAAQ,MAAM,GAAG;GAClD,GAAG;GACH,GAAG;EACL,CAAC;CACH;CACA,OAAO,oBAAoB,OAAO,OAAO,gBAAgB;EACvD,aAAa,SAAS,OAAO;EAC7B,OAAO;CACT,CAAC,GAAG,MAAM;AACZ;;AAGA,SAAgB,oBACd,OACA,QACsE;CACtE,IAAI,OAAO,UAAU,eAAe,KAAK,OAAO,cAAc,GAC5D,MAAM,IAAID,4DACR,gDACF;CAEF,OAAO,eAAe,OAAO,gBAAgB;EAC3C,YAAY;EACZ,QAAQ,YACN,sBAAsB,QAAQ,OAAO;CACzC,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,sBAAsB,QAAiC;CACrE,OAAO,OAAO,YAAY,OAAO,QAAQ,MAAM,EAAE,KAAK,CAAC,MAAM,WAAW,CACtE,MAAM,sBAAsB;EAAE;EAAO;CAAK,CAAC,CAC7C,CAAC,CAAC;AACJ"}
+{"version":3,"file":"state-composable.cjs","names":["LayoutConfigurationError","capitalize"],"sources":["../../src/create-config/state-composable.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  useContext,\n  type ComponentType,\n  type JSX,\n} from 'react';\nimport { LayoutConfigurationError } from '../errors';\nimport type { IncludedProps } from '../props';\nimport { capitalize } from '../utils/capitalize';\n\n/** Props selected here are inherited from the containing state's render props. */\nexport type StateComposableOptions<\n  Props extends object,\n  Include extends IncludedProps<Props> = {},\n> = {\n  props?: {\n    include?: Include & { [Key in Exclude<keyof Include, keyof Props>]: never };\n  };\n};\n\ntype StateComposableCallProps<Props extends object, Carried extends keyof Props> =\n  Omit<Props, Carried> & Partial<Pick<Props, Carried>>;\n\n/** Non-enumerable state helpers; class methods stay out of object-spread types. */\nexport declare class StateComposableHandle<Props extends object> {\n  asComposable<const Include extends IncludedProps<Props> = {}>(\n    options?: StateComposableOptions<Props, Include>,\n  ): StateComposable<Props, keyof Include & keyof Props>;\n}\n\n/** A state component usable in a composables map, optionally inheriting props. */\nexport type StateComposable<\n  Props extends object,\n  Carried extends keyof Props = never,\n> = {\n  (props: StateComposableCallProps<Props, Carried>): JSX.Element;\n  displayName: string;\n  props: StateComposableCallProps<Props, Carried>;\n  asComposable: AsStateComposable<Props>;\n};\n\n/** Converts a state into a composable; unselected required props remain required. */\nexport type AsStateComposable<Props extends object> = <\n  const Include extends IncludedProps<Props> = {},\n>(\n  options?: StateComposableOptions<Props, Include>,\n) => StateComposable<Props, keyof Include & keyof Props>;\n\n/** @internal The definition is kept by identity so builder references need no registration. */\nexport type StateComposableSource = {\n  input: unknown;\n  name: string;\n  /** Fallback state that must not recursively render this reference. */\n  fallbackStateName?: string;\n};\n\nexport const stateReferenceSource = Symbol.for('@jfdevelops/react-layout/state-reference');\n\n/** @internal Shared by all states in one created resource layout. */\nexport type RenderStateScope = {\n  states: Record<string, StateComposable<Record<string, unknown>>>;\n  resolve: (source: StateComposableSource) => ComponentType<Record<string, unknown>>;\n};\n\n/** @internal Each rendered state supplies its own resolved values for carry-over. */\nexport const StateComposableContext = createContext<{\n  scope: RenderStateScope;\n  props: Record<string, unknown>;\n  definitions: Record<string, unknown>;\n} | undefined>(undefined);\n\n/** @internal Defers state resolution until render, allowing forward references. */\nexport function createStateComposable(\n  source: StateComposableSource,\n  options: StateComposableOptions<Record<string, unknown>, IncludedProps<Record<string, unknown>>> & {\n    normalizeIncludedKeys?: boolean;\n  } = {},\n): StateComposable<Record<string, unknown>> {\n  function StateReference(callProps: Record<string, unknown>) {\n    const context = useContext(StateComposableContext);\n    if (!context) {\n      throw new LayoutConfigurationError(\n        `Render state \"${source.name}\" must be used inside a resource layout`,\n      );\n    }\n    const inherited = Object.fromEntries(\n      Object.keys(options.props?.include ?? {}).map((key) => {\n        const definition = context.definitions[key];\n        return options.normalizeIncludedKeys && typeof definition === 'function' &&\n          'type' in definition && definition.type === 'JSX.Element' ? capitalize(key) : key;\n      }).flatMap((key) =>\n        Object.prototype.hasOwnProperty.call(context.props, key) && context.props[key] !== undefined\n          ? [[key, context.props[key]]]\n          : [],\n      ),\n    );\n    return createElement(context.scope.resolve(source), {\n      ...inherited,\n      ...callProps,\n    });\n  }\n  Object.defineProperty(StateReference, stateReferenceSource, { value: source });\n  return withStateComposable(Object.assign(StateReference, {\n    displayName: `State.${source.name}`,\n    props: undefined as unknown as Record<string, unknown>,\n  }), source) as StateComposable<Record<string, unknown>>;\n}\n\n/** @internal Keeps helper methods out of spreadable state maps. */\nexport function withStateComposable<Value extends object>(\n  value: Value,\n  source: StateComposableSource,\n): Value & { asComposable: AsStateComposable<Record<string, unknown>> } {\n  if (Object.prototype.hasOwnProperty.call(value, 'asComposable')) {\n    throw new LayoutConfigurationError(\n      'Render state name \"asComposable\" is reserved',\n    );\n  }\n  Object.defineProperty(value, 'asComposable', {\n    enumerable: false,\n    value: (options?: StateComposableOptions<Record<string, unknown>, IncludedProps<Record<string, unknown>>>) =>\n      createStateComposable(source, options),\n  });\n  return value as Value & { asComposable: AsStateComposable<Record<string, unknown>> };\n}\n\n/** @internal References are descriptors, so reading them never constructs a layout. */\nexport function createStateReferences(states: Record<string, unknown>) {\n  return Object.fromEntries(Object.entries(states).map(([name, input]) => [\n    name, createStateComposable({ input, name }),\n  ]));\n}\n"],"mappings":";;;;;AAyDA,MAAa,uBAAuB,OAAO,IAAI,0CAA0C;;AASzF,MAAa,kDAIE,MAAS;;AAGxB,SAAgB,sBACd,QACA,UAEI,CAAC,GACqC;CAC1C,SAAS,eAAe,WAAoC;EAC1D,MAAM,gCAAqB,sBAAsB;EACjD,IAAI,CAAC,SACH,MAAM,IAAIA,4DACR,iBAAiB,OAAO,KAAK,wCAC/B;EAEF,MAAM,YAAY,OAAO,YACvB,OAAO,KAAK,QAAQ,OAAO,WAAW,CAAC,CAAC,EAAE,KAAK,QAAQ;GACrD,MAAM,aAAa,QAAQ,YAAY;GACvC,OAAO,QAAQ,yBAAyB,OAAO,eAAe,cAC5D,UAAU,cAAc,WAAW,SAAS,gBAAgBC,8BAAW,GAAG,IAAI;EAClF,CAAC,EAAE,SAAS,QACV,OAAO,UAAU,eAAe,KAAK,QAAQ,OAAO,GAAG,KAAK,QAAQ,MAAM,SAAS,SAC/E,CAAC,CAAC,KAAK,QAAQ,MAAM,IAAI,CAAC,IAC1B,CAAC,CACP,CACF;EACA,gCAAqB,QAAQ,MAAM,QAAQ,MAAM,GAAG;GAClD,GAAG;GACH,GAAG;EACL,CAAC;CACH;CACA,OAAO,eAAe,gBAAgB,sBAAsB,EAAE,OAAO,OAAO,CAAC;CAC7E,OAAO,oBAAoB,OAAO,OAAO,gBAAgB;EACvD,aAAa,SAAS,OAAO;EAC7B,OAAO;CACT,CAAC,GAAG,MAAM;AACZ;;AAGA,SAAgB,oBACd,OACA,QACsE;CACtE,IAAI,OAAO,UAAU,eAAe,KAAK,OAAO,cAAc,GAC5D,MAAM,IAAID,4DACR,gDACF;CAEF,OAAO,eAAe,OAAO,gBAAgB;EAC3C,YAAY;EACZ,QAAQ,YACN,sBAAsB,QAAQ,OAAO;CACzC,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,sBAAsB,QAAiC;CACrE,OAAO,OAAO,YAAY,OAAO,QAAQ,MAAM,EAAE,KAAK,CAAC,MAAM,WAAW,CACtE,MAAM,sBAAsB;EAAE;EAAO;CAAK,CAAC,CAC7C,CAAC,CAAC;AACJ"}

package/dist/create-config/state-composable.mjs

@@ -3,6 +3,7 @@ import { capitalize } from "../utils/capitalize.mjs";
 import { createContext, createElement, useContext } from "react";
 
 //#region src/create-config/state-composable.ts
+const stateReferenceSource = Symbol.for("@jfdevelops/react-layout/state-reference");
 /** @internal Each rendered state supplies its own resolved values for carry-over. */
 const StateComposableContext = createContext(void 0);
 /** @internal Defers state resolution until render, allowing forward references. */
@@ -19,6 +20,7 @@ function createStateComposable(source, options = {}) {
 			...callProps
 		});
 	}
+	Object.defineProperty(StateReference, stateReferenceSource, { value: source });
 	return withStateComposable(Object.assign(StateReference, {
 		displayName: `State.${source.name}`,
 		props: void 0
@@ -42,5 +44,5 @@ function createStateReferences(states) {
 }
 
 //#endregion
-export { StateComposableContext, createStateComposable, createStateReferences, withStateComposable };
+export { StateComposableContext, createStateComposable, createStateReferences, stateReferenceSource, withStateComposable };
 //# sourceMappingURL=state-composable.mjs.map

package/dist/create-config/state-composable.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"state-composable.mjs","names":[],"sources":["../../src/create-config/state-composable.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  useContext,\n  type ComponentType,\n  type JSX,\n} from 'react';\nimport { LayoutConfigurationError } from '../errors';\nimport type { IncludedProps } from '../props';\nimport { capitalize } from '../utils/capitalize';\n\n/** Props selected here are inherited from the containing state's render props. */\nexport type StateComposableOptions<\n  Props extends object,\n  Include extends IncludedProps<Props> = {},\n> = {\n  props?: {\n    include?: Include & { [Key in Exclude<keyof Include, keyof Props>]: never };\n  };\n};\n\ntype StateComposableCallProps<Props extends object, Carried extends keyof Props> =\n  Omit<Props, Carried> & Partial<Pick<Props, Carried>>;\n\n/** Non-enumerable state helpers; class methods stay out of object-spread types. */\nexport declare class StateComposableHandle<Props extends object> {\n  asComposable<const Include extends IncludedProps<Props> = {}>(\n    options?: StateComposableOptions<Props, Include>,\n  ): StateComposable<Props, keyof Include & keyof Props>;\n}\n\n/** A state component usable in a composables map, optionally inheriting props. */\nexport type StateComposable<\n  Props extends object,\n  Carried extends keyof Props = never,\n> = {\n  (props: StateComposableCallProps<Props, Carried>): JSX.Element;\n  displayName: string;\n  props: StateComposableCallProps<Props, Carried>;\n  asComposable: AsStateComposable<Props>;\n};\n\n/** Converts a state into a composable; unselected required props remain required. */\nexport type AsStateComposable<Props extends object> = <\n  const Include extends IncludedProps<Props> = {},\n>(\n  options?: StateComposableOptions<Props, Include>,\n) => StateComposable<Props, keyof Include & keyof Props>;\n\n/** @internal The definition is kept by identity so builder references need no registration. */\nexport type StateComposableSource = {\n  input: unknown;\n  name: string;\n  /** Fallback state that must not recursively render this reference. */\n  fallbackStateName?: string;\n};\n\n/** @internal Shared by all states in one created resource layout. */\nexport type RenderStateScope = {\n  states: Record<string, StateComposable<Record<string, unknown>>>;\n  resolve: (source: StateComposableSource) => ComponentType<Record<string, unknown>>;\n};\n\n/** @internal Each rendered state supplies its own resolved values for carry-over. */\nexport const StateComposableContext = createContext<{\n  scope: RenderStateScope;\n  props: Record<string, unknown>;\n  definitions: Record<string, unknown>;\n} | undefined>(undefined);\n\n/** @internal Defers state resolution until render, allowing forward references. */\nexport function createStateComposable(\n  source: StateComposableSource,\n  options: StateComposableOptions<Record<string, unknown>, IncludedProps<Record<string, unknown>>> & {\n    normalizeIncludedKeys?: boolean;\n  } = {},\n): StateComposable<Record<string, unknown>> {\n  function StateReference(callProps: Record<string, unknown>) {\n    const context = useContext(StateComposableContext);\n    if (!context) {\n      throw new LayoutConfigurationError(\n        `Render state \"${source.name}\" must be used inside a resource layout`,\n      );\n    }\n    const inherited = Object.fromEntries(\n      Object.keys(options.props?.include ?? {}).map((key) => {\n        const definition = context.definitions[key];\n        return options.normalizeIncludedKeys && typeof definition === 'function' &&\n          'type' in definition && definition.type === 'JSX.Element' ? capitalize(key) : key;\n      }).flatMap((key) =>\n        Object.prototype.hasOwnProperty.call(context.props, key) && context.props[key] !== undefined\n          ? [[key, context.props[key]]]\n          : [],\n      ),\n    );\n    return createElement(context.scope.resolve(source), {\n      ...inherited,\n      ...callProps,\n    });\n  }\n  return withStateComposable(Object.assign(StateReference, {\n    displayName: `State.${source.name}`,\n    props: undefined as unknown as Record<string, unknown>,\n  }), source) as StateComposable<Record<string, unknown>>;\n}\n\n/** @internal Keeps helper methods out of spreadable state maps. */\nexport function withStateComposable<Value extends object>(\n  value: Value,\n  source: StateComposableSource,\n): Value & { asComposable: AsStateComposable<Record<string, unknown>> } {\n  if (Object.prototype.hasOwnProperty.call(value, 'asComposable')) {\n    throw new LayoutConfigurationError(\n      'Render state name \"asComposable\" is reserved',\n    );\n  }\n  Object.defineProperty(value, 'asComposable', {\n    enumerable: false,\n    value: (options?: StateComposableOptions<Record<string, unknown>, IncludedProps<Record<string, unknown>>>) =>\n      createStateComposable(source, options),\n  });\n  return value as Value & { asComposable: AsStateComposable<Record<string, unknown>> };\n}\n\n/** @internal References are descriptors, so reading them never constructs a layout. */\nexport function createStateReferences(states: Record<string, unknown>) {\n  return Object.fromEntries(Object.entries(states).map(([name, input]) => [\n    name, createStateComposable({ input, name }),\n  ]));\n}\n"],"mappings":";;;;;;AAgEA,MAAa,yBAAyB,cAIvB,MAAS;;AAGxB,SAAgB,sBACd,QACA,UAEI,CAAC,GACqC;CAC1C,SAAS,eAAe,WAAoC;EAC1D,MAAM,UAAU,WAAW,sBAAsB;EACjD,IAAI,CAAC,SACH,MAAM,IAAI,yBACR,iBAAiB,OAAO,KAAK,wCAC/B;EAEF,MAAM,YAAY,OAAO,YACvB,OAAO,KAAK,QAAQ,OAAO,WAAW,CAAC,CAAC,EAAE,KAAK,QAAQ;GACrD,MAAM,aAAa,QAAQ,YAAY;GACvC,OAAO,QAAQ,yBAAyB,OAAO,eAAe,cAC5D,UAAU,cAAc,WAAW,SAAS,gBAAgB,WAAW,GAAG,IAAI;EAClF,CAAC,EAAE,SAAS,QACV,OAAO,UAAU,eAAe,KAAK,QAAQ,OAAO,GAAG,KAAK,QAAQ,MAAM,SAAS,SAC/E,CAAC,CAAC,KAAK,QAAQ,MAAM,IAAI,CAAC,IAC1B,CAAC,CACP,CACF;EACA,OAAO,cAAc,QAAQ,MAAM,QAAQ,MAAM,GAAG;GAClD,GAAG;GACH,GAAG;EACL,CAAC;CACH;CACA,OAAO,oBAAoB,OAAO,OAAO,gBAAgB;EACvD,aAAa,SAAS,OAAO;EAC7B,OAAO;CACT,CAAC,GAAG,MAAM;AACZ;;AAGA,SAAgB,oBACd,OACA,QACsE;CACtE,IAAI,OAAO,UAAU,eAAe,KAAK,OAAO,cAAc,GAC5D,MAAM,IAAI,yBACR,gDACF;CAEF,OAAO,eAAe,OAAO,gBAAgB;EAC3C,YAAY;EACZ,QAAQ,YACN,sBAAsB,QAAQ,OAAO;CACzC,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,sBAAsB,QAAiC;CACrE,OAAO,OAAO,YAAY,OAAO,QAAQ,MAAM,EAAE,KAAK,CAAC,MAAM,WAAW,CACtE,MAAM,sBAAsB;EAAE;EAAO;CAAK,CAAC,CAC7C,CAAC,CAAC;AACJ"}
+{"version":3,"file":"state-composable.mjs","names":[],"sources":["../../src/create-config/state-composable.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  useContext,\n  type ComponentType,\n  type JSX,\n} from 'react';\nimport { LayoutConfigurationError } from '../errors';\nimport type { IncludedProps } from '../props';\nimport { capitalize } from '../utils/capitalize';\n\n/** Props selected here are inherited from the containing state's render props. */\nexport type StateComposableOptions<\n  Props extends object,\n  Include extends IncludedProps<Props> = {},\n> = {\n  props?: {\n    include?: Include & { [Key in Exclude<keyof Include, keyof Props>]: never };\n  };\n};\n\ntype StateComposableCallProps<Props extends object, Carried extends keyof Props> =\n  Omit<Props, Carried> & Partial<Pick<Props, Carried>>;\n\n/** Non-enumerable state helpers; class methods stay out of object-spread types. */\nexport declare class StateComposableHandle<Props extends object> {\n  asComposable<const Include extends IncludedProps<Props> = {}>(\n    options?: StateComposableOptions<Props, Include>,\n  ): StateComposable<Props, keyof Include & keyof Props>;\n}\n\n/** A state component usable in a composables map, optionally inheriting props. */\nexport type StateComposable<\n  Props extends object,\n  Carried extends keyof Props = never,\n> = {\n  (props: StateComposableCallProps<Props, Carried>): JSX.Element;\n  displayName: string;\n  props: StateComposableCallProps<Props, Carried>;\n  asComposable: AsStateComposable<Props>;\n};\n\n/** Converts a state into a composable; unselected required props remain required. */\nexport type AsStateComposable<Props extends object> = <\n  const Include extends IncludedProps<Props> = {},\n>(\n  options?: StateComposableOptions<Props, Include>,\n) => StateComposable<Props, keyof Include & keyof Props>;\n\n/** @internal The definition is kept by identity so builder references need no registration. */\nexport type StateComposableSource = {\n  input: unknown;\n  name: string;\n  /** Fallback state that must not recursively render this reference. */\n  fallbackStateName?: string;\n};\n\nexport const stateReferenceSource = Symbol.for('@jfdevelops/react-layout/state-reference');\n\n/** @internal Shared by all states in one created resource layout. */\nexport type RenderStateScope = {\n  states: Record<string, StateComposable<Record<string, unknown>>>;\n  resolve: (source: StateComposableSource) => ComponentType<Record<string, unknown>>;\n};\n\n/** @internal Each rendered state supplies its own resolved values for carry-over. */\nexport const StateComposableContext = createContext<{\n  scope: RenderStateScope;\n  props: Record<string, unknown>;\n  definitions: Record<string, unknown>;\n} | undefined>(undefined);\n\n/** @internal Defers state resolution until render, allowing forward references. */\nexport function createStateComposable(\n  source: StateComposableSource,\n  options: StateComposableOptions<Record<string, unknown>, IncludedProps<Record<string, unknown>>> & {\n    normalizeIncludedKeys?: boolean;\n  } = {},\n): StateComposable<Record<string, unknown>> {\n  function StateReference(callProps: Record<string, unknown>) {\n    const context = useContext(StateComposableContext);\n    if (!context) {\n      throw new LayoutConfigurationError(\n        `Render state \"${source.name}\" must be used inside a resource layout`,\n      );\n    }\n    const inherited = Object.fromEntries(\n      Object.keys(options.props?.include ?? {}).map((key) => {\n        const definition = context.definitions[key];\n        return options.normalizeIncludedKeys && typeof definition === 'function' &&\n          'type' in definition && definition.type === 'JSX.Element' ? capitalize(key) : key;\n      }).flatMap((key) =>\n        Object.prototype.hasOwnProperty.call(context.props, key) && context.props[key] !== undefined\n          ? [[key, context.props[key]]]\n          : [],\n      ),\n    );\n    return createElement(context.scope.resolve(source), {\n      ...inherited,\n      ...callProps,\n    });\n  }\n  Object.defineProperty(StateReference, stateReferenceSource, { value: source });\n  return withStateComposable(Object.assign(StateReference, {\n    displayName: `State.${source.name}`,\n    props: undefined as unknown as Record<string, unknown>,\n  }), source) as StateComposable<Record<string, unknown>>;\n}\n\n/** @internal Keeps helper methods out of spreadable state maps. */\nexport function withStateComposable<Value extends object>(\n  value: Value,\n  source: StateComposableSource,\n): Value & { asComposable: AsStateComposable<Record<string, unknown>> } {\n  if (Object.prototype.hasOwnProperty.call(value, 'asComposable')) {\n    throw new LayoutConfigurationError(\n      'Render state name \"asComposable\" is reserved',\n    );\n  }\n  Object.defineProperty(value, 'asComposable', {\n    enumerable: false,\n    value: (options?: StateComposableOptions<Record<string, unknown>, IncludedProps<Record<string, unknown>>>) =>\n      createStateComposable(source, options),\n  });\n  return value as Value & { asComposable: AsStateComposable<Record<string, unknown>> };\n}\n\n/** @internal References are descriptors, so reading them never constructs a layout. */\nexport function createStateReferences(states: Record<string, unknown>) {\n  return Object.fromEntries(Object.entries(states).map(([name, input]) => [\n    name, createStateComposable({ input, name }),\n  ]));\n}\n"],"mappings":";;;;;AAyDA,MAAa,uBAAuB,OAAO,IAAI,0CAA0C;;AASzF,MAAa,yBAAyB,cAIvB,MAAS;;AAGxB,SAAgB,sBACd,QACA,UAEI,CAAC,GACqC;CAC1C,SAAS,eAAe,WAAoC;EAC1D,MAAM,UAAU,WAAW,sBAAsB;EACjD,IAAI,CAAC,SACH,MAAM,IAAI,yBACR,iBAAiB,OAAO,KAAK,wCAC/B;EAEF,MAAM,YAAY,OAAO,YACvB,OAAO,KAAK,QAAQ,OAAO,WAAW,CAAC,CAAC,EAAE,KAAK,QAAQ;GACrD,MAAM,aAAa,QAAQ,YAAY;GACvC,OAAO,QAAQ,yBAAyB,OAAO,eAAe,cAC5D,UAAU,cAAc,WAAW,SAAS,gBAAgB,WAAW,GAAG,IAAI;EAClF,CAAC,EAAE,SAAS,QACV,OAAO,UAAU,eAAe,KAAK,QAAQ,OAAO,GAAG,KAAK,QAAQ,MAAM,SAAS,SAC/E,CAAC,CAAC,KAAK,QAAQ,MAAM,IAAI,CAAC,IAC1B,CAAC,CACP,CACF;EACA,OAAO,cAAc,QAAQ,MAAM,QAAQ,MAAM,GAAG;GAClD,GAAG;GACH,GAAG;EACL,CAAC;CACH;CACA,OAAO,eAAe,gBAAgB,sBAAsB,EAAE,OAAO,OAAO,CAAC;CAC7E,OAAO,oBAAoB,OAAO,OAAO,gBAAgB;EACvD,aAAa,SAAS,OAAO;EAC7B,OAAO;CACT,CAAC,GAAG,MAAM;AACZ;;AAGA,SAAgB,oBACd,OACA,QACsE;CACtE,IAAI,OAAO,UAAU,eAAe,KAAK,OAAO,cAAc,GAC5D,MAAM,IAAI,yBACR,gDACF;CAEF,OAAO,eAAe,OAAO,gBAAgB;EAC3C,YAAY;EACZ,QAAQ,YACN,sBAAsB,QAAQ,OAAO;CACzC,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,sBAAsB,QAAiC;CACrE,OAAO,OAAO,YAAY,OAAO,QAAQ,MAAM,EAAE,KAAK,CAAC,MAAM,WAAW,CACtE,MAAM,sBAAsB;EAAE;EAAO;CAAK,CAAC,CAC7C,CAAC,CAAC;AACJ"}

package/dist/index.cjs

@@ -9,10 +9,12 @@ const require_missing_path_variable = require('./errors/missing-path-variable.cj
 const require_missing_resource_provider = require('./errors/missing-resource-provider.cjs');
 const require_layout_configuration_error = require('./errors/layout-configuration-error.cjs');
 const require_resource_state_error = require('./errors/resource-state-error.cjs');
+const require_preview = require('./create-config/preview.cjs');
 const require_resource = require('./resource.cjs');
 const require_utils = require('./utils.cjs');
 const require_define_layout = require('./create-config/define-layout.cjs');
 const require_create_defined_resource_layout = require('./create-config/create-defined-resource-layout.cjs');
+const require_layout_name = require('./create-config/layout-name.cjs');
 let _jfdevelops_react_layout_composables = require("@jfdevelops/react-layout-composables");
 let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-validator");
 
@@ -76,6 +78,8 @@ Object.defineProperty(exports, 'defineComposableComponent', {
     return _jfdevelops_react_layout_composables.defineComposableComponent;
   }
 });
+exports.defineLayoutName = require_layout_name.defineLayoutName;
+exports.defineLayoutPreview = require_preview.defineLayoutPreview;
 exports.defineResourceLayout = require_define_layout.defineResourceLayout;
 Object.defineProperty(exports, 'isPropDefinitionShape', {
   enumerable: true,

package/dist/index.d.cts

@@ -3,6 +3,7 @@ import { LayoutResourceKey, NormalizeResource, NormalizeResources, NormalizedRes
 import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.cjs";
 import { AsStateComposable, StateComposable, StateComposableOptions } from "./create-config/state-composable.cjs";
 import { AnyRenderStateDefinition, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, CreateRenderStateFromState, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallProps, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateName, RenderStateOverloads, RenderStateProps, RenderStateReferences, TypedRenderStateCallback } from "./create-config/render-state.cjs";
+import { LayoutNameContext, LayoutNameInput, LayoutNameParts, LayoutNameResolver, ResolvedLayoutName, defineLayoutName } from "./create-config/layout-name.cjs";
 import { ParameterizedResourcePath, PathVariables } from "./create-config/paths/types.cjs";
 import { CreateGetComponentForPath, GetComponentForPath, ResolvedPathValue } from "./create-config/for-paths/get-component-for-path.cjs";
 import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./create-config/for-paths/builder.cjs";
@@ -13,6 +14,7 @@ import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResour
 import { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates } from "./create-config/lazy-resource-layout.cjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.cjs";
 import { ResourceLayoutShellPublisher } from "./create-config/shell-context.cjs";
+import { LayoutPreviewProps, defineLayoutPreview } from "./create-config/preview.cjs";
 import { ReactLayoutError } from "./errors/react-layout-error.cjs";
 import { InvalidConfigContext, InvalidConfigError } from "./errors/invalid-config.cjs";
 import { InvalidPathContext, InvalidPathError } from "./errors/invalid-path.cjs";
@@ -25,4 +27,4 @@ import { LayoutConfigurationError, LayoutConfigurationErrorContext } from "./err
 import { ResourceModuleLoadError, ResourceRenderError, ResourceStateError } from "./errors/resource-state-error.cjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyRenderState, type LazyResourceErrorComponent, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, type LazyResourceStates, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutNameContext, type LayoutNameInput, type LayoutNameParts, type LayoutNameResolver, type LayoutPreviewProps, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyRenderState, type LazyResourceErrorComponent, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, type LazyResourceStates, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedLayoutName, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/index.d.mts

@@ -3,6 +3,7 @@ import { LayoutResourceKey, NormalizeResource, NormalizeResources, NormalizedRes
 import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedComponentPropDefinitions, IncludedPropBehavior, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedComponentProps, ResolvedIncludedConfigProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.mjs";
 import { AsStateComposable, StateComposable, StateComposableOptions } from "./create-config/state-composable.mjs";
 import { AnyRenderStateDefinition, CreateLayoutBuildingBlocks, CreateLayoutBuildingBlocksArguments, CreateLayoutBuildingBlocksResult, CreateRenderState, CreateRenderStateBuilderArguments, CreateRenderStateBuilderResult, CreateRenderStateFromState, DeferredRenderState, DefineLayoutComposables, LayoutComposablesDefinition, LazyRenderState, RenderStateCallProps, RenderStateCallback, RenderStateComposablesDefinition, RenderStateContext, RenderStateFragment, RenderStateName, RenderStateOverloads, RenderStateProps, RenderStateReferences, TypedRenderStateCallback } from "./create-config/render-state.mjs";
+import { LayoutNameContext, LayoutNameInput, LayoutNameParts, LayoutNameResolver, ResolvedLayoutName, defineLayoutName } from "./create-config/layout-name.mjs";
 import { ParameterizedResourcePath, PathVariables } from "./create-config/paths/types.mjs";
 import { CreateGetComponentForPath, GetComponentForPath, ResolvedPathValue } from "./create-config/for-paths/get-component-for-path.mjs";
 import { ForPaths, ForPathsRenderContext, RenderedPathComponent, RenderedPathComponentHOF, TargetPathBuilder } from "./create-config/for-paths/builder.mjs";
@@ -13,6 +14,7 @@ import { ContextualInlineRenderState, ContextualInlineRenderStates, CreateResour
 import { LazyResourceErrorComponent, LazyResourceLayoutComponent, LazyResourceLayoutOptions, LazyResourceLoadingComponent, LazyResourceStates } from "./create-config/lazy-resource-layout.mjs";
 import { BoundDefineResourceLayout, CreateDefinedResourceLayoutOptions, CreateDefinedResourceLayoutResult, DefineLazyDefaults, DefinedResourceLayoutInput, NonEmptyResources, createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.mjs";
 import { ResourceLayoutShellPublisher } from "./create-config/shell-context.mjs";
+import { LayoutPreviewProps, defineLayoutPreview } from "./create-config/preview.mjs";
 import { ReactLayoutError } from "./errors/react-layout-error.mjs";
 import { InvalidConfigContext, InvalidConfigError } from "./errors/invalid-config.mjs";
 import { InvalidPathContext, InvalidPathError } from "./errors/invalid-path.mjs";
@@ -25,4 +27,4 @@ import { LayoutConfigurationError, LayoutConfigurationErrorContext } from "./err
 import { ResourceModuleLoadError, ResourceRenderError, ResourceStateError } from "./errors/resource-state-error.mjs";
 import { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { AnyBuiltPropDefinition, ExtractDefinitionValue, PropError, PropErrorOptions, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyRenderState, type LazyResourceErrorComponent, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, type LazyResourceStates, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type AnyRenderStateDefinition, type AsStateComposable, type BaseComponent, type BoundDefineResourceLayout, type ComponentTypes, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type ContextualInlineRenderState, type ContextualInlineRenderStates, type CreateDefinedResourceLayoutOptions, type CreateDefinedResourceLayoutResult, type CreateGetComponentForPath, type CreateLayoutBuildingBlocks, type CreateLayoutBuildingBlocksArguments, type CreateLayoutBuildingBlocksResult, type CreateLayoutComposable, type CreateRenderState, type CreateRenderStateBuilderArguments, type CreateRenderStateBuilderResult, type CreateRenderStateFromState, type CreateResourceConfigFn, type CreateResourceConfigForResource, type CreateResourceLayoutWithLayoutOptions, type CreateResourceMap, type CreateResourceMapFn, type CreateViewMapBuiltInRenderStatesOptions, type CreateViewMapFunctionRenderOptions, type CreateViewMapInlineRenderStatesOptions, type CreateViewMapRenderStatesOptions, type CreatedResourceConfig, type DeferredRenderState, type DefineLayoutComposables, type DefineLazyDefaults, type DefineResourceLayoutWithLayoutFn, type DefineResourcesFn, type DefinedComposableComponentRecord, type DefinedResourceLayoutInput, type DefinedResourceLayoutWithShell, type ExtractDefinitionValue, type ForPaths, type ForPathsRenderContext, type GetComponentForPath, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedComponentPropDefinitions, type IncludedPropBehavior, type IncludedProps, type InferredInProps, type InvalidComponentContext, InvalidComponentError, type InvalidConfigContext, InvalidConfigError, type InvalidPathContext, InvalidPathError, type InvalidResourceContext, InvalidResourceError, type InvalidSubResourceContext, InvalidSubResourceError, type IsSubResourceKey, LayoutComposablePresetProvider, type LayoutComposablesDefinition, type LayoutComposablesFactory, LayoutConfigurationError, type LayoutConfigurationErrorContext, type LayoutNameContext, type LayoutNameInput, type LayoutNameParts, type LayoutNameResolver, type LayoutPreviewProps, type LayoutRenderProps, type LayoutRenderResourcesAccessor, type LayoutResourceKey, type LayoutResourcesAccessor, type LazyRenderState, type LazyResourceErrorComponent, type LazyResourceLayoutComponent, type LazyResourceLayoutOptions, type LazyResourceLoadingComponent, type LazyResourceStates, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type MissingPathVariableContext, MissingPathVariableError, MissingResourceProviderError, type NonEmptyResources, type NormalizeResource, type NormalizeResources, type NormalizedResourceDefinition, type NormalizedResourceDefinitions, type ParameterizedResourcePath, type PathVariables, type PresetPropsFromComposable, PropError, type PropErrorOptions, type PropsContextRender, type PropsRenderDefinition, ReactLayoutError, type RenderStateCallProps, type RenderStateCallback, type RenderStateComposablesDefinition, type RenderStateContext, type RenderStateFragment, type RenderStateName, type RenderStateOverloads, type RenderStateProps, type RenderStateReferences, type RenderedPathComponent, type RenderedPathComponentHOF, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedComponentProps, type ResolvedIncludedConfigProps, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResolvedLayoutName, type ResolvedPathValue, type ResourceConfigFragment, type ResourceDefinition, type ResourceDefinitionValue, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceLayoutProvider, type ResourceLayoutProviderProps, type ResourceLayoutShellComponent, type ResourceLayoutShellProps, type ResourceLayoutShellPublisher, ResourceModuleLoadError, type ResourcePath, ResourceRenderError, type ResourceSelection, type ResourceStateError, type ResourceTree, type ShellLayoutDefinition, type ShellRenderContext, type Show, type StateComposable, type StateComposableOptions, type TargetPathBuilder, type TypedBuiltInRenderStates, type TypedInlineRenderState, type TypedRenderStateCallback, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/index.mjs

@@ -8,11 +8,13 @@ import { MissingPathVariableError } from "./errors/missing-path-variable.mjs";
 import { MissingResourceProviderError } from "./errors/missing-resource-provider.mjs";
 import { LayoutConfigurationError } from "./errors/layout-configuration-error.mjs";
 import { ResourceModuleLoadError, ResourceRenderError } from "./errors/resource-state-error.mjs";
+import { defineLayoutPreview } from "./create-config/preview.mjs";
 import { normalizeResource, normalizeResourceDefinitions, normalizeResources, toResourceEnum } from "./resource.mjs";
 import { pick } from "./utils.mjs";
 import { defineResourceLayout } from "./create-config/define-layout.mjs";
 import { createDefinedResourceLayout } from "./create-config/create-defined-resource-layout.mjs";
+import { defineLayoutName } from "./create-config/layout-name.mjs";
 import { LayoutComposablePresetProvider, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables } from "@jfdevelops/react-layout-composables";
 import { PropError, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
 
-export { InvalidComponentError, InvalidConfigError, InvalidPathError, InvalidResourceError, InvalidSubResourceError, LayoutComposablePresetProvider, LayoutConfigurationError, MissingPathVariableError, MissingResourceProviderError, PropError, ReactLayoutError, ResourceModuleLoadError, ResourceRenderError, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { InvalidComponentError, InvalidConfigError, InvalidPathError, InvalidResourceError, InvalidSubResourceError, LayoutComposablePresetProvider, LayoutConfigurationError, MissingPathVariableError, MissingResourceProviderError, PropError, ReactLayoutError, ResourceModuleLoadError, ResourceRenderError, collectComposablePresetEntries, createComposableComponent, createDefinedResourceLayout, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineLayoutName, defineLayoutPreview, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResourceDefinitions, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/utils/capitalize.d.cts

@@ -0,0 +1,6 @@
+//#region src/utils/capitalize.d.ts
+declare function capitalize<T extends string>(str: T): Capitalize<T>;
+declare function capitalize(str: string): string;
+//#endregion
+export { capitalize };
+//# sourceMappingURL=capitalize.d.cts.map

package/dist/utils/capitalize.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.d.cts","names":[],"sources":["../../src/utils/capitalize.ts"],"mappings":";iBAEgB,UAAA,mBAA6B,GAAA,EAAK,CAAA,GAAI,UAAA,CAAW,CAAA;AAAA,iBACjD,UAAA,CAAW,GAAW"}

package/dist/utils/capitalize.d.mts

@@ -0,0 +1,6 @@
+//#region src/utils/capitalize.d.ts
+declare function capitalize<T extends string>(str: T): Capitalize<T>;
+declare function capitalize(str: string): string;
+//#endregion
+export { capitalize };
+//# sourceMappingURL=capitalize.d.mts.map

package/dist/utils/capitalize.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.d.mts","names":[],"sources":["../../src/utils/capitalize.ts"],"mappings":";iBAEgB,UAAA,mBAA6B,GAAA,EAAK,CAAA,GAAI,UAAA,CAAW,CAAA;AAAA,iBACjD,UAAA,CAAW,GAAW"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jfdevelops/react-layout",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "A React library for creating layout components.",
   "repository": {
     "type": "git",
@@ -29,7 +29,8 @@
   "dependencies": {
     "@jfdevelops/create-error": "0.2.0",
     "arktype": "2.2.8",
-    "@jfdevelops/react-layout-composables": "0.2.8",
+    "@jfdevelops/react-layout-composables": "0.3.0",
+    "@jfdevelops/react-layout-devtools-core": "0.2.0",
     "@jfdevelops/react-layout-validator": "0.3.0"
   },
   "peerDependencies": {
@@ -59,13 +60,13 @@
     "vitest": "4.1.5"
   },
   "scripts": {
-    "dev": "vite",
+    "dev": "portless react-layout vite",
     "build": "tsdown",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
-    "preview": "vite preview"
+    "preview": "portless react-layout vite preview"
   }
 }