@cratis/components 3.6.1 → 4.0.0

package/dist/esm/Toolbar/ToolbarSlot.d.ts

@@ -1,13 +1,59 @@
 import { ReactNode } from 'react';
+/** Props for the {@link ToolbarSlotProvider} component. */
 export interface ToolbarSlotProviderProps {
+    /**
+     * The subtree that contains both toolbar slot consumers ({@link ToolbarGroup},
+     * {@link ToolbarContext}) and slot producers ({@link ToolbarSlot}).
+     */
     children: ReactNode;
 }
+/**
+ * Provides the toolbar slot registry to the component tree.
+ *
+ * Mount once above both the toolbar and the components that fill slots.
+ * Each provider creates an isolated registry — nesting providers creates isolated scopes.
+ */
 export declare const ToolbarSlotProvider: ({ children }: ToolbarSlotProviderProps) => import("react").JSX.Element;
+/**
+ * Returns the sorted slot contents for a given `slotName` as a stable array.
+ * Returns an empty array when no {@link ToolbarSlotProvider} is present or when the slot has no content.
+ *
+ * Suitable for direct use inside components that host a slot (e.g. {@link ToolbarGroup}).
+ */
 export declare const useToolbarSlot: (slotName: string) => ReactNode[];
+/** Props for the {@link ToolbarSlot} component. */
 export interface ToolbarSlotProps {
+    /**
+     * The name of the destination slot.
+     * Must match the `slotName` on a {@link ToolbarGroup} or {@link ToolbarContext}.
+     */
     slotName: string;
+    /**
+     * Render order relative to other entries in the same slot.
+     * Lower numbers appear first (default: `0`).
+     */
     order?: number;
+    /**
+     * The toolbar content to teleport into the named slot.
+     * Wrap in `useMemo` to keep the reference stable and avoid unnecessary re-renders.
+     */
     children: ReactNode;
 }
+/**
+ * Teleports its children into the named toolbar slot without prop drilling.
+ * Renders nothing itself — place it anywhere inside a {@link ToolbarSlotProvider} tree.
+ *
+ * The nearest {@link ToolbarGroup} or {@link ToolbarContext} with a matching `slotName`
+ * will render the content. Use {@link ToolbarSlotProps.order} to control position relative to
+ * other {@link ToolbarSlot} entries in the same slot.
+ *
+ * @example
+ * ```tsx
+ * // In a feature component, inject a button into the 'canvas-tools' slot:
+ * <ToolbarSlot slotName="canvas-tools" order={10}>
+ *     <ToolbarButton icon={<span aria-hidden='true'>◆</span>} title="Favorite" />
+ * </ToolbarSlot>
+ * ```
+ */
 export declare const ToolbarSlot: ({ slotName, order, children }: ToolbarSlotProps) => null;
 //# sourceMappingURL=ToolbarSlot.d.ts.map

package/dist/esm/Toolbar/ToolbarSlot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToolbarSlot.d.ts","sourceRoot":"","sources":["../../../Toolbar/ToolbarSlot.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAA8F,MAAM,OAAO,CAAC;AAkF7I,MAAM,WAAW,wBAAwB;IAKrC,QAAQ,EAAE,SAAS,CAAC;CACvB;AAQD,eAAO,MAAM,mBAAmB,GAAI,cAAc,wBAAwB,gCAGzE,CAAC;AAQF,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,SAAS,EAQ1D,CAAC;AAGF,MAAM,WAAW,gBAAgB;IAK7B,QAAQ,EAAE,MAAM,CAAC;IAMjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAMf,QAAQ,EAAE,SAAS,CAAC;CACvB;AAkBD,eAAO,MAAM,WAAW,GAAI,+BAAmC,gBAAgB,SAa9E,CAAC"}
+{"version":3,"file":"ToolbarSlot.d.ts","sourceRoot":"","sources":["../../../Toolbar/ToolbarSlot.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAA8F,MAAM,OAAO,CAAC;AAiF7I,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACrC;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,cAAc,wBAAwB,gCAGzE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,SAAS,EAQ1D,CAAC;AAEF,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,GAAI,+BAAmC,gBAAgB,SAa9E,CAAC"}

package/dist/esm/Toolbar/ToolbarSlot.js

@@ -1,20 +1,11 @@
 import { jsx } from 'react/jsx-runtime';
 import { createContext, useId, useContext, useLayoutEffect, useEffect, useState, useCallback, useSyncExternalStore } from 'react';
 
-/** Stable empty snapshot returned when a slot name has no registered content. */
 const _emptySnapshot = [];
-/**
- * Registry for named toolbar slot entries.
- * Maintained outside React state so slot registrations never re-render the provider.
- */
 class ToolbarSlotRegistry {
     _slots = new Map();
     _snapshots = new Map();
     _subscribers = new Set();
-    /**
-     * Register or update a slot entry.
-     * Notifies subscribers only when the content reference or order actually changes.
-     */
     register(slotName, id, content, order) {
         if (!this._slots.has(slotName)) {
             this._slots.set(slotName, new Map());
@@ -27,7 +18,6 @@ class ToolbarSlotRegistry {
         this._recompute(slotName);
         this._notify();
     }
-    /** Remove a slot entry and notify subscribers. */
     unregister(slotName, id) {
         const slotMap = this._slots.get(slotName);
         if (!slotMap?.has(id))
@@ -36,15 +26,10 @@ class ToolbarSlotRegistry {
         this._recompute(slotName);
         this._notify();
     }
-    /** Subscribe to any slot change. Returns an unsubscribe function. */
     subscribe(fn) {
         this._subscribers.add(fn);
         return () => this._subscribers.delete(fn);
     }
-    /**
-     * Returns a stable snapshot of sorted slot contents for the given slot name.
-     * The reference only changes when the slot set actually changes.
-     */
     getSnapshot(slotName) {
         return this._snapshots.get(slotName) ?? _emptySnapshot;
     }
@@ -63,22 +48,10 @@ class ToolbarSlotRegistry {
     }
 }
 const ToolbarSlotContext = createContext(null);
-/**
- * Provides the toolbar slot registry to the component tree.
- *
- * Mount once above both the toolbar and the components that fill slots.
- * Each provider creates an isolated registry — nesting providers creates isolated scopes.
- */
 const ToolbarSlotProvider = ({ children }) => {
     const [registry] = useState(() => new ToolbarSlotRegistry());
     return jsx(ToolbarSlotContext.Provider, { value: registry, children: children });
 };
-/**
- * Returns the sorted slot contents for a given `slotName` as a stable array.
- * Returns an empty array when no {@link ToolbarSlotProvider} is present or when the slot has no content.
- *
- * Suitable for direct use inside components that host a slot (e.g. {@link ToolbarGroup}).
- */
 const useToolbarSlot = (slotName) => {
     const registry = useContext(ToolbarSlotContext);
     const subscribe = useCallback((fn) => {
@@ -87,29 +60,11 @@ const useToolbarSlot = (slotName) => {
         return registry.subscribe(fn);
     }, [registry]);
     const getSnapshot = useCallback(() => registry?.getSnapshot(slotName) ?? _emptySnapshot, [registry, slotName]);
-    return useSyncExternalStore(subscribe, getSnapshot);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
 };
-/**
- * Teleports its children into the named toolbar slot without prop drilling.
- * Renders nothing itself — place it anywhere inside a {@link ToolbarSlotProvider} tree.
- *
- * The nearest {@link ToolbarGroup} or {@link ToolbarContext} with a matching `slotName`
- * will render the content. Use {@link ToolbarSlotProps.order} to control position relative to
- * other {@link ToolbarSlot} entries in the same slot.
- *
- * @example
- * ```tsx
- * // In a feature component, inject a button into the 'canvas-tools' slot:
- * <ToolbarSlot slotName="canvas-tools" order={10}>
- *     <ToolbarButton icon="pi pi-star" title="Favorite" />
- * </ToolbarSlot>
- * ```
- */
 const ToolbarSlot = ({ slotName, order = 0, children }) => {
     const id = useId();
     const registry = useContext(ToolbarSlotContext);
-    // Re-register on every render so fresh closures are always captured.
-    // The registry skips notification when the content reference hasn't changed.
     useLayoutEffect(() => {
         registry?.register(slotName, id, children, order);
     });

package/dist/esm/Toolbar/ToolbarSlot.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToolbarSlot.js","sources":["../../../Toolbar/ToolbarSlot.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":"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"}
+{"version":3,"file":"ToolbarSlot.js","sources":["../../../Toolbar/ToolbarSlot.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":"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"}

package/dist/esm/Toolbar/index.d.ts

@@ -1,22 +1,21 @@
-export { Toolbar } from './Toolbar';
-export type { ToolbarProps } from './Toolbar';
-export { ToolbarButton } from './ToolbarButton';
-export type { ToolbarButtonProps } from './ToolbarButton';
-export { ToolbarContext } from './ToolbarContext';
-export type { ToolbarContextProps } from './ToolbarContext';
-export { ToolbarGroup } from './ToolbarGroup';
-export type { ToolbarGroupProps } from './ToolbarGroup';
-export { ToolbarSection } from './ToolbarSection';
-export type { ToolbarSectionProps } from './ToolbarSection';
-export { ToolbarSeparator } from './ToolbarSeparator';
-export type { ToolbarSeparatorProps } from './ToolbarSeparator';
-export { ToolbarFanOutItem } from './ToolbarFanOutItem';
-export type { ToolbarFanOutItemProps } from './ToolbarFanOutItem';
-export { ToolbarFolder } from './ToolbarFolder';
-export type { ToolbarFolderProps } from './ToolbarFolder';
-export type { ToolbarFolderMode } from './ToolbarFolderContext';
-export { ToolbarSlot, ToolbarSlotProvider, useToolbarSlot } from './ToolbarSlot';
-export type { ToolbarSlotProps, ToolbarSlotProviderProps } from './ToolbarSlot';
-export { ToolbarLayout } from './ToolbarLayout';
-export type { ToolbarLayoutProps } from './ToolbarLayout';
-//# sourceMappingURL=index.d.ts.map
+export { Toolbar } from './Toolbar.js';
+export type { ToolbarParts, ToolbarProps } from './Toolbar.js';
+export { ToolbarButton } from './ToolbarButton.js';
+export type { ToolbarButtonParts, ToolbarButtonProps } from './ToolbarButton.js';
+export { ToolbarContext } from './ToolbarContext.js';
+export type { ToolbarContextProps } from './ToolbarContext.js';
+export { ToolbarGroup } from './ToolbarGroup.js';
+export type { ToolbarGroupParts, ToolbarGroupProps } from './ToolbarGroup.js';
+export { ToolbarSection } from './ToolbarSection.js';
+export type { ToolbarSectionParts, ToolbarSectionProps } from './ToolbarSection.js';
+export { ToolbarSeparator } from './ToolbarSeparator.js';
+export type { ToolbarSeparatorParts, ToolbarSeparatorProps } from './ToolbarSeparator.js';
+export { ToolbarFanOutItem } from './ToolbarFanOutItem.js';
+export type { ToolbarFanOutItemProps, ToolbarFanOutParts } from './ToolbarFanOutItem.js';
+export { ToolbarFolder } from './ToolbarFolder.js';
+export type { ToolbarFolderParts, ToolbarFolderProps } from './ToolbarFolder.js';
+export type { ToolbarFolderMode } from './ToolbarFolderContext.js';
+export { ToolbarSlot, ToolbarSlotProvider, useToolbarSlot } from './ToolbarSlot.js';
+export type { ToolbarSlotProps, ToolbarSlotProviderProps } from './ToolbarSlot.js';
+export { ToolbarLayout } from './ToolbarLayout.js';
+export type { ToolbarLayoutParts, ToolbarLayoutProps } from './ToolbarLayout.js';

package/dist/esm/Toolbar/index.js

@@ -8,7 +8,4 @@ export { ToolbarFanOutItem } from './ToolbarFanOutItem.js';
 export { ToolbarFolder } from './ToolbarFolder.js';
 export { ToolbarSlot, ToolbarSlotProvider, useToolbarSlot } from './ToolbarSlot.js';
 export { ToolbarLayout } from './ToolbarLayout.js';
-
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 //# sourceMappingURL=index.js.map

package/dist/esm/Toolbar/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../Toolbar/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;AAAA;AACA"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/esm/index.d.ts

@@ -1,25 +1,18 @@
-import * as Canvas from './Canvas';
-import * as Chat from './Chat';
-import * as CommandDialog from './CommandDialog';
-import * as CommandStepper from './CommandDialog';
-import * as CommandForm from './CommandForm';
-import * as Common from './Common';
-import * as Compatibility from './Compatibility';
-import * as DataPage from './DataPage';
-import * as DataTables from './DataTables';
-import * as Dialogs from './Dialogs';
-import * as Display from './Display';
-import * as Dropdown from './Dropdown';
-import * as Filter from './Filter';
-import * as Notifications from './Notifications';
-import * as ObjectContentEditor from './ObjectContentEditor';
-import * as ObjectNavigationalBar from './ObjectNavigationalBar';
-import * as PivotViewer from './PivotViewer';
-import * as SchemaEditor from './SchemaEditor';
-import * as TimeMachine from './TimeMachine';
-import * as Toolbar from './Toolbar';
-import * as Types from './types';
-export { Canvas, Chat, CommandDialog, CommandStepper, CommandForm, Common, Compatibility, DataPage, DataTables, Dialogs, Display, Dropdown, Filter, Notifications, ObjectContentEditor, ObjectNavigationalBar, PivotViewer, SchemaEditor, TimeMachine, Toolbar, Types, };
-export { CratisComponentsProvider, cratisDefaults, mergeCratisComponentsConfig, type CratisComponentsConfig, type CratisComponentsProviderProps, } from './Common/CratisComponentsProvider';
-export { assertPrimeReact11PassThroughCompatibility, components3PrimeReact11PassThroughContract, primeReact11PassThroughSentinelAttribute, primeReact11PassThroughSentinelPreset, type PrimeReact11PassThroughComponent, } from './Compatibility';
-//# sourceMappingURL=index.d.ts.map
+/**
+ * The package root is a setup-only surface: it carries the application-wide
+ * {@link CratisComponentsProvider} and its configuration contract - locale,
+ * messages, and the hook/merge helpers that read and build that configuration
+ * - and nothing else. Every component, part type, and utility lives behind its
+ * own explicit subpath (`@cratis/components/Canvas`, `@cratis/components/CommandDialog`,
+ * `@cratis/components/DataPage`, ...); the root barrel intentionally does not
+ * re-export those namespaces.
+ *
+ * This keeps a consumer's root import free of every optional-peer-heavy subsystem
+ * (Canvas and PivotViewer's Pixi dependency chief among them) and free of every
+ * `@cratis/arc`/`@cratis/arc.react` runtime or declaration edge. Importing the root
+ * therefore does not resolve or type-check Pixi or Arc modules; package-level peer metadata
+ * still describes the requirements of the complete set of optional capability subpaths.
+ * Import a component from its subpath; import the provider and its configuration
+ * types from here.
+ */
+export { CratisComponentsProvider, useCratisComponentsConfig, cratisDefaults, mergeCratisComponentsConfig, type CratisComponentsConfig, type CratisComponentsProviderProps, type CratisComponentsMessages, type CratisPaginatorMessages, type CratisDatePickerMessages, type CratisDropdownMessages, type CratisDialogMessages, type CratisStepperMessages, type CratisNotificationsMessages, type CratisDataTableMessages, type CratisColumnFilterMessages, } from './Common/CratisComponentsProvider.js';

package/dist/esm/index.js

@@ -1,46 +1,4 @@
-import * as index from './Canvas/index.js';
-export { index as Canvas };
-import * as index$1 from './Chat/index.js';
-export { index$1 as Chat };
-import * as index$2 from './CommandDialog/index.js';
-export { index$2 as CommandDialog };
-export { index$2 as CommandStepper };
-import * as index$3 from './CommandForm/index.js';
-export { index$3 as CommandForm };
-import * as index$4 from './Common/index.js';
-export { index$4 as Common };
-import * as index$5 from './Compatibility/index.js';
-export { index$5 as Compatibility };
-import * as index$6 from './DataPage/index.js';
-export { index$6 as DataPage };
-import * as index$7 from './DataTables/index.js';
-export { index$7 as DataTables };
-import * as index$8 from './Dialogs/index.js';
-export { index$8 as Dialogs };
-import * as index$9 from './Display/index.js';
-export { index$9 as Display };
-import * as index$a from './Dropdown/index.js';
-export { index$a as Dropdown };
-import * as index$b from './Filter/index.js';
-export { index$b as Filter };
-import * as index$c from './Notifications/index.js';
-export { index$c as Notifications };
-import * as index$d from './ObjectContentEditor/index.js';
-export { index$d as ObjectContentEditor };
-import * as index$e from './ObjectNavigationalBar/index.js';
-export { index$e as ObjectNavigationalBar };
-import * as index$f from './PivotViewer/index.js';
-export { index$f as PivotViewer };
-import * as index$g from './SchemaEditor/index.js';
-export { index$g as SchemaEditor };
-import * as index$h from './TimeMachine/index.js';
-export { index$h as TimeMachine };
-import * as index$i from './Toolbar/index.js';
-export { index$i as Toolbar };
-import * as index$j from './types/index.js';
-export { index$j as Types };
-export { CratisComponentsProvider, cratisDefaults, mergeCratisComponentsConfig } from './Common/CratisComponentsProvider.js';
-export { assertPrimeReact11PassThroughCompatibility } from './Compatibility/assertPrimeReact11PassThroughCompatibility.js';
-export { components3PrimeReact11PassThroughContract } from './Compatibility/components3PrimeReact11PassThroughContract.js';
-export { primeReact11PassThroughSentinelAttribute, primeReact11PassThroughSentinelPreset } from './Compatibility/primeReact11PassThroughSentinelPreset.js';
+export { CratisComponentsProvider, mergeCratisComponentsConfig } from './Common/CratisComponentsProvider.js';
+export { cratisDefaults } from './Common/CratisComponentsDefaults.js';
+export { useCratisComponentsConfig } from './Common/CratisComponentsContext.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/renderer/RendererContext.d.ts

@@ -0,0 +1,50 @@
+import { type ReactNode } from 'react';
+import type { unstable_CapabilityId } from './capabilities.js';
+import { type unstable_AdapterDiagnostic } from './errors.js';
+import type { unstable_RendererSetup, unstable_UiLibrary } from './manifest.js';
+import { type unstable_CratisOverlayEnvironment } from './overlayEnvironment.js';
+import { type unstable_RendererLayer } from './resolve.js';
+import type { unstable_SlotDeclaration, unstable_SlotId, unstable_SlotMap } from './slots.js';
+/** Internal renderer state shared by the provider and nested scopes. */
+export interface unstable_RendererContextValue {
+    readonly layers: readonly unstable_RendererLayer[];
+    readonly slots: unstable_SlotMap;
+    readonly libraryMode: 'strict' | 'degrade';
+    readonly rendererFallback: 'core' | 'throw';
+    readonly overlayEnvironment: unstable_CratisOverlayEnvironment;
+    readonly rendererSetup: unstable_RendererSetup;
+    readonly coreSlots: unstable_SlotMap;
+    readonly providerLibraryReferences: readonly unstable_UiLibrary[];
+    readonly reportDiagnostic: (diagnostic: unstable_AdapterDiagnostic) => void;
+}
+/** Props for the internal renderer boundary mounted by the setup provider. */
+export interface unstable_RendererRootProps {
+    readonly library?: unstable_UiLibrary | readonly unstable_UiLibrary[];
+    readonly libraryMode?: 'strict' | 'degrade';
+    readonly rendererFallback?: 'core' | 'throw';
+    readonly overlayEnvironment?: unstable_CratisOverlayEnvironment;
+    /** Non-secret application setup attestations supplied to the selected library provider. */
+    readonly rendererSetup?: unstable_RendererSetup;
+    readonly coreSlots?: unstable_SlotMap;
+    readonly children: ReactNode;
+}
+/** One source-owned context singleton. It is deliberately not exported from the renderer barrel. */
+export declare const unstable_RendererContext: import("react").Context<unstable_RendererContextValue | undefined>;
+/** Internal root boundary. Renderer manifests remain outside Components configuration merging. */
+export declare const unstable_RendererRoot: ({ library, libraryMode, rendererFallback, overlayEnvironment, rendererSetup, coreSlots, children, }: unstable_RendererRootProps) => import("react").JSX.Element;
+/**
+ * Resolves one slot through scopes/provider, a facade-local Core declaration, then Core context.
+ *
+ * @unstable Internal component-routing contract for Slice E. Expect changes until renderer
+ * conformance gates promote it.
+ */
+export declare function unstable_useSlot<K extends unstable_SlotId>(slotId: K, localCoreDeclaration: unstable_SlotDeclaration<K>): unstable_SlotDeclaration<K>;
+export declare function unstable_useSlot<K extends unstable_SlotId>(slotId: K): unstable_SlotDeclaration<K> | undefined;
+/** Returns whether any active renderer layer advertises a Core-owned capability. */
+export declare const unstable_useCapability: (capability: unstable_CapabilityId) => boolean;
+/**
+ * Returns the nearest renderer identity for telemetry only. Behavior must branch on capabilities.
+ */
+export declare const unstable_useRendererId: () => string;
+/** Internal overlay hook. Reading it never invokes getContainer during render or SSR. */
+export declare const unstable_useOverlayEnvironment: () => unstable_CratisOverlayEnvironment;

package/dist/esm/renderer/RendererContext.js

@@ -0,0 +1,128 @@
+import { jsx } from 'react/jsx-runtime';
+import { createContext, useContext, useRef, useEffect, useMemo, useCallback } from 'react';
+import { unstable_AdapterError, unstable_adapterErrorCodes } from './errors.js';
+import { unstable_defaultOverlayEnvironment } from './overlayEnvironment.js';
+import { unstable_resolveSlot, unstable_emptyCoreRendererSlots, unstable_diagnosticKey, unstable_logDiagnostic, unstable_resolveLibraryInput, unstable_createRendererLayer, unstable_validateUiLibrary, unstable_sameLibraryReferences, unstable_createResolvedSlotTable } from './resolve.js';
+
+const unstable_RendererContext = createContext(undefined);
+const emptyRendererSetup = Object.freeze({});
+const freezeRendererSetup = (setup) => Object.freeze(Object.fromEntries(Object.entries(setup).filter(([, value]) => typeof value === 'boolean')));
+const nestedLibraryDiagnostic = (library) => ({
+    code: unstable_adapterErrorCodes.nestedLibraries,
+    adapterId: library.id,
+    message: 'A nested CratisComponentsProvider selected a conflicting renderer library.',
+    remedy: 'Select renderer libraries once at the application provider and use RendererScope for local overrides.',
+});
+const unstable_RendererRoot = ({ library, libraryMode = 'strict', rendererFallback = 'core', overlayEnvironment, rendererSetup, coreSlots, children, }) => {
+    const parent = useContext(unstable_RendererContext);
+    const selected = useMemo(() => unstable_resolveLibraryInput(library), [library]);
+    const setup = useMemo(() => rendererSetup
+        ? freezeRendererSetup(rendererSetup)
+        : (parent?.rendererSetup ?? emptyRendererSetup), [parent?.rendererSetup, rendererSetup]);
+    const layer = useMemo(() => selected.library ? unstable_createRendererLayer(selected.library) : undefined, [selected]);
+    const reportedDiagnostics = useRef(new Set());
+    const reportDiagnostic = useCallback((diagnostic) => {
+        const key = unstable_diagnosticKey(diagnostic);
+        if (reportedDiagnostics.current.has(key))
+            return;
+        reportedDiagnostics.current.add(key);
+        unstable_logDiagnostic(diagnostic);
+    }, []);
+    const diagnostics = useMemo(() => {
+        if (!selected.library)
+            return Object.freeze([]);
+        const currentDiagnostics = selected.references.flatMap((reference) => unstable_validateUiLibrary(reference));
+        if (parent?.providerLibraryReferences.length &&
+            !unstable_sameLibraryReferences(parent.providerLibraryReferences, selected.references)) {
+            currentDiagnostics.unshift(nestedLibraryDiagnostic(selected.library));
+        }
+        return Object.freeze(currentDiagnostics);
+    }, [parent?.providerLibraryReferences, selected]);
+    useEffect(() => {
+        if (libraryMode === 'degrade') {
+            diagnostics.forEach(reportDiagnostic);
+        }
+    }, [diagnostics, libraryMode, reportDiagnostic]);
+    const layers = useMemo(() => Object.freeze([...(parent?.layers ?? []), ...(layer ? [layer] : [])]), [layer, parent?.layers]);
+    const slots = useMemo(() => unstable_createResolvedSlotTable(layers), [layers]);
+    const resolvedCoreSlots = useMemo(() => coreSlots
+        ? Object.freeze({ ...coreSlots })
+        : (parent?.coreSlots ?? unstable_emptyCoreRendererSlots), [coreSlots, parent?.coreSlots]);
+    const value = useMemo(() => Object.freeze({
+        layers,
+        slots,
+        libraryMode,
+        rendererFallback,
+        overlayEnvironment: overlayEnvironment ??
+            parent?.overlayEnvironment ??
+            unstable_defaultOverlayEnvironment,
+        rendererSetup: setup,
+        coreSlots: resolvedCoreSlots,
+        providerLibraryReferences: selected.references.length > 0
+            ? selected.references
+            : (parent?.providerLibraryReferences ?? selected.references),
+        reportDiagnostic,
+    }), [
+        layers,
+        libraryMode,
+        overlayEnvironment,
+        parent?.overlayEnvironment,
+        parent?.providerLibraryReferences,
+        rendererFallback,
+        reportDiagnostic,
+        resolvedCoreSlots,
+        selected.references,
+        setup,
+        slots,
+    ]);
+    if (libraryMode === 'strict' && diagnostics.length > 0) {
+        throw new unstable_AdapterError(diagnostics[0]);
+    }
+    const LibraryProvider = selected.library?.Provider;
+    return (jsx(unstable_RendererContext.Provider, { value: value, children: LibraryProvider ? (jsx(LibraryProvider, { setup: setup, children: children })) : (children) }));
+};
+const fallbackDiagnostic = (context, slotId) => ({
+    code: unstable_adapterErrorCodes.strictProfileFallback,
+    adapterId: context?.layers[context.layers.length - 1]?.library.id ?? 'core',
+    slotId,
+    message: `Renderer resolution requested Core fallback for slot '${slotId}'.`,
+    remedy: `Provide a supported '${slotId}' renderer declaration or intentionally retain the Core fallback.`,
+});
+function unstable_useSlot(slotId, localCoreDeclaration) {
+    const context = useContext(unstable_RendererContext);
+    const localReportedDiagnostics = useRef(new Set());
+    const result = unstable_resolveSlot(slotId, context?.slots ?? unstable_emptyCoreRendererSlots, localCoreDeclaration, context?.coreSlots ?? unstable_emptyCoreRendererSlots);
+    const diagnostic = result.usedCoreFallback && (context?.layers.length ?? 0) > 0
+        ? fallbackDiagnostic(context, slotId)
+        : undefined;
+    useEffect(() => {
+        if (!diagnostic)
+            return;
+        if (context) {
+            context.reportDiagnostic(diagnostic);
+            return;
+        }
+        const key = unstable_diagnosticKey(diagnostic);
+        if (!localReportedDiagnostics.current.has(key)) {
+            localReportedDiagnostics.current.add(key);
+            unstable_logDiagnostic(diagnostic);
+        }
+    }, [context, diagnostic]);
+    if (result.usedCoreFallback && (context?.rendererFallback ?? 'core') === 'throw') {
+        throw new unstable_AdapterError(diagnostic ?? fallbackDiagnostic(context, slotId));
+    }
+    return result.declaration;
+}
+const unstable_useCapability = (capability) => {
+    const context = useContext(unstable_RendererContext);
+    return (context?.layers.some((layer) => layer.library.capabilities.includes(capability)) ?? false);
+};
+const unstable_useRendererId = () => {
+    const context = useContext(unstable_RendererContext);
+    return context?.layers[context.layers.length - 1]?.library.id ?? 'core';
+};
+const unstable_useOverlayEnvironment = () => useContext(unstable_RendererContext)?.overlayEnvironment ??
+    unstable_defaultOverlayEnvironment;
+
+export { unstable_RendererContext, unstable_RendererRoot, unstable_useCapability, unstable_useOverlayEnvironment, unstable_useRendererId, unstable_useSlot };
+//# sourceMappingURL=RendererContext.js.map

package/dist/esm/renderer/RendererContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RendererContext.js","sources":["../../../renderer/RendererContext.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;;MAmEa,wBAAwB,GAAG,aAAa,CAEnD,SAAS;AAEX,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAA2B;AAEtE,MAAM,mBAAmB,GAAG,CACxB,KAAwC,KAExC,MAAM,CAAC,MAAM,CACT,MAAM,CAAC,WAAW,CACd,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,OAAO,KAAK,KAAK,SAAS,CAAC,CAC1E,CACsB;AAE/B,MAAM,uBAAuB,GAAG,CAC5B,OAA2B,MACG;IAC9B,IAAI,EAAE,0BAA0B,CAAC,eAAe;IAChD,SAAS,EAAE,OAAO,CAAC,EAAE;AACrB,IAAA,OAAO,EAAE,4EAA4E;AACrF,IAAA,MAAM,EAAE,uGAAuG;AAClH,CAAA,CAAC;AAGK,MAAM,qBAAqB,GAAG,CAAC,EAClC,OAAO,EACP,WAAW,GAAG,QAAQ,EACtB,gBAAgB,GAAG,MAAM,EACzB,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,QAAQ,GACiB,KAAI;AAC7B,IAAA,MAAM,MAAM,GAAG,UAAU,CAAC,wBAAwB,CAAC;AACnD,IAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,4BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;AAChF,IAAA,MAAM,KAAK,GAAG,OAAO,CACjB,MACI;AACI,UAAE,mBAAmB,CAAC,aAAa;AACnC,WAAG,MAAM,EAAE,aAAa,IAAI,kBAAkB,CAAC,EACvD,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CACzC;AACD,IAAA,MAAM,KAAK,GAAG,OAAO,CACjB,MACI,QAAQ,CAAC,OAAO,GAAG,4BAA4B,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,EACjF,CAAC,QAAQ,CAAC,CACb;IACD,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,GAAG,EAAU,CAAC;AACrD,IAAA,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,UAAsC,KAAI;AAC5E,QAAA,MAAM,GAAG,GAAG,sBAAsB,CAAC,UAAU,CAAC;AAC9C,QAAA,IAAI,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE;AAC1C,QAAA,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QACpC,sBAAsB,CAAC,UAAU,CAAC;IACtC,CAAC,EAAE,EAAE,CAAC;AAEN,IAAA,MAAM,WAAW,GAAG,OAAO,CAAC,MAAK;QAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO;AACjB,YAAA,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAA0C;AAErE,QAAA,MAAM,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,KAC7D,0BAA0B,CAAC,SAAS,CAAC,CACxC;AACD,QAAA,IACI,MAAM,EAAE,yBAAyB,CAAC,MAAM;YACxC,CAAC,8BAA8B,CAC3B,MAAM,CAAC,yBAAyB,EAChC,QAAQ,CAAC,UAAU,CACtB,EACH;YACE,kBAAkB,CAAC,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzE;AACA,QAAA,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAC5C,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,EAAE,QAAQ,CAAC,CAAC;IAEjD,SAAS,CAAC,MAAK;AACX,QAAA,IAAI,WAAW,KAAK,SAAS,EAAE;AAC3B,YAAA,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACzC;IACJ,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,OAAO,CAClB,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAC3E,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAC1B;AACD,IAAA,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,gCAAgC,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AAC/E,IAAA,MAAM,iBAAiB,GAAG,OAAO,CAC7B,MACI;UACM,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,EAAE;AAChC,WAAG,MAAM,EAAE,SAAS,IAAI,+BAA+B,CAAC,EAChE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CACjC;IACD,MAAM,KAAK,GAAG,OAAO,CACjB,MACI,MAAM,CAAC,MAAM,CAAC;QACV,MAAM;QACN,KAAK;QACL,WAAW;QACX,gBAAgB;AAChB,QAAA,kBAAkB,EACd,kBAAkB;AAClB,YAAA,MAAM,EAAE,kBAAkB;YAC1B,kCAAkC;AACtC,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,SAAS,EAAE,iBAAiB;AAC5B,QAAA,yBAAyB,EACrB,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG;cACvB,QAAQ,CAAC;eACR,MAAM,EAAE,yBAAyB,IAAI,QAAQ,CAAC,UAAU,CAAC;QACpE,gBAAgB;AACnB,KAAA,CAAC,EACN;QACI,MAAM;QACN,WAAW;QACX,kBAAkB;AAClB,QAAA,MAAM,EAAE,kBAAkB;AAC1B,QAAA,MAAM,EAAE,yBAAyB;QACjC,gBAAgB;QAChB,gBAAgB;QAChB,iBAAiB;AACjB,QAAA,QAAQ,CAAC,UAAU;QACnB,KAAK;QACL,KAAK;AACR,KAAA,CACJ;IAED,IAAI,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;QACpD,MAAM,IAAI,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACnD;AAEA,IAAA,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ;AAClD,IAAA,QACIA,GAAA,CAAC,wBAAwB,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,KAAK,EAAA,QAAA,EAC1C,eAAe,IACZA,GAAA,CAAC,eAAe,EAAA,EAAC,KAAK,EAAE,KAAK,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAmB,KAE3D,QAAQ,CACX,EAAA,CAC+B;AAE5C;AAEA,MAAM,kBAAkB,GAAG,CACvB,OAAkD,EAClD,MAAuB,MACO;IAC9B,IAAI,EAAE,0BAA0B,CAAC,qBAAqB;AACtD,IAAA,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,MAAM;IAC3E,MAAM;IACN,OAAO,EAAE,CAAA,sDAAA,EAAyD,MAAM,CAAA,EAAA,CAAI;IAC5E,MAAM,EAAE,CAAA,qBAAA,EAAwB,MAAM,CAAA,iEAAA,CAAmE;AAC5G,CAAA,CAAC;AAeI,SAAU,gBAAgB,CAC5B,MAAS,EACT,oBAAkD,EAAA;AAElD,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,wBAAwB,CAAC;IACpD,MAAM,wBAAwB,GAAG,MAAM,CAAC,IAAI,GAAG,EAAU,CAAC;IAC1D,MAAM,MAAM,GAAG,oBAAoB,CAC/B,MAAM,EACN,OAAO,EAAE,KAAK,IAAI,+BAA+B,EACjD,oBAAoB,EACpB,OAAO,EAAE,SAAS,IAAI,+BAA+B,CACxD;AAED,IAAA,MAAM,UAAU,GACZ,MAAM,CAAC,gBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI;AACvD,UAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM;UAClC,SAAS;IAEnB,SAAS,CAAC,MAAK;AACX,QAAA,IAAI,CAAC,UAAU;YAAE;QACjB,IAAI,OAAO,EAAE;AACT,YAAA,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC;YACpC;QACJ;AACA,QAAA,MAAM,GAAG,GAAG,sBAAsB,CAAC,UAAU,CAAC;QAC9C,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AAC5C,YAAA,wBAAwB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YACzC,sBAAsB,CAAC,UAAU,CAAC;QACtC;AACJ,IAAA,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAEzB,IAAA,IAAI,MAAM,CAAC,gBAAgB,IAAI,CAAC,OAAO,EAAE,gBAAgB,IAAI,MAAM,MAAM,OAAO,EAAE;AAC9E,QAAA,MAAM,IAAI,qBAAqB,CAC3B,UAAU,IAAI,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CACpD;IACL;IAEA,OAAO,MAAM,CAAC,WAAW;AAC7B;AAGO,MAAM,sBAAsB,GAAG,CAAC,UAAiC,KAAa;AACjF,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,wBAAwB,CAAC;IACpD,QACI,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,KACvB,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAClD,IAAI,KAAK;AAElB;AAKO,MAAM,sBAAsB,GAAG,MAAa;AAC/C,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,wBAAwB,CAAC;AACpD,IAAA,OAAO,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,MAAM;AAC3E;AAGO,MAAM,8BAA8B,GAAG,MAC1C,UAAU,CAAC,wBAAwB,CAAC,EAAE,kBAAkB;AACxD,IAAA;;"}

package/dist/esm/renderer/RendererScope.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from 'react';
+import type { unstable_UiLibrary } from './manifest.js';
+import type { unstable_SlotId } from './slots.js';
+/** Props for a local renderer override. */
+export interface unstable_RendererScopeProps {
+    /** One renderer or an ordered last-wins composition used in this subtree. */
+    readonly use: unstable_UiLibrary | readonly unstable_UiLibrary[];
+    /** Optional slot allow-list. Other slots continue through outer scopes and the provider. */
+    readonly only?: readonly unstable_SlotId[];
+    /** Scoped application content. */
+    readonly children: ReactNode;
+}
+/**
+ * Applies a renderer locally. The nearest matching scope wins; `only` lets all other slots continue
+ * through outer scopes and the application provider.
+ *
+ * @unstable Consumer contract. Expect changes until renderer conformance gates promote it.
+ */
+export declare const unstable_RendererScope: ({ use, only, children, }: unstable_RendererScopeProps) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;

package/dist/esm/renderer/RendererScope.js

@@ -0,0 +1,54 @@
+import { jsx } from 'react/jsx-runtime';
+import { useContext, useMemo, useEffect } from 'react';
+import { unstable_AdapterError, unstable_adapterErrorCodes } from './errors.js';
+import { unstable_resolveLibraryInput, unstable_isKnownSlot, unstable_createRendererLayer, unstable_validateUiLibrary, unstable_createResolvedSlotTable } from './resolve.js';
+import { unstable_RendererContext } from './RendererContext.js';
+
+const invalidOnlyDiagnostic = (library, slotId) => ({
+    code: unstable_adapterErrorCodes.missingRequirement,
+    adapterId: library.id,
+    message: `RendererScope only includes unknown slot '${String(slotId)}'.`,
+    remedy: 'Use only slot identifiers declared by the installed Components version.',
+});
+const unstable_RendererScope = ({ use, only, children, }) => {
+    const parent = useContext(unstable_RendererContext);
+    const selected = useMemo(() => unstable_resolveLibraryInput(use), [use]);
+    const acceptedOnly = useMemo(() => only?.filter(unstable_isKnownSlot), [only]);
+    const layer = useMemo(() => selected.library
+        ? unstable_createRendererLayer(selected.library, acceptedOnly)
+        : undefined, [acceptedOnly, selected]);
+    const diagnostics = useMemo(() => {
+        if (!selected.library)
+            return Object.freeze([]);
+        return Object.freeze([
+            ...selected.references.flatMap((reference) => unstable_validateUiLibrary(reference)),
+            ...(only ?? [])
+                .filter((slotId) => !unstable_isKnownSlot(slotId))
+                .map((slotId) => invalidOnlyDiagnostic(selected.library, slotId)),
+        ]);
+    }, [only, selected]);
+    useEffect(() => {
+        if (parent?.libraryMode === 'degrade') {
+            diagnostics.forEach(parent.reportDiagnostic);
+        }
+    }, [diagnostics, parent]);
+    const layers = useMemo(() => (parent && layer ? Object.freeze([...parent.layers, layer]) : undefined), [layer, parent]);
+    const slots = useMemo(() => (layers ? unstable_createResolvedSlotTable(layers) : undefined), [layers]);
+    const value = useMemo(() => parent && layers && slots
+        ? Object.freeze({
+            ...parent,
+            layers,
+            slots,
+        })
+        : undefined, [layers, parent, slots]);
+    if ((parent?.libraryMode ?? 'strict') === 'strict' && diagnostics.length > 0) {
+        throw new unstable_AdapterError(diagnostics[0]);
+    }
+    const LibraryProvider = selected.library?.Provider;
+    if (!value)
+        return children;
+    return (jsx(unstable_RendererContext.Provider, { value: value, children: LibraryProvider ? (jsx(LibraryProvider, { setup: value.rendererSetup, children: children })) : (children) }));
+};
+
+export { unstable_RendererScope };
+//# sourceMappingURL=RendererScope.js.map

package/dist/esm/renderer/RendererScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RendererScope.js","sources":["../../../renderer/RendererScope.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":"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"}

package/dist/esm/renderer/builtin/index.d.ts

@@ -0,0 +1,12 @@
+import { type unstable_UiLibrary } from '../manifest.js';
+/**
+ * Opt-in manifest for the Components-owned implementations of every renderer ABI v1 slot.
+ *
+ * This proof adapter is intentionally isolated to `@cratis/components/renderer/builtin`. Importing
+ * it opts into the complete component-family graph; the package root and lean `./renderer` subpath
+ * never reach this manifest or the private Core slot table behind it.
+ *
+ * @unstable Adapter-author proof contract. It is not an application default or a discovery API.
+ */
+export declare const unstable_cratisBuiltIn: unstable_UiLibrary;
+//# sourceMappingURL=index.d.ts.map