@jfdevelops/react-layout 1.6.1 → 2.0.0

package/dist/lazy/lazy-boundary.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-boundary.cjs","names":["Component","isLazyResourceError","Suspense"],"sources":["../../src/lazy/lazy-boundary.tsx"],"sourcesContent":["import {\n  Component,\n  Suspense,\n  useEffect,\n  useReducer,\n  type ReactNode,\n} from 'react';\nimport { isLazyResourceError } from '../errors/lazy-resource-error';\nimport type { LazyResourceErrorComponent } from './types';\nimport type { LazyLoader } from './create-lazy-loader';\n\ntype BoundaryProps = {\n  children: ReactNode;\n  ErrorComponent?: LazyResourceErrorComponent;\n  resource: string;\n  onRetry: () => void;\n};\n\nclass LazyErrorBoundary extends Component<\n  BoundaryProps,\n  { failed: boolean; error?: unknown }\n> {\n  state = { failed: false, error: undefined as unknown };\n  static getDerivedStateFromError(error: unknown) {\n    return { failed: true, error };\n  }\n  retry = () => {\n    this.props.onRetry();\n    this.setState({ failed: false, error: undefined });\n  };\n  render() {\n    if (!this.state.failed) return this.props.children;\n    const { ErrorComponent, resource } = this.props;\n    if (!isLazyResourceError(this.state.error) || !ErrorComponent)\n      throw this.state.error;\n    return (\n      <ErrorComponent\n        error={this.state.error}\n        retry={this.retry}\n        resource={resource}\n      />\n    );\n  }\n}\n\n/** Shared loading, typed error handling and retry for all lazy components. */\nexport function LazyBoundary({\n  loader,\n  member,\n  resource,\n  fallback,\n  ErrorComponent,\n  componentProps,\n  onMount,\n  map,\n}: {\n  loader: LazyLoader<any>;\n  member?: PropertyKey;\n  map?: (selected: any) => React.ComponentType<any>;\n  resource: string;\n  fallback?: ReactNode;\n  ErrorComponent?: LazyResourceErrorComponent;\n  componentProps: Record<string, unknown>;\n  onMount?: () => (() => void) | undefined;\n}) {\n  const [, rerender] = useReducer((value) => value + 1, 0);\n  useEffect(() => onMount?.(), [onMount]);\n  const Current = loader.component(member, map);\n  return (\n    <LazyErrorBoundary\n      resource={resource}\n      ErrorComponent={ErrorComponent}\n      onRetry={() => {\n        loader.reset();\n        rerender();\n      }}\n    >\n      <Suspense fallback={fallback}>\n        <Current {...componentProps} />\n      </Suspense>\n    </LazyErrorBoundary>\n  );\n}\n"],"mappings":";;;;;AAkBA,IAAM,oBAAN,cAAgCA,gBAG9B;CACA,QAAQ;EAAE,QAAQ;EAAO,OAAO;CAAqB;CACrD,OAAO,yBAAyB,OAAgB;EAC9C,OAAO;GAAE,QAAQ;GAAM;EAAM;CAC/B;CACA,cAAc;EACZ,KAAK,MAAM,QAAQ;EACnB,KAAK,SAAS;GAAE,QAAQ;GAAO,OAAO;EAAU,CAAC;CACnD;CACA,SAAS;EACP,IAAI,CAAC,KAAK,MAAM,QAAQ,OAAO,KAAK,MAAM;EAC1C,MAAM,EAAE,gBAAgB,aAAa,KAAK;EAC1C,IAAI,CAACC,gDAAoB,KAAK,MAAM,KAAK,KAAK,CAAC,gBAC7C,MAAM,KAAK,MAAM;EACnB,OACE,2CAAC,gBAAD;GACE,OAAO,KAAK,MAAM;GAClB,OAAO,KAAK;GACF;EACX;CAEL;AACF;;AAGA,SAAgB,aAAa,EAC3B,QACA,QACA,UACA,UACA,gBACA,gBACA,SACA,OAUC;CACD,MAAM,GAAG,mCAAwB,UAAU,QAAQ,GAAG,CAAC;CACvD,2BAAgB,UAAU,GAAG,CAAC,OAAO,CAAC;CAEtC,OACE,2CAAC,mBAAD;EACY;EACM;EAChB,eAAe;GACb,OAAO,MAAM;GACb,SAAS;EACX;YAEA,2CAACC,gBAAD;GAAoB;aAClB,2CAXU,OAAO,UAAU,QAAQ,GAW5B,GAAP,EAAS,GAAI,eAAiB;EACtB;CACO;AAEvB"}

package/dist/lazy/lazy-boundary.mjs

@@ -0,0 +1,55 @@
+import { isLazyResourceError } from "../errors/lazy-resource-error.mjs";
+import { Component, Suspense, useEffect, useReducer } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/lazy/lazy-boundary.tsx
+var LazyErrorBoundary = class extends Component {
+	state = {
+		failed: false,
+		error: void 0
+	};
+	static getDerivedStateFromError(error) {
+		return {
+			failed: true,
+			error
+		};
+	}
+	retry = () => {
+		this.props.onRetry();
+		this.setState({
+			failed: false,
+			error: void 0
+		});
+	};
+	render() {
+		if (!this.state.failed) return this.props.children;
+		const { ErrorComponent, resource } = this.props;
+		if (!isLazyResourceError(this.state.error) || !ErrorComponent) throw this.state.error;
+		return /* @__PURE__ */ jsx(ErrorComponent, {
+			error: this.state.error,
+			retry: this.retry,
+			resource
+		});
+	}
+};
+/** Shared loading, typed error handling and retry for all lazy components. */
+function LazyBoundary({ loader, member, resource, fallback, ErrorComponent, componentProps, onMount, map }) {
+	const [, rerender] = useReducer((value) => value + 1, 0);
+	useEffect(() => onMount?.(), [onMount]);
+	return /* @__PURE__ */ jsx(LazyErrorBoundary, {
+		resource,
+		ErrorComponent,
+		onRetry: () => {
+			loader.reset();
+			rerender();
+		},
+		children: /* @__PURE__ */ jsx(Suspense, {
+			fallback,
+			children: /* @__PURE__ */ jsx(loader.component(member, map), { ...componentProps })
+		})
+	});
+}
+
+//#endregion
+export { LazyBoundary };
+//# sourceMappingURL=lazy-boundary.mjs.map

package/dist/lazy/lazy-boundary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-boundary.mjs","names":[],"sources":["../../src/lazy/lazy-boundary.tsx"],"sourcesContent":["import {\n  Component,\n  Suspense,\n  useEffect,\n  useReducer,\n  type ReactNode,\n} from 'react';\nimport { isLazyResourceError } from '../errors/lazy-resource-error';\nimport type { LazyResourceErrorComponent } from './types';\nimport type { LazyLoader } from './create-lazy-loader';\n\ntype BoundaryProps = {\n  children: ReactNode;\n  ErrorComponent?: LazyResourceErrorComponent;\n  resource: string;\n  onRetry: () => void;\n};\n\nclass LazyErrorBoundary extends Component<\n  BoundaryProps,\n  { failed: boolean; error?: unknown }\n> {\n  state = { failed: false, error: undefined as unknown };\n  static getDerivedStateFromError(error: unknown) {\n    return { failed: true, error };\n  }\n  retry = () => {\n    this.props.onRetry();\n    this.setState({ failed: false, error: undefined });\n  };\n  render() {\n    if (!this.state.failed) return this.props.children;\n    const { ErrorComponent, resource } = this.props;\n    if (!isLazyResourceError(this.state.error) || !ErrorComponent)\n      throw this.state.error;\n    return (\n      <ErrorComponent\n        error={this.state.error}\n        retry={this.retry}\n        resource={resource}\n      />\n    );\n  }\n}\n\n/** Shared loading, typed error handling and retry for all lazy components. */\nexport function LazyBoundary({\n  loader,\n  member,\n  resource,\n  fallback,\n  ErrorComponent,\n  componentProps,\n  onMount,\n  map,\n}: {\n  loader: LazyLoader<any>;\n  member?: PropertyKey;\n  map?: (selected: any) => React.ComponentType<any>;\n  resource: string;\n  fallback?: ReactNode;\n  ErrorComponent?: LazyResourceErrorComponent;\n  componentProps: Record<string, unknown>;\n  onMount?: () => (() => void) | undefined;\n}) {\n  const [, rerender] = useReducer((value) => value + 1, 0);\n  useEffect(() => onMount?.(), [onMount]);\n  const Current = loader.component(member, map);\n  return (\n    <LazyErrorBoundary\n      resource={resource}\n      ErrorComponent={ErrorComponent}\n      onRetry={() => {\n        loader.reset();\n        rerender();\n      }}\n    >\n      <Suspense fallback={fallback}>\n        <Current {...componentProps} />\n      </Suspense>\n    </LazyErrorBoundary>\n  );\n}\n"],"mappings":";;;;;AAkBA,IAAM,oBAAN,cAAgC,UAG9B;CACA,QAAQ;EAAE,QAAQ;EAAO,OAAO;CAAqB;CACrD,OAAO,yBAAyB,OAAgB;EAC9C,OAAO;GAAE,QAAQ;GAAM;EAAM;CAC/B;CACA,cAAc;EACZ,KAAK,MAAM,QAAQ;EACnB,KAAK,SAAS;GAAE,QAAQ;GAAO,OAAO;EAAU,CAAC;CACnD;CACA,SAAS;EACP,IAAI,CAAC,KAAK,MAAM,QAAQ,OAAO,KAAK,MAAM;EAC1C,MAAM,EAAE,gBAAgB,aAAa,KAAK;EAC1C,IAAI,CAAC,oBAAoB,KAAK,MAAM,KAAK,KAAK,CAAC,gBAC7C,MAAM,KAAK,MAAM;EACnB,OACE,oBAAC,gBAAD;GACE,OAAO,KAAK,MAAM;GAClB,OAAO,KAAK;GACF;EACX;CAEL;AACF;;AAGA,SAAgB,aAAa,EAC3B,QACA,QACA,UACA,UACA,gBACA,gBACA,SACA,OAUC;CACD,MAAM,GAAG,YAAY,YAAY,UAAU,QAAQ,GAAG,CAAC;CACvD,gBAAgB,UAAU,GAAG,CAAC,OAAO,CAAC;CAEtC,OACE,oBAAC,mBAAD;EACY;EACM;EAChB,eAAe;GACb,OAAO,MAAM;GACb,SAAS;EACX;YAEA,oBAAC,UAAD;GAAoB;aAClB,oBAXU,OAAO,UAAU,QAAQ,GAW5B,GAAP,EAAS,GAAI,eAAiB;EACtB;CACO;AAEvB"}

package/dist/lazy/scoped-content.cjs

@@ -0,0 +1,87 @@
+const require_lazy_resource_error = require('../errors/lazy-resource-error.cjs');
+const require_lazy_boundary = require('./lazy-boundary.cjs');
+const require_fallback_props = require('./fallback-props.cjs');
+const require_create_lazy_loader = require('./create-lazy-loader.cjs');
+const require_inspection = require('./inspection.cjs');
+const require_render_state = require('../create-config/render-state.cjs');
+const require_scoped_render = require('../create-config/for-resources/scoped-render.cjs');
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+let _jfdevelops_react_layout_devtools_core = require("@jfdevelops/react-layout-devtools-core");
+
+//#region src/lazy/scoped-content.tsx
+const scopedLazySymbol = Symbol("scopedLazy");
+/** Content is imported only when rendered or preloaded, never during shell creation. */
+function createScopedLazyContent(input, resource, label, environment) {
+	const options = typeof input.lazy === "function" ? { load: input.lazy } : input.lazy;
+	const componentId = environment?.store.node({
+		id: (0, _jfdevelops_react_layout_devtools_core.inspectionId)("component"),
+		kind: "component",
+		label,
+		details: { resource }
+	});
+	if (componentId && environment) environment.store.edge(environment.parent, componentId, "declares");
+	const inspection = require_inspection.inspectLazy(label, environment?.store, componentId);
+	if (componentId) inspection.hooks.onMount = () => inspection.store.mount(componentId, inspection.id);
+	const loader = require_create_lazy_loader.createLazyLoader({
+		load: options.load,
+		label,
+		hooks: inspection.hooks,
+		async select(module) {
+			const candidates = Object.values(module).filter((value) => require_scoped_render.isRenderableComponentType(value) || typeof value === "object" && value !== null && require_render_state.definedRenderStateSymbol in value);
+			if (candidates.length !== 1) throw new require_lazy_resource_error.LazyResourceModuleShapeError(label, candidates.length);
+			const selected = candidates[0];
+			const render = typeof selected === "object" && selected !== null && require_render_state.definedRenderStateSymbol in selected ? (await require_render_state.findDefinedRenderState({ State: selected }, label)).render : selected;
+			function Loaded({ callProps, context }) {
+				if (typeof render !== "function" || render.prototype?.isReactComponent) return (0, react.createElement)(render, callProps);
+				return require_scoped_render.resolveScopedRenderResult(render(callProps, context), callProps);
+			}
+			return Loaded;
+		}
+	});
+	const Content = require_inspection.withLazyHandle(function LazyScopedContent({ callProps, context }) {
+		const defaults = environment?.defaults() ?? {};
+		const currentProps = (0, react.useRef)(callProps);
+		currentProps.current = callProps;
+		const fallbackStates = (0, react.useRef)();
+		fallbackStates.current ??= environment?.states?.(resource, callProps) ?? {};
+		const nearest = fallbackStates.current;
+		const errorComponent = (0, react.useRef)();
+		const NearestError = nearest.Error;
+		if (NearestError && !errorComponent.current) errorComponent.current = function ScopedFallbackError(props) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_fallback_props.LazyFallbackPropsContext.Provider, {
+				value: {
+					owner: nearest.owner,
+					props: currentProps.current
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NearestError, { ...props })
+			});
+		};
+		const Loading = nearest.Loading ?? defaults.Loading;
+		const fallback = input.fallback !== void 0 ? input.fallback : options.fallback;
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_lazy_boundary.LazyBoundary, {
+			loader,
+			resource,
+			componentProps: {
+				callProps,
+				context
+			},
+			ErrorComponent: errorComponent.current ?? defaults.Error,
+			onMount: inspection.hooks.onMount,
+			fallback: fallback !== void 0 ? fallback : Loading ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_fallback_props.LazyFallbackPropsContext.Provider, {
+				value: {
+					owner: nearest.owner,
+					props: callProps
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Loading, { resource })
+			}) : null
+		});
+	}, loader);
+	inspection.store.attach(Content);
+	return Content;
+}
+
+//#endregion
+exports.createScopedLazyContent = createScopedLazyContent;
+exports.scopedLazySymbol = scopedLazySymbol;
+//# sourceMappingURL=scoped-content.cjs.map

package/dist/lazy/scoped-content.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-content.cjs","names":["inspectLazy","createLazyLoader","isRenderableComponentType","definedRenderStateSymbol","LazyResourceModuleShapeError","findDefinedRenderState","resolveScopedRenderResult","withLazyHandle","LazyFallbackPropsContext","LazyBoundary"],"sources":["../../src/lazy/scoped-content.tsx"],"sourcesContent":["import { LazyFallbackPropsContext } from './fallback-props';\nimport { createElement, useRef, type ComponentType } from 'react';\nimport type { LazyOptions, LazyResourceStates } from './types';\nimport { createLazyLoader } from './create-lazy-loader';\nimport { LazyBoundary } from './lazy-boundary';\nimport { inspectLazy, withLazyHandle } from './inspection';\nimport { LazyResourceModuleShapeError } from '../errors/lazy-resource-error';\nimport {\n  definedRenderStateSymbol,\n  findDefinedRenderState,\n} from '../create-config/render-state';\nimport {\n  isRenderableComponentType,\n  resolveScopedRenderResult,\n  type ScopedRenderResult,\n} from '../create-config/for-resources/scoped-render';\nimport {\n  inspectionId,\n  type InspectionStore,\n} from '@jfdevelops/react-layout-devtools-core';\n\nexport type ScopedComponentRenderFn<\n  Props = Record<string, unknown>,\n  Context = Record<string, ComponentType<any>>,\n> = (props: Props, context: Context) => ScopedRenderResult;\n\nexport type ScopedLazyContent<Render> =\n  | { render: Render; lazy?: never; fallback?: never }\n  | {\n      render?: never;\n      lazy: LazyOptions['load'] | LazyOptions;\n      fallback?: React.ReactNode;\n    };\n\nexport type LazyEnvironment = {\n  store: InspectionStore;\n  parent: string;\n  defaults: () => LazyResourceStates;\n  states?: (\n    resource: string,\n    props: Record<string, unknown>,\n  ) => LazyResourceStates & { owner?: string };\n};\n\nexport const scopedLazySymbol = Symbol('scopedLazy');\n\n/** Content is imported only when rendered or preloaded, never during shell creation. */\nexport function createScopedLazyContent(\n  input: {\n    lazy: LazyOptions['load'] | LazyOptions;\n    fallback?: React.ReactNode;\n  },\n  resource: string,\n  label: string,\n  environment?: LazyEnvironment,\n) {\n  const options =\n    typeof input.lazy === 'function' ? { load: input.lazy } : input.lazy;\n  const componentId = environment?.store.node({\n    id: inspectionId('component'),\n    kind: 'component',\n    label,\n    details: { resource },\n  });\n  if (componentId && environment) {\n    environment.store.edge(environment.parent, componentId, 'declares');\n  }\n  const inspection = inspectLazy(label, environment?.store, componentId);\n  if (componentId) {\n    inspection.hooks.onMount = () =>\n      inspection.store.mount(componentId, inspection.id);\n  }\n  const loader = createLazyLoader({\n    load: options.load,\n    label,\n    hooks: inspection.hooks,\n    async select(module) {\n      const candidates = Object.values(module).filter(\n        (value) =>\n          isRenderableComponentType(value) ||\n          (typeof value === 'object' &&\n            value !== null &&\n            definedRenderStateSymbol in value),\n      );\n      if (candidates.length !== 1)\n        throw new LazyResourceModuleShapeError(label, candidates.length);\n      const selected = candidates[0];\n      const render =\n        typeof selected === 'object' &&\n        selected !== null &&\n        definedRenderStateSymbol in selected\n          ? (await findDefinedRenderState({ State: selected }, label)).render\n          : (selected as ScopedComponentRenderFn);\n      // The render callback runs as a React component so hooks remain legal.\n      function Loaded({\n        callProps,\n        context,\n      }: {\n        callProps: Record<string, unknown>;\n        context: Record<string, ComponentType<any>>;\n      }) {\n        if (\n          typeof render !== 'function' ||\n          (render as unknown as { prototype?: { isReactComponent?: unknown } })\n            .prototype?.isReactComponent\n        )\n          return createElement(render as ComponentType<any>, callProps);\n        return resolveScopedRenderResult(render(callProps, context), callProps);\n      }\n      return Loaded;\n    },\n  });\n  const Content = withLazyHandle(function LazyScopedContent({\n    callProps,\n    context,\n  }: {\n    callProps: Record<string, unknown>;\n    context: Record<string, ComponentType<any>>;\n  }) {\n    const defaults = environment?.defaults() ?? {};\n    const currentProps = useRef(callProps);\n    currentProps.current = callProps;\n    const fallbackStates = useRef<LazyResourceStates & { owner?: string }>();\n    fallbackStates.current ??= environment?.states?.(resource, callProps) ?? {};\n    const nearest = fallbackStates.current;\n    const errorComponent = useRef<LazyResourceStates['Error']>();\n    const NearestError = nearest.Error;\n    if (NearestError && !errorComponent.current) {\n      errorComponent.current = function ScopedFallbackError(props) {\n        return (\n          <LazyFallbackPropsContext.Provider\n            value={{ owner: nearest.owner, props: currentProps.current }}\n          >\n            <NearestError {...props} />\n          </LazyFallbackPropsContext.Provider>\n        );\n      };\n    }\n    const Loading = nearest.Loading ?? defaults.Loading;\n    const fallback =\n      input.fallback !== undefined ? input.fallback : options.fallback;\n    return (\n      <LazyBoundary\n        loader={loader}\n        resource={resource}\n        componentProps={{ callProps, context }}\n        ErrorComponent={errorComponent.current ?? defaults.Error}\n        onMount={inspection.hooks.onMount}\n        fallback={\n          fallback !== undefined ? (\n            fallback\n          ) : Loading ? (\n            <LazyFallbackPropsContext.Provider\n              value={{ owner: nearest.owner, props: callProps }}\n            >\n              <Loading resource={resource} />\n            </LazyFallbackPropsContext.Provider>\n          ) : null\n        }\n      />\n    );\n  }, loader);\n  inspection.store.attach(Content);\n  return Content;\n}\n"],"mappings":";;;;;;;;;;;;AA4CA,MAAa,mBAAmB,OAAO,YAAY;;AAGnD,SAAgB,wBACd,OAIA,UACA,OACA,aACA;CACA,MAAM,UACJ,OAAO,MAAM,SAAS,aAAa,EAAE,MAAM,MAAM,KAAK,IAAI,MAAM;CAClE,MAAM,cAAc,aAAa,MAAM,KAAK;EAC1C,6DAAiB,WAAW;EAC5B,MAAM;EACN;EACA,SAAS,EAAE,SAAS;CACtB,CAAC;CACD,IAAI,eAAe,aACjB,YAAY,MAAM,KAAK,YAAY,QAAQ,aAAa,UAAU;CAEpE,MAAM,aAAaA,+BAAY,OAAO,aAAa,OAAO,WAAW;CACrE,IAAI,aACF,WAAW,MAAM,gBACf,WAAW,MAAM,MAAM,aAAa,WAAW,EAAE;CAErD,MAAM,SAASC,4CAAiB;EAC9B,MAAM,QAAQ;EACd;EACA,OAAO,WAAW;EAClB,MAAM,OAAO,QAAQ;GACnB,MAAM,aAAa,OAAO,OAAO,MAAM,EAAE,QACtC,UACCC,gDAA0B,KAAK,KAC9B,OAAO,UAAU,YAChB,UAAU,QACVC,iDAA4B,KAClC;GACA,IAAI,WAAW,WAAW,GACxB,MAAM,IAAIC,yDAA6B,OAAO,WAAW,MAAM;GACjE,MAAM,WAAW,WAAW;GAC5B,MAAM,SACJ,OAAO,aAAa,YACpB,aAAa,QACbD,iDAA4B,YACvB,MAAME,4CAAuB,EAAE,OAAO,SAAS,GAAG,KAAK,GAAG,SAC1D;GAEP,SAAS,OAAO,EACd,WACA,WAIC;IACD,IACE,OAAO,WAAW,cACjB,OACE,WAAW,kBAEd,gCAAqB,QAA8B,SAAS;IAC9D,OAAOC,gDAA0B,OAAO,WAAW,OAAO,GAAG,SAAS;GACxE;GACA,OAAO;EACT;CACF,CAAC;CACD,MAAM,UAAUC,kCAAe,SAAS,kBAAkB,EACxD,WACA,WAIC;EACD,MAAM,WAAW,aAAa,SAAS,KAAK,CAAC;EAC7C,MAAM,iCAAsB,SAAS;EACrC,aAAa,UAAU;EACvB,MAAM,mCAAiE;EACvE,eAAe,YAAY,aAAa,SAAS,UAAU,SAAS,KAAK,CAAC;EAC1E,MAAM,UAAU,eAAe;EAC/B,MAAM,mCAAqD;EAC3D,MAAM,eAAe,QAAQ;EAC7B,IAAI,gBAAgB,CAAC,eAAe,SAClC,eAAe,UAAU,SAAS,oBAAoB,OAAO;GAC3D,OACE,2CAACC,gDAAyB,UAA1B;IACE,OAAO;KAAE,OAAO,QAAQ;KAAO,OAAO,aAAa;IAAQ;cAE3D,2CAAC,cAAD,EAAc,GAAI,MAAQ;GACO;EAEvC;EAEF,MAAM,UAAU,QAAQ,WAAW,SAAS;EAC5C,MAAM,WACJ,MAAM,aAAa,SAAY,MAAM,WAAW,QAAQ;EAC1D,OACE,2CAACC,oCAAD;GACU;GACE;GACV,gBAAgB;IAAE;IAAW;GAAQ;GACrC,gBAAgB,eAAe,WAAW,SAAS;GACnD,SAAS,WAAW,MAAM;GAC1B,UACE,aAAa,SACX,WACE,UACF,2CAACD,gDAAyB,UAA1B;IACE,OAAO;KAAE,OAAO,QAAQ;KAAO,OAAO;IAAU;cAEhD,2CAAC,SAAD,EAAmB,SAAW;GACG,KACjC;EAEP;CAEL,GAAG,MAAM;CACT,WAAW,MAAM,OAAO,OAAO;CAC/B,OAAO;AACT"}

package/dist/lazy/scoped-content.d.cts

@@ -0,0 +1,19 @@
+import { LazyOptions } from "./types.cjs";
+import { ScopedRenderResult } from "../create-config/for-resources/scoped-render.cjs";
+import { ComponentType } from "react";
+import { InspectionStore } from "@jfdevelops/react-layout-devtools-core";
+
+//#region src/lazy/scoped-content.d.ts
+type ScopedComponentRenderFn<Props = Record<string, unknown>, Context = Record<string, ComponentType<any>>> = (props: Props, context: Context) => ScopedRenderResult;
+type ScopedLazyContent<Render> = {
+  render: Render;
+  lazy?: never;
+  fallback?: never;
+} | {
+  render?: never;
+  lazy: LazyOptions['load'] | LazyOptions;
+  fallback?: React.ReactNode;
+};
+//#endregion
+export { ScopedComponentRenderFn, ScopedLazyContent };
+//# sourceMappingURL=scoped-content.d.cts.map

package/dist/lazy/scoped-content.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-content.d.cts","names":[],"sources":["../../src/lazy/scoped-content.tsx"],"mappings":";;;;;;KAqBY,uBAAA,SACF,MAAA,6BACE,MAAA,SAAe,aAAA,WACtB,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,OAAA,KAAY,kBAAA;AAAA,KAE5B,iBAAA;EACN,MAAA,EAAQ,MAAA;EAAQ,IAAA;EAAc,QAAA;AAAA;EAE9B,MAAA;EACA,IAAA,EAAM,WAAA,WAAsB,WAAA;EAC5B,QAAA,GAAW,KAAA,CAAM,SAAA;AAAA"}

package/dist/lazy/scoped-content.d.mts

@@ -0,0 +1,19 @@
+import { LazyOptions } from "./types.mjs";
+import { ScopedRenderResult } from "../create-config/for-resources/scoped-render.mjs";
+import { ComponentType } from "react";
+import { InspectionStore } from "@jfdevelops/react-layout-devtools-core";
+
+//#region src/lazy/scoped-content.d.ts
+type ScopedComponentRenderFn<Props = Record<string, unknown>, Context = Record<string, ComponentType<any>>> = (props: Props, context: Context) => ScopedRenderResult;
+type ScopedLazyContent<Render> = {
+  render: Render;
+  lazy?: never;
+  fallback?: never;
+} | {
+  render?: never;
+  lazy: LazyOptions['load'] | LazyOptions;
+  fallback?: React.ReactNode;
+};
+//#endregion
+export { ScopedComponentRenderFn, ScopedLazyContent };
+//# sourceMappingURL=scoped-content.d.mts.map

package/dist/lazy/scoped-content.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-content.d.mts","names":[],"sources":["../../src/lazy/scoped-content.tsx"],"mappings":";;;;;;KAqBY,uBAAA,SACF,MAAA,6BACE,MAAA,SAAe,aAAA,WACtB,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,OAAA,KAAY,kBAAA;AAAA,KAE5B,iBAAA;EACN,MAAA,EAAQ,MAAA;EAAQ,IAAA;EAAc,QAAA;AAAA;EAE9B,MAAA;EACA,IAAA,EAAM,WAAA,WAAsB,WAAA;EAC5B,QAAA,GAAW,KAAA,CAAM,SAAA;AAAA"}

package/dist/lazy/scoped-content.mjs

@@ -0,0 +1,86 @@
+import { LazyResourceModuleShapeError } from "../errors/lazy-resource-error.mjs";
+import { LazyBoundary } from "./lazy-boundary.mjs";
+import { LazyFallbackPropsContext } from "./fallback-props.mjs";
+import { createLazyLoader } from "./create-lazy-loader.mjs";
+import { inspectLazy, withLazyHandle } from "./inspection.mjs";
+import { definedRenderStateSymbol, findDefinedRenderState } from "../create-config/render-state.mjs";
+import { isRenderableComponentType, resolveScopedRenderResult } from "../create-config/for-resources/scoped-render.mjs";
+import { createElement, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+import { inspectionId } from "@jfdevelops/react-layout-devtools-core";
+
+//#region src/lazy/scoped-content.tsx
+const scopedLazySymbol = Symbol("scopedLazy");
+/** Content is imported only when rendered or preloaded, never during shell creation. */
+function createScopedLazyContent(input, resource, label, environment) {
+	const options = typeof input.lazy === "function" ? { load: input.lazy } : input.lazy;
+	const componentId = environment?.store.node({
+		id: inspectionId("component"),
+		kind: "component",
+		label,
+		details: { resource }
+	});
+	if (componentId && environment) environment.store.edge(environment.parent, componentId, "declares");
+	const inspection = inspectLazy(label, environment?.store, componentId);
+	if (componentId) inspection.hooks.onMount = () => inspection.store.mount(componentId, inspection.id);
+	const loader = createLazyLoader({
+		load: options.load,
+		label,
+		hooks: inspection.hooks,
+		async select(module) {
+			const candidates = Object.values(module).filter((value) => isRenderableComponentType(value) || typeof value === "object" && value !== null && definedRenderStateSymbol in value);
+			if (candidates.length !== 1) throw new LazyResourceModuleShapeError(label, candidates.length);
+			const selected = candidates[0];
+			const render = typeof selected === "object" && selected !== null && definedRenderStateSymbol in selected ? (await findDefinedRenderState({ State: selected }, label)).render : selected;
+			function Loaded({ callProps, context }) {
+				if (typeof render !== "function" || render.prototype?.isReactComponent) return createElement(render, callProps);
+				return resolveScopedRenderResult(render(callProps, context), callProps);
+			}
+			return Loaded;
+		}
+	});
+	const Content = withLazyHandle(function LazyScopedContent({ callProps, context }) {
+		const defaults = environment?.defaults() ?? {};
+		const currentProps = useRef(callProps);
+		currentProps.current = callProps;
+		const fallbackStates = useRef();
+		fallbackStates.current ??= environment?.states?.(resource, callProps) ?? {};
+		const nearest = fallbackStates.current;
+		const errorComponent = useRef();
+		const NearestError = nearest.Error;
+		if (NearestError && !errorComponent.current) errorComponent.current = function ScopedFallbackError(props) {
+			return /* @__PURE__ */ jsx(LazyFallbackPropsContext.Provider, {
+				value: {
+					owner: nearest.owner,
+					props: currentProps.current
+				},
+				children: /* @__PURE__ */ jsx(NearestError, { ...props })
+			});
+		};
+		const Loading = nearest.Loading ?? defaults.Loading;
+		const fallback = input.fallback !== void 0 ? input.fallback : options.fallback;
+		return /* @__PURE__ */ jsx(LazyBoundary, {
+			loader,
+			resource,
+			componentProps: {
+				callProps,
+				context
+			},
+			ErrorComponent: errorComponent.current ?? defaults.Error,
+			onMount: inspection.hooks.onMount,
+			fallback: fallback !== void 0 ? fallback : Loading ? /* @__PURE__ */ jsx(LazyFallbackPropsContext.Provider, {
+				value: {
+					owner: nearest.owner,
+					props: callProps
+				},
+				children: /* @__PURE__ */ jsx(Loading, { resource })
+			}) : null
+		});
+	}, loader);
+	inspection.store.attach(Content);
+	return Content;
+}
+
+//#endregion
+export { createScopedLazyContent, scopedLazySymbol };
+//# sourceMappingURL=scoped-content.mjs.map

package/dist/lazy/scoped-content.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-content.mjs","names":[],"sources":["../../src/lazy/scoped-content.tsx"],"sourcesContent":["import { LazyFallbackPropsContext } from './fallback-props';\nimport { createElement, useRef, type ComponentType } from 'react';\nimport type { LazyOptions, LazyResourceStates } from './types';\nimport { createLazyLoader } from './create-lazy-loader';\nimport { LazyBoundary } from './lazy-boundary';\nimport { inspectLazy, withLazyHandle } from './inspection';\nimport { LazyResourceModuleShapeError } from '../errors/lazy-resource-error';\nimport {\n  definedRenderStateSymbol,\n  findDefinedRenderState,\n} from '../create-config/render-state';\nimport {\n  isRenderableComponentType,\n  resolveScopedRenderResult,\n  type ScopedRenderResult,\n} from '../create-config/for-resources/scoped-render';\nimport {\n  inspectionId,\n  type InspectionStore,\n} from '@jfdevelops/react-layout-devtools-core';\n\nexport type ScopedComponentRenderFn<\n  Props = Record<string, unknown>,\n  Context = Record<string, ComponentType<any>>,\n> = (props: Props, context: Context) => ScopedRenderResult;\n\nexport type ScopedLazyContent<Render> =\n  | { render: Render; lazy?: never; fallback?: never }\n  | {\n      render?: never;\n      lazy: LazyOptions['load'] | LazyOptions;\n      fallback?: React.ReactNode;\n    };\n\nexport type LazyEnvironment = {\n  store: InspectionStore;\n  parent: string;\n  defaults: () => LazyResourceStates;\n  states?: (\n    resource: string,\n    props: Record<string, unknown>,\n  ) => LazyResourceStates & { owner?: string };\n};\n\nexport const scopedLazySymbol = Symbol('scopedLazy');\n\n/** Content is imported only when rendered or preloaded, never during shell creation. */\nexport function createScopedLazyContent(\n  input: {\n    lazy: LazyOptions['load'] | LazyOptions;\n    fallback?: React.ReactNode;\n  },\n  resource: string,\n  label: string,\n  environment?: LazyEnvironment,\n) {\n  const options =\n    typeof input.lazy === 'function' ? { load: input.lazy } : input.lazy;\n  const componentId = environment?.store.node({\n    id: inspectionId('component'),\n    kind: 'component',\n    label,\n    details: { resource },\n  });\n  if (componentId && environment) {\n    environment.store.edge(environment.parent, componentId, 'declares');\n  }\n  const inspection = inspectLazy(label, environment?.store, componentId);\n  if (componentId) {\n    inspection.hooks.onMount = () =>\n      inspection.store.mount(componentId, inspection.id);\n  }\n  const loader = createLazyLoader({\n    load: options.load,\n    label,\n    hooks: inspection.hooks,\n    async select(module) {\n      const candidates = Object.values(module).filter(\n        (value) =>\n          isRenderableComponentType(value) ||\n          (typeof value === 'object' &&\n            value !== null &&\n            definedRenderStateSymbol in value),\n      );\n      if (candidates.length !== 1)\n        throw new LazyResourceModuleShapeError(label, candidates.length);\n      const selected = candidates[0];\n      const render =\n        typeof selected === 'object' &&\n        selected !== null &&\n        definedRenderStateSymbol in selected\n          ? (await findDefinedRenderState({ State: selected }, label)).render\n          : (selected as ScopedComponentRenderFn);\n      // The render callback runs as a React component so hooks remain legal.\n      function Loaded({\n        callProps,\n        context,\n      }: {\n        callProps: Record<string, unknown>;\n        context: Record<string, ComponentType<any>>;\n      }) {\n        if (\n          typeof render !== 'function' ||\n          (render as unknown as { prototype?: { isReactComponent?: unknown } })\n            .prototype?.isReactComponent\n        )\n          return createElement(render as ComponentType<any>, callProps);\n        return resolveScopedRenderResult(render(callProps, context), callProps);\n      }\n      return Loaded;\n    },\n  });\n  const Content = withLazyHandle(function LazyScopedContent({\n    callProps,\n    context,\n  }: {\n    callProps: Record<string, unknown>;\n    context: Record<string, ComponentType<any>>;\n  }) {\n    const defaults = environment?.defaults() ?? {};\n    const currentProps = useRef(callProps);\n    currentProps.current = callProps;\n    const fallbackStates = useRef<LazyResourceStates & { owner?: string }>();\n    fallbackStates.current ??= environment?.states?.(resource, callProps) ?? {};\n    const nearest = fallbackStates.current;\n    const errorComponent = useRef<LazyResourceStates['Error']>();\n    const NearestError = nearest.Error;\n    if (NearestError && !errorComponent.current) {\n      errorComponent.current = function ScopedFallbackError(props) {\n        return (\n          <LazyFallbackPropsContext.Provider\n            value={{ owner: nearest.owner, props: currentProps.current }}\n          >\n            <NearestError {...props} />\n          </LazyFallbackPropsContext.Provider>\n        );\n      };\n    }\n    const Loading = nearest.Loading ?? defaults.Loading;\n    const fallback =\n      input.fallback !== undefined ? input.fallback : options.fallback;\n    return (\n      <LazyBoundary\n        loader={loader}\n        resource={resource}\n        componentProps={{ callProps, context }}\n        ErrorComponent={errorComponent.current ?? defaults.Error}\n        onMount={inspection.hooks.onMount}\n        fallback={\n          fallback !== undefined ? (\n            fallback\n          ) : Loading ? (\n            <LazyFallbackPropsContext.Provider\n              value={{ owner: nearest.owner, props: callProps }}\n            >\n              <Loading resource={resource} />\n            </LazyFallbackPropsContext.Provider>\n          ) : null\n        }\n      />\n    );\n  }, loader);\n  inspection.store.attach(Content);\n  return Content;\n}\n"],"mappings":";;;;;;;;;;;;AA4CA,MAAa,mBAAmB,OAAO,YAAY;;AAGnD,SAAgB,wBACd,OAIA,UACA,OACA,aACA;CACA,MAAM,UACJ,OAAO,MAAM,SAAS,aAAa,EAAE,MAAM,MAAM,KAAK,IAAI,MAAM;CAClE,MAAM,cAAc,aAAa,MAAM,KAAK;EAC1C,IAAI,aAAa,WAAW;EAC5B,MAAM;EACN;EACA,SAAS,EAAE,SAAS;CACtB,CAAC;CACD,IAAI,eAAe,aACjB,YAAY,MAAM,KAAK,YAAY,QAAQ,aAAa,UAAU;CAEpE,MAAM,aAAa,YAAY,OAAO,aAAa,OAAO,WAAW;CACrE,IAAI,aACF,WAAW,MAAM,gBACf,WAAW,MAAM,MAAM,aAAa,WAAW,EAAE;CAErD,MAAM,SAAS,iBAAiB;EAC9B,MAAM,QAAQ;EACd;EACA,OAAO,WAAW;EAClB,MAAM,OAAO,QAAQ;GACnB,MAAM,aAAa,OAAO,OAAO,MAAM,EAAE,QACtC,UACC,0BAA0B,KAAK,KAC9B,OAAO,UAAU,YAChB,UAAU,QACV,4BAA4B,KAClC;GACA,IAAI,WAAW,WAAW,GACxB,MAAM,IAAI,6BAA6B,OAAO,WAAW,MAAM;GACjE,MAAM,WAAW,WAAW;GAC5B,MAAM,SACJ,OAAO,aAAa,YACpB,aAAa,QACb,4BAA4B,YACvB,MAAM,uBAAuB,EAAE,OAAO,SAAS,GAAG,KAAK,GAAG,SAC1D;GAEP,SAAS,OAAO,EACd,WACA,WAIC;IACD,IACE,OAAO,WAAW,cACjB,OACE,WAAW,kBAEd,OAAO,cAAc,QAA8B,SAAS;IAC9D,OAAO,0BAA0B,OAAO,WAAW,OAAO,GAAG,SAAS;GACxE;GACA,OAAO;EACT;CACF,CAAC;CACD,MAAM,UAAU,eAAe,SAAS,kBAAkB,EACxD,WACA,WAIC;EACD,MAAM,WAAW,aAAa,SAAS,KAAK,CAAC;EAC7C,MAAM,eAAe,OAAO,SAAS;EACrC,aAAa,UAAU;EACvB,MAAM,iBAAiB,OAAgD;EACvE,eAAe,YAAY,aAAa,SAAS,UAAU,SAAS,KAAK,CAAC;EAC1E,MAAM,UAAU,eAAe;EAC/B,MAAM,iBAAiB,OAAoC;EAC3D,MAAM,eAAe,QAAQ;EAC7B,IAAI,gBAAgB,CAAC,eAAe,SAClC,eAAe,UAAU,SAAS,oBAAoB,OAAO;GAC3D,OACE,oBAAC,yBAAyB,UAA1B;IACE,OAAO;KAAE,OAAO,QAAQ;KAAO,OAAO,aAAa;IAAQ;cAE3D,oBAAC,cAAD,EAAc,GAAI,MAAQ;GACO;EAEvC;EAEF,MAAM,UAAU,QAAQ,WAAW,SAAS;EAC5C,MAAM,WACJ,MAAM,aAAa,SAAY,MAAM,WAAW,QAAQ;EAC1D,OACE,oBAAC,cAAD;GACU;GACE;GACV,gBAAgB;IAAE;IAAW;GAAQ;GACrC,gBAAgB,eAAe,WAAW,SAAS;GACnD,SAAS,WAAW,MAAM;GAC1B,UACE,aAAa,SACX,WACE,UACF,oBAAC,yBAAyB,UAA1B;IACE,OAAO;KAAE,OAAO,QAAQ;KAAO,OAAO;IAAU;cAEhD,oBAAC,SAAD,EAAmB,SAAW;GACG,KACjC;EAEP;CAEL,GAAG,MAAM;CACT,WAAW,MAAM,OAAO,OAAO;CAC/B,OAAO;AACT"}

package/dist/lazy/types.cjs

@@ -0,0 +1,10 @@
+
+//#region src/lazy/types.ts
+/** Internal factory defaults propagated to layouts without publishing metadata. */
+const lazyDefaultsSymbol = Symbol("lazyDefaults");
+const lazyStatesSymbol = Symbol("lazyStates");
+
+//#endregion
+exports.lazyDefaultsSymbol = lazyDefaultsSymbol;
+exports.lazyStatesSymbol = lazyStatesSymbol;
+//# sourceMappingURL=types.cjs.map

package/dist/lazy/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/lazy/types.ts"],"sourcesContent":["import type { ComponentType, ReactNode } from 'react';\nimport type { LoadStatus } from '@jfdevelops/react-layout-devtools-core';\nimport type {\n  LazyResourceError,\n  LazyResourceErrorMap,\n} from '../errors/lazy-resource-error';\n\nexport type { LoadStatus } from '@jfdevelops/react-layout-devtools-core';\n\n/** Options shared by lazy layouts, render states, and scoped content. */\nexport type LazyOptions<\n  Module extends Record<string, unknown> = Record<string, unknown>,\n> = {\n  load: () => Promise<Module>;\n  fallback?: ReactNode;\n};\n\nexport type LazyHandle = {\n  preload(): Promise<void>;\n  readonly status: LoadStatus;\n};\n\nexport type LazyResourceErrorProps<Resource = string> = {\n  error: LazyResourceError;\n  retry: () => void;\n  resource: Resource;\n};\n\nexport type LazyResourceErrorComponent<Resource = string> = ComponentType<\n  LazyResourceErrorProps<Resource>\n>;\nexport type LazyResourceLoadingComponent<Resource = string> = ComponentType<{\n  resource: Resource;\n}>;\nexport type LazyResourceStates<Resource = string> = {\n  Error?: LazyResourceErrorComponent<Resource>;\n  Loading?: LazyResourceLoadingComponent<Resource>;\n};\n\nexport type LazyErrorHandlers<Resource, Custom extends object = {}> = {\n  [Code in LazyResourceError['code']]?: (\n    props: Custom &\n      Omit<LazyResourceErrorProps<Resource>, 'error'> & {\n        error: LazyResourceErrorMap[Code];\n      },\n  ) => ReactNode;\n} & {\n  fallback?: (props: Custom & LazyResourceErrorProps<Resource>) => ReactNode;\n};\n\nexport type CreateLazyErrorComponent<Resource> = {\n  <Custom extends object = {}>(\n    render: (props: Custom & LazyResourceErrorProps<Resource>) => ReactNode,\n  ): ComponentType<Custom & LazyResourceErrorProps<Resource>>;\n  <Custom extends object = {}>(\n    handlers: LazyErrorHandlers<Resource, Custom>,\n  ): ComponentType<Custom & LazyResourceErrorProps<Resource>>;\n};\n\n/** Internal factory defaults propagated to layouts without publishing metadata. */\nexport const lazyDefaultsSymbol = Symbol('lazyDefaults');\n\nexport const lazyStatesSymbol = Symbol('lazyStates');\n"],"mappings":";;;AA4DA,MAAa,qBAAqB,OAAO,cAAc;AAEvD,MAAa,mBAAmB,OAAO,YAAY"}

package/dist/lazy/types.d.cts

@@ -0,0 +1,39 @@
+import { LazyResourceError, LazyResourceErrorMap } from "../errors/lazy-resource-error.cjs";
+import { ComponentType, ReactNode } from "react";
+import { LoadStatus, LoadStatus as LoadStatus$1 } from "@jfdevelops/react-layout-devtools-core";
+
+//#region src/lazy/types.d.ts
+/** Options shared by lazy layouts, render states, and scoped content. */
+type LazyOptions<Module extends Record<string, unknown> = Record<string, unknown>> = {
+  load: () => Promise<Module>;
+  fallback?: ReactNode;
+};
+type LazyHandle = {
+  preload(): Promise<void>;
+  readonly status: LoadStatus;
+};
+type LazyResourceErrorProps<Resource = string> = {
+  error: LazyResourceError;
+  retry: () => void;
+  resource: Resource;
+};
+type LazyResourceErrorComponent<Resource = string> = ComponentType<LazyResourceErrorProps<Resource>>;
+type LazyResourceLoadingComponent<Resource = string> = ComponentType<{
+  resource: Resource;
+}>;
+type LazyResourceStates<Resource = string> = {
+  Error?: LazyResourceErrorComponent<Resource>;
+  Loading?: LazyResourceLoadingComponent<Resource>;
+};
+type LazyErrorHandlers<Resource, Custom extends object = {}> = { [Code in LazyResourceError['code']]?: (props: Custom & Omit<LazyResourceErrorProps<Resource>, 'error'> & {
+  error: LazyResourceErrorMap[Code];
+}) => ReactNode } & {
+  fallback?: (props: Custom & LazyResourceErrorProps<Resource>) => ReactNode;
+};
+type CreateLazyErrorComponent<Resource> = {
+  <Custom extends object = {}>(render: (props: Custom & LazyResourceErrorProps<Resource>) => ReactNode): ComponentType<Custom & LazyResourceErrorProps<Resource>>;
+  <Custom extends object = {}>(handlers: LazyErrorHandlers<Resource, Custom>): ComponentType<Custom & LazyResourceErrorProps<Resource>>;
+};
+//#endregion
+export { CreateLazyErrorComponent, LazyErrorHandlers, LazyHandle, LazyOptions, LazyResourceErrorComponent, LazyResourceErrorProps, LazyResourceLoadingComponent, LazyResourceStates, type LoadStatus$1 as LoadStatus };
+//# sourceMappingURL=types.d.cts.map

package/dist/lazy/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/lazy/types.ts"],"mappings":";;;;;;KAUY,WAAA,gBACK,MAAA,oBAA0B,MAAA;EAEzC,IAAA,QAAY,OAAA,CAAQ,MAAA;EACpB,QAAA,GAAW,SAAA;AAAA;AAAA,KAGD,UAAA;EACV,OAAA,IAAW,OAAA;EAAA,SACF,MAAA,EAAQ,UAAU;AAAA;AAAA,KAGjB,sBAAA;EACV,KAAA,EAAO,iBAAA;EACP,KAAA;EACA,QAAA,EAAU,QAAQ;AAAA;AAAA,KAGR,0BAAA,sBAAgD,aAAA,CAC1D,sBAAA,CAAuB,QAAA;AAAA,KAEb,4BAAA,sBAAkD,aAAa;EACzE,QAAA,EAAU,QAAA;AAAA;AAAA,KAEA,kBAAA;EACV,KAAA,GAAQ,0BAAA,CAA2B,QAAA;EACnC,OAAA,GAAU,4BAAA,CAA6B,QAAA;AAAA;AAAA,KAG7B,iBAAA,oDACD,iBAAA,aACP,KAAA,EAAO,MAAA,GACL,IAAA,CAAK,sBAAA,CAAuB,QAAA;EAC1B,KAAA,EAAO,oBAAA,CAAqB,IAAA;AAAA,MAE7B,SAAA;EAEL,QAAA,IAAY,KAAA,EAAO,MAAA,GAAS,sBAAA,CAAuB,QAAA,MAAc,SAAA;AAAA;AAAA,KAGvD,wBAAA;EAAA,6BAER,MAAA,GAAS,KAAA,EAAO,MAAA,GAAS,sBAAA,CAAuB,QAAA,MAAc,SAAA,GAC7D,aAAA,CAAc,MAAA,GAAS,sBAAA,CAAuB,QAAA;EAAA,6BAE/C,QAAA,EAAU,iBAAA,CAAkB,QAAA,EAAU,MAAA,IACrC,aAAA,CAAc,MAAA,GAAS,sBAAA,CAAuB,QAAA;AAAA"}

package/dist/lazy/types.d.mts

@@ -0,0 +1,39 @@
+import { LazyResourceError, LazyResourceErrorMap } from "../errors/lazy-resource-error.mjs";
+import { ComponentType, ReactNode } from "react";
+import { LoadStatus, LoadStatus as LoadStatus$1 } from "@jfdevelops/react-layout-devtools-core";
+
+//#region src/lazy/types.d.ts
+/** Options shared by lazy layouts, render states, and scoped content. */
+type LazyOptions<Module extends Record<string, unknown> = Record<string, unknown>> = {
+  load: () => Promise<Module>;
+  fallback?: ReactNode;
+};
+type LazyHandle = {
+  preload(): Promise<void>;
+  readonly status: LoadStatus;
+};
+type LazyResourceErrorProps<Resource = string> = {
+  error: LazyResourceError;
+  retry: () => void;
+  resource: Resource;
+};
+type LazyResourceErrorComponent<Resource = string> = ComponentType<LazyResourceErrorProps<Resource>>;
+type LazyResourceLoadingComponent<Resource = string> = ComponentType<{
+  resource: Resource;
+}>;
+type LazyResourceStates<Resource = string> = {
+  Error?: LazyResourceErrorComponent<Resource>;
+  Loading?: LazyResourceLoadingComponent<Resource>;
+};
+type LazyErrorHandlers<Resource, Custom extends object = {}> = { [Code in LazyResourceError['code']]?: (props: Custom & Omit<LazyResourceErrorProps<Resource>, 'error'> & {
+  error: LazyResourceErrorMap[Code];
+}) => ReactNode } & {
+  fallback?: (props: Custom & LazyResourceErrorProps<Resource>) => ReactNode;
+};
+type CreateLazyErrorComponent<Resource> = {
+  <Custom extends object = {}>(render: (props: Custom & LazyResourceErrorProps<Resource>) => ReactNode): ComponentType<Custom & LazyResourceErrorProps<Resource>>;
+  <Custom extends object = {}>(handlers: LazyErrorHandlers<Resource, Custom>): ComponentType<Custom & LazyResourceErrorProps<Resource>>;
+};
+//#endregion
+export { CreateLazyErrorComponent, LazyErrorHandlers, LazyHandle, LazyOptions, LazyResourceErrorComponent, LazyResourceErrorProps, LazyResourceLoadingComponent, LazyResourceStates, type LoadStatus$1 as LoadStatus };
+//# sourceMappingURL=types.d.mts.map

package/dist/lazy/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/lazy/types.ts"],"mappings":";;;;;;KAUY,WAAA,gBACK,MAAA,oBAA0B,MAAA;EAEzC,IAAA,QAAY,OAAA,CAAQ,MAAA;EACpB,QAAA,GAAW,SAAA;AAAA;AAAA,KAGD,UAAA;EACV,OAAA,IAAW,OAAA;EAAA,SACF,MAAA,EAAQ,UAAU;AAAA;AAAA,KAGjB,sBAAA;EACV,KAAA,EAAO,iBAAA;EACP,KAAA;EACA,QAAA,EAAU,QAAQ;AAAA;AAAA,KAGR,0BAAA,sBAAgD,aAAA,CAC1D,sBAAA,CAAuB,QAAA;AAAA,KAEb,4BAAA,sBAAkD,aAAa;EACzE,QAAA,EAAU,QAAA;AAAA;AAAA,KAEA,kBAAA;EACV,KAAA,GAAQ,0BAAA,CAA2B,QAAA;EACnC,OAAA,GAAU,4BAAA,CAA6B,QAAA;AAAA;AAAA,KAG7B,iBAAA,oDACD,iBAAA,aACP,KAAA,EAAO,MAAA,GACL,IAAA,CAAK,sBAAA,CAAuB,QAAA;EAC1B,KAAA,EAAO,oBAAA,CAAqB,IAAA;AAAA,MAE7B,SAAA;EAEL,QAAA,IAAY,KAAA,EAAO,MAAA,GAAS,sBAAA,CAAuB,QAAA,MAAc,SAAA;AAAA;AAAA,KAGvD,wBAAA;EAAA,6BAER,MAAA,GAAS,KAAA,EAAO,MAAA,GAAS,sBAAA,CAAuB,QAAA,MAAc,SAAA,GAC7D,aAAA,CAAc,MAAA,GAAS,sBAAA,CAAuB,QAAA;EAAA,6BAE/C,QAAA,EAAU,iBAAA,CAAkB,QAAA,EAAU,MAAA,IACrC,aAAA,CAAc,MAAA,GAAS,sBAAA,CAAuB,QAAA;AAAA"}

package/dist/lazy/types.mjs

@@ -0,0 +1,8 @@
+//#region src/lazy/types.ts
+/** Internal factory defaults propagated to layouts without publishing metadata. */
+const lazyDefaultsSymbol = Symbol("lazyDefaults");
+const lazyStatesSymbol = Symbol("lazyStates");
+
+//#endregion
+export { lazyDefaultsSymbol, lazyStatesSymbol };
+//# sourceMappingURL=types.mjs.map

package/dist/lazy/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/lazy/types.ts"],"sourcesContent":["import type { ComponentType, ReactNode } from 'react';\nimport type { LoadStatus } from '@jfdevelops/react-layout-devtools-core';\nimport type {\n  LazyResourceError,\n  LazyResourceErrorMap,\n} from '../errors/lazy-resource-error';\n\nexport type { LoadStatus } from '@jfdevelops/react-layout-devtools-core';\n\n/** Options shared by lazy layouts, render states, and scoped content. */\nexport type LazyOptions<\n  Module extends Record<string, unknown> = Record<string, unknown>,\n> = {\n  load: () => Promise<Module>;\n  fallback?: ReactNode;\n};\n\nexport type LazyHandle = {\n  preload(): Promise<void>;\n  readonly status: LoadStatus;\n};\n\nexport type LazyResourceErrorProps<Resource = string> = {\n  error: LazyResourceError;\n  retry: () => void;\n  resource: Resource;\n};\n\nexport type LazyResourceErrorComponent<Resource = string> = ComponentType<\n  LazyResourceErrorProps<Resource>\n>;\nexport type LazyResourceLoadingComponent<Resource = string> = ComponentType<{\n  resource: Resource;\n}>;\nexport type LazyResourceStates<Resource = string> = {\n  Error?: LazyResourceErrorComponent<Resource>;\n  Loading?: LazyResourceLoadingComponent<Resource>;\n};\n\nexport type LazyErrorHandlers<Resource, Custom extends object = {}> = {\n  [Code in LazyResourceError['code']]?: (\n    props: Custom &\n      Omit<LazyResourceErrorProps<Resource>, 'error'> & {\n        error: LazyResourceErrorMap[Code];\n      },\n  ) => ReactNode;\n} & {\n  fallback?: (props: Custom & LazyResourceErrorProps<Resource>) => ReactNode;\n};\n\nexport type CreateLazyErrorComponent<Resource> = {\n  <Custom extends object = {}>(\n    render: (props: Custom & LazyResourceErrorProps<Resource>) => ReactNode,\n  ): ComponentType<Custom & LazyResourceErrorProps<Resource>>;\n  <Custom extends object = {}>(\n    handlers: LazyErrorHandlers<Resource, Custom>,\n  ): ComponentType<Custom & LazyResourceErrorProps<Resource>>;\n};\n\n/** Internal factory defaults propagated to layouts without publishing metadata. */\nexport const lazyDefaultsSymbol = Symbol('lazyDefaults');\n\nexport const lazyStatesSymbol = Symbol('lazyStates');\n"],"mappings":";;AA4DA,MAAa,qBAAqB,OAAO,cAAc;AAEvD,MAAa,mBAAmB,OAAO,YAAY"}

package/dist/props.cjs

@@ -1,9 +1,11 @@
+const require_layout_configuration_error = require('./errors/layout-configuration-error.cjs');
 
 //#region src/props.ts
 function getIncludedPropBehavior(value) {
 	if (value === null || typeof value !== "object") return null;
-	const required = "required" in value && typeof value.required === "boolean" ? value.required : "visibility" in value ? value.visibility === "required" : void 0;
-	const suppliedVia = "suppliedVia" in value ? value.suppliedVia : "passthrough" in value ? value.passthrough : void 0;
+	if ("visibility" in value || "passthrough" in value) throw new require_layout_configuration_error.LayoutConfigurationError("Include properties visibility and passthrough were removed; use required and suppliedVia.");
+	const required = "required" in value && typeof value.required === "boolean" ? value.required : void 0;
+	const suppliedVia = "suppliedVia" in value ? value.suppliedVia : void 0;
 	if (required === void 0 || suppliedVia !== "component" && suppliedVia !== "config") return null;
 	return {
 		visibility: required ? "required" : "optional",

package/dist/props.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"props.cjs","names":[],"sources":["../src/props.ts"],"sourcesContent":["import type {\n  ComposableComponents,\n  MergePresetProps,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '@jfdevelops/react-layout-composables';\nimport {\n  EnumWrappedProp,\n  LiteralWrappedProp,\n  ResolveLayoutProps,\n  ResolveLayoutPropsAsDefined,\n  ResolveProps,\n} from '@jfdevelops/react-layout-validator';\nimport { ResourceDefinition, ResourceEnum } from './resource';\nimport { Show } from './utils';\n\nexport type { InPropsObject };\n\n/**\n * Two-argument `render(props, context)` used by createComponent and scoped\n * resource components. `Context` is sibling components (scoped) or the\n * resource render context (top-level).\n */\nexport type PropsContextRender<RenderProps, Context, Result = unknown> = (\n  props: RenderProps,\n  context: Context\n) => Result;\n\n/**\n * Shared `{ props?, render }` shape used by createComponent, scoped\n * components, and anywhere else a value declares props and a two-arg render.\n *\n * @typeParam Props - Declared on the entry (`props`). Often an\n *   {@link InPropsObject}, or a layout include/custom bag.\n * @typeParam RenderProps - First argument to `render` (defaults to\n *   {@link ResolveProps}<Props> when Props is an {@link InPropsObject})\n * @typeParam Result - `render` return type\n * @typeParam Context - Second argument to `render`\n */\nexport interface PropsRenderDefinition<\n  Props = InPropsObject,\n  RenderProps = Props extends InPropsObject ? ResolveProps<Props> : unknown,\n  Result = unknown,\n  Context = unknown\n> {\n  props?: Props;\n  render: PropsContextRender<RenderProps, Context, Result>;\n}\n\nexport type InPropsOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Name extends string\n> = {\n  name: LiteralWrappedProp<Name, 'string', 'required'>;\n  resource: EnumWrappedProp<ResourceEnum<Resources>, 'string', 'required'>;\n};\nexport type InPropsFunction<\n  Resources extends ReadonlyArray<ResourceDefinition>\n> = <Name extends string>(\n  props: Show<InPropsOptions<Resources, Name>>\n) => InPropsObject;\nexport type InPropsDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>\n> = InPropsObject | InPropsFunction<Resources>;\nexport type InferredInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>\n> = Options extends InPropsFunction<Resources> ? ReturnType<Options> : Options;\nexport type MergedLayoutInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents\n> = InferredInProps<Resources, Options> extends InPropsObject\n  ? InferredInProps<Resources, Options> & MergePresetProps<Composables>\n  : never;\nexport type RequiredVariant = true | 'required';\n/**\n * @typeParam RequiredVariant How the required props are selected. In application code,\n * it will always be `true`, but internally we need to support `'required'` as well.\n */\ntype PropsType<Variant extends RequiredVariant = true> = Variant | 'optional';\ntype InternalPropsType = PropsType<'required'>;\ntype IncludedPropSource = 'component' | 'config';\ntype IncludedPropRequirement =\n  | {\n      /**\n       * Whether the prop must be supplied. When both names are present,\n       * `required` takes precedence over the deprecated `visibility` setting.\n       */\n      required: boolean;\n    }\n  | {\n      /**\n       * Whether the prop must be supplied (`'required'`) or may be omitted\n       * (`'optional'`). The `required` setting takes precedence when both are present.\n       *\n       * @deprecated Use `required: true` instead of `visibility: 'required'`, or\n       * `required: false` instead of `visibility: 'optional'`.\n       * This property will be removed in the next major version.\n       */\n      visibility: 'optional' | 'required';\n    };\ntype IncludedPropSupply =\n  | {\n      /**\n       * Where the prop is supplied: at component render time (`'component'`)\n       * or through layout creation options (`'config'`). Optional component props\n       * also accept configuration-time defaults. This setting takes precedence\n       * over the deprecated `passthrough` setting.\n       */\n      suppliedVia: IncludedPropSource;\n    }\n  | {\n      /**\n       * Where the prop is supplied: at component render time (`'component'`)\n       * or through layout creation options (`'config'`). Optional component props\n       * also accept configuration-time defaults. The `suppliedVia` setting takes\n       * precedence when both names are present.\n       *\n       * @deprecated Use `suppliedVia: 'component'` instead of\n       * `passthrough: 'component'`, or `suppliedVia: 'config'` instead of\n       * `passthrough: 'config'`. This property will be removed in the next major version.\n       */\n      passthrough: IncludedPropSource;\n    };\n\n/**\n * Controls where an included layout prop is supplied and whether it is required there.\n */\nexport type IncludedPropBehavior = IncludedPropRequirement & IncludedPropSupply;\n\ntype IncludedPropType = PropsType | IncludedPropBehavior;\n/**\n * A map of props to include in the layout.\n */\nexport type IncludedProps<T extends object> = {\n  [K in keyof T & string]?: IncludedPropType;\n};\n\ntype PropsKeys<Props extends InPropsObject, T> = T & keyof Props;\nexport type IncludedPropVisibility<Value> = Value extends { required: boolean }\n  ? Value['required'] extends true\n    ? 'required'\n    : 'optional'\n  : Value extends { visibility: 'required' | 'optional' }\n  ? Value['visibility']\n  : Value extends true | 'required'\n  ? 'required'\n  : Value extends 'optional'\n  ? 'optional'\n  : never;\nexport type IncludedPropSupplySource<Value> = Value extends {\n  suppliedVia: IncludedPropSource;\n}\n  ? Value['suppliedVia']\n  : Value extends { passthrough: IncludedPropSource }\n  ? Value['passthrough']\n  : never;\n/**\n * Canonical shape used internally for either spelling of an include behavior.\n */\nexport type NormalizedIncludedPropBehavior<Value> = Value extends\n  | { required: boolean }\n  | { suppliedVia: IncludedPropSource }\n  ? {\n      visibility: IncludedPropVisibility<Value>;\n      passthrough: IncludedPropSupplySource<Value>;\n    }\n  : Value;\n\nexport type IncludedPropPassthrough<Value> = Value extends\n  | { required: boolean }\n  | { suppliedVia: IncludedPropSource }\n  ? IncludedPropSupplySource<Value> extends 'component'\n    ? IncludedPropVisibility<Value> extends 'optional'\n      ? 'component' | 'config'\n      : 'component'\n    : IncludedPropSupplySource<Value>\n  : Value extends {\n      visibility: 'required' | 'optional';\n      passthrough: IncludedPropSource;\n    }\n  ? Value['passthrough'] extends 'component'\n    ? Value['visibility'] extends 'optional'\n      ? 'component' | 'config'\n      : 'component'\n    : Value['passthrough']\n  : Value extends true | 'required'\n  ? 'config'\n  : Value extends 'optional'\n  ? 'component' | 'config'\n  : never;\n\ntype GetPropsKey<\n  IncludeProps extends object,\n  Visibility extends InternalPropsType,\n  Passthrough extends IncludedPropSource | 'render' = 'render'\n> = {\n  [Key in keyof IncludeProps]: IncludedPropVisibility<\n    IncludeProps[Key]\n  > extends Visibility\n    ? Passthrough extends 'render'\n      ? Key\n      : Passthrough extends IncludedPropPassthrough<IncludeProps[Key]>\n      ? Key\n      : never\n    : never;\n}[keyof IncludeProps];\ntype SelectedIncludedProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n  Visibility extends InternalPropsType,\n  Passthrough extends IncludedPropSource | 'render' = 'render'\n> = Pick<\n  Props,\n  PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>\n>;\n\ntype OptionalPropDefinition<Definition> = Definition extends {\n  optional(): infer OptionalDefinition;\n}\n  ? OptionalDefinition\n  : Definition;\n\n/** Raw validator definitions accepted by a generated component call. */\nexport type IncludedComponentPropDefinitions<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>\n> = SelectedIncludedProps<Props, IncludeProps, 'required', 'component'> & {\n  [Key in keyof SelectedIncludedProps<\n    Props,\n    IncludeProps,\n    'optional',\n    'component'\n  >]: OptionalPropDefinition<\n    SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>[Key]\n  >;\n};\n\nexport type ResolvedIncludedProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>\n> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required'>> &\n  Partial<\n    ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional'>>\n  >;\n\nexport type ResolvedIncludedConfigProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>\n> = ResolveLayoutProps<\n  SelectedIncludedProps<Props, IncludeProps, 'required', 'config'>\n> &\n  Partial<\n    ResolveLayoutProps<\n      SelectedIncludedProps<Props, IncludeProps, 'optional', 'config'>\n    >\n  >;\n\nexport type ResolvedIncludedComponentProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>\n> = ResolveLayoutProps<\n  SelectedIncludedProps<Props, IncludeProps, 'required', 'component'>\n> &\n  Partial<\n    ResolveLayoutProps<\n      SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>\n    >\n  >;\n\n/**\n * Like {@link ResolvedIncludedProps}, but keeps included prop keys exactly as\n * declared (no `JSX.Element` capitalization).\n */\nexport type ResolvedIncludedPropsAsDefined<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>\n> = ResolveLayoutPropsAsDefined<\n  SelectedIncludedProps<Props, IncludeProps, 'required'>\n> &\n  Partial<\n    ResolveLayoutPropsAsDefined<\n      SelectedIncludedProps<Props, IncludeProps, 'optional'>\n    >\n  >;\nexport type LayoutRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, Composables>\n  > = {},\n  CustomProps extends InPropsObject = {}\n> = Show<\n  ResolveProps<CustomProps> &\n    ResolvedIncludedProps<\n      MergedLayoutInProps<Resources, Options, Composables>,\n      IncludeProps\n    >\n>;\n\nexport function getIncludedPropBehavior(value: unknown): {\n  visibility: 'required' | 'optional';\n  passthrough: 'component' | 'config';\n} | null {\n  if (value === null || typeof value !== 'object') {\n    return null;\n  }\n\n  const required =\n    'required' in value && typeof value.required === 'boolean'\n      ? value.required\n      : 'visibility' in value\n      ? value.visibility === 'required'\n      : undefined;\n  const suppliedVia =\n    'suppliedVia' in value\n      ? value.suppliedVia\n      : 'passthrough' in value\n      ? value.passthrough\n      : undefined;\n\n  if (\n    required === undefined ||\n    (suppliedVia !== 'component' && suppliedVia !== 'config')\n  ) {\n    return null;\n  }\n\n  return {\n    visibility: required ? 'required' : 'optional',\n    passthrough: suppliedVia,\n  };\n}\n"],"mappings":";;AA6SA,SAAgB,wBAAwB,OAG/B;CACP,IAAI,UAAU,QAAQ,OAAO,UAAU,UACrC,OAAO;CAGT,MAAM,WACJ,cAAc,SAAS,OAAO,MAAM,aAAa,YAC7C,MAAM,WACN,gBAAgB,QAChB,MAAM,eAAe,aACrB;CACN,MAAM,cACJ,iBAAiB,QACb,MAAM,cACN,iBAAiB,QACjB,MAAM,cACN;CAEN,IACE,aAAa,UACZ,gBAAgB,eAAe,gBAAgB,UAEhD,OAAO;CAGT,OAAO;EACL,YAAY,WAAW,aAAa;EACpC,aAAa;CACf;AACF"}
+{"version":3,"file":"props.cjs","names":["LayoutConfigurationError"],"sources":["../src/props.ts"],"sourcesContent":["import { LayoutConfigurationError } from './errors';\nimport type {\n  ComposableComponents,\n  MergePresetProps,\n} from '@jfdevelops/react-layout-composables';\nimport type { InPropsObject } from '@jfdevelops/react-layout-composables';\nimport {\n  EnumWrappedProp,\n  LiteralWrappedProp,\n  ResolveLayoutProps,\n  ResolveLayoutPropsAsDefined,\n  ResolveProps,\n} from '@jfdevelops/react-layout-validator';\nimport { ResourceDefinition, ResourceEnum } from './resource';\nimport { Show } from './utils';\n\nexport type { InPropsObject };\n\n/**\n * Two-argument `render(props, context)` used by createComponent and scoped\n * resource components. `Context` is sibling components (scoped) or the\n * resource render context (top-level).\n */\nexport type PropsContextRender<RenderProps, Context, Result = unknown> = (\n  props: RenderProps,\n  context: Context,\n) => Result;\n\n/**\n * Shared `{ props?, render }` shape used by createComponent, scoped\n * components, and anywhere else a value declares props and a two-arg render.\n *\n * @typeParam Props - Declared on the entry (`props`). Often an\n *   {@link InPropsObject}, or a layout include/custom bag.\n * @typeParam RenderProps - First argument to `render` (defaults to\n *   {@link ResolveProps}<Props> when Props is an {@link InPropsObject})\n * @typeParam Result - `render` return type\n * @typeParam Context - Second argument to `render`\n */\nexport interface PropsRenderDefinition<\n  Props = InPropsObject,\n  RenderProps = Props extends InPropsObject ? ResolveProps<Props> : unknown,\n  Result = unknown,\n  Context = unknown,\n> {\n  props?: Props;\n  render: PropsContextRender<RenderProps, Context, Result>;\n}\n\nexport type InPropsOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Name extends string,\n> = {\n  name: LiteralWrappedProp<Name, 'string', 'required'>;\n  resource: EnumWrappedProp<ResourceEnum<Resources>, 'string', 'required'>;\n};\nexport type InPropsFunction<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = <Name extends string>(\n  props: Show<InPropsOptions<Resources, Name>>,\n) => InPropsObject;\nexport type InPropsDefinition<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n> = InPropsObject | InPropsFunction<Resources>;\nexport type InferredInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n> = Options extends InPropsFunction<Resources> ? ReturnType<Options> : Options;\nexport type MergedLayoutInProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents,\n> =\n  InferredInProps<Resources, Options> extends InPropsObject\n    ? InferredInProps<Resources, Options> & MergePresetProps<Composables>\n    : never;\nexport type RequiredVariant = true | 'required';\n/**\n * @typeParam RequiredVariant How the required props are selected. In application code,\n * it will always be `true`, but internally we need to support `'required'` as well.\n */\ntype PropsType<Variant extends RequiredVariant = true> = Variant | 'optional';\ntype InternalPropsType = PropsType<'required'>;\ntype IncludedPropSource = 'component' | 'config';\n/** Controls whether an included prop is required and where it is supplied. */\nexport type IncludedPropBehavior = {\n  required: boolean;\n  suppliedVia: IncludedPropSource;\n};\n\ntype IncludedPropType = PropsType | IncludedPropBehavior;\n/**\n * A map of props to include in the layout.\n */\nexport type IncludedProps<T extends object> = {\n  [K in keyof T & string]?: IncludedPropType;\n};\n\ntype PropsKeys<Props extends InPropsObject, T> = T & keyof Props;\nexport type IncludedPropVisibility<Value> = Value extends { required: boolean }\n  ? Value['required'] extends true\n    ? 'required'\n    : 'optional'\n  : Value extends true | 'required'\n    ? 'required'\n    : Value extends 'optional'\n      ? 'optional'\n      : never;\nexport type IncludedPropSupplySource<Value> = Value extends {\n  suppliedVia: IncludedPropSource;\n}\n  ? Value['suppliedVia']\n  : never;\n/**\n * Internal representation of the supported include behavior.\n */\nexport type NormalizedIncludedPropBehavior<Value> = Value extends\n  | { required: boolean }\n  | { suppliedVia: IncludedPropSource }\n  ? {\n      visibility: IncludedPropVisibility<Value>;\n      passthrough: IncludedPropSupplySource<Value>;\n    }\n  : Value;\n\nexport type IncludedPropPassthrough<Value> = Value extends\n  | { required: boolean }\n  | { suppliedVia: IncludedPropSource }\n  ? IncludedPropSupplySource<Value> extends 'component'\n    ? IncludedPropVisibility<Value> extends 'optional'\n      ? 'component' | 'config'\n      : 'component'\n    : IncludedPropSupplySource<Value>\n  : Value extends true | 'required'\n    ? 'config'\n    : Value extends 'optional'\n      ? 'component' | 'config'\n      : never;\n\ntype GetPropsKey<\n  IncludeProps extends object,\n  Visibility extends InternalPropsType,\n  Passthrough extends IncludedPropSource | 'render' = 'render',\n> = {\n  [Key in keyof IncludeProps]: IncludedPropVisibility<\n    IncludeProps[Key]\n  > extends Visibility\n    ? Passthrough extends 'render'\n      ? Key\n      : Passthrough extends IncludedPropPassthrough<IncludeProps[Key]>\n        ? Key\n        : never\n    : never;\n}[keyof IncludeProps];\ntype SelectedIncludedProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n  Visibility extends InternalPropsType,\n  Passthrough extends IncludedPropSource | 'render' = 'render',\n> = Pick<\n  Props,\n  PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>\n>;\n\ntype OptionalPropDefinition<Definition> = Definition extends {\n  optional(): infer OptionalDefinition;\n}\n  ? OptionalDefinition\n  : Definition;\n\n/** Raw validator definitions accepted by a generated component call. */\nexport type IncludedComponentPropDefinitions<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = SelectedIncludedProps<Props, IncludeProps, 'required', 'component'> & {\n  [Key in keyof SelectedIncludedProps<\n    Props,\n    IncludeProps,\n    'optional',\n    'component'\n  >]: OptionalPropDefinition<\n    SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>[Key]\n  >;\n};\n\nexport type ResolvedIncludedProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'required'>> &\n  Partial<\n    ResolveLayoutProps<SelectedIncludedProps<Props, IncludeProps, 'optional'>>\n  >;\n\nexport type ResolvedIncludedConfigProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<\n  SelectedIncludedProps<Props, IncludeProps, 'required', 'config'>\n> &\n  Partial<\n    ResolveLayoutProps<\n      SelectedIncludedProps<Props, IncludeProps, 'optional', 'config'>\n    >\n  >;\n\nexport type ResolvedIncludedComponentProps<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutProps<\n  SelectedIncludedProps<Props, IncludeProps, 'required', 'component'>\n> &\n  Partial<\n    ResolveLayoutProps<\n      SelectedIncludedProps<Props, IncludeProps, 'optional', 'component'>\n    >\n  >;\n\n/**\n * Like {@link ResolvedIncludedProps}, but keeps included prop keys exactly as\n * declared (no `JSX.Element` capitalization).\n */\nexport type ResolvedIncludedPropsAsDefined<\n  Props extends InPropsObject,\n  IncludeProps extends IncludedProps<Props>,\n> = ResolveLayoutPropsAsDefined<\n  SelectedIncludedProps<Props, IncludeProps, 'required'>\n> &\n  Partial<\n    ResolveLayoutPropsAsDefined<\n      SelectedIncludedProps<Props, IncludeProps, 'optional'>\n    >\n  >;\nexport type LayoutRenderProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  Composables extends ComposableComponents = {},\n  IncludeProps extends IncludedProps<\n    MergedLayoutInProps<Resources, Options, Composables>\n  > = {},\n  CustomProps extends InPropsObject = {},\n> = Show<\n  ResolveProps<CustomProps> &\n    ResolvedIncludedProps<\n      MergedLayoutInProps<Resources, Options, Composables>,\n      IncludeProps\n    >\n>;\n\nexport function getIncludedPropBehavior(value: unknown): {\n  visibility: 'required' | 'optional';\n  passthrough: 'component' | 'config';\n} | null {\n  if (value === null || typeof value !== 'object') {\n    return null;\n  }\n\n  if ('visibility' in value || 'passthrough' in value) {\n    throw new LayoutConfigurationError(\n      'Include properties visibility and passthrough were removed; use required and suppliedVia.',\n    );\n  }\n\n  const required =\n    'required' in value && typeof value.required === 'boolean'\n      ? value.required\n      : undefined;\n  const suppliedVia = 'suppliedVia' in value ? value.suppliedVia : undefined;\n\n  if (\n    required === undefined ||\n    (suppliedVia !== 'component' && suppliedVia !== 'config')\n  ) {\n    return null;\n  }\n\n  return {\n    visibility: required ? 'required' : 'optional',\n    passthrough: suppliedVia,\n  };\n}\n"],"mappings":";;;AAwPA,SAAgB,wBAAwB,OAG/B;CACP,IAAI,UAAU,QAAQ,OAAO,UAAU,UACrC,OAAO;CAGT,IAAI,gBAAgB,SAAS,iBAAiB,OAC5C,MAAM,IAAIA,4DACR,2FACF;CAGF,MAAM,WACJ,cAAc,SAAS,OAAO,MAAM,aAAa,YAC7C,MAAM,WACN;CACN,MAAM,cAAc,iBAAiB,QAAQ,MAAM,cAAc;CAEjE,IACE,aAAa,UACZ,gBAAgB,eAAe,gBAAgB,UAEhD,OAAO;CAGT,OAAO;EACL,YAAY,WAAW,aAAa;EACpC,aAAa;CACf;AACF"}

package/dist/props.d.cts

@@ -41,48 +41,11 @@ type RequiredVariant = true | 'required';
 type PropsType<Variant extends RequiredVariant = true> = Variant | 'optional';
 type InternalPropsType = PropsType<'required'>;
 type IncludedPropSource = 'component' | 'config';
-type IncludedPropRequirement = {
-  /**
-   * Whether the prop must be supplied. When both names are present,
-   * `required` takes precedence over the deprecated `visibility` setting.
-   */
+/** Controls whether an included prop is required and where it is supplied. */
+type IncludedPropBehavior = {
   required: boolean;
-} | {
-  /**
-   * Whether the prop must be supplied (`'required'`) or may be omitted
-   * (`'optional'`). The `required` setting takes precedence when both are present.
-   *
-   * @deprecated Use `required: true` instead of `visibility: 'required'`, or
-   * `required: false` instead of `visibility: 'optional'`.
-   * This property will be removed in the next major version.
-   */
-  visibility: 'optional' | 'required';
-};
-type IncludedPropSupply = {
-  /**
-   * Where the prop is supplied: at component render time (`'component'`)
-   * or through layout creation options (`'config'`). Optional component props
-   * also accept configuration-time defaults. This setting takes precedence
-   * over the deprecated `passthrough` setting.
-   */
   suppliedVia: IncludedPropSource;
-} | {
-  /**
-   * Where the prop is supplied: at component render time (`'component'`)
-   * or through layout creation options (`'config'`). Optional component props
-   * also accept configuration-time defaults. The `suppliedVia` setting takes
-   * precedence when both names are present.
-   *
-   * @deprecated Use `suppliedVia: 'component'` instead of
-   * `passthrough: 'component'`, or `suppliedVia: 'config'` instead of
-   * `passthrough: 'config'`. This property will be removed in the next major version.
-   */
-  passthrough: IncludedPropSource;
 };
-/**
- * Controls where an included layout prop is supplied and whether it is required there.
- */
-type IncludedPropBehavior = IncludedPropRequirement & IncludedPropSupply;
 type IncludedPropType = PropsType | IncludedPropBehavior;
 /**
  * A map of props to include in the layout.
@@ -91,16 +54,12 @@ type IncludedProps<T extends object> = { [K in keyof T & string]?: IncludedPropT
 type PropsKeys<Props extends InPropsObject, T> = T & keyof Props;
 type IncludedPropVisibility<Value> = Value extends {
   required: boolean;
-} ? Value['required'] extends true ? 'required' : 'optional' : Value extends {
-  visibility: 'required' | 'optional';
-} ? Value['visibility'] : Value extends true | 'required' ? 'required' : Value extends 'optional' ? 'optional' : never;
+} ? Value['required'] extends true ? 'required' : 'optional' : Value extends true | 'required' ? 'required' : Value extends 'optional' ? 'optional' : never;
 type IncludedPropSupplySource<Value> = Value extends {
   suppliedVia: IncludedPropSource;
-} ? Value['suppliedVia'] : Value extends {
-  passthrough: IncludedPropSource;
-} ? Value['passthrough'] : never;
+} ? Value['suppliedVia'] : never;
 /**
- * Canonical shape used internally for either spelling of an include behavior.
+ * Internal representation of the supported include behavior.
  */
 type NormalizedIncludedPropBehavior<Value> = Value extends {
   required: boolean;
@@ -114,10 +73,7 @@ type IncludedPropPassthrough<Value> = Value extends {
   required: boolean;
 } | {
   suppliedVia: IncludedPropSource;
-} ? IncludedPropSupplySource<Value> extends 'component' ? IncludedPropVisibility<Value> extends 'optional' ? 'component' | 'config' : 'component' : IncludedPropSupplySource<Value> : Value extends {
-  visibility: 'required' | 'optional';
-  passthrough: IncludedPropSource;
-} ? Value['passthrough'] extends 'component' ? Value['visibility'] extends 'optional' ? 'component' | 'config' : 'component' : Value['passthrough'] : Value extends true | 'required' ? 'config' : Value extends 'optional' ? 'component' | 'config' : never;
+} ? IncludedPropSupplySource<Value> extends 'component' ? IncludedPropVisibility<Value> extends 'optional' ? 'component' | 'config' : 'component' : IncludedPropSupplySource<Value> : Value extends true | 'required' ? 'config' : Value extends 'optional' ? 'component' | 'config' : never;
 type GetPropsKey<IncludeProps extends object, Visibility extends InternalPropsType, Passthrough extends IncludedPropSource | 'render' = 'render'> = { [Key in keyof IncludeProps]: IncludedPropVisibility<IncludeProps[Key]> extends Visibility ? Passthrough extends 'render' ? Key : Passthrough extends IncludedPropPassthrough<IncludeProps[Key]> ? Key : never : never }[keyof IncludeProps];
 type SelectedIncludedProps<Props extends InPropsObject, IncludeProps extends IncludedProps<Props>, Visibility extends InternalPropsType, Passthrough extends IncludedPropSource | 'render' = 'render'> = Pick<Props, PropsKeys<Props, GetPropsKey<IncludeProps, Visibility, Passthrough>>>;
 type OptionalPropDefinition<Definition> = Definition extends {