@kubuild/schema 0.8.0 → 0.8.2

package/dist/actions.d.cts

@@ -0,0 +1,473 @@
+import { z } from 'zod';
+/**
+ * Action Trigger Types
+ * Events in the DOM or component lifecycle that can trigger an action pipeline.
+ */
+export declare const ActionTriggerTypeSchema: z.ZodEnum<{
+    load: "load";
+    change: "change";
+    blur: "blur";
+    click: "click";
+    focus: "focus";
+    submit: "submit";
+    expire: "expire";
+}>;
+export type ActionTriggerType = z.infer<typeof ActionTriggerTypeSchema>;
+export type ActionTrigger = ActionTriggerType;
+export declare const ActionTriggerSchema: z.ZodEnum<{
+    load: "load";
+    change: "change";
+    blur: "blur";
+    click: "click";
+    focus: "focus";
+    submit: "submit";
+    expire: "expire";
+}>;
+/**
+ * Action Step Types
+ * Discrete operations executed sequentially or conditionally within an action pipeline.
+ */
+export declare const ActionStepTypeSchema: z.ZodEnum<{
+    navigate: "navigate";
+    api_request: "api_request";
+    set_state: "set_state";
+    reset_form: "reset_form";
+    show_toast: "show_toast";
+    open_modal: "open_modal";
+    close_modal: "close_modal";
+    toggle_modal: "toggle_modal";
+    copy_clipboard: "copy_clipboard";
+    custom_event: "custom_event";
+    track_event: "track_event";
+}>;
+export type ActionStepType = z.infer<typeof ActionStepTypeSchema>;
+/**
+ * Condition Operators for branch & conditional step execution.
+ */
+export declare const ConditionOperatorSchema: z.ZodEnum<{
+    contains: "contains";
+    regex: "regex";
+    equals: "equals";
+    not_equals: "not_equals";
+    not_contains: "not_contains";
+    is_truthy: "is_truthy";
+    is_falsy: "is_falsy";
+    gt: "gt";
+    gte: "gte";
+    lt: "lt";
+    lte: "lte";
+}>;
+export type ConditionOperator = z.infer<typeof ConditionOperatorSchema>;
+/**
+ * Action Step Condition Schema
+ * Evaluated before running a step. If condition fails, step is skipped.
+ */
+export declare const ActionStepConditionSchema: z.ZodObject<{
+    field: z.ZodString;
+    operator: z.ZodEnum<{
+        contains: "contains";
+        regex: "regex";
+        equals: "equals";
+        not_equals: "not_equals";
+        not_contains: "not_contains";
+        is_truthy: "is_truthy";
+        is_falsy: "is_falsy";
+        gt: "gt";
+        gte: "gte";
+        lt: "lt";
+        lte: "lte";
+    }>;
+    value: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type ActionStepCondition = z.infer<typeof ActionStepConditionSchema>;
+export declare function isSafeActionUrl(url: string): boolean;
+/**
+ * 1. API Request Step Payload Schema
+ */
+export declare const ApiRequestStepPayloadSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        DELETE: "DELETE";
+        PATCH: "PATCH";
+        HEAD: "HEAD";
+        OPTIONS: "OPTIONS";
+    }>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    body: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown>]>>>;
+    bodyFormat: z.ZodOptional<z.ZodEnum<{
+        raw: "raw";
+        formData: "formData";
+        text: "text";
+        json: "json";
+        "form-data": "form-data";
+        urlencoded: "urlencoded";
+        "url-encoded": "url-encoded";
+    }>>;
+    bodyType: z.ZodOptional<z.ZodEnum<{
+        raw: "raw";
+        formData: "formData";
+        text: "text";
+        json: "json";
+        "form-data": "form-data";
+        urlencoded: "urlencoded";
+        "url-encoded": "url-encoded";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    responseMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type ApiRequestStepPayload = z.infer<typeof ApiRequestStepPayloadSchema>;
+/**
+ * 2. Navigate Step Payload Schema
+ */
+export declare const NavigateStepPayloadSchema: z.ZodObject<{
+    url: z.ZodString;
+    target: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        _self: "_self";
+        _blank: "_blank";
+        _parent: "_parent";
+        _top: "_top";
+    }>>>;
+    replace: z.ZodOptional<z.ZodBoolean>;
+    scroll: z.ZodOptional<z.ZodBoolean>;
+    behavior: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        smooth: "smooth";
+    }>>;
+}, z.core.$strip>;
+export type NavigateStepPayload = z.infer<typeof NavigateStepPayloadSchema>;
+/**
+ * 3. Set State Step Payload Schema
+ */
+export declare const SetStateStepPayloadSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodUnknown;
+    scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        document: "document";
+        local: "local";
+        runtime: "runtime";
+    }>>>;
+}, z.core.$strip>;
+export type SetStateStepPayload = z.infer<typeof SetStateStepPayloadSchema>;
+/**
+ * 4. Reset Form Step Payload Schema
+ */
+export declare const ResetFormStepPayloadSchema: z.ZodObject<{
+    formId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ResetFormStepPayload = z.infer<typeof ResetFormStepPayloadSchema>;
+/**
+ * 5. Show Toast Step Payload Schema
+ */
+export declare const ShowToastStepPayloadSchema: z.ZodObject<{
+    message: z.ZodString;
+    type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warning: "warning";
+        success: "success";
+    }>>>;
+    variant: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warning: "warning";
+        success: "success";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    position: z.ZodOptional<z.ZodEnum<{
+        "top-right": "top-right";
+        "top-left": "top-left";
+        "bottom-right": "bottom-right";
+        "bottom-left": "bottom-left";
+        "top-center": "top-center";
+        "bottom-center": "bottom-center";
+    }>>;
+}, z.core.$strip>;
+export type ShowToastStepPayload = z.infer<typeof ShowToastStepPayloadSchema>;
+/**
+ * 6. Open Modal Step Payload Schema
+ */
+export declare const OpenModalStepPayloadSchema: z.ZodObject<{
+    modalId: z.ZodOptional<z.ZodString>;
+    modalNodeId: z.ZodOptional<z.ZodString>;
+    toggle: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type OpenModalStepPayload = z.infer<typeof OpenModalStepPayloadSchema>;
+/**
+ * 7. Close Modal Step Payload Schema
+ */
+export declare const CloseModalStepPayloadSchema: z.ZodObject<{
+    modalId: z.ZodOptional<z.ZodString>;
+    modalNodeId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CloseModalStepPayload = z.infer<typeof CloseModalStepPayloadSchema>;
+/**
+ * 7b. Toggle Modal Step Payload Schema
+ * Flips a modal/drawer/collapsible between open and closed. The renderer's
+ * `toggle_modal` runner resolves the target from the first non-empty of
+ * `modalId`, `modalNodeId`, `targetNodeId`, `nodeId`.
+ */
+export declare const ToggleModalStepPayloadSchema: z.ZodObject<{
+    modalId: z.ZodOptional<z.ZodString>;
+    modalNodeId: z.ZodOptional<z.ZodString>;
+    targetNodeId: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ToggleModalStepPayload = z.infer<typeof ToggleModalStepPayloadSchema>;
+/**
+ * 8. Copy Clipboard Step Payload Schema
+ */
+export declare const CopyClipboardStepPayloadSchema: z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodUnknown>;
+    notify: z.ZodOptional<z.ZodBoolean>;
+    toastMessage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CopyClipboardStepPayload = z.infer<typeof CopyClipboardStepPayloadSchema>;
+/**
+ * 9. Custom Event Step Payload Schema
+ */
+export declare const CustomEventStepPayloadSchema: z.ZodObject<{
+    eventName: z.ZodString;
+    detail: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    bubbles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    cancelable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type CustomEventStepPayload = z.infer<typeof CustomEventStepPayloadSchema>;
+/**
+ * Dictionary of Step Payload Schemas by Step Type
+ */
+export declare const StepPayloadSchemas: {
+    readonly api_request: z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodDefault<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            DELETE: "DELETE";
+            PATCH: "PATCH";
+            HEAD: "HEAD";
+            OPTIONS: "OPTIONS";
+        }>>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        body: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown>]>>>;
+        bodyFormat: z.ZodOptional<z.ZodEnum<{
+            raw: "raw";
+            formData: "formData";
+            text: "text";
+            json: "json";
+            "form-data": "form-data";
+            urlencoded: "urlencoded";
+            "url-encoded": "url-encoded";
+        }>>;
+        bodyType: z.ZodOptional<z.ZodEnum<{
+            raw: "raw";
+            formData: "formData";
+            text: "text";
+            json: "json";
+            "form-data": "form-data";
+            urlencoded: "urlencoded";
+            "url-encoded": "url-encoded";
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        responseMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    readonly navigate: z.ZodObject<{
+        url: z.ZodString;
+        target: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            _self: "_self";
+            _blank: "_blank";
+            _parent: "_parent";
+            _top: "_top";
+        }>>>;
+        replace: z.ZodOptional<z.ZodBoolean>;
+        scroll: z.ZodOptional<z.ZodBoolean>;
+        behavior: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            smooth: "smooth";
+        }>>;
+    }, z.core.$strip>;
+    readonly set_state: z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodUnknown;
+        scope: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            session: "session";
+            document: "document";
+            local: "local";
+            runtime: "runtime";
+        }>>>;
+    }, z.core.$strip>;
+    readonly reset_form: z.ZodObject<{
+        formId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly show_toast: z.ZodObject<{
+        message: z.ZodString;
+        type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+            success: "success";
+        }>>>;
+        variant: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+            success: "success";
+        }>>;
+        title: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        position: z.ZodOptional<z.ZodEnum<{
+            "top-right": "top-right";
+            "top-left": "top-left";
+            "bottom-right": "bottom-right";
+            "bottom-left": "bottom-left";
+            "top-center": "top-center";
+            "bottom-center": "bottom-center";
+        }>>;
+    }, z.core.$strip>;
+    readonly open_modal: z.ZodObject<{
+        modalId: z.ZodOptional<z.ZodString>;
+        modalNodeId: z.ZodOptional<z.ZodString>;
+        toggle: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly close_modal: z.ZodObject<{
+        modalId: z.ZodOptional<z.ZodString>;
+        modalNodeId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly toggle_modal: z.ZodObject<{
+        modalId: z.ZodOptional<z.ZodString>;
+        modalNodeId: z.ZodOptional<z.ZodString>;
+        targetNodeId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly copy_clipboard: z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodUnknown>;
+        notify: z.ZodOptional<z.ZodBoolean>;
+        toastMessage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly custom_event: z.ZodObject<{
+        eventName: z.ZodString;
+        detail: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        bubbles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        cancelable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+    readonly track_event: z.ZodObject<{
+        eventName: z.ZodString;
+        eventType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            standard: "standard";
+            custom: "custom";
+        }>>>;
+        provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            custom: "custom";
+            meta: "meta";
+            google: "google";
+            gtm: "gtm";
+            tiktok: "tiktok";
+        }>>>;
+        delivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            both: "both";
+            client_only: "client_only";
+            server_only: "server_only";
+        }>>>;
+        eventId: z.ZodOptional<z.ZodString>;
+        params: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        userData: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+};
+/**
+ * Action Step Interface
+ * Recursive definition allowing branching (onSuccess, onError).
+ */
+export interface ActionStep {
+    id: string;
+    type: ActionStepType;
+    label?: string;
+    payload?: Record<string, unknown>;
+    condition?: ActionStepCondition;
+    timeout?: number;
+    continueOnError?: boolean;
+    onSuccess?: ActionStep[];
+    onError?: ActionStep[];
+}
+/**
+ * Action Step Schema
+ * Validates individual steps in an action pipeline, supporting recursive branching.
+ */
+export declare const ActionStepSchema: z.ZodType<ActionStep>;
+/**
+ * Action Pipeline Schema
+ * Defines an event trigger and an ordered sequence of action steps to execute.
+ */
+export declare const ActionPipelineSchema: z.ZodObject<{
+    id: z.ZodString;
+    trigger: z.ZodEnum<{
+        load: "load";
+        change: "change";
+        blur: "blur";
+        click: "click";
+        focus: "focus";
+        submit: "submit";
+        expire: "expire";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    debounceMs: z.ZodOptional<z.ZodNumber>;
+    preventDuplicate: z.ZodOptional<z.ZodBoolean>;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    steps: z.ZodArray<z.ZodType<ActionStep, unknown, z.core.$ZodTypeInternals<ActionStep, unknown>>>;
+}, z.core.$strip>;
+export type ActionPipeline = z.infer<typeof ActionPipelineSchema>;
+/**
+ * Type Guards
+ */
+export declare function isActionTriggerType(value: unknown): value is ActionTriggerType;
+export declare function isActionStepType(value: unknown): value is ActionStepType;
+export declare function isConditionOperator(value: unknown): value is ConditionOperator;
+export declare function isActionStepCondition(value: unknown): value is ActionStepCondition;
+export declare function isActionStep(value: unknown): value is ActionStep;
+export declare function isActionPipeline(value: unknown): value is ActionPipeline;
+/**
+ * Validates a step's payload specifically according to its step type.
+ */
+export declare function validateActionStepPayload(type: ActionStepType, payload: unknown): {
+    success: boolean;
+    data?: unknown;
+    error?: z.ZodError;
+};
+/**
+ * Sanitization Utilities
+ */
+/**
+ * Sanitizes a URL string by checking if it contains dangerous protocols or scripts.
+ * Returns the trimmed URL if safe, or a fallback string (default empty string `""`).
+ */
+export declare function sanitizeActionUrl(url: unknown, fallback?: string): string;
+/**
+ * Sanitizes a general string value against script tags and dangerous HTML/protocols.
+ */
+export declare function sanitizeActionString(value: unknown, fallback?: string): string;
+/**
+ * Recursively sanitizes any arbitrary value (string, object, array, primitive) in an action payload.
+ */
+export declare function sanitizeActionValue(value: unknown): unknown;
+/**
+ * Sanitizes an action step payload object, cleaning dangerous URLs and injection strings recursively.
+ */
+export declare function sanitizeActionPayload(payload: Record<string, unknown> | undefined): Record<string, unknown>;
+/**
+ * Recursively sanitizes an ActionStep, including its payload, condition, onSuccess, and onError branches.
+ */
+export declare function sanitizeActionStep(step: ActionStep): ActionStep;
+/**
+ * Recursively sanitizes an ActionPipeline and all its nested steps.
+ */
+export declare function sanitizeActionPipeline(pipeline: ActionPipeline): ActionPipeline;
+//# sourceMappingURL=actions.d.cts.map

package/dist/actions.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.cts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}

package/dist/breakpoints.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Single source of truth for responsive breakpoints (STORA-541).
+ *
+ * Every consumer that maps a screen width to a `ResponsiveStyles` layer — the editor's
+ * viewport switcher/resizer, the runtime renderer's `@media` output, the preview adapter
+ * and the static code generator — must read these values instead of hard-coding numbers.
+ *
+ * Ranges are disjoint and mirror the editor's per-viewport preview exactly: a viewport's
+ * effective style is `base` merged with *that one* layer (tablet does not cascade into
+ * mobile, desktop does not leak into tablet/mobile).
+ *
+ *   mobile  :        width <  768px
+ *   tablet  : 768 <= width < 1024px
+ *   desktop : 1024 <= width
+ *
+ * 768/1024 were chosen over the older 640/1024 code-generator values because they match
+ * the published docs, the editor's existing width→viewport logic and its default tablet
+ * preview width (768px), so what users see in the editor is what ships.
+ */
+/** Viewport layers that carry breakpoint overrides (`base` applies everywhere). */
+export type BreakpointName = 'desktop' | 'tablet' | 'mobile';
+export interface BreakpointRange {
+    /** Inclusive lower bound in CSS px. */
+    readonly minWidth: number;
+    /** Inclusive upper bound in CSS px, or `null` for unbounded. */
+    readonly maxWidth: number | null;
+}
+export declare const BREAKPOINTS: Readonly<Record<BreakpointName, BreakpointRange>>;
+/** Order used for emitting CSS and iterating layers (widest first). */
+export declare const BREAKPOINT_ORDER: readonly BreakpointName[];
+/** CSS media query (without the `@media` keyword) for each breakpoint layer. */
+export declare const BREAKPOINT_MEDIA_QUERIES: Readonly<Record<BreakpointName, string>>;
+/** Resolve which breakpoint layer applies at a given viewport width in CSS px. */
+export declare function getBreakpointForWidth(width: number): BreakpointName;
+//# sourceMappingURL=breakpoints.d.cts.map

package/dist/breakpoints.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.d.cts","sourceRoot":"","sources":["../src/breakpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAIxE,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAIpD,CAAC;AAUH,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAM5E,CAAC;AAEH,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAInE"}

package/dist/builtin-components.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Canonical list of built-in component type names shipped by `@kubuild/components`'
+ * `createDefaultComponentRegistry()`.
+ *
+ * It lives in `@kubuild/schema` (the bottom of the dependency graph) so that
+ * `@kubuild/core` can use it — e.g. to tell built-in from custom components in
+ * `extractTemplateRequirements` — without depending on `@kubuild/components`, which
+ * would invert the `schema → core → components` direction. `@kubuild/components`
+ * derives its `CoreComponentType` union from this list and a test there asserts the
+ * default registry registers exactly these types, so the two cannot drift apart.
+ *
+ * When adding a built-in component definition, add its type here as well.
+ */
+export declare const BUILTIN_COMPONENT_TYPES: readonly ["page", "section", "container", "columns", "flex", "grid", "heading", "text", "paragraph", "link", "blockquote", "badge", "code-block", "image", "video", "icon", "html-embed", "button", "button-submit", "form", "input", "textarea", "select", "checkbox", "switch", "radio-group", "radio", "radio-item", "file-upload", "collection", "list", "list-item", "table", "table-row", "table-cell", "modal", "drawer", "collapsible", "countdown", "accordion", "accordion-item", "tabs", "tab-panel", "carousel", "rating", "divider", "spacer"];
+export type BuiltinComponentType = (typeof BUILTIN_COMPONENT_TYPES)[number];
+export declare function isBuiltinComponentType(type: unknown): type is BuiltinComponentType;
+//# sourceMappingURL=builtin-components.d.cts.map

package/dist/builtin-components.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-components.d.cts","sourceRoot":"","sources":["../src/builtin-components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,6hBAuD1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,oBAAoB,CAElF"}

package/dist/canonical-props.d.cts

@@ -0,0 +1,39 @@
+/**
+ * Canonical prop names for text-bearing components (STORA-550).
+ *
+ * Historically the renderer accepted several names for the same visible text
+ * (`text` / `content`, `text` / `label`, `quote` / `text`, ...). Each component now has
+ * exactly one canonical name; the others are deprecated aliases that
+ * - the `1.1.0 -> 1.2.0` document migration moves onto the canonical name, and
+ * - the renderer still reads (for one minor version) while emitting a
+ *   `DEPRECATED_PROP` diagnostic.
+ *
+ * Pure data, no zod — safe to import from any layer.
+ */
+export interface CanonicalTextPropRule {
+    /** The one prop name authors, templates and the editor should write. */
+    canonical: string;
+    /** Deprecated names still read for backwards compatibility. */
+    aliases: readonly string[];
+    /**
+     * Order in which the pre-1.2.0 renderer resolved the visible value (first defined
+     * wins). The migration uses this so a migrated document renders exactly as before.
+     */
+    legacyReadOrder: readonly string[];
+}
+export declare const CANONICAL_TEXT_PROPS: Readonly<Record<string, CanonicalTextPropRule>>;
+/** Returns the canonical text prop rule for a component type, if it has one. */
+export declare function getCanonicalTextPropRule(componentType: string): CanonicalTextPropRule | undefined;
+export interface DeprecatedPropUsage {
+    /** Alias prop present on the node. */
+    propName: string;
+    /** Canonical prop name that should be used instead. */
+    canonicalName: string;
+    /** True when the canonical prop is absent, i.e. the alias is what actually renders. */
+    inEffect: boolean;
+}
+/**
+ * Lists deprecated alias props present on a node's props (does not mutate).
+ */
+export declare function findDeprecatedPropAliases(componentType: string, props: Record<string, unknown> | undefined): DeprecatedPropUsage[];
+//# sourceMappingURL=canonical-props.d.cts.map

package/dist/canonical-props.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-props.d.cts","sourceRoot":"","sources":["../src/canonical-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAgB/E,CAAC;AAEH,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAIjG;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,mBAAmB,EAAE,CAYvB"}