@jfdevelops/react-layout 0.15.1 → 0.17.0

package/dist/create-config/for-resources/scoped-render.mjs

@@ -0,0 +1,100 @@
+import { createElement, isValidElement } from "react";
+
+//#region src/create-config/for-resources/scoped-render.ts
+/**
+* Names a scoped component cannot use. Scoped components are attached to
+* function objects, so they collide with the component's own statics and with
+* non-writable `Function.prototype` properties. `__proto__` is reserved so
+* assignment cannot hit the prototype setter on a normal object.
+*/
+const reservedScopedComponentNames = new Set([
+	"__proto__",
+	"apply",
+	"arguments",
+	"bind",
+	"call",
+	"caller",
+	"displayName",
+	"length",
+	"name",
+	"props",
+	"prototype",
+	"resource"
+]);
+/**
+* `$$typeof` tags for object component wrappers that `createElement` accepts
+* as `type` (forwardRef, memo, lazy).
+*
+* Do not treat "any object with `$$typeof`" as a component: portals also have
+* `$$typeof` (`Symbol.for('react.portal')`) and `isValidElement(portal)` is
+* false, so a naive check would mis-classify them.
+*/
+const reactForwardRefType = Symbol.for("react.forward_ref");
+const reactMemoType = Symbol.for("react.memo");
+const reactLazyType = Symbol.for("react.lazy");
+/**
+* True when `value` can be passed as the `type` argument to `createElement`.
+*
+* Functions always qualify. Object wrappers qualify only for the forwardRef /
+* memo / lazy tags above — not portals or other React nodes that happen to
+* carry `$$typeof`.
+*/
+function isRenderableComponentType(value) {
+	if (typeof value === "function") return true;
+	if (typeof value !== "object" || value === null || Array.isArray(value) || isValidElement(value) || !("$$typeof" in value)) return false;
+	const typeTag = value.$$typeof;
+	return typeTag === reactForwardRefType || typeTag === reactMemoType || typeTag === reactLazyType;
+}
+/**
+* If `render` returned a component type, mount it with `props`; otherwise
+* return the node as-is (elements, portals, null, etc.).
+*/
+function resolveScopedRenderResult(result, props = {}) {
+	if (isRenderableComponentType(result)) return createElement(result, props);
+	return result;
+}
+/**
+* Runtime counterpart of `ScopedComponentCompoundStaticKey` — keys that must
+* not be treated as compound component statics on a scoped wrapper.
+*/
+const reservedScopedCompoundStaticKeys = new Set([
+	"apply",
+	"arguments",
+	"bind",
+	"call",
+	"caller",
+	"childContextTypes",
+	"contextTypes",
+	"defaultProps",
+	"displayName",
+	"length",
+	"name",
+	"propTypes",
+	"prototype",
+	"toLocaleString",
+	"toString",
+	"valueOf",
+	"$$typeof"
+]);
+/**
+* Exposes compound statics (e.g. `DataTable.Loading`) on a scoped wrapper so
+* runtime matches `ScopedComponentCompoundStatics`.
+*
+* Why a Proxy: JSX reads `components.DataTable.Loading` while building the
+* element tree — before `DataTable` itself renders — so statics cannot be
+* copied only after the first `render` call. Property access lazily creates a
+* stable wrapper component that re-runs the scoped `render` under context and
+* mounts the matching static from the returned component type.
+*/
+function withScopedCompoundStatics(wrapper, createCompoundStatic) {
+	return new Proxy(wrapper, { get(target, property, receiver) {
+		if (typeof property === "symbol" || reservedScopedCompoundStaticKeys.has(property) || property in target) return Reflect.get(target, property, receiver);
+		const CompoundStatic = createCompoundStatic(property);
+		target[property] = CompoundStatic;
+		return CompoundStatic;
+	} });
+}
+
+//#endregion
+export { isRenderableComponentType, reservedScopedComponentNames, resolveScopedRenderResult, withScopedCompoundStatics };
+//# sourceMappingURL=scoped-render.mjs.map

package/dist/create-config/for-resources/scoped-render.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-render.mjs","names":[],"sources":["../../../src/create-config/for-resources/scoped-render.ts"],"sourcesContent":["import {\n  createElement,\n  isValidElement,\n  type ComponentType,\n  type JSX,\n  type ReactNode,\n} from 'react';\n\n/**\n * Names a scoped component cannot use. Scoped components are attached to\n * function objects, so they collide with the component's own statics and with\n * non-writable `Function.prototype` properties. `__proto__` is reserved so\n * assignment cannot hit the prototype setter on a normal object.\n */\nexport const reservedScopedComponentNames = new Set([\n  '__proto__',\n  'apply',\n  'arguments',\n  'bind',\n  'call',\n  'caller',\n  'displayName',\n  'length',\n  'name',\n  'props',\n  'prototype',\n  'resource',\n]);\n\n/**\n * Values a createComponent / scoped-component `render` may return.\n *\n * Alongside rendered nodes, a component type is allowed — the type constituent\n * of a React element — so factories like `createDataTable(columns)` can be\n * returned directly and mounted with the call-site props.\n *\n * At runtime, `resolveScopedRenderResult` distinguishes component types from\n * nodes (including portals). Getting that wrong mounts a portal via\n * `createElement` and blows up with an invalid-element-type error.\n */\n// Returned components declare their own props; a concrete props parameter would\n// be contravariant and reject the factories callers actually return.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- see above\nexport type ScopedRenderResult = ReactNode | ComponentType<any>;\n\n/**\n * `$$typeof` tags for object component wrappers that `createElement` accepts\n * as `type` (forwardRef, memo, lazy).\n *\n * Do not treat \"any object with `$$typeof`\" as a component: portals also have\n * `$$typeof` (`Symbol.for('react.portal')`) and `isValidElement(portal)` is\n * false, so a naive check would mis-classify them.\n */\nconst reactForwardRefType = Symbol.for('react.forward_ref');\nconst reactMemoType = Symbol.for('react.memo');\nconst reactLazyType = Symbol.for('react.lazy');\n\n/**\n * True when `value` can be passed as the `type` argument to `createElement`.\n *\n * Functions always qualify. Object wrappers qualify only for the forwardRef /\n * memo / lazy tags above — not portals or other React nodes that happen to\n * carry `$$typeof`.\n */\nexport function isRenderableComponentType(\n  value: unknown,\n): value is ComponentType<Record<string, unknown>> {\n  if (typeof value === 'function') {\n    return true;\n  }\n\n  if (\n    typeof value !== 'object' ||\n    value === null ||\n    Array.isArray(value) ||\n    isValidElement(value) ||\n    !('$$typeof' in value)\n  ) {\n    return false;\n  }\n\n  const typeTag = (value as { $$typeof: unknown }).$$typeof;\n\n  return (\n    typeTag === reactForwardRefType ||\n    typeTag === reactMemoType ||\n    typeTag === reactLazyType\n  );\n}\n\n/**\n * If `render` returned a component type, mount it with `props`; otherwise\n * return the node as-is (elements, portals, null, etc.).\n */\nexport function resolveScopedRenderResult(\n  result: ScopedRenderResult,\n  props: Record<string, unknown> = {},\n): JSX.Element {\n  if (isRenderableComponentType(result)) {\n    return createElement(result, props);\n  }\n\n  return result as JSX.Element;\n}\n\n/**\n * Runtime counterpart of `ScopedComponentCompoundStaticKey` — keys that must\n * not be treated as compound component statics on a scoped wrapper.\n */\nconst reservedScopedCompoundStaticKeys = new Set<PropertyKey>([\n  'apply',\n  'arguments',\n  'bind',\n  'call',\n  'caller',\n  'childContextTypes',\n  'contextTypes',\n  'defaultProps',\n  'displayName',\n  'length',\n  'name',\n  'propTypes',\n  'prototype',\n  'toLocaleString',\n  'toString',\n  'valueOf',\n  '$$typeof',\n]);\n\ntype ScopedComponentWrapper = ((\n  props?: Record<string, unknown>,\n) => JSX.Element) &\n  Record<string, unknown>;\n\n/**\n * Exposes compound statics (e.g. `DataTable.Loading`) on a scoped wrapper so\n * runtime matches `ScopedComponentCompoundStatics`.\n *\n * Why a Proxy: JSX reads `components.DataTable.Loading` while building the\n * element tree — before `DataTable` itself renders — so statics cannot be\n * copied only after the first `render` call. Property access lazily creates a\n * stable wrapper component that re-runs the scoped `render` under context and\n * mounts the matching static from the returned component type.\n */\nexport function withScopedCompoundStatics(\n  wrapper: (props?: Record<string, unknown>) => JSX.Element,\n  createCompoundStatic: (\n    staticName: string,\n  ) => (ownProps?: Record<string, unknown>) => JSX.Element,\n): ScopedComponentWrapper {\n  return new Proxy(wrapper as ScopedComponentWrapper, {\n    get(target, property, receiver) {\n      if (\n        typeof property === 'symbol' ||\n        reservedScopedCompoundStaticKeys.has(property) ||\n        property in target\n      ) {\n        return Reflect.get(target, property, receiver);\n      }\n\n      // Cache on the target so repeated `.Loading` access keeps one identity.\n      const CompoundStatic = createCompoundStatic(property);\n      target[property] = CompoundStatic;\n      return CompoundStatic;\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AAcA,MAAa,+BAA+B,IAAI,IAAI;CAClD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;;AA0BD,MAAM,sBAAsB,OAAO,IAAI,mBAAmB;AAC1D,MAAM,gBAAgB,OAAO,IAAI,YAAY;AAC7C,MAAM,gBAAgB,OAAO,IAAI,YAAY;;;;;;;;AAS7C,SAAgB,0BACd,OACiD;CACjD,IAAI,OAAO,UAAU,YACnB,OAAO;CAGT,IACE,OAAO,UAAU,YACjB,UAAU,QACV,MAAM,QAAQ,KAAK,KACnB,eAAe,KAAK,KACpB,EAAE,cAAc,QAEhB,OAAO;CAGT,MAAM,UAAW,MAAgC;CAEjD,OACE,YAAY,uBACZ,YAAY,iBACZ,YAAY;AAEhB;;;;;AAMA,SAAgB,0BACd,QACA,QAAiC,CAAC,GACrB;CACb,IAAI,0BAA0B,MAAM,GAClC,OAAO,cAAc,QAAQ,KAAK;CAGpC,OAAO;AACT;;;;;AAMA,MAAM,mCAAmC,IAAI,IAAiB;CAC5D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;;;;AAiBD,SAAgB,0BACd,SACA,sBAGwB;CACxB,OAAO,IAAI,MAAM,SAAmC,EAClD,IAAI,QAAQ,UAAU,UAAU;EAC9B,IACE,OAAO,aAAa,YACpB,iCAAiC,IAAI,QAAQ,KAC7C,YAAY,QAEZ,OAAO,QAAQ,IAAI,QAAQ,UAAU,QAAQ;EAI/C,MAAM,iBAAiB,qBAAqB,QAAQ;EACpD,OAAO,YAAY;EACnB,OAAO;CACT,EACF,CAAC;AACH"}

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

@@ -1,4 +1,4 @@
 import { BaseResourceConfigComponents, ResourceConfig, ResourceConfigComponentKey, ResourceConfigComponents, ResourceConfigInput, ResourceConfigMap, SharedResourceConfigOptions, SubResourceConfig, SubResourceConfigComponentsFor } from "./types.cjs";
 import { CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.cjs";
 import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, InferHashFromResourceLinkHref, ResourceAnchorLinkFn, ResourceLinkHref } from "./create-resource-links.cjs";
-import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, defineResourceLayout } from "./define-layout.cjs";
+import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, defineResourceLayout } from "./define-layout.cjs";

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

@@ -1,4 +1,4 @@
 import { BaseResourceConfigComponents, ResourceConfig, ResourceConfigComponentKey, ResourceConfigComponents, ResourceConfigInput, ResourceConfigMap, SharedResourceConfigOptions, SubResourceConfig, SubResourceConfigComponentsFor } from "./types.mjs";
 import { CreateResourceConfigFn, CreatedResourceConfig, GetComponent, GetComponentAtBound, GetComponentForResource, GetComponentForResourceOptions, GetComponentOptions, GetComponentOptionsForResource, ResourceFromGetComponentBound, SubResourceFromGetComponentBound, ValidateForResourceBound } from "./get-component.mjs";
 import { CreateResourceLinkConfig, CreateResourceLinkGroupInput, CreateResourceLinkGroupOptions, CreateResourceLinkOptions, CreateResourceLinksFn, CreateResourceLinksWithGroups, CreateResourceLinksWithGroupsFn, CreatedResourceHref, CreatedResourceLink, CreatedResourceLinkBase, InferHashFromResourceLinkHref, ResourceAnchorLinkFn, ResourceLinkHref } from "./create-resource-links.mjs";
-import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, defineResourceLayout } from "./define-layout.mjs";
+import { CreateResourceLayoutFn, CreateResourceLayoutMakeComposableOptions, DefineResourceLayout, DefineResourceLayoutFn, DefineResourceLayoutForResources, DefineResourceLayoutForResourcesFactory, defineResourceLayout } from "./define-layout.mjs";

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { BaseComponent, MergeIntersection, Show, UnionToIntersection, pick } from "./utils.cjs";
 import { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceEnum, ResourceLayoutComponentProps, ResourceTree, normalizeResource, normalizeResources, toResourceEnum } from "./resource.cjs";
-import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.cjs";
+import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.cjs";
 import { defineResourceLayout } from "./create-config/define-layout.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, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateLayoutComposable, type DefinedComposableComponentRecord, type ExtractDefinitionValue, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedProps, type InferredInProps, LayoutComposablePresetProvider, type LayoutComposablesFactory, type LayoutRenderProps, type LayoutResourceKey, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type NormalizeResource, type NormalizeResources, type PresetPropsFromComposable, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResourceDefinition, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceTree, type Show, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateLayoutComposable, type DefinedComposableComponentRecord, type ExtractDefinitionValue, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedProps, type InferredInProps, LayoutComposablePresetProvider, type LayoutComposablesFactory, type LayoutRenderProps, type LayoutResourceKey, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type NormalizeResource, type NormalizeResources, type PresetPropsFromComposable, type PropsContextRender, type PropsRenderDefinition, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResourceDefinition, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceTree, type Show, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { BaseComponent, MergeIntersection, Show, UnionToIntersection, pick } from "./utils.mjs";
 import { LayoutResourceKey, NormalizeResource, NormalizeResources, ResourceDefinition, ResourceEnum, ResourceLayoutComponentProps, ResourceTree, normalizeResource, normalizeResources, toResourceEnum } from "./resource.mjs";
-import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.mjs";
+import { InPropsDefinition, InPropsFunction, InPropsObject, InPropsOptions, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined } from "./props.mjs";
 import { defineResourceLayout } from "./create-config/define-layout.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, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps, ResolvedBuiltPropShape, createPrimitivePropBuilder, createProp, isPropDefinitionShape, resolvePropDefinitionValues, validateProps } from "@jfdevelops/react-layout-validator";
-export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateLayoutComposable, type DefinedComposableComponentRecord, type ExtractDefinitionValue, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedProps, type InferredInProps, LayoutComposablePresetProvider, type LayoutComposablesFactory, type LayoutRenderProps, type LayoutResourceKey, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type NormalizeResource, type NormalizeResources, type PresetPropsFromComposable, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResourceDefinition, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceTree, type Show, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };
+export { type AnyBuiltPropDefinition, type AnyComposableComponent, type BaseComponent, type ComposableComponent, type ComposableComponentCallable, type ComposableComponents, type ComposableNameContext, type ComposablePresetComponent, type ComposablePresetComponentCallProps, type ComposablePresetMeta, type ComposablePresetProps, type ComposableResourceLayout, type CreateLayoutComposable, type DefinedComposableComponentRecord, type ExtractDefinitionValue, type InPropsDefinition, type InPropsFunction, type InPropsObject, type InPropsOptions, type IncludedProps, type InferredInProps, LayoutComposablePresetProvider, type LayoutComposablesFactory, type LayoutRenderProps, type LayoutResourceKey, type MakeComposable, type MakeComposableOptions, type MergeIntersection, type MergePresetProps, type MergedLayoutInProps, type NormalizeResource, type NormalizeResources, type PresetPropsFromComposable, type PropsContextRender, type PropsRenderDefinition, type RequiredPresetLayoutProps, type RequiredPresetRenderProps, type ResolveLayoutComposables, type ResolveLayoutProps, type ResolveLayoutPropsAsDefined, type ResolveProps, type ResolvedBuiltPropShape, type ResolvedIncludedProps, type ResolvedIncludedPropsAsDefined, type ResourceDefinition, type ResourceEnum, type ResourceLayoutComponentProps, type ResourceTree, type Show, type UnionToIntersection, collectComposablePresetEntries, createComposableComponent, createLayoutComposableFactory, createPrimitivePropBuilder, createProp, defineComposableComponent, defineResourceLayout, isPropDefinitionShape, makeComposable, normalizeResource, normalizeResources, pick, resolveComposablePresetProps, resolveLayoutComposables, resolvePropDefinitionValues, toResourceEnum, validateProps };

package/dist/props.d.cts

@@ -4,6 +4,27 @@ import { ComposableComponents, InPropsObject, MergePresetProps } from "@jfdevelo
 import { EnumWrappedProp, LiteralWrappedProp, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps } from "@jfdevelops/react-layout-validator";
 
 //#region src/props.d.ts
+/**
+ * Two-argument `render(props, context)` used by createComponent and scoped
+ * resource components. `Context` is sibling components (scoped) or the
+ * resource render context (top-level).
+ */
+type PropsContextRender<RenderProps, Context, Result = unknown> = (props: RenderProps, context: Context) => Result;
+/**
+ * Shared `{ props?, render }` shape used by createComponent, scoped
+ * components, and anywhere else a value declares props and a two-arg render.
+ *
+ * @typeParam Props - Declared on the entry (`props`). Often an
+ *   {@link InPropsObject}, or a layout include/custom bag.
+ * @typeParam RenderProps - First argument to `render` (defaults to
+ *   {@link ResolveProps}<Props> when Props is an {@link InPropsObject})
+ * @typeParam Result - `render` return type
+ * @typeParam Context - Second argument to `render`
+ */
+interface PropsRenderDefinition<Props = InPropsObject, RenderProps = (Props extends InPropsObject ? ResolveProps<Props> : unknown), Result = unknown, Context = unknown> {
+  props?: Props;
+  render: PropsContextRender<RenderProps, Context, Result>;
+}
 type InPropsOptions<Resources extends ReadonlyArray<ResourceDefinition>, Name extends string> = {
   name: LiteralWrappedProp<Name, 'string', 'required'>;
   resource: EnumWrappedProp<ResourceEnum<Resources>, 'string', 'required'>;
@@ -26,5 +47,5 @@ type ResolvedIncludedProps<Props extends InPropsObject, IncludeProps extends Inc
 type ResolvedIncludedPropsAsDefined<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutPropsAsDefined<Pick<Props, RequiredIncludedPropKeys<IncludeProps> & keyof Props>> & Partial<ResolveLayoutPropsAsDefined<Pick<Props, OptionalIncludedPropKeys<IncludeProps> & keyof Props>>>;
 type LayoutRenderProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents = {}, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, Composables>> = {}, CustomProps extends InPropsObject = {}> = Show<ResolveProps<CustomProps> & ResolvedIncludedProps<MergedLayoutInProps<Resources, Options, Composables>, IncludeProps>>;
 //#endregion
-export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
+export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
 //# sourceMappingURL=props.d.cts.map

package/dist/props.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.cts","names":[],"sources":["../src/props.ts"],"mappings":";;;;;;KAaY,cAAA,mBACQ,aAAA,CAAc,kBAAA;EAGhC,IAAA,EAAM,kBAAA,CAAmB,IAAA;EACzB,QAAA,EAAU,eAAA,CAAgB,YAAA,CAAa,SAAA;AAAA;AAAA,KAE7B,eAAA,mBACQ,aAAA,CAAc,kBAAA,2BAEhC,KAAA,EAAO,IAAA,CAAK,cAAA,CAAe,SAAA,EAAW,IAAA,OACnC,aAAA;AAAA,KACO,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,aAAA,GAAgB,eAAA,CAAgB,SAAA;AAAA,KACxB,eAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,KAChC,OAAA,SAAgB,eAAA,CAAgB,SAAA,IAAa,UAAA,CAAW,OAAA,IAAW,OAAA;AAAA,KAC3D,mBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,IAClB,eAAA,CAAgB,SAAA,EAAW,OAAA,UAAiB,aAAA,GAC5C,eAAA,CAAgB,SAAA,EAAW,OAAA,IAAW,gBAAA,CAAiB,WAAA;;;;KAK/C,aAAA,mCACE,CAAC;AAAA,KAGV,wBAAA,gDACW,YAAA,GAAe,YAAA,CAAa,GAAA,iBAAoB,GAAA,iBACxD,YAAA;AAAA,KAEH,wBAAA,gDACW,YAAA,GAAe,YAAA,CAAa,GAAA,uBACtC,GAAA,iBAEE,YAAA;AAAA,KAEI,qBAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,kBAAA,CACF,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA,KAE3D,OAAA,CACE,kBAAA,CACE,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA;;;;AA9Cf;KAsDtC,8BAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,2BAAA,CACF,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA,KAE3D,OAAA,CACE,2BAAA,CACE,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA;AAAA,KAGrD,iBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,aAAA,CACnB,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,6BAEtB,aAAA,SAClB,IAAA,CACF,YAAA,CAAa,WAAA,IACX,qBAAA,CACE,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,GACxC,YAAA"}
+{"version":3,"file":"props.d.cts","names":[],"sources":["../src/props.ts"],"mappings":";;;;;;AAmBA;;;;;AAAA,KAAY,kBAAA,4CAIP,KAAA,EAAO,WAAA,EAAa,OAAA,EAAS,OAAA,KAAY,MAAA;;;;;;;;;;;;UAa7B,qBAAA,SACP,aAAA,iBACM,KAAA,SAAc,aAAA,GAAgB,YAAA,CAAa,KAAA;EAIzD,KAAA,GAAQ,KAAA;EACR,MAAA,EAAQ,kBAAA,CAAmB,WAAA,EAAa,OAAA,EAAS,MAAA;AAAA;AAAA,KAGvC,cAAA,mBACQ,aAAA,CAAc,kBAAA;EAGhC,IAAA,EAAM,kBAAA,CAAmB,IAAA;EACzB,QAAA,EAAU,eAAA,CAAgB,YAAA,CAAa,SAAA;AAAA;AAAA,KAE7B,eAAA,mBACQ,aAAA,CAAc,kBAAA,2BAEhC,KAAA,EAAO,IAAA,CAAK,cAAA,CAAe,SAAA,EAAW,IAAA,OACnC,aAAA;AAAA,KACO,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,aAAA,GAAgB,eAAA,CAAgB,SAAA;AAAA,KACxB,eAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,KAChC,OAAA,SAAgB,eAAA,CAAgB,SAAA,IAAa,UAAA,CAAW,OAAA,IAAW,OAAA;AAAA,KAC3D,mBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,IAClB,eAAA,CAAgB,SAAA,EAAW,OAAA,UAAiB,aAAA,GAC5C,eAAA,CAAgB,SAAA,EAAW,OAAA,IAAW,gBAAA,CAAiB,WAAA;;;;KAK/C,aAAA,mCACE,CAAC;AAAA,KAGV,wBAAA,gDACW,YAAA,GAAe,YAAA,CAAa,GAAA,iBAAoB,GAAA,iBACxD,YAAA;AAAA,KAEH,wBAAA,gDACW,YAAA,GAAe,YAAA,CAAa,GAAA,uBACtC,GAAA,iBAEE,YAAA;AAAA,KAEI,qBAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,kBAAA,CACF,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA,KAE3D,OAAA,CACE,kBAAA,CACE,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA;;;;;KAQrD,8BAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,2BAAA,CACF,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA,KAE3D,OAAA,CACE,2BAAA,CACE,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA;AAAA,KAGrD,iBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,aAAA,CACnB,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,6BAEtB,aAAA,SAClB,IAAA,CACF,YAAA,CAAa,WAAA,IACX,qBAAA,CACE,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,GACxC,YAAA"}

package/dist/props.d.mts

@@ -4,6 +4,27 @@ import { ComposableComponents, InPropsObject, MergePresetProps } from "@jfdevelo
 import { EnumWrappedProp, LiteralWrappedProp, ResolveLayoutProps, ResolveLayoutPropsAsDefined, ResolveProps } from "@jfdevelops/react-layout-validator";
 
 //#region src/props.d.ts
+/**
+ * Two-argument `render(props, context)` used by createComponent and scoped
+ * resource components. `Context` is sibling components (scoped) or the
+ * resource render context (top-level).
+ */
+type PropsContextRender<RenderProps, Context, Result = unknown> = (props: RenderProps, context: Context) => Result;
+/**
+ * Shared `{ props?, render }` shape used by createComponent, scoped
+ * components, and anywhere else a value declares props and a two-arg render.
+ *
+ * @typeParam Props - Declared on the entry (`props`). Often an
+ *   {@link InPropsObject}, or a layout include/custom bag.
+ * @typeParam RenderProps - First argument to `render` (defaults to
+ *   {@link ResolveProps}<Props> when Props is an {@link InPropsObject})
+ * @typeParam Result - `render` return type
+ * @typeParam Context - Second argument to `render`
+ */
+interface PropsRenderDefinition<Props = InPropsObject, RenderProps = (Props extends InPropsObject ? ResolveProps<Props> : unknown), Result = unknown, Context = unknown> {
+  props?: Props;
+  render: PropsContextRender<RenderProps, Context, Result>;
+}
 type InPropsOptions<Resources extends ReadonlyArray<ResourceDefinition>, Name extends string> = {
   name: LiteralWrappedProp<Name, 'string', 'required'>;
   resource: EnumWrappedProp<ResourceEnum<Resources>, 'string', 'required'>;
@@ -26,5 +47,5 @@ type ResolvedIncludedProps<Props extends InPropsObject, IncludeProps extends Inc
 type ResolvedIncludedPropsAsDefined<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>> = ResolveLayoutPropsAsDefined<Pick<Props, RequiredIncludedPropKeys<IncludeProps> & keyof Props>> & Partial<ResolveLayoutPropsAsDefined<Pick<Props, OptionalIncludedPropKeys<IncludeProps> & keyof Props>>>;
 type LayoutRenderProps<Resources extends ReadonlyArray<ResourceDefinition>, Options extends InPropsDefinition<Resources>, Composables extends ComposableComponents = {}, IncludeProps extends IncludedProps<MergedLayoutInProps<Resources, Options, Composables>> = {}, CustomProps extends InPropsObject = {}> = Show<ResolveProps<CustomProps> & ResolvedIncludedProps<MergedLayoutInProps<Resources, Options, Composables>, IncludeProps>>;
 //#endregion
-export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
+export { InPropsDefinition, InPropsFunction, type InPropsObject, InPropsOptions, IncludedProps, InferredInProps, LayoutRenderProps, MergedLayoutInProps, PropsContextRender, PropsRenderDefinition, ResolvedIncludedProps, ResolvedIncludedPropsAsDefined };
 //# sourceMappingURL=props.d.mts.map

package/dist/props.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.mts","names":[],"sources":["../src/props.ts"],"mappings":";;;;;;KAaY,cAAA,mBACQ,aAAA,CAAc,kBAAA;EAGhC,IAAA,EAAM,kBAAA,CAAmB,IAAA;EACzB,QAAA,EAAU,eAAA,CAAgB,YAAA,CAAa,SAAA;AAAA;AAAA,KAE7B,eAAA,mBACQ,aAAA,CAAc,kBAAA,2BAEhC,KAAA,EAAO,IAAA,CAAK,cAAA,CAAe,SAAA,EAAW,IAAA,OACnC,aAAA;AAAA,KACO,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,aAAA,GAAgB,eAAA,CAAgB,SAAA;AAAA,KACxB,eAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,KAChC,OAAA,SAAgB,eAAA,CAAgB,SAAA,IAAa,UAAA,CAAW,OAAA,IAAW,OAAA;AAAA,KAC3D,mBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,IAClB,eAAA,CAAgB,SAAA,EAAW,OAAA,UAAiB,aAAA,GAC5C,eAAA,CAAgB,SAAA,EAAW,OAAA,IAAW,gBAAA,CAAiB,WAAA;;;;KAK/C,aAAA,mCACE,CAAC;AAAA,KAGV,wBAAA,gDACW,YAAA,GAAe,YAAA,CAAa,GAAA,iBAAoB,GAAA,iBACxD,YAAA;AAAA,KAEH,wBAAA,gDACW,YAAA,GAAe,YAAA,CAAa,GAAA,uBACtC,GAAA,iBAEE,YAAA;AAAA,KAEI,qBAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,kBAAA,CACF,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA,KAE3D,OAAA,CACE,kBAAA,CACE,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA;;;;AA9Cf;KAsDtC,8BAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,2BAAA,CACF,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA,KAE3D,OAAA,CACE,2BAAA,CACE,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA;AAAA,KAGrD,iBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,aAAA,CACnB,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,6BAEtB,aAAA,SAClB,IAAA,CACF,YAAA,CAAa,WAAA,IACX,qBAAA,CACE,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,GACxC,YAAA"}
+{"version":3,"file":"props.d.mts","names":[],"sources":["../src/props.ts"],"mappings":";;;;;;AAmBA;;;;;AAAA,KAAY,kBAAA,4CAIP,KAAA,EAAO,WAAA,EAAa,OAAA,EAAS,OAAA,KAAY,MAAA;;;;;;;;;;;;UAa7B,qBAAA,SACP,aAAA,iBACM,KAAA,SAAc,aAAA,GAAgB,YAAA,CAAa,KAAA;EAIzD,KAAA,GAAQ,KAAA;EACR,MAAA,EAAQ,kBAAA,CAAmB,WAAA,EAAa,OAAA,EAAS,MAAA;AAAA;AAAA,KAGvC,cAAA,mBACQ,aAAA,CAAc,kBAAA;EAGhC,IAAA,EAAM,kBAAA,CAAmB,IAAA;EACzB,QAAA,EAAU,eAAA,CAAgB,YAAA,CAAa,SAAA;AAAA;AAAA,KAE7B,eAAA,mBACQ,aAAA,CAAc,kBAAA,2BAEhC,KAAA,EAAO,IAAA,CAAK,cAAA,CAAe,SAAA,EAAW,IAAA,OACnC,aAAA;AAAA,KACO,iBAAA,mBACQ,aAAA,CAAc,kBAAA,KAC9B,aAAA,GAAgB,eAAA,CAAgB,SAAA;AAAA,KACxB,eAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,KAChC,OAAA,SAAgB,eAAA,CAAgB,SAAA,IAAa,UAAA,CAAW,OAAA,IAAW,OAAA;AAAA,KAC3D,mBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,IAClB,eAAA,CAAgB,SAAA,EAAW,OAAA,UAAiB,aAAA,GAC5C,eAAA,CAAgB,SAAA,EAAW,OAAA,IAAW,gBAAA,CAAiB,WAAA;;;;KAK/C,aAAA,mCACE,CAAC;AAAA,KAGV,wBAAA,gDACW,YAAA,GAAe,YAAA,CAAa,GAAA,iBAAoB,GAAA,iBACxD,YAAA;AAAA,KAEH,wBAAA,gDACW,YAAA,GAAe,YAAA,CAAa,GAAA,uBACtC,GAAA,iBAEE,YAAA;AAAA,KAEI,qBAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,kBAAA,CACF,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA,KAE3D,OAAA,CACE,kBAAA,CACE,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA;;;;;KAQrD,8BAAA,eACI,aAAA,uBACO,aAAA,CAAc,KAAA,KACjC,2BAAA,CACF,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA,KAE3D,OAAA,CACE,2BAAA,CACE,IAAA,CAAK,KAAA,EAAO,wBAAA,CAAyB,YAAA,UAAsB,KAAA;AAAA,KAGrD,iBAAA,mBACQ,aAAA,CAAc,kBAAA,mBAChB,iBAAA,CAAkB,SAAA,uBACd,oBAAA,4BACC,aAAA,CACnB,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,6BAEtB,aAAA,SAClB,IAAA,CACF,YAAA,CAAa,WAAA,IACX,qBAAA,CACE,mBAAA,CAAoB,SAAA,EAAW,OAAA,EAAS,WAAA,GACxC,YAAA"}

package/dist/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["export type Show<T> = T extends (...args: infer A) => infer R\n  ? (...args: A) => R\n  : { [K in keyof T]: T[K] } & {};\nexport type MergeIntersection<T> = {\n  [Key in keyof T]: T[Key];\n};\nexport type IsUnion<T, U = T> = T extends unknown\n  ? [U] extends [T]\n    ? false\n    : true\n  : never;\nexport type UnionToIntersection<Union> = (\n  Union extends unknown ? (value: Union) => void : never\n) extends (value: infer Intersection) => void\n  ? Intersection\n  : never;\nexport type Updater<T> = T | ((prev: T) => T);\n\nexport interface BaseComponent<Name extends string, Props = {}> {\n  /**\n   * The name of the component. Useful for debugging and error messages.\n   */\n  displayName: Name;\n  /**\n   * A type only property to get the type of the props. At runtime,\n   * this is `undefined`.\n   */\n  props: Props;\n}\n\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: K[]) {\n  if (keys.length === 0) {\n    return {} as Pick<T, K>;\n  }\n\n  return keys.reduce(\n    (acc, key) => {\n      if (key in obj) acc[key] = obj[key];\n\n      return acc;\n    },\n    {} as Pick<T, K>,\n  );\n}\n\nexport function functionalUpdate<T>(value: T, updater: Updater<T>){\n  if (typeof updater === 'function') {\n    return (updater as (prev: T) => T)(value);\n  }\n\n  return updater;\n}\n"],"mappings":";;AA8BA,SAAgB,KAA0C,KAAQ,MAAW;CAC3E,IAAI,KAAK,WAAW,GAClB,OAAO,CAAC;CAGV,OAAO,KAAK,QACT,KAAK,QAAQ;EACZ,IAAI,OAAO,KAAK,IAAI,OAAO,IAAI;EAE/B,OAAO;CACT,GACA,CAAC,CACH;AACF;AAEA,SAAgB,iBAAoB,OAAU,SAAoB;CAChE,IAAI,OAAO,YAAY,YACrB,OAAQ,QAA2B,KAAK;CAG1C,OAAO;AACT"}
+{"version":3,"file":"utils.cjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["export type Show<T> = T extends (...args: infer A) => infer R\n  ? (...args: A) => R\n  : { [K in keyof T]: T[K] } & {};\nexport type MergeIntersection<T> = {\n  [Key in keyof T]: T[Key];\n};\nexport type IsUnion<T, U = T> = T extends unknown\n  ? [U] extends [T]\n    ? false\n    : true\n  : never;\nexport type UnionToIntersection<Union> = (\n  Union extends unknown ? (value: Union) => void : never\n) extends (value: infer Intersection) => void\n  ? Intersection\n  : never;\nexport type Updater<T> = T | ((prev: T) => T);\nexport type OptionalRecord<K extends string, V = unknown> = {\n  [key in K]?: V;\n};\n\nexport interface BaseComponent<Name extends string, Props = {}> {\n  /**\n   * The name of the component. Useful for debugging and error messages.\n   */\n  displayName: Name;\n  /**\n   * A type only property to get the type of the props. At runtime,\n   * this is `undefined`.\n   */\n  props: Props;\n}\n\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: K[]) {\n  if (keys.length === 0) {\n    return {} as Pick<T, K>;\n  }\n\n  return keys.reduce(\n    (acc, key) => {\n      if (key in obj) acc[key] = obj[key];\n\n      return acc;\n    },\n    {} as Pick<T, K>,\n  );\n}\n\nexport function functionalUpdate<T>(value: T, updater: Updater<T>){\n  if (typeof updater === 'function') {\n    return (updater as (prev: T) => T)(value);\n  }\n\n  return updater;\n}\n"],"mappings":";;AAiCA,SAAgB,KAA0C,KAAQ,MAAW;CAC3E,IAAI,KAAK,WAAW,GAClB,OAAO,CAAC;CAGV,OAAO,KAAK,QACT,KAAK,QAAQ;EACZ,IAAI,OAAO,KAAK,IAAI,OAAO,IAAI;EAE/B,OAAO;CACT,GACA,CAAC,CACH;AACF;AAEA,SAAgB,iBAAoB,OAAU,SAAoB;CAChE,IAAI,OAAO,YAAY,YACrB,OAAQ,QAA2B,KAAK;CAG1C,OAAO;AACT"}

package/dist/utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","names":[],"sources":["../src/utils.ts"],"mappings":";KAAY,IAAA,MAAU,CAAA,cAAc,IAAA,6BAC5B,IAAA,EAAM,CAAA,KAAM,CAAA,iBACF,CAAA,GAAI,CAAA,CAAE,CAAA;AAAA,KACZ,iBAAA,sBACI,CAAA,GAAI,CAAA,CAAE,GAAA;AAAA,KAOV,mBAAA,WACV,KAAA,oBAAyB,KAAA,EAAO,KAAK,6BAC5B,KAAA,iCACP,YAAA;AAAA,KAEQ,OAAA,MAAa,CAAA,KAAM,IAAA,EAAM,CAAA,KAAM,CAAA;AAAA,UAE1B,aAAA;EAhBQ;;;EAoBvB,WAAA,EAAa,IAAA;EAtBqB;;;;EA2BlC,KAAA,EAAO,KAAK;AAAA;AAAA,iBAGE,IAAA,mCAAuC,CAAA,EAAG,GAAA,EAAK,CAAA,EAAG,IAAA,EAAM,CAAA,KAAG,IAAA,CAAA,CAAA,EAAA,CAAA"}
+{"version":3,"file":"utils.d.cts","names":[],"sources":["../src/utils.ts"],"mappings":";KAAY,IAAA,MAAU,CAAA,cAAc,IAAA,6BAC5B,IAAA,EAAM,CAAA,KAAM,CAAA,iBACF,CAAA,GAAI,CAAA,CAAE,CAAA;AAAA,KACZ,iBAAA,sBACI,CAAA,GAAI,CAAA,CAAE,GAAA;AAAA,KAOV,mBAAA,WACV,KAAA,oBAAyB,KAAA,EAAO,KAAK,6BAC5B,KAAA,iCACP,YAAA;AAAA,KAEQ,OAAA,MAAa,CAAA,KAAM,IAAA,EAAM,CAAA,KAAM,CAAA;AAAA,UAK1B,aAAA;EArBK;;;EAyBpB,WAAA,EAAa,IAAA;EAxBP;;;;EA6BN,KAAA,EAAO,KAAK;AAAA;AAAA,iBAGE,IAAA,mCAAuC,CAAA,EAAG,GAAA,EAAK,CAAA,EAAG,IAAA,EAAM,CAAA,KAAG,IAAA,CAAA,CAAA,EAAA,CAAA"}

package/dist/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.ts"],"mappings":";KAAY,IAAA,MAAU,CAAA,cAAc,IAAA,6BAC5B,IAAA,EAAM,CAAA,KAAM,CAAA,iBACF,CAAA,GAAI,CAAA,CAAE,CAAA;AAAA,KACZ,iBAAA,sBACI,CAAA,GAAI,CAAA,CAAE,GAAA;AAAA,KAOV,mBAAA,WACV,KAAA,oBAAyB,KAAA,EAAO,KAAK,6BAC5B,KAAA,iCACP,YAAA;AAAA,KAEQ,OAAA,MAAa,CAAA,KAAM,IAAA,EAAM,CAAA,KAAM,CAAA;AAAA,UAE1B,aAAA;EAhBQ;;;EAoBvB,WAAA,EAAa,IAAA;EAtBqB;;;;EA2BlC,KAAA,EAAO,KAAK;AAAA;AAAA,iBAGE,IAAA,mCAAuC,CAAA,EAAG,GAAA,EAAK,CAAA,EAAG,IAAA,EAAM,CAAA,KAAG,IAAA,CAAA,CAAA,EAAA,CAAA"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.ts"],"mappings":";KAAY,IAAA,MAAU,CAAA,cAAc,IAAA,6BAC5B,IAAA,EAAM,CAAA,KAAM,CAAA,iBACF,CAAA,GAAI,CAAA,CAAE,CAAA;AAAA,KACZ,iBAAA,sBACI,CAAA,GAAI,CAAA,CAAE,GAAA;AAAA,KAOV,mBAAA,WACV,KAAA,oBAAyB,KAAA,EAAO,KAAK,6BAC5B,KAAA,iCACP,YAAA;AAAA,KAEQ,OAAA,MAAa,CAAA,KAAM,IAAA,EAAM,CAAA,KAAM,CAAA;AAAA,UAK1B,aAAA;EArBK;;;EAyBpB,WAAA,EAAa,IAAA;EAxBP;;;;EA6BN,KAAA,EAAO,KAAK;AAAA;AAAA,iBAGE,IAAA,mCAAuC,CAAA,EAAG,GAAA,EAAK,CAAA,EAAG,IAAA,EAAM,CAAA,KAAG,IAAA,CAAA,CAAA,EAAA,CAAA"}

package/dist/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["export type Show<T> = T extends (...args: infer A) => infer R\n  ? (...args: A) => R\n  : { [K in keyof T]: T[K] } & {};\nexport type MergeIntersection<T> = {\n  [Key in keyof T]: T[Key];\n};\nexport type IsUnion<T, U = T> = T extends unknown\n  ? [U] extends [T]\n    ? false\n    : true\n  : never;\nexport type UnionToIntersection<Union> = (\n  Union extends unknown ? (value: Union) => void : never\n) extends (value: infer Intersection) => void\n  ? Intersection\n  : never;\nexport type Updater<T> = T | ((prev: T) => T);\n\nexport interface BaseComponent<Name extends string, Props = {}> {\n  /**\n   * The name of the component. Useful for debugging and error messages.\n   */\n  displayName: Name;\n  /**\n   * A type only property to get the type of the props. At runtime,\n   * this is `undefined`.\n   */\n  props: Props;\n}\n\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: K[]) {\n  if (keys.length === 0) {\n    return {} as Pick<T, K>;\n  }\n\n  return keys.reduce(\n    (acc, key) => {\n      if (key in obj) acc[key] = obj[key];\n\n      return acc;\n    },\n    {} as Pick<T, K>,\n  );\n}\n\nexport function functionalUpdate<T>(value: T, updater: Updater<T>){\n  if (typeof updater === 'function') {\n    return (updater as (prev: T) => T)(value);\n  }\n\n  return updater;\n}\n"],"mappings":";AA8BA,SAAgB,KAA0C,KAAQ,MAAW;CAC3E,IAAI,KAAK,WAAW,GAClB,OAAO,CAAC;CAGV,OAAO,KAAK,QACT,KAAK,QAAQ;EACZ,IAAI,OAAO,KAAK,IAAI,OAAO,IAAI;EAE/B,OAAO;CACT,GACA,CAAC,CACH;AACF;AAEA,SAAgB,iBAAoB,OAAU,SAAoB;CAChE,IAAI,OAAO,YAAY,YACrB,OAAQ,QAA2B,KAAK;CAG1C,OAAO;AACT"}
+{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["export type Show<T> = T extends (...args: infer A) => infer R\n  ? (...args: A) => R\n  : { [K in keyof T]: T[K] } & {};\nexport type MergeIntersection<T> = {\n  [Key in keyof T]: T[Key];\n};\nexport type IsUnion<T, U = T> = T extends unknown\n  ? [U] extends [T]\n    ? false\n    : true\n  : never;\nexport type UnionToIntersection<Union> = (\n  Union extends unknown ? (value: Union) => void : never\n) extends (value: infer Intersection) => void\n  ? Intersection\n  : never;\nexport type Updater<T> = T | ((prev: T) => T);\nexport type OptionalRecord<K extends string, V = unknown> = {\n  [key in K]?: V;\n};\n\nexport interface BaseComponent<Name extends string, Props = {}> {\n  /**\n   * The name of the component. Useful for debugging and error messages.\n   */\n  displayName: Name;\n  /**\n   * A type only property to get the type of the props. At runtime,\n   * this is `undefined`.\n   */\n  props: Props;\n}\n\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: K[]) {\n  if (keys.length === 0) {\n    return {} as Pick<T, K>;\n  }\n\n  return keys.reduce(\n    (acc, key) => {\n      if (key in obj) acc[key] = obj[key];\n\n      return acc;\n    },\n    {} as Pick<T, K>,\n  );\n}\n\nexport function functionalUpdate<T>(value: T, updater: Updater<T>){\n  if (typeof updater === 'function') {\n    return (updater as (prev: T) => T)(value);\n  }\n\n  return updater;\n}\n"],"mappings":";AAiCA,SAAgB,KAA0C,KAAQ,MAAW;CAC3E,IAAI,KAAK,WAAW,GAClB,OAAO,CAAC;CAGV,OAAO,KAAK,QACT,KAAK,QAAQ;EACZ,IAAI,OAAO,KAAK,IAAI,OAAO,IAAI;EAE/B,OAAO;CACT,GACA,CAAC,CACH;AACF;AAEA,SAAgB,iBAAoB,OAAU,SAAoB;CAChE,IAAI,OAAO,YAAY,YACrB,OAAQ,QAA2B,KAAK;CAG1C,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jfdevelops/react-layout",
-  "version": "0.15.1",
+  "version": "0.17.0",
   "description": "A React library for creating layout components.",
   "repository": {
     "type": "git",
@@ -8,7 +8,8 @@
   },
   "type": "module",
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "sideEffects": false,
   "main": "./dist/index.cjs",

package/skills/build-react-layouts/SKILL.md

@@ -0,0 +1,132 @@
+---
+name: build-react-layouts
+description: Build, extend, refactor, and review typed resource-based React application layouts using @jfdevelops/react-layout. Use when defining shared application shells with defineResourceLayout, generating resource pages with createResourceLayout, creating semantic composables, configuring grouped resource navigation, dispatching route components with createResourceConfig, building create or detail panes, or sharing implementations across multiple resources.
+---
+
+# Build React Layouts
+
+Use `@jfdevelops/react-layout` as a typed application-structure layer.
+
+Model the application around a central resource definition, a shared layout
+contract, small resource-specific page configurations, and router adapters that
+dispatch through the resource configuration. Create additional layout
+definitions for structurally different surfaces such as side panes.
+
+Do not treat the library as a replacement for routing, data fetching, form
+state, or application business logic.
+
+## Follow the workflow
+
+1. Inspect the existing layout definition and resource list.
+2. Identify whether the requested surface belongs to an existing layout family.
+3. Add or reuse the resource in the central definition.
+4. Define shared configuration values with `createProp`.
+5. Expose semantic layout regions through composables.
+6. Generate the narrowest suitable page factory.
+7. Connect navigation and route-state dispatch through the helpers returned by
+   `defineResourceLayout`.
+8. Run the application's typecheck and relevant tests.
+
+Read [references/architecture.md](references/architecture.md) before creating
+or substantially restructuring a layout definition.
+
+Read [references/factory-patterns.md](references/factory-patterns.md) when
+choosing between direct creation, `forResource`, `forResources`,
+`makeComposable`, or `createComponent(...).asHOF()`.
+
+Read
+[references/routing-and-navigation.md](references/routing-and-navigation.md)
+when integrating resource links, route components, pending states, errors, or
+not-found states.
+
+## Apply the core conventions
+
+- Import `defineResourceLayout` and `createProp` from
+  `@jfdevelops/react-layout`.
+- Import optional preset composables from their dedicated packages.
+- Export the helpers returned by the central `defineResourceLayout` call.
+- Keep the authoritative resource list in the central layout definition.
+- Use resource names that match the application's route vocabulary.
+- Define reusable configuration in `options`.
+- Use `layout.props.include` for definition-time values consumed by the shared
+  renderer.
+- Use `layout.props.custom` for props passed when rendering the generated React
+  component.
+- Use `createProp.component({ type: 'ReactNode' })` for React content.
+- Mark genuinely optional values with `.optional()`.
+- Give optional custom values defaults in the shared renderer when appropriate.
+- Name composables by semantic role rather than visual implementation.
+- Connect semantic composables to design-system components with `wrapWith`.
+- Use resource-aware composable names so generated components remain
+  identifiable in React DevTools.
+- Keep page configuration close to the corresponding resource feature.
+- Keep resource routing generic instead of building a separate route component
+  for every resource.
+- Confirm helper signatures against the installed package version and let the
+  current TypeScript types determine which resource-configuration branches are
+  supported.
+- Reuse the consuming application's router and runtime-validation tools. Do not
+  add a schema dependency solely to connect a route parameter to a resource.
+- Create a separate `defineResourceLayout` definition for a surface with a
+  meaningfully different structural contract, such as a create or detail pane.
+- Preserve inferred types. Do not use `any`, broad casts, or duplicated
+  hand-written resource types to work around a layout mismatch.
+
+## Define semantic composables
+
+Prefer names that describe application structure, such as `Layout`, `Header`,
+`Content`, `ResourceLayout`, `ResourceHeader`, `ResourceHeaderActions`, and
+`Breadcrumb`.
+
+Do not expose every wrapper element as a composable. Expose a region when
+consumers may need to replace it, compose it, style it, or address it through a
+generated component.
+
+## Separate definition-time and render-time props
+
+Use `options` for values supplied while creating a resource layout:
+
+```tsx
+options: {
+  title: createProp.component({ type: 'ReactNode' }).optional(),
+}
+```
+
+Make an option available to the shared renderer through `include`:
+
+```tsx
+layout: {
+  props: {
+    include: {
+      title: true,
+    },
+  },
+}
+```
+
+Use `custom` for values supplied when rendering the resulting component:
+
+```tsx
+layout: {
+  props: {
+    custom: {
+      children: createProp.component({ type: 'ReactNode' }),
+      actions: createProp.component({ type: 'ReactNode' }).optional(),
+      showHeader: createProp.boolean().optional(),
+    },
+  },
+}
+```
+
+Keep these categories distinct. Do not turn a definition-time page contract
+into a custom render prop merely because both eventually reach the renderer.
+
+## Verify the result
+
+1. Typecheck the consuming application.
+2. Run relevant component and route tests.
+3. Exercise at least one resource page.
+4. Exercise pending, error, and not-found dispatch if route configuration
+   changed.
+5. Exercise create and detail panes if pane configuration changed.
+6. Confirm grouped navigation generates the intended resource and route.

package/skills/build-react-layouts/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Build React Layouts"
+  short_description: "Build typed resource-driven React layouts"
+  default_prompt: "Use $build-react-layouts to build or refactor a typed resource-based React application layout."

package/skills/build-react-layouts/references/architecture.md

@@ -0,0 +1,184 @@
+# Application Architecture
+
+## Contents
+
+- Central layout definition
+- Shared layout contract
+- Semantic composables
+- Preset composables
+- Secondary layout families
+- Feature organization
+
+## Create a central layout definition
+
+Create one central definition for resources that share the same application
+shell. Export the generated helpers from that module:
+
+```tsx
+import {
+  createProp,
+  defineResourceLayout,
+} from '@jfdevelops/react-layout';
+
+export const {
+  createResourceConfig,
+  createResourceLayout,
+  createResourceLinks,
+} = defineResourceLayout({
+  resources: ['appointments', 'locations', 'services', 'settings'],
+  options: {
+    title: createProp.component({ type: 'ReactNode' }).optional(),
+  },
+  layout: {
+    // Define the shared contract here.
+  },
+});
+```
+
+Import these generated helpers in feature modules instead of defining parallel
+resource lists or rebuilding the application shell.
+
+## Define the shared layout contract
+
+Separate definition-time configuration from render-time component props:
+
+```tsx
+layout: {
+  props: {
+    include: {
+      title: true,
+      segments: true,
+    },
+    custom: {
+      children: createProp.component({ type: 'ReactNode' }),
+      actions: createProp.component({ type: 'ReactNode' }).optional(),
+      showHeader: createProp.boolean().optional(),
+    },
+  },
+}
+```
+
+Use included props for values that describe the generated page. Use custom
+props for content supplied when the generated page component is rendered.
+
+Default optional behavioral props in the renderer:
+
+```tsx
+render: (
+  { children, actions, showHeader = true, segments },
+  { composables },
+) => {
+  // Render the shared shell.
+}
+```
+
+## Create semantic composables
+
+Define named layout regions through the scoped `create` function:
+
+```tsx
+composables: (create) => ({
+  Layout: create({
+    name: ({ capitalize, resource }) =>
+      `${capitalize(resource)}Layout`,
+    wrapWith: AppLayout,
+  }),
+  Header: create({
+    name: ({ capitalize, resource }) =>
+      `${capitalize(resource)}Header`,
+    wrapWith: AppHeader,
+  }),
+  Content: create({
+    name: ({ capitalize, resource }) =>
+      `${capitalize(resource)}Content`,
+    wrapWith: AppContent,
+  }),
+  ResourceHeaderActions: create({
+    name: ({ capitalize, resource }) =>
+      `${capitalize(resource)}ResourceHeaderActions`,
+    wrapWith: AppResourceHeaderActions,
+  }),
+}),
+```
+
+Make the composable name communicate the region's role. Use `wrapWith` to
+connect that role to the application's design-system implementation.
+
+## Merge preset composables
+
+Merge optional preset composables into the same semantic map:
+
+```tsx
+import {
+  createBreadcrumbComposable,
+} from '@jfdevelops/react-layout-composable-breadcrumb';
+
+composables: (create) => ({
+  Layout: create({ name: 'Layout', wrapWith: AppLayout }),
+  ...createBreadcrumbComposable(({ segments }) => (
+    <AppBreadcrumb segments={segments} />
+  )),
+})
+```
+
+Include the preset's required values in `layout.props.include`. Keep
+presentation in the preset renderer and segment definitions in resource page
+configuration.
+
+## Create secondary layout families
+
+Create another `defineResourceLayout` when a surface has a distinct structural
+contract. A side pane is not merely a variation of the main page shell:
+
+```tsx
+export const resourcePaneLayout = defineResourceLayout({
+  resources: ['create', 'detail'],
+  options: {
+    title: createProp.component({ type: 'ReactNode' }),
+  },
+  layout: {
+    props: {
+      include: {
+        title: true,
+      },
+      custom: {
+        children: createProp.component({ type: 'ReactNode' }),
+      },
+    },
+    render: function Render({ children, title }) {
+      return (
+        <Panel>
+          <PanelHeader>
+            <PanelTitle>{title}</PanelTitle>
+          </PanelHeader>
+          <PanelContent>{children}</PanelContent>
+        </Panel>
+      );
+    },
+  },
+});
+```
+
+Do not overload the main page layout with pane-specific flags and conditional
+branches.
+
+## Organize by feature
+
+Keep the general layout definition centralized and concrete page definitions
+beside their feature:
+
+```text
+admin/
+├── -utils/
+│   └── layout.tsx
+├── $resource/
+│   ├── -page-config.tsx
+│   ├── -pane/
+│   │   └── layout.tsx
+│   ├── -appointments/
+│   │   └── pages-config.ts
+│   ├── -locations/
+│   │   └── pages-config.ts
+│   └── index.tsx
+└── route.tsx
+```