@cratis/components 3.6.1 → 4.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../renderer/builtin/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAGH,KAAK,kBAAkB,EAC1B,MAAM,gBAAgB,CAAC;AAoCxB;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,kBAU/B,CAAC"}

package/dist/esm/renderer/builtin/index.js

@@ -0,0 +1,47 @@
+import { unstable_coreSlots } from '../coreSlots.js';
+import { unstable_defineUiLibrary, unstable_CRATIS_UI_ABI_VERSION } from '../manifest.js';
+
+const profileSlots = Object.freeze([
+    '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 capabilities = Object.freeze([
+    'slot.render',
+    'parts.passthrough',
+    'focus.trap',
+    'focus.restore',
+    'overlay.portal',
+    'selection.multi',
+    'datetime.i18n',
+    'form.validationMessage',
+    'theme.tokens',
+    'ssr.staticRender',
+    'rtl',
+    'forcedColors',
+    'motion.reduced',
+]);
+const unstable_cratisBuiltIn = unstable_defineUiLibrary({
+    id: 'cratis-built-in',
+    displayName: 'Cratis built-in renderer',
+    abi: unstable_CRATIS_UI_ABI_VERSION,
+    level: 'full',
+    profile: 'core/v1',
+    profileSlots,
+    capabilities,
+    slots: unstable_coreSlots,
+});
+
+export { unstable_cratisBuiltIn };
+//# sourceMappingURL=index.js.map

package/dist/esm/renderer/builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../renderer/builtin/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAYA,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,eAAe;IACf,mBAAmB;IACnB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,oBAAoB;IACpB,sBAAsB;AACY,CAAA,CAAC;AAEvC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,aAAa;IACb,mBAAmB;IACnB,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,wBAAwB;IACxB,cAAc;IACd,kBAAkB;IAClB,KAAK;IACL,cAAc;IACd,gBAAgB;AACwB,CAAA,CAAC;AAWtC,MAAM,sBAAsB,GAC/B,wBAAwB,CAAC;AACrB,IAAA,EAAE,EAAE,iBAAiB;AACrB,IAAA,WAAW,EAAE,0BAA0B;AACvC,IAAA,GAAG,EAAE,8BAA8B;AACnC,IAAA,KAAK,EAAE,MAAM;AACb,IAAA,OAAO,EAAE,SAAS;IAClB,YAAY;IACZ,YAAY;AACZ,IAAA,KAAK,EAAE,kBAAkB;AAC5B,CAAA;;"}

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

@@ -0,0 +1,8 @@
+/**
+ * Capability identifiers understood by the renderer ABI. Consumers branch on capabilities, never
+ * on a renderer's identity.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export type unstable_CapabilityId = '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';
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../renderer/capabilities.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAC3B,aAAa,GACb,mBAAmB,GACnB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,uBAAuB,GACvB,iBAAiB,GACjB,eAAe,GACf,wBAAwB,GACxB,cAAc,GACd,kBAAkB,GAClB,KAAK,GACL,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,CAAC"}

package/dist/esm/renderer/capabilities.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=capabilities.js.map

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

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

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

@@ -0,0 +1,80 @@
+import type { ComponentType } from 'react';
+import type { unstable_BehaviorMode } from './slots.js';
+/**
+ * Complete Core slot inventory for renderer ABI proof and conformance tests only.
+ *
+ * Every facade owns its local Core declaration, so neither the setup-only provider nor the public
+ * renderer barrel may import this private all-family table.
+ */
+export declare const unstable_coreSlots: Readonly<{
+    'common.button': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+    }>;
+    'common.iconButton': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").IconButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+    }>;
+    'common.textInput': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").TextInputProps & import("react").RefAttributes<HTMLInputElement>>;
+    }>;
+    'common.textArea': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").TextAreaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+    }>;
+    'common.checkbox': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;
+    }>;
+    'common.radio': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").RadioProps & import("react").RefAttributes<HTMLInputElement>>;
+    }>;
+    'common.switch': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").SwitchProps & import("react").RefAttributes<HTMLInputElement>>;
+    }>;
+    'common.progress': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Display/index.js").ProgressBarProps>;
+    }>;
+    'common.surface': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").SurfaceProps & import("react").RefAttributes<HTMLElement>>;
+    }>;
+    'common.tooltip': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").TooltipProps>;
+    }>;
+    'dropdown.select': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Dropdown/index.js").DropdownProps<unknown>>;
+    }>;
+    'dialogs.dialog': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Dialogs/index.js").DialogProps>;
+    }>;
+    'display.datePicker': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../Common/index.js").DatePickerInputProps>;
+    }>;
+    'datatables.paginator': Readonly<{
+        mode: unstable_BehaviorMode;
+        fidelity: "native";
+        render: ComponentType<import("../DataTables/index.js").TablePaginatorProps>;
+    }>;
+}>;

package/dist/esm/renderer/coreSlots.js

@@ -0,0 +1,35 @@
+import { ButtonImplementation } from '../Common/ButtonImplementation.js';
+import { CheckboxImplementation } from '../Common/CheckboxImplementation.js';
+import { DatePickerInputImplementation } from '../Common/DatePickerInputImplementation.js';
+import { IconButtonImplementation } from '../Common/IconButtonImplementation.js';
+import { RadioImplementation } from '../Common/RadioImplementation.js';
+import { SurfaceImplementation } from '../Common/SurfaceImplementation.js';
+import { SwitchImplementation } from '../Common/SwitchImplementation.js';
+import { TextAreaImplementation } from '../Common/TextAreaImplementation.js';
+import { TextInputImplementation } from '../Common/TextInputImplementation.js';
+import { TooltipImplementation } from '../Common/TooltipImplementation.js';
+import { TablePaginatorImplementation } from '../DataTables/TablePaginatorImplementation.js';
+import { ProgressBarImplementation } from '../Display/ProgressBarImplementation.js';
+import { DialogImplementation } from '../Dialogs/DialogImplementation.js';
+import { DropdownImplementation } from '../Dropdown/DropdownImplementation.js';
+
+const nativeDeclaration = (mode, render) => Object.freeze({ mode, fidelity: 'native', render });
+const unstable_coreSlots = Object.freeze({
+    'common.button': nativeDeclaration('presentation', ButtonImplementation),
+    'common.iconButton': nativeDeclaration('presentation', IconButtonImplementation),
+    'common.textInput': nativeDeclaration('presentation', TextInputImplementation),
+    'common.textArea': nativeDeclaration('presentation', TextAreaImplementation),
+    'common.checkbox': nativeDeclaration('presentation', CheckboxImplementation),
+    'common.radio': nativeDeclaration('presentation', RadioImplementation),
+    'common.switch': nativeDeclaration('presentation', SwitchImplementation),
+    'common.progress': nativeDeclaration('presentation', ProgressBarImplementation),
+    'common.surface': nativeDeclaration('presentation', SurfaceImplementation),
+    'common.tooltip': nativeDeclaration('atomic', TooltipImplementation),
+    'dropdown.select': nativeDeclaration('atomic', DropdownImplementation),
+    'dialogs.dialog': nativeDeclaration('atomic', DialogImplementation),
+    'display.datePicker': nativeDeclaration('atomic', DatePickerInputImplementation),
+    'datatables.paginator': nativeDeclaration('atomic', TablePaginatorImplementation),
+});
+
+export { unstable_coreSlots };
+//# sourceMappingURL=coreSlots.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreSlots.js","sources":["../../../renderer/coreSlots.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;AAuBA,MAAM,iBAAiB,GAAG,CACtB,IAA2B,EAC3B,MAA4B,KAC3B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAiB,EAAE,MAAM,EAAE,CAAC;AAQ1D,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;AAC5C,IAAA,eAAe,EAAE,iBAAiB,CAAC,cAAc,EAAE,oBAAoB,CAAC;AACxE,IAAA,mBAAmB,EAAE,iBAAiB,CAClC,cAAc,EACd,wBAAwB,CAC3B;AACD,IAAA,kBAAkB,EAAE,iBAAiB,CAAC,cAAc,EAAE,uBAAuB,CAAC;AAC9E,IAAA,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,sBAAsB,CAAC;AAC5E,IAAA,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,sBAAsB,CAAC;AAC5E,IAAA,cAAc,EAAE,iBAAiB,CAAC,cAAc,EAAE,mBAAmB,CAAC;AACtE,IAAA,eAAe,EAAE,iBAAiB,CAAC,cAAc,EAAE,oBAAoB,CAAC;AACxE,IAAA,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,yBAAyB,CAAC;AAC/E,IAAA,gBAAgB,EAAE,iBAAiB,CAAC,cAAc,EAAE,qBAAqB,CAAC;AAC1E,IAAA,gBAAgB,EAAE,iBAAiB,CAAC,QAAQ,EAAE,qBAAqB,CAAC;AACpE,IAAA,iBAAiB,EAAE,iBAAiB,CAAC,QAAQ,EAAE,sBAAsB,CAAC;AACtE,IAAA,gBAAgB,EAAE,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,CAAC;AACnE,IAAA,oBAAoB,EAAE,iBAAiB,CAAC,QAAQ,EAAE,6BAA6B,CAAC;AAChF,IAAA,sBAAsB,EAAE,iBAAiB,CAAC,QAAQ,EAAE,4BAA4B,CAAC;AACpF,CAAA;;"}

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

@@ -0,0 +1,58 @@
+import type { unstable_SlotId } from './slots.js';
+/**
+ * Stable diagnostic codes reserved by the unstable renderer ABI.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export declare const unstable_adapterErrorCodes: Readonly<{
+    readonly abiMismatch: "CRATIS-UI-1001";
+    readonly missingRequirement: "CRATIS-UI-1002";
+    readonly strictProfileFallback: "CRATIS-UI-1003";
+    readonly missingUpstreamPeer: "CRATIS-UI-1004";
+    readonly missingLicenseKey: "CRATIS-UI-1005";
+    readonly nestedLibraries: "CRATIS-UI-1006";
+    readonly ssrContractViolation: "CRATIS-UI-1007";
+    readonly duplicateResolution: "CRATIS-UI-1008";
+    readonly deprecatedSlot: "CRATIS-UI-1009";
+}>;
+/**
+ * Renderer diagnostic code from `CRATIS-UI-1001` through `CRATIS-UI-1009`.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export type unstable_AdapterErrorCode = (typeof unstable_adapterErrorCodes)[keyof typeof unstable_adapterErrorCodes];
+/**
+ * Actionable renderer diagnostic. A diagnostic carries exactly one remedy so failures cannot leave
+ * consumers choosing between conflicting recovery instructions.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export interface unstable_AdapterDiagnostic {
+    /** Core-owned diagnostic code. */
+    readonly code: unstable_AdapterErrorCode;
+    /** Adapter that produced or caused the diagnostic. */
+    readonly adapterId: string;
+    /** Affected slot when the diagnostic is slot-specific. */
+    readonly slotId?: unstable_SlotId;
+    /** Human-readable explanation of the failure or degradation. */
+    readonly message: string;
+    /** The single action a consumer should take to remedy the diagnostic. */
+    readonly remedy: string;
+}
+/**
+ * Typed failure raised when a renderer contract cannot be honored.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export declare class unstable_AdapterError extends Error {
+    /** Stable diagnostic that caused the failure. */
+    readonly diagnostic: unstable_AdapterDiagnostic;
+    /** Stable diagnostic code, repeated for convenient error-boundary inspection. */
+    readonly code: unstable_AdapterErrorCode;
+    /**
+     * Initializes a renderer contract failure.
+     *
+     * @param diagnostic Actionable renderer diagnostic.
+     */
+    constructor(diagnostic: unstable_AdapterDiagnostic);
+}

package/dist/esm/renderer/errors.js

@@ -0,0 +1,24 @@
+const unstable_adapterErrorCodes = Object.freeze({
+    abiMismatch: 'CRATIS-UI-1001',
+    missingRequirement: 'CRATIS-UI-1002',
+    strictProfileFallback: 'CRATIS-UI-1003',
+    missingUpstreamPeer: 'CRATIS-UI-1004',
+    missingLicenseKey: 'CRATIS-UI-1005',
+    nestedLibraries: 'CRATIS-UI-1006',
+    ssrContractViolation: 'CRATIS-UI-1007',
+    duplicateResolution: 'CRATIS-UI-1008',
+    deprecatedSlot: 'CRATIS-UI-1009',
+});
+class unstable_AdapterError extends Error {
+    diagnostic;
+    code;
+    constructor(diagnostic) {
+        super(`[${diagnostic.code}] ${diagnostic.message} Remedy: ${diagnostic.remedy}`);
+        this.name = 'unstable_AdapterError';
+        this.diagnostic = diagnostic;
+        this.code = diagnostic.code;
+    }
+}
+
+export { unstable_AdapterError, unstable_adapterErrorCodes };
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../../../renderer/errors.ts"],"sourcesContent":[null],"names":[],"mappings":"AAUO,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;AACpD,IAAA,WAAW,EAAE,gBAAgB;AAC7B,IAAA,kBAAkB,EAAE,gBAAgB;AACpC,IAAA,qBAAqB,EAAE,gBAAgB;AACvC,IAAA,mBAAmB,EAAE,gBAAgB;AACrC,IAAA,iBAAiB,EAAE,gBAAgB;AACnC,IAAA,eAAe,EAAE,gBAAgB;AACjC,IAAA,oBAAoB,EAAE,gBAAgB;AACtC,IAAA,mBAAmB,EAAE,gBAAgB;AACrC,IAAA,cAAc,EAAE,gBAAgB;AAC1B,CAAA;AAkCJ,MAAO,qBAAsB,SAAQ,KAAK,CAAA;AAEnC,IAAA,UAAU;AAGV,IAAA,IAAI;AAOb,IAAA,WAAA,CAAY,UAAsC,EAAA;AAC9C,QAAA,KAAK,CAAC,CAAA,CAAA,EAAI,UAAU,CAAC,IAAI,CAAA,EAAA,EAAK,UAAU,CAAC,OAAO,YAAY,UAAU,CAAC,MAAM,CAAA,CAAE,CAAC;AAChF,QAAA,IAAI,CAAC,IAAI,GAAG,uBAAuB;AACnC,QAAA,IAAI,CAAC,UAAU,GAAG,UAAU;AAC5B,QAAA,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI;IAC/B;AACH;;"}

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

@@ -0,0 +1,60 @@
+import type { ButtonProps } from '../Common/Button.js';
+import type { CheckboxProps } from '../Common/Checkbox.js';
+import type { DatePickerInputProps } from '../Common/DatePickerInput.js';
+import type { IconButtonProps } from '../Common/IconButton.js';
+import type { RadioProps } from '../Common/Radio.js';
+import type { SurfaceProps } from '../Common/Surface.js';
+import type { SwitchProps } from '../Common/Switch.js';
+import type { TextAreaProps } from '../Common/TextArea.js';
+import type { TextInputProps } from '../Common/TextInput.js';
+import type { TooltipProps } from '../Common/Tooltip.js';
+import type { TablePaginatorProps } from '../DataTables/TablePaginator.js';
+import type { ProgressBarProps } from '../Display/ProgressBar.js';
+import type { DialogProps } from '../Dialogs/Dialog.js';
+import type { DropdownProps } from '../Dropdown/Dropdown.js';
+/** Core-owned slot contracts loaded only by the renderer subpath. */
+declare module './slots.js' {
+    interface unstable_CratisSlots {
+        /** Cratis button presentation contract. */
+        'common.button': ButtonProps;
+        /** Cratis icon-button presentation contract. */
+        'common.iconButton': IconButtonProps;
+        /** Native text-input presentation contract. */
+        'common.textInput': TextInputProps;
+        /** Native text-area presentation contract. */
+        'common.textArea': TextAreaProps;
+        /** Native checkbox presentation contract. */
+        'common.checkbox': CheckboxProps;
+        /** Native radio-option presentation contract. */
+        'common.radio': RadioProps;
+        /** Native switch presentation contract. */
+        'common.switch': SwitchProps;
+        /** Progress-bar presentation contract. */
+        'common.progress': ProgressBarProps;
+        /** Semantic surface presentation contract. */
+        'common.surface': SurfaceProps;
+        /** Interaction-heavy tooltip contract. */
+        'common.tooltip': TooltipProps;
+        /** Interaction-heavy select/dropdown contract. */
+        'dropdown.select': DropdownProps<unknown>;
+        /** Interaction-heavy modal dialog contract. */
+        'dialogs.dialog': DialogProps;
+        /** Interaction-heavy date-picker contract. */
+        'display.datePicker': DatePickerInputProps;
+        /** Interaction-heavy, composite-adjacent table paginator contract. */
+        'datatables.paginator': TablePaginatorProps;
+    }
+}
+/**
+ * Renderer contracts for adapter authors. The bounded nine-slot presentation profile is stable;
+ * every broader renderer-system symbol remains `unstable_`-prefixed. E1 presentation and E2 atomic
+ * routing are facade-local; lazy/preload entries remain deferred.
+ */
+export type { unstable_CapabilityId } from './capabilities.js';
+export { unstable_AdapterError, unstable_adapterErrorCodes, type unstable_AdapterDiagnostic, type unstable_AdapterErrorCode, } from './errors.js';
+export { unstable_CRATIS_UI_ABI_VERSION, unstable_composeUiLibraries, unstable_defineUiLibrary, type CratisPresentationUiLibraryProviderProps, type CratisRendererSetup, type CratisRendererSetupExtensions, type unstable_RendererSetup, type unstable_RendererSetupExtensions, type unstable_UiLibrary, type unstable_UiLibraryProviderProps, } from './manifest.js';
+export { unstable_defaultOverlayEnvironment, type CratisOverlayEnvironment, type unstable_CratisOverlayEnvironment, } from './overlayEnvironment.js';
+export { CRATIS_PRESENTATION_ABI_VERSION, CRATIS_PRESENTATION_PROFILE, cratisPresentationSlotIds, definePresentationUiLibrary, type CratisPresentationCapabilities, type CratisPresentationCapabilityId, type CratisPresentationSlotDeclaration, type CratisPresentationSlotId, type CratisPresentationSlotMap, type CratisPresentationSlots, type CratisPresentationUiLibrary, } from './presentation.js';
+export { unstable_useCapability, unstable_useOverlayEnvironment, unstable_useRendererId, } from './RendererContext.js';
+export { unstable_RendererScope, type unstable_RendererScopeProps, } from './RendererScope.js';
+export type { unstable_BehaviorMode, unstable_CratisSlots, unstable_Fidelity, unstable_SlotDeclaration, unstable_SlotId, unstable_SlotMap, } from './slots.js';

package/dist/esm/renderer/index.js

@@ -0,0 +1,7 @@
+export { unstable_AdapterError, unstable_adapterErrorCodes } from './errors.js';
+export { unstable_CRATIS_UI_ABI_VERSION, unstable_composeUiLibraries, unstable_defineUiLibrary } from './manifest.js';
+export { unstable_defaultOverlayEnvironment } from './overlayEnvironment.js';
+export { CRATIS_PRESENTATION_ABI_VERSION, CRATIS_PRESENTATION_PROFILE, cratisPresentationSlotIds, definePresentationUiLibrary } from './presentation.js';
+export { unstable_useCapability, unstable_useOverlayEnvironment, unstable_useRendererId } from './RendererContext.js';
+export { unstable_RendererScope } from './RendererScope.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/{Styled → renderer}/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/manifest.d.ts

@@ -0,0 +1,97 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { unstable_CapabilityId } from './capabilities.js';
+import type { unstable_AdapterDiagnostic } from './errors.js';
+import type { unstable_SlotId, unstable_SlotMap } from './slots.js';
+/**
+ * Open declaration-merging surface for renderer-specific, non-secret setup attestations.
+ * Adapter packages add boolean keys only; credentials never belong in this interface.
+ */
+export interface CratisRendererSetupExtensions extends Record<never, never> {
+}
+/**
+ * Compatibility declaration-merging surface for renderer setup attestations.
+ *
+ * @deprecated Merge new adapter keys into {@link CratisRendererSetupExtensions}.
+ */
+export interface unstable_RendererSetupExtensions extends CratisRendererSetupExtensions {
+}
+/** Non-secret application setup attestations supplied to a renderer provider. */
+export type CratisRendererSetup = Readonly<{
+    [Key in keyof CratisRendererSetupExtensions | keyof unstable_RendererSetupExtensions]?: boolean;
+}>;
+/**
+ * Compatibility alias for {@link CratisRendererSetup}.
+ *
+ * @deprecated Use {@link CratisRendererSetup}.
+ */
+export type unstable_RendererSetup = CratisRendererSetup;
+/** Props supplied to a stable presentation renderer library provider. */
+export interface CratisPresentationUiLibraryProviderProps {
+    /** Non-secret application setup attestations. Never credentials or license tokens. */
+    readonly setup: CratisRendererSetup;
+    /** Application content. */
+    readonly children: ReactNode;
+}
+/**
+ * Compatibility alias for {@link CratisPresentationUiLibraryProviderProps}.
+ *
+ * @deprecated Use {@link CratisPresentationUiLibraryProviderProps}.
+ */
+export type unstable_UiLibraryProviderProps = CratisPresentationUiLibraryProviderProps;
+/**
+ * Renderer ABI major implemented by this package.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export declare const unstable_CRATIS_UI_ABI_VERSION = 1;
+/**
+ * Runtime renderer manifest. Manifests are immutable values and are never passed through the
+ * Components configuration deep-merge path.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export interface unstable_UiLibrary {
+    /** Stable, package-local renderer identity used for diagnostics and telemetry. */
+    readonly id: string;
+    /** Human-readable renderer name. */
+    readonly displayName: string;
+    /** Renderer ABI major implemented by this library. */
+    readonly abi: number;
+    /** Breadth and ownership level offered by the library. */
+    readonly level: 'full' | 'primitive' | 'behavior' | 'portal' | 'theme';
+    /** Named contract profile promised by the library. */
+    readonly profile: string;
+    /**
+     * Slots promised by the named profile. When omitted, the library promises its own slot keys.
+     */
+    readonly profileSlots?: readonly unstable_SlotId[];
+    /** Core-owned capabilities honestly supported by the library. */
+    readonly capabilities: readonly unstable_CapabilityId[];
+    /** Typed partial slot implementation table. */
+    readonly slots: unstable_SlotMap;
+    /** Optional library-level provider mounted once around the selected renderer scope. */
+    readonly Provider?: ComponentType<CratisPresentationUiLibraryProviderProps>;
+    /** Optional static diagnostic preflight evaluated by renderer providers and scopes. */
+    readonly preflight?: () => readonly unstable_AdapterDiagnostic[];
+}
+/**
+ * Defines a renderer library while preserving its inferred literal type. The helper is
+ * side-effect-free and defensively copies/freezes mutable manifest containers; component and
+ * callback references remain untouched.
+ *
+ * @param library Renderer library to define.
+ * @returns A frozen defensive copy with the same inferred public type.
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export declare const unstable_defineUiLibrary: <const T extends unstable_UiLibrary>(library: T) => T;
+/**
+ * Composes one or more renderer libraries. Slot declarations and metadata use last-library-wins
+ * semantics; capabilities are de-duplicated in first-seen order for deterministic diagnostics.
+ * The result is defensively copied and frozen through {@link unstable_defineUiLibrary}.
+ *
+ * @param libraries Libraries in increasing precedence order.
+ * @returns One frozen renderer library containing the union of capabilities and slots.
+ * @throws {RangeError} When no libraries are supplied.
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export declare const unstable_composeUiLibraries: (...libraries: readonly unstable_UiLibrary[]) => unstable_UiLibrary;

package/dist/esm/renderer/manifest.js

@@ -0,0 +1,36 @@
+const unstable_CRATIS_UI_ABI_VERSION = 1;
+const frozenSlots = (slots) => {
+    const copy = {};
+    for (const [slotId, declaration] of Object.entries(slots)) {
+        if (declaration)
+            copy[slotId] = Object.freeze({ ...declaration });
+    }
+    return Object.freeze(copy);
+};
+const unstable_defineUiLibrary = (library) => Object.freeze({
+    ...library,
+    capabilities: Object.freeze([...library.capabilities]),
+    profileSlots: Object.freeze([
+        ...(library.profileSlots ?? Object.keys(library.slots)),
+    ]),
+    slots: frozenSlots(library.slots),
+});
+const unstable_composeUiLibraries = (...libraries) => {
+    if (libraries.length === 0) {
+        throw new RangeError('At least one UI library is required for composition.');
+    }
+    const last = libraries[libraries.length - 1];
+    const capabilities = [
+        ...new Set(libraries.flatMap((library) => library.capabilities)),
+    ];
+    const slots = Object.assign({}, ...libraries.map((library) => library.slots));
+    return unstable_defineUiLibrary({
+        ...last,
+        capabilities,
+        profileSlots: last.profileSlots ?? Object.keys(slots),
+        slots,
+    });
+};
+
+export { unstable_CRATIS_UI_ABI_VERSION, unstable_composeUiLibraries, unstable_defineUiLibrary };
+//# sourceMappingURL=manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sources":["../../../renderer/manifest.ts"],"sourcesContent":[null],"names":[],"mappings":"AA6DO,MAAM,8BAA8B,GAAG;AAiC9C,MAAM,WAAW,GAAG,CAAC,KAAuB,KAAsB;IAC9D,MAAM,IAAI,GAA2B,EAAE;AACvC,IAAA,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACvD,QAAA,IAAI,WAAW;AAAE,YAAA,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,WAAW,EAAE,CAAC;IACrE;AACA,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAqB;AAClD,CAAC;AAWM,MAAM,wBAAwB,GAAG,CACpC,OAAU,KAEV,MAAM,CAAC,MAAM,CAAC;AACV,IAAA,GAAG,OAAO;IACV,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AACtD,IAAA,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;AACxB,QAAA,IAAI,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;KAC1D,CAAC;AACF,IAAA,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;AACpC,CAAA;MAYQ,2BAA2B,GAAG,CACvC,GAAG,SAAwC,KACvB;AACpB,IAAA,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;AACxB,QAAA,MAAM,IAAI,UAAU,CAAC,sDAAsD,CAAC;IAChF;IAEA,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5C,IAAA,MAAM,YAAY,GAAG;AACjB,QAAA,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;KACnE;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;AAE7E,IAAA,OAAO,wBAAwB,CAAC;AAC5B,QAAA,GAAG,IAAI;QACP,YAAY;QACZ,YAAY,EAAE,IAAI,CAAC,YAAY,IAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAuB;QAC5E,KAAK;AACR,KAAA,CAAC;AACN;;"}

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

@@ -0,0 +1,23 @@
+/**
+ * Host environment used by overlay implementations to obtain their portal container.
+ * `null` means no container is currently available; callers must defer rather than retarget.
+ *
+ */
+export interface CratisOverlayEnvironment {
+    /** Resolves the current overlay container without requiring browser globals during import. */
+    getContainer(): HTMLElement | null;
+}
+/**
+ * Compatibility alias for {@link CratisOverlayEnvironment}.
+ *
+ * @deprecated Use {@link CratisOverlayEnvironment}.
+ */
+export type unstable_CratisOverlayEnvironment = CratisOverlayEnvironment;
+/**
+ * Default browser overlay environment. The module is SSR-safe: `document` is inspected only when
+ * `getContainer()` is invoked, never while this module is initialized.
+ *
+ * @unstable Adapter-author contract. Expect changes until renderer conformance gates promote it.
+ */
+export declare const unstable_defaultOverlayEnvironment: unstable_CratisOverlayEnvironment;
+//# sourceMappingURL=overlayEnvironment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlayEnvironment.d.ts","sourceRoot":"","sources":["../../../renderer/overlayEnvironment.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC,8FAA8F;IAC9F,YAAY,IAAI,WAAW,GAAG,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG,wBAAwB,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,EAAE,iCAI3C,CAAC"}

package/dist/esm/renderer/overlayEnvironment.js

@@ -0,0 +1,6 @@
+const unstable_defaultOverlayEnvironment = Object.freeze({
+    getContainer: () => typeof document === 'undefined' ? null : document.body,
+});
+
+export { unstable_defaultOverlayEnvironment };
+//# sourceMappingURL=overlayEnvironment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlayEnvironment.js","sources":["../../../renderer/overlayEnvironment.ts"],"sourcesContent":[null],"names":[],"mappings":"AA0BO,MAAM,kCAAkC,GAC3C,MAAM,CAAC,MAAM,CAAC;AACV,IAAA,YAAY,EAAE,MACV,OAAO,QAAQ,KAAK,WAAW,GAAG,IAAI,GAAG,QAAQ,CAAC,IAAI;AAC7D,CAAA;;"}

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

@@ -0,0 +1,93 @@
+import type { ComponentType } from 'react';
+import type { ButtonProps } from '../Common/Button.js';
+import type { CheckboxProps } from '../Common/Checkbox.js';
+import type { IconButtonProps } from '../Common/IconButton.js';
+import type { RadioProps } from '../Common/Radio.js';
+import type { SurfaceProps } from '../Common/Surface.js';
+import type { SwitchProps } from '../Common/Switch.js';
+import type { TextAreaProps } from '../Common/TextArea.js';
+import type { TextInputProps } from '../Common/TextInput.js';
+import type { ProgressBarProps } from '../Display/ProgressBar.js';
+import type { CratisPresentationUiLibraryProviderProps } from './manifest.js';
+/** Stable renderer profile implemented by certified presentation adapters. */
+export declare const CRATIS_PRESENTATION_PROFILE: "stable-presentation/v1";
+/** Renderer ABI major for the stable presentation profile. */
+export declare const CRATIS_PRESENTATION_ABI_VERSION: 1;
+/** Immutable, canonical slot order for the stable presentation profile. */
+export declare const cratisPresentationSlotIds: readonly ["common.button", "common.iconButton", "common.textInput", "common.textArea", "common.checkbox", "common.radio", "common.switch", "common.progress", "common.surface"];
+/** Identifier of one stable presentation slot. */
+export type CratisPresentationSlotId = (typeof cratisPresentationSlotIds)[number];
+/** Exact public component prop and ref contracts covered by the stable presentation profile. */
+export interface CratisPresentationSlots {
+    /** Cratis button presentation contract, including native button refs and form behavior. */
+    readonly 'common.button': ButtonProps;
+    /** Accessible icon-only button contract with native button ownership. */
+    readonly 'common.iconButton': IconButtonProps;
+    /** Native text-input contract with semantic value-first change events. */
+    readonly 'common.textInput': TextInputProps;
+    /** Native multiline text-input contract with semantic value-first change events. */
+    readonly 'common.textArea': TextAreaProps;
+    /** Native checkbox contract with checked state, form participation, and input refs. */
+    readonly 'common.checkbox': CheckboxProps;
+    /** Native radio-option contract with selection state, form participation, and input refs. */
+    readonly 'common.radio': RadioProps;
+    /** Boolean switch contract preserving switch semantics and input ownership. */
+    readonly 'common.switch': SwitchProps;
+    /** Determinate or indeterminate progress presentation contract. */
+    readonly 'common.progress': ProgressBarProps;
+    /** Non-interactive semantic surface and native-element presentation contract. */
+    readonly 'common.surface': SurfaceProps;
+}
+/** One stable, presentation-owned renderer slot declaration. */
+export interface CratisPresentationSlotDeclaration<SlotId extends CratisPresentationSlotId> {
+    /** Stable presentation slots always preserve Components behavior ownership. */
+    readonly mode: 'presentation';
+    /** Unsupported declarations cannot claim the stable profile. */
+    readonly fidelity: 'native' | 'emulated';
+    /** Component implementing the slot's exact public props and ref contract. */
+    readonly render: ComponentType<CratisPresentationSlots[SlotId]>;
+}
+/** Complete implementation table required by the stable presentation profile. */
+export type CratisPresentationSlotMap = {
+    readonly [SlotId in CratisPresentationSlotId]: CratisPresentationSlotDeclaration<SlotId>;
+};
+/** Capabilities whose meaning is stable for the bounded presentation profile. */
+export type CratisPresentationCapabilityId = 'slot.render' | 'parts.passthrough' | 'ssr.staticRender' | 'rtl' | 'forcedColors' | 'motion.reduced';
+type CratisPresentationOptionalCapabilityId = Exclude<CratisPresentationCapabilityId, 'slot.render' | 'parts.passthrough' | 'ssr.staticRender'>;
+/** Required presentation capabilities followed by optional stable evidence capabilities. */
+export type CratisPresentationCapabilities = readonly [
+    'slot.render',
+    'parts.passthrough',
+    'ssr.staticRender',
+    ...CratisPresentationOptionalCapabilityId[]
+];
+/** Immutable manifest for one implementation of the stable presentation profile. */
+export interface CratisPresentationUiLibrary {
+    /** Stable, package-local renderer identity used for diagnostics and telemetry. */
+    readonly id: string;
+    /** Human-readable renderer name. */
+    readonly displayName: string;
+    /** Stable presentation renderer ABI major. */
+    readonly abi: typeof CRATIS_PRESENTATION_ABI_VERSION;
+    /** The bounded profile is a primitive presentation adapter. */
+    readonly level: 'primitive';
+    /** Exact stable presentation profile identifier. */
+    readonly profile: typeof CRATIS_PRESENTATION_PROFILE;
+    /** Canonical immutable list of all nine stable slots. */
+    readonly profileSlots: typeof cratisPresentationSlotIds;
+    /** Required presentation capabilities followed by any optional stable capabilities. */
+    readonly capabilities: CratisPresentationCapabilities;
+    /** Complete nine-slot presentation implementation. */
+    readonly slots: CratisPresentationSlotMap;
+    /** Optional provider mounted once around the selected renderer scope. */
+    readonly Provider?: ComponentType<CratisPresentationUiLibraryProviderProps>;
+}
+/**
+ * Defines and freezes a complete implementation of the stable nine-slot presentation profile.
+ * Runtime validation protects JavaScript callers from claiming a profile they do not implement.
+ *
+ * @param library Stable presentation library declaration.
+ * @returns A defensive, deeply frozen manifest copy.
+ */
+export declare const definePresentationUiLibrary: (library: CratisPresentationUiLibrary) => CratisPresentationUiLibrary;
+export {};