@cratis/components 3.6.1 → 4.1.0

package/dist/esm/renderer/presentation.js

@@ -0,0 +1,119 @@
+const CRATIS_PRESENTATION_PROFILE = 'stable-presentation/v1';
+const CRATIS_PRESENTATION_ABI_VERSION = 1;
+const cratisPresentationSlotIds = Object.freeze([
+    'common.button',
+    'common.iconButton',
+    'common.textInput',
+    'common.textArea',
+    'common.checkbox',
+    'common.radio',
+    'common.switch',
+    'common.progress',
+    'common.surface',
+]);
+const requiredCapabilityIds = [
+    'slot.render',
+    'parts.passthrough',
+    'ssr.staticRender',
+];
+const stableCapabilityIds = new Set([
+    ...requiredCapabilityIds,
+    'rtl',
+    'forcedColors',
+    'motion.reduced',
+]);
+const invalidPresentationLibrary = (reason) => {
+    throw new TypeError(`Invalid stable presentation UI library: ${reason}.`);
+};
+const hasCanonicalProfileSlots = (profileSlots) => profileSlots.length === cratisPresentationSlotIds.length &&
+    profileSlots.every((slotId, index) => slotId === cratisPresentationSlotIds[index]);
+const definePresentationUiLibrary = (library) => {
+    if (library === null || typeof library !== 'object') {
+        invalidPresentationLibrary('manifest must be an object');
+    }
+    if (typeof library.id !== 'string' ||
+        library.id.length > 128 ||
+        !/^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/u.test(library.id)) {
+        invalidPresentationLibrary('id must be a valid package-local renderer identity');
+    }
+    if (typeof library.displayName !== 'string' ||
+        library.displayName.trim().length === 0 ||
+        library.displayName.length > 128) {
+        invalidPresentationLibrary('displayName must contain between 1 and 128 characters');
+    }
+    if (library.Provider !== undefined && typeof library.Provider !== 'function') {
+        invalidPresentationLibrary('Provider must be a React component when supplied');
+    }
+    if (library.profile !== CRATIS_PRESENTATION_PROFILE) {
+        invalidPresentationLibrary(`profile must be '${CRATIS_PRESENTATION_PROFILE}'`);
+    }
+    if (library.abi !== CRATIS_PRESENTATION_ABI_VERSION) {
+        invalidPresentationLibrary(`ABI must be ${CRATIS_PRESENTATION_ABI_VERSION}`);
+    }
+    if (library.level !== 'primitive') {
+        invalidPresentationLibrary("level must be 'primitive'");
+    }
+    if (!Array.isArray(library.profileSlots) ||
+        !hasCanonicalProfileSlots(library.profileSlots)) {
+        invalidPresentationLibrary('profileSlots must be the canonical nine-slot profile');
+    }
+    if (!library.slots || typeof library.slots !== 'object') {
+        invalidPresentationLibrary('slots must be an object');
+    }
+    const slotIds = Object.keys(library.slots);
+    if (slotIds.length !== cratisPresentationSlotIds.length ||
+        cratisPresentationSlotIds.some((slotId) => !slotIds.includes(slotId))) {
+        invalidPresentationLibrary('slots must contain exactly the nine stable presentation slots');
+    }
+    for (const slotId of cratisPresentationSlotIds) {
+        const declaration = library.slots[slotId];
+        if (!declaration) {
+            throw new TypeError(`Invalid stable presentation UI library: slot '${slotId}' must provide a declaration.`);
+        }
+        if (declaration.mode !== 'presentation') {
+            invalidPresentationLibrary(`slot '${slotId}' must use presentation mode`);
+        }
+        if (declaration.fidelity !== 'native' && declaration.fidelity !== 'emulated') {
+            invalidPresentationLibrary(`slot '${slotId}' must use native or emulated fidelity`);
+        }
+        if (declaration.render === null ||
+            (typeof declaration.render !== 'function' &&
+                typeof declaration.render !== 'object')) {
+            invalidPresentationLibrary(`slot '${slotId}' must provide a component`);
+        }
+    }
+    if (!Array.isArray(library.capabilities) ||
+        library.capabilities.some((capability) => !stableCapabilityIds.has(capability))) {
+        invalidPresentationLibrary('capabilities must stay within the stable presentation subset');
+    }
+    if (requiredCapabilityIds.some((capability, index) => library.capabilities[index] !== capability)) {
+        invalidPresentationLibrary('capabilities must begin with slot.render, parts.passthrough, and ssr.staticRender');
+    }
+    if (new Set(library.capabilities).size !== library.capabilities.length) {
+        invalidPresentationLibrary('capabilities must not contain duplicates');
+    }
+    const slots = Object.freeze(Object.fromEntries(cratisPresentationSlotIds.map((slotId) => [
+        slotId,
+        Object.freeze({
+            mode: library.slots[slotId].mode,
+            fidelity: library.slots[slotId].fidelity,
+            render: library.slots[slotId].render,
+        }),
+    ])));
+    return Object.freeze({
+        id: library.id,
+        displayName: library.displayName,
+        abi: library.abi,
+        level: library.level,
+        profile: library.profile,
+        profileSlots: cratisPresentationSlotIds,
+        capabilities: Object.freeze([
+            ...library.capabilities,
+        ]),
+        slots,
+        Provider: library.Provider,
+    });
+};
+
+export { CRATIS_PRESENTATION_ABI_VERSION, CRATIS_PRESENTATION_PROFILE, cratisPresentationSlotIds, definePresentationUiLibrary };
+//# sourceMappingURL=presentation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sources":["../../../renderer/presentation.ts"],"sourcesContent":[null],"names":[],"mappings":"AAgBO,MAAM,2BAA2B,GAAG;AAGpC,MAAM,+BAA+B,GAAG;AAGxC,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,eAAe;IACf,mBAAmB;IACnB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,iBAAiB;IACjB,gBAAgB;AACV,CAAA;AA0FV,MAAM,qBAAqB,GAAG;IAC1B,aAAa;IACb,mBAAmB;IACnB,kBAAkB;CACZ;AAEV,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAiC;AAChE,IAAA,GAAG,qBAAqB;IACxB,KAAK;IACL,cAAc;IACd,gBAAgB;AACnB,CAAA,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAC,MAAc,KAAW;AACzD,IAAA,MAAM,IAAI,SAAS,CAAC,2CAA2C,MAAM,CAAA,CAAA,CAAG,CAAC;AAC7E,CAAC;AAED,MAAM,wBAAwB,GAAG,CAAC,YAAgC,KAC9D,YAAY,CAAC,MAAM,KAAK,yBAAyB,CAAC,MAAM;AACxD,IAAA,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,KAAK,yBAAyB,CAAC,KAAK,CAAC,CAAC;AAS/E,MAAM,2BAA2B,GAAG,CACvC,OAAoC,KACP;IAC7B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;QACjD,0BAA0B,CAAC,4BAA4B,CAAC;IAC5D;AACA,IAAA,IACI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;AAC9B,QAAA,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG;QACvB,CAAC,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAC1D;QACE,0BAA0B,CAAC,oDAAoD,CAAC;IACpF;AACA,IAAA,IACI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QACvC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;AACvC,QAAA,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,GAAG,EAClC;QACE,0BAA0B,CACtB,uDAAuD,CAC1D;IACL;AACA,IAAA,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU,EAAE;QAC1E,0BAA0B,CAAC,kDAAkD,CAAC;IAClF;AACA,IAAA,IAAI,OAAO,CAAC,OAAO,KAAK,2BAA2B,EAAE;AACjD,QAAA,0BAA0B,CAAC,CAAA,iBAAA,EAAoB,2BAA2B,CAAA,CAAA,CAAG,CAAC;IAClF;AACA,IAAA,IAAI,OAAO,CAAC,GAAG,KAAK,+BAA+B,EAAE;AACjD,QAAA,0BAA0B,CAAC,CAAA,YAAA,EAAe,+BAA+B,CAAA,CAAE,CAAC;IAChF;AACA,IAAA,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE;QAC/B,0BAA0B,CAAC,2BAA2B,CAAC;IAC3D;IACA,IACI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;AACpC,QAAA,CAAC,wBAAwB,CAAC,OAAO,CAAC,YAAY,CAAC,EACjD;QACE,0BAA0B,CACtB,sDAAsD,CACzD;IACL;AACA,IAAA,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE;QACrD,0BAA0B,CAAC,yBAAyB,CAAC;IACzD;IAEA,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;AAC1C,IAAA,IACI,OAAO,CAAC,MAAM,KAAK,yBAAyB,CAAC,MAAM;AACnD,QAAA,yBAAyB,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EACvE;QACE,0BAA0B,CACtB,+DAA+D,CAClE;IACL;AAEA,IAAA,KAAK,MAAM,MAAM,IAAI,yBAAyB,EAAE;QAG5C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CACD;QACvC,IAAI,CAAC,WAAW,EAAE;AACd,YAAA,MAAM,IAAI,SAAS,CACf,iDAAiD,MAAM,CAAA,6BAAA,CAA+B,CACzF;QACL;AACA,QAAA,IAAI,WAAW,CAAC,IAAI,KAAK,cAAc,EAAE;AACrC,YAAA,0BAA0B,CAAC,CAAA,MAAA,EAAS,MAAM,CAAA,4BAAA,CAA8B,CAAC;QAC7E;AACA,QAAA,IAAI,WAAW,CAAC,QAAQ,KAAK,QAAQ,IAAI,WAAW,CAAC,QAAQ,KAAK,UAAU,EAAE;AAC1E,YAAA,0BAA0B,CACtB,CAAA,MAAA,EAAS,MAAM,CAAA,sCAAA,CAAwC,CAC1D;QACL;AACA,QAAA,IACI,WAAW,CAAC,MAAM,KAAK,IAAI;AAC3B,aAAC,OAAO,WAAW,CAAC,MAAM,KAAK,UAAU;AACrC,gBAAA,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC,EAC7C;AACE,YAAA,0BAA0B,CAAC,CAAA,MAAA,EAAS,MAAM,CAAA,0BAAA,CAA4B,CAAC;QAC3E;IACJ;IAEA,IACI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;AACpC,QAAA,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EACjF;QACE,0BAA0B,CACtB,8DAA8D,CACjE;IACL;IACA,IACI,qBAAqB,CAAC,IAAI,CACtB,CAAC,UAAU,EAAE,KAAK,KAAK,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,UAAU,CACpE,EACH;QACE,0BAA0B,CACtB,mFAAmF,CACtF;IACL;AACA,IAAA,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE;QACpE,0BAA0B,CAAC,0CAA0C,CAAC;IAC1E;AAEA,IAAA,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CACvB,MAAM,CAAC,WAAW,CACd,yBAAyB,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK;QACtC,MAAM;QACN,MAAM,CAAC,MAAM,CAAC;YACV,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI;YAChC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ;YACxC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM;SACvC,CAAC;KACL,CAAC,CACL,CACyB;IAE9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;AACxB,QAAA,YAAY,EAAE,yBAAyB;AACvC,QAAA,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YACxB,GAAG,OAAO,CAAC,YAAY;SAC1B,CAAmC;QACpC,KAAK;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;AAC7B,KAAA,CAAC;AACN;;"}

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

@@ -0,0 +1,8 @@
+import { type ComponentType, type ForwardedRef, type ReactElement } from 'react';
+interface RenderDeclaration<Props> {
+    readonly render: ComponentType<Props>;
+}
+export declare function renderSlot<Props extends object>(declaration: RenderDeclaration<Props>, props: Props): ReactElement;
+export declare function renderSlot<Props extends object, Element>(declaration: RenderDeclaration<Props>, props: Props, ref: ForwardedRef<Element>): ReactElement;
+export {};
+//# sourceMappingURL=renderSlot.d.ts.map

package/dist/esm/renderer/renderSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderSlot.d.ts","sourceRoot":"","sources":["../../../renderer/renderSlot.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EAEpB,MAAM,OAAO,CAAC;AAEf,UAAU,iBAAiB,CAAC,KAAK;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;CACzC;AAED,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,EAC3C,WAAW,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACrC,KAAK,EAAE,KAAK,GACb,YAAY,CAAC;AAChB,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO,EACpD,WAAW,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACrC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAC3B,YAAY,CAAC"}

package/dist/esm/renderer/renderSlot.js

@@ -0,0 +1,12 @@
+import { createElement } from 'react';
+
+function renderSlot(declaration, props, ref) {
+    if (arguments.length < 3)
+        return createElement(declaration.render, props);
+    const RefCapableSlot = declaration.render;
+    const slotProps = { ...props, ref };
+    return createElement(RefCapableSlot, slotProps);
+}
+
+export { renderSlot };
+//# sourceMappingURL=renderSlot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderSlot.js","sources":["../../../renderer/renderSlot.ts"],"sourcesContent":[null],"names":[],"mappings":";;SAwBgB,UAAU,CACtB,WAAqC,EACrC,KAAY,EACZ,GAA2B,EAAA;AAE3B,IAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC;AAKzE,IAAA,MAAM,cAAc,GAAG,WAAW,CAAC,MAElC;IACD,MAAM,SAAS,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,EAAoC;AACrE,IAAA,OAAO,aAAa,CAAC,cAAc,EAAE,SAAS,CAAC;AACnD;;"}

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

@@ -0,0 +1,37 @@
+import type { unstable_AdapterDiagnostic } from './errors.js';
+import { type unstable_UiLibrary } from './manifest.js';
+import type { unstable_SlotDeclaration, unstable_SlotId, unstable_SlotMap } from './slots.js';
+/** Internal immutable renderer layer used by context resolution. */
+export interface unstable_RendererLayer {
+    readonly library: unstable_UiLibrary;
+    readonly slots: unstable_SlotMap;
+    readonly only?: ReadonlySet<unstable_SlotId>;
+}
+/** Identity-preserving normalization result for a provider or scope library input. */
+export interface unstable_ResolvedLibraryInput {
+    readonly library?: unstable_UiLibrary;
+    readonly references: readonly unstable_UiLibrary[];
+}
+/** Empty D2 Core fallback table. Slice E can inject its built-in table without a registry. */
+export declare const unstable_emptyCoreRendererSlots: unstable_SlotMap;
+/** Returns whether a value is one of the Core-owned slot identifiers. */
+export declare const unstable_isKnownSlot: (value: unknown) => value is unstable_SlotId;
+/** Normalizes one library or an ordered last-wins composition without deep merging it. */
+export declare const unstable_resolveLibraryInput: (input: unstable_UiLibrary | readonly unstable_UiLibrary[] | undefined) => unstable_ResolvedLibraryInput;
+/** Creates one immutable slot lookup snapshot for a manifest and optional scope filter. */
+export declare const unstable_createRendererLayer: (library: unstable_UiLibrary, only?: readonly unstable_SlotId[]) => unstable_RendererLayer;
+/** Runs ABI, profile, capability, and adapter preflight validation. */
+export declare const unstable_validateUiLibrary: (library: unstable_UiLibrary) => readonly unstable_AdapterDiagnostic[];
+/** Compares normalized library identities without comparing or cloning manifest contents. */
+export declare const unstable_sameLibraryReferences: (left: readonly unstable_UiLibrary[], right: readonly unstable_UiLibrary[]) => boolean;
+/** Flattens outer-to-inner layers into one frozen, last-wins lookup table. */
+export declare const unstable_createResolvedSlotTable: (layers: readonly unstable_RendererLayer[]) => unstable_SlotMap;
+/** Resolves a slot through external layers, a facade-local Core declaration, then Core context. */
+export declare const unstable_resolveSlot: <K extends unstable_SlotId>(slotId: K, slots: unstable_SlotMap, localCoreDeclaration: unstable_SlotDeclaration<K> | undefined, coreSlots: unstable_SlotMap) => {
+    declaration?: unstable_SlotDeclaration<K>;
+    usedCoreFallback: boolean;
+};
+/** Stable log key used to de-duplicate diagnostics within one provider identity. */
+export declare const unstable_diagnosticKey: (diagnostic: unstable_AdapterDiagnostic) => string;
+/** Emits one actionable renderer diagnostic without exposing manifest contents. */
+export declare const unstable_logDiagnostic: (diagnostic: unstable_AdapterDiagnostic) => void;

package/dist/esm/renderer/resolve.js

@@ -0,0 +1,123 @@
+import { unstable_adapterErrorCodes } from './errors.js';
+import { unstable_composeUiLibraries, unstable_CRATIS_UI_ABI_VERSION } from './manifest.js';
+
+const knownSlots = new Set([
+    'common.button',
+    'common.iconButton',
+    'common.textInput',
+    'common.textArea',
+    'common.checkbox',
+    'common.radio',
+    'common.switch',
+    'common.progress',
+    'common.surface',
+    'common.tooltip',
+    'dropdown.select',
+    'dialogs.dialog',
+    'display.datePicker',
+    'datatables.paginator',
+]);
+const unstable_emptyCoreRendererSlots = Object.freeze({});
+const unstable_isKnownSlot = (value) => typeof value === 'string' && knownSlots.has(value);
+const unstable_resolveLibraryInput = (input) => {
+    if (!input)
+        return Object.freeze({ references: Object.freeze([]) });
+    const references = Object.freeze(Array.isArray(input) ? [...input] : [input]);
+    if (references.length === 0) {
+        return Object.freeze({ references });
+    }
+    return Object.freeze({
+        library: references.length === 1
+            ? references[0]
+            : unstable_composeUiLibraries(...references),
+        references,
+    });
+};
+const unstable_createRendererLayer = (library, only) => Object.freeze({
+    library,
+    slots: Object.freeze({ ...library.slots }),
+    only: only ? new Set(only) : undefined,
+});
+const missingRequirement = (library, message, remedy, slotId) => ({
+    code: unstable_adapterErrorCodes.missingRequirement,
+    adapterId: library.id,
+    slotId,
+    message,
+    remedy,
+});
+const unstable_validateUiLibrary = (library) => {
+    const diagnostics = [];
+    if (library.abi !== unstable_CRATIS_UI_ABI_VERSION) {
+        diagnostics.push({
+            code: unstable_adapterErrorCodes.abiMismatch,
+            adapterId: library.id,
+            message: `Renderer ABI ${library.abi} does not match Core ABI ${unstable_CRATIS_UI_ABI_VERSION}.`,
+            remedy: `Install a renderer that targets ABI ${unstable_CRATIS_UI_ABI_VERSION}.`,
+        });
+    }
+    const profileSlots = library.profileSlots ?? Object.keys(library.slots);
+    if (profileSlots.length > 0 && !library.capabilities.includes('slot.render')) {
+        diagnostics.push(missingRequirement(library, `Profile '${library.profile}' promises slots without the 'slot.render' capability.`, "Declare 'slot.render' only after the adapter can render every promised slot."));
+    }
+    for (const profileSlot of profileSlots) {
+        if (!unstable_isKnownSlot(profileSlot)) {
+            diagnostics.push(missingRequirement(library, `Profile '${library.profile}' promises unknown slot '${String(profileSlot)}'.`, 'Remove the unknown slot or install a Core version that declares it.'));
+            continue;
+        }
+        const declaration = library.slots[profileSlot];
+        if (!declaration || declaration.fidelity === 'unsupported') {
+            diagnostics.push(missingRequirement(library, `Profile '${library.profile}' does not support promised slot '${profileSlot}'.`, `Provide a supported '${profileSlot}' declaration or remove it from profileSlots.`, profileSlot));
+        }
+    }
+    if (library.preflight) {
+        try {
+            diagnostics.push(...library.preflight());
+        }
+        catch (error) {
+            diagnostics.push({
+                code: unstable_adapterErrorCodes.missingUpstreamPeer,
+                adapterId: library.id,
+                message: `Renderer preflight failed: ${error instanceof Error ? error.message : String(error)}.`,
+                remedy: 'Correct the renderer installation so its preflight can complete.',
+            });
+        }
+    }
+    return Object.freeze([...diagnostics]);
+};
+const unstable_sameLibraryReferences = (left, right) => left.length === right.length &&
+    left.every((library, index) => library === right[index]);
+const unstable_createResolvedSlotTable = (layers) => {
+    const resolved = {};
+    for (const layer of layers) {
+        for (const [slotId, declaration] of Object.entries(layer.slots)) {
+            if (!declaration ||
+                declaration.fidelity === 'unsupported' ||
+                (layer.only && !layer.only.has(slotId)))
+                continue;
+            resolved[slotId] = declaration;
+        }
+    }
+    return Object.freeze(resolved);
+};
+const unstable_resolveSlot = (slotId, slots, localCoreDeclaration, coreSlots) => {
+    const declaration = slots[slotId];
+    if (declaration)
+        return { declaration, usedCoreFallback: false };
+    return {
+        declaration: localCoreDeclaration ??
+            coreSlots[slotId],
+        usedCoreFallback: true,
+    };
+};
+const unstable_diagnosticKey = (diagnostic) => [
+    diagnostic.code,
+    diagnostic.adapterId,
+    diagnostic.slotId ?? '',
+    diagnostic.message,
+].join('|');
+const unstable_logDiagnostic = (diagnostic) => {
+    console.error(`[${diagnostic.code}] ${diagnostic.message} Remedy: ${diagnostic.remedy}`);
+};
+
+export { unstable_createRendererLayer, unstable_createResolvedSlotTable, unstable_diagnosticKey, unstable_emptyCoreRendererSlots, unstable_isKnownSlot, unstable_logDiagnostic, unstable_resolveLibraryInput, unstable_resolveSlot, unstable_sameLibraryReferences, unstable_validateUiLibrary };
+//# sourceMappingURL=resolve.js.map

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

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

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

@@ -0,0 +1,52 @@
+import type { ComponentType } from 'react';
+/**
+ * Open renderer slot table. Core declarations are attached by the renderer barrel at the subpath
+ * boundary so the setup-only package root can name `unstable_UiLibrary` without resolving
+ * every component contract and optional peer. Adapters may declaration-merge private slots here.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export interface unstable_CratisSlots extends Record<never, never> {
+}
+/**
+ * Identifier of a declared renderer slot.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export type unstable_SlotId = keyof unstable_CratisSlots;
+/**
+ * Ownership mode for a renderer slot. Presentation mode preserves Core behavior; atomic mode gives
+ * the adapter ownership of the complete interaction.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export type unstable_BehaviorMode = 'presentation' | 'atomic';
+/**
+ * Fidelity with which an adapter implements a slot.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export type unstable_Fidelity = 'native' | 'emulated' | 'unsupported';
+/**
+ * One typed renderer implementation and its behavior/fidelity declaration.
+ *
+ * @typeParam K Slot implemented by the declaration.
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export interface unstable_SlotDeclaration<K extends unstable_SlotId> {
+    /** Which layer owns the slot's interaction behavior. */
+    readonly mode: unstable_BehaviorMode;
+    /** How faithfully the adapter satisfies the Core slot contract. */
+    readonly fidelity: unstable_Fidelity;
+    /** React component implementing the slot's exact public props. */
+    readonly render: ComponentType<unstable_CratisSlots[K]>;
+}
+/**
+ * Partial renderer slot table. A library may implement only the slots it honestly supports.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export type unstable_SlotMap = {
+    readonly [K in unstable_SlotId]?: unstable_SlotDeclaration<K>;
+};
+//# sourceMappingURL=slots.d.ts.map

package/dist/esm/renderer/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../renderer/slots.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;;;GAMG;AAIH,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;CAAG;AAErE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,oBAAoB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,eAAe;IAC/D,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3D;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,EAAE,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC;CAChE,CAAC"}

package/dist/esm/renderer/slots.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=slots.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../../renderer/slots.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/esm/schemas/ui-adapter.schema.d.ts

@@ -0,0 +1,7 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** JSON Schema document describing a Cratis renderer adapter package manifest. */
+declare const schema: unknown;
+
+export default schema;

package/dist/esm/schemas/ui-adapter.schema.json

@@ -0,0 +1,210 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://cratis.io/schemas/ui-adapter.schema.json",
+    "title": "Cratis UI adapter package metadata",
+    "description": "Static package.json `cratis` metadata for a Cratis UI adapter.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "kind",
+        "id",
+        "displayName",
+        "abi",
+        "level",
+        "profile",
+        "category",
+        "entry",
+        "export",
+        "slots",
+        "modes",
+        "capabilities",
+        "ssr",
+        "a11y",
+        "license",
+        "upstream"
+    ],
+    "properties": {
+        "kind": {
+            "const": "ui-adapter"
+        },
+        "id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$"
+        },
+        "displayName": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+        },
+        "abi": {
+            "type": "string",
+            "pattern": "^\\^[1-9][0-9]{0,2}$"
+        },
+        "level": {
+            "enum": ["full", "primitive", "behavior", "portal", "theme"]
+        },
+        "profile": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[a-z][a-z0-9.-]*/v[1-9][0-9]{0,2}$"
+        },
+        "category": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        },
+        "entry": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 256,
+            "pattern": "^\\./(?!.*(?:^|/)\\.\\.(?:/|$))[^\\s]+$"
+        },
+        "export": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[A-Za-z_$][A-Za-z0-9_$]*$"
+        },
+        "slots": {
+            "type": "array",
+            "maxItems": 256,
+            "uniqueItems": true,
+            "items": {
+                "$ref": "#/$defs/slotId"
+            }
+        },
+        "modes": {
+            "type": "object",
+            "maxProperties": 256,
+            "propertyNames": {
+                "$ref": "#/$defs/slotId"
+            },
+            "additionalProperties": {
+                "enum": ["presentation", "atomic"]
+            }
+        },
+        "capabilities": {
+            "type": "array",
+            "maxItems": 16,
+            "uniqueItems": true,
+            "items": {
+                "enum": [
+                    "slot.render",
+                    "parts.passthrough",
+                    "focus.trap",
+                    "focus.restore",
+                    "overlay.portal",
+                    "collection.virtualize",
+                    "selection.multi",
+                    "datetime.i18n",
+                    "form.validationMessage",
+                    "theme.tokens",
+                    "ssr.staticRender",
+                    "rtl",
+                    "forcedColors",
+                    "motion.reduced",
+                    "machine.binding",
+                    "paging.server"
+                ]
+            }
+        },
+        "ssr": {
+            "enum": ["safe", "client-only", "hydration-risk"]
+        },
+        "a11y": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["axeProfile", "evidence"],
+            "properties": {
+                "axeProfile": {
+                    "enum": ["wcag21a", "wcag21aa", "wcag22a", "wcag22aa"]
+                },
+                "evidence": {
+                    "type": "string",
+                    "minLength": 3,
+                    "maxLength": 256,
+                    "pattern": "^\\./(?!.*(?:^|/)\\.\\.(?:/|$))[^\\s]+$"
+                }
+            }
+        },
+        "license": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["spdx", "requiresKey"],
+            "properties": {
+                "spdx": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128
+                },
+                "requiresKey": {
+                    "type": "boolean"
+                },
+                "keyEnv": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Z][A-Z0-9_]*$"
+                },
+                "url": {
+                    "type": "string",
+                    "minLength": 8,
+                    "maxLength": 2048,
+                    "pattern": "^https://[^\\s]+$"
+                }
+            },
+            "allOf": [
+                {
+                    "if": {
+                        "properties": {
+                            "requiresKey": {
+                                "const": true
+                            }
+                        },
+                        "required": ["requiresKey"]
+                    },
+                    "then": {
+                        "required": ["keyEnv"]
+                    }
+                }
+            ]
+        },
+        "upstream": {
+            "type": "object",
+            "minProperties": 1,
+            "maxProperties": 32,
+            "propertyNames": {
+                "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
+            },
+            "additionalProperties": {
+                "$ref": "#/$defs/boundedSemverRange"
+            }
+        }
+    },
+    "$defs": {
+        "slotId": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 128,
+            "pattern": "^[a-z][a-zA-Z0-9]*(?:[.-][a-zA-Z0-9]+)+$"
+        },
+        "boundedSemverRange": {
+            "type": "string",
+            "oneOf": [
+                {
+                    "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?$"
+                },
+                {
+                    "pattern": "^[~^][0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?$"
+                },
+                {
+                    "pattern": "^>=[0-9]+(?:\\.[0-9]+){0,2}(?:-[0-9A-Za-z.-]+)? <[0-9]+(?:\\.[0-9]+){0,2}(?:-[0-9A-Za-z.-]+)?$"
+                }
+            ]
+        }
+    }
+}