@sketchscreens/core-schema 0.1.0

package/dist/schema.d.ts

@@ -0,0 +1,625 @@
+import { z } from "zod";
+/**
+ * The SketchScreens contract.
+ *
+ * One JSON shape, produced by the extractor and consumed by the renderer.
+ * It is deliberately stack-agnostic: a Next.js screen and a Flutter screen
+ * both reduce to the same `ScreenSpec`, so the renderer draws them identically.
+ *
+ * Design note: `ElementType` is a CLOSED enum on purpose. Each value maps 1:1
+ * onto a renderable hand-drawn primitive (mostly wired-elements). A closed set
+ * keeps every map renderable and stops the LLM extractor from inventing element
+ * types the renderer can't draw.
+ */
+/** The closed set of wireframe primitives. Each maps to a renderable widget. */
+export declare const ElementType: z.ZodEnum<["heading", "text", "input", "textarea", "button", "checkbox", "radio", "toggle", "select", "listbox", "card", "image", "list", "divider", "nav", "tabs"]>;
+export type ElementType = z.infer<typeof ElementType>;
+/** Optional visual role for buttons, so the renderer can vary emphasis. */
+export declare const ElementVariant: z.ZodEnum<["primary", "secondary", "destructive", "ghost", "link"]>;
+export type ElementVariant = z.infer<typeof ElementVariant>;
+/**
+ * Which vertical band of the screen an element sits in. `top` = a header / nav
+ * bar pinned to the top; `bottom` = a footer / sticky action bar; `main` = the
+ * scrollable body (the default). Lets the sketch mirror the real screen's
+ * coarse layout without pixel positions.
+ */
+export declare const ElementRegion: z.ZodEnum<["top", "main", "bottom"]>;
+export type ElementRegion = z.infer<typeof ElementRegion>;
+/**
+ * Horizontal placement of an element within its band. `full` stretches edge to
+ * edge (inputs, nav bars, lists); `center` is a centered block (a hero button,
+ * a centered card); `left`/`right` hug a side. Default is `full` for fields and
+ * `left` for text.
+ */
+export declare const ElementAlign: z.ZodEnum<["left", "center", "right", "full"]>;
+export type ElementAlign = z.infer<typeof ElementAlign>;
+/**
+ * One UI element on a screen. `label` is the visible text (button caption,
+ * field label, heading text). Order in the `elements` array = top-to-bottom
+ * position in the sketch (structural fidelity, not pixel-exact).
+ */
+export declare const ScreenElement: z.ZodObject<{
+    type: z.ZodEnum<["heading", "text", "input", "textarea", "button", "checkbox", "radio", "toggle", "select", "listbox", "card", "image", "list", "divider", "nav", "tabs"]>;
+    /** Visible text: caption, label, or heading. Optional for dividers/images. */
+    label: z.ZodOptional<z.ZodString>;
+    /** Placeholder / hint text for inputs. */
+    placeholder: z.ZodOptional<z.ZodString>;
+    /** Visual emphasis (mainly for buttons). */
+    variant: z.ZodOptional<z.ZodEnum<["primary", "secondary", "destructive", "ghost", "link"]>>;
+    /** True for password / masked inputs. */
+    secure: z.ZodOptional<z.ZodBoolean>;
+    /** True if the element is marked required in the source. */
+    required: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Optional grouping key. Elements sharing a group render inside one
+     * card/section, preserving the source's visual grouping.
+     */
+    group: z.ZodOptional<z.ZodString>;
+    /**
+     * Which band of the screen this element sits in (top nav / main / bottom
+     * bar). Defaults to "main". Lets the sketch mirror the real layout.
+     */
+    region: z.ZodOptional<z.ZodEnum<["top", "main", "bottom"]>>;
+    /**
+     * Horizontal placement within the band. Defaults sensibly by type (fields
+     * full-width, text left). Set "center" for a centered hero button/card.
+     */
+    align: z.ZodOptional<z.ZodEnum<["left", "center", "right", "full"]>>;
+    /**
+     * Whether `label` is the app's verbatim text or the extractor's SHAPE
+     * description of a dynamic region (a list/table it couldn't read literally).
+     * Defaults to "verbatim". The renderer styles "descriptive" labels distinctly
+     * so a reviewer sees "this is the tool's summary, not the app's words."
+     */
+    labelKind: z.ZodOptional<z.ZodEnum<["verbatim", "descriptive"]>>;
+    /** Free-form note the extractor wants to surface (e.g. "conditionally shown"). */
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+    label?: string | undefined;
+    placeholder?: string | undefined;
+    variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+    secure?: boolean | undefined;
+    required?: boolean | undefined;
+    group?: string | undefined;
+    region?: "top" | "main" | "bottom" | undefined;
+    align?: "left" | "center" | "right" | "full" | undefined;
+    labelKind?: "verbatim" | "descriptive" | undefined;
+    note?: string | undefined;
+}, {
+    type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+    label?: string | undefined;
+    placeholder?: string | undefined;
+    variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+    secure?: boolean | undefined;
+    required?: boolean | undefined;
+    group?: string | undefined;
+    region?: "top" | "main" | "bottom" | undefined;
+    align?: "left" | "center" | "right" | "full" | undefined;
+    labelKind?: "verbatim" | "descriptive" | undefined;
+    note?: string | undefined;
+}>;
+export type ScreenElement = z.infer<typeof ScreenElement>;
+/** One screen = one node in the map. */
+export declare const ScreenSpec: z.ZodObject<{
+    /** Stable id, unique within the map. Referenced by edges. */
+    id: z.ZodString;
+    /** Human-friendly screen name (e.g. "Login"). */
+    name: z.ZodString;
+    /**
+     * The route or address of this screen: a URL path (`/settings/profile`),
+     * a Flutter widget class (`SettingsScreen`), or an API path group. Optional
+     * because not every screen is addressable (e.g. a modal).
+     */
+    route: z.ZodOptional<z.ZodString>;
+    /** Repo-relative path of the file this screen was extracted from. */
+    sourceFile: z.ZodOptional<z.ZodString>;
+    /** The elements on this screen, in top-to-bottom order. */
+    elements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["heading", "text", "input", "textarea", "button", "checkbox", "radio", "toggle", "select", "listbox", "card", "image", "list", "divider", "nav", "tabs"]>;
+        /** Visible text: caption, label, or heading. Optional for dividers/images. */
+        label: z.ZodOptional<z.ZodString>;
+        /** Placeholder / hint text for inputs. */
+        placeholder: z.ZodOptional<z.ZodString>;
+        /** Visual emphasis (mainly for buttons). */
+        variant: z.ZodOptional<z.ZodEnum<["primary", "secondary", "destructive", "ghost", "link"]>>;
+        /** True for password / masked inputs. */
+        secure: z.ZodOptional<z.ZodBoolean>;
+        /** True if the element is marked required in the source. */
+        required: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * Optional grouping key. Elements sharing a group render inside one
+         * card/section, preserving the source's visual grouping.
+         */
+        group: z.ZodOptional<z.ZodString>;
+        /**
+         * Which band of the screen this element sits in (top nav / main / bottom
+         * bar). Defaults to "main". Lets the sketch mirror the real layout.
+         */
+        region: z.ZodOptional<z.ZodEnum<["top", "main", "bottom"]>>;
+        /**
+         * Horizontal placement within the band. Defaults sensibly by type (fields
+         * full-width, text left). Set "center" for a centered hero button/card.
+         */
+        align: z.ZodOptional<z.ZodEnum<["left", "center", "right", "full"]>>;
+        /**
+         * Whether `label` is the app's verbatim text or the extractor's SHAPE
+         * description of a dynamic region (a list/table it couldn't read literally).
+         * Defaults to "verbatim". The renderer styles "descriptive" labels distinctly
+         * so a reviewer sees "this is the tool's summary, not the app's words."
+         */
+        labelKind: z.ZodOptional<z.ZodEnum<["verbatim", "descriptive"]>>;
+        /** Free-form note the extractor wants to surface (e.g. "conditionally shown"). */
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+        secure?: boolean | undefined;
+        required?: boolean | undefined;
+        group?: string | undefined;
+        region?: "top" | "main" | "bottom" | undefined;
+        align?: "left" | "center" | "right" | "full" | undefined;
+        labelKind?: "verbatim" | "descriptive" | undefined;
+        note?: string | undefined;
+    }, {
+        type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+        secure?: boolean | undefined;
+        required?: boolean | undefined;
+        group?: string | undefined;
+        region?: "top" | "main" | "bottom" | undefined;
+        align?: "left" | "center" | "right" | "full" | undefined;
+        labelKind?: "verbatim" | "descriptive" | undefined;
+        note?: string | undefined;
+    }>, "many">>;
+    /** Optional short description / purpose of the screen. */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional label-path for this screen's section, most-general first, using
+     * " › " as the separator — e.g. "Settings › AI Settings". Groups cluster and
+     * label screens; the renderer nests group labels. Deriveable from the route.
+     * (For the overall journey SHAPE, prefer `parent` below.)
+     */
+    group: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional id of the screen this one hangs beneath in the JOURNEY tree — the
+     * screen a user reaches this one *from*. This is what roots the map as a real
+     * flow: an entry screen has no parent; the auth screen's parent is the entry;
+     * each feature-section hub's parent is the dashboard; etc. When set, it
+     * overrides route-derived nesting so the tree matches how users actually
+     * navigate. Must reference another screen's `id`.
+     */
+    parent: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional hint that this screen is the app's entry point / root of the
+     * journey (what the user sees first). At most one screen should set this; the
+     * renderer roots the tree here. If none is set, the renderer infers a root.
+     */
+    isEntry: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * How this screen is presented. "screen" (default) is a full page/route; the
+     * others are overlays. The renderer draws non-"screen" presentations with a
+     * distinct overlay frame and attaches them to their opener via an edge rather
+     * than the journey backbone.
+     */
+    presentation: z.ZodOptional<z.ZodEnum<["screen", "modal", "drawer", "sheet"]>>;
+    /**
+     * Optional state variant this screen represents (an empty/error/loading view
+     * of another screen). The renderer can cluster it beside its base screen.
+     */
+    state: z.ZodOptional<z.ZodEnum<["default", "empty", "error", "loading"]>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    elements: {
+        type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+        secure?: boolean | undefined;
+        required?: boolean | undefined;
+        group?: string | undefined;
+        region?: "top" | "main" | "bottom" | undefined;
+        align?: "left" | "center" | "right" | "full" | undefined;
+        labelKind?: "verbatim" | "descriptive" | undefined;
+        note?: string | undefined;
+    }[];
+    group?: string | undefined;
+    route?: string | undefined;
+    sourceFile?: string | undefined;
+    description?: string | undefined;
+    parent?: string | undefined;
+    isEntry?: boolean | undefined;
+    presentation?: "screen" | "modal" | "drawer" | "sheet" | undefined;
+    state?: "default" | "empty" | "error" | "loading" | undefined;
+}, {
+    id: string;
+    name: string;
+    group?: string | undefined;
+    route?: string | undefined;
+    sourceFile?: string | undefined;
+    elements?: {
+        type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+        label?: string | undefined;
+        placeholder?: string | undefined;
+        variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+        secure?: boolean | undefined;
+        required?: boolean | undefined;
+        group?: string | undefined;
+        region?: "top" | "main" | "bottom" | undefined;
+        align?: "left" | "center" | "right" | "full" | undefined;
+        labelKind?: "verbatim" | "descriptive" | undefined;
+        note?: string | undefined;
+    }[] | undefined;
+    description?: string | undefined;
+    parent?: string | undefined;
+    isEntry?: boolean | undefined;
+    presentation?: "screen" | "modal" | "drawer" | "sheet" | undefined;
+    state?: "default" | "empty" | "error" | "loading" | undefined;
+}>;
+export type ScreenSpec = z.infer<typeof ScreenSpec>;
+/** Split a group path ("Settings › AI Settings") into its segments. */
+export declare function groupSegments(group: string | undefined): string[];
+/** A navigation transition from one screen to another. */
+export declare const Edge: z.ZodObject<{
+    /** Source screen id. */
+    from: z.ZodString;
+    /** Destination screen id. */
+    to: z.ZodString;
+    /**
+     * What triggers the transition — usually a button/link label
+     * ("Continue", "Forgot?"). Rendered as the edge label.
+     */
+    trigger: z.ZodOptional<z.ZodString>;
+    /** How the transition is expressed, if useful (e.g. "redirect", "push", "link"). */
+    kind: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    to: string;
+    trigger?: string | undefined;
+    kind?: string | undefined;
+}, {
+    from: string;
+    to: string;
+    trigger?: string | undefined;
+    kind?: string | undefined;
+}>;
+export type Edge = z.infer<typeof Edge>;
+/**
+ * Which surface this map represents. Each surface is its own map — a web app,
+ * a mobile app, a CRM, and a backend are mapped separately, not tangled into one.
+ */
+export declare const Surface: z.ZodEnum<["web", "mobile", "crm", "admin", "backend", "desktop", "other"]>;
+export type Surface = z.infer<typeof Surface>;
+/** Optional provenance / metadata about how this map was produced. */
+export declare const ProjectMapMeta: z.ZodObject<{
+    /** The tool version that produced the map. */
+    generator: z.ZodOptional<z.ZodString>;
+    /** Repo-relative or absolute root the map was extracted from. */
+    repoRoot: z.ZodOptional<z.ZodString>;
+    /** ISO timestamp string (set by the producer; schema stays time-agnostic). */
+    generatedAt: z.ZodOptional<z.ZodString>;
+    /** How elements were derived: "agent", "static", or "hybrid". */
+    extraction: z.ZodOptional<z.ZodEnum<["agent", "static", "hybrid", "manual"]>>;
+}, "strip", z.ZodTypeAny, {
+    generator?: string | undefined;
+    repoRoot?: string | undefined;
+    generatedAt?: string | undefined;
+    extraction?: "agent" | "static" | "hybrid" | "manual" | undefined;
+}, {
+    generator?: string | undefined;
+    repoRoot?: string | undefined;
+    generatedAt?: string | undefined;
+    extraction?: "agent" | "static" | "hybrid" | "manual" | undefined;
+}>;
+export type ProjectMapMeta = z.infer<typeof ProjectMapMeta>;
+/** The contract version this build of SketchScreens speaks. */
+export declare const CONTRACT_VERSION = 1;
+/** The whole thing: one surface's screens + the flow between them. */
+export declare const ProjectMap: z.ZodObject<{
+    /**
+     * Contract version. Accepts any positive integer so an OLD renderer reading a
+     * NEWER map fails with a clear "upgrade" message (see validate.ts) rather than
+     * a generic zod "invalid literal". New fields are additive; bump only on a
+     * breaking change.
+     */
+    version: z.ZodDefault<z.ZodNumber>;
+    /** Display name for this map (e.g. "AiPhone 360 — Web App"). */
+    name: z.ZodString;
+    /** Which surface this represents. */
+    surface: z.ZodEnum<["web", "mobile", "crm", "admin", "backend", "desktop", "other"]>;
+    /** The screens (nodes). */
+    screens: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** Stable id, unique within the map. Referenced by edges. */
+        id: z.ZodString;
+        /** Human-friendly screen name (e.g. "Login"). */
+        name: z.ZodString;
+        /**
+         * The route or address of this screen: a URL path (`/settings/profile`),
+         * a Flutter widget class (`SettingsScreen`), or an API path group. Optional
+         * because not every screen is addressable (e.g. a modal).
+         */
+        route: z.ZodOptional<z.ZodString>;
+        /** Repo-relative path of the file this screen was extracted from. */
+        sourceFile: z.ZodOptional<z.ZodString>;
+        /** The elements on this screen, in top-to-bottom order. */
+        elements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["heading", "text", "input", "textarea", "button", "checkbox", "radio", "toggle", "select", "listbox", "card", "image", "list", "divider", "nav", "tabs"]>;
+            /** Visible text: caption, label, or heading. Optional for dividers/images. */
+            label: z.ZodOptional<z.ZodString>;
+            /** Placeholder / hint text for inputs. */
+            placeholder: z.ZodOptional<z.ZodString>;
+            /** Visual emphasis (mainly for buttons). */
+            variant: z.ZodOptional<z.ZodEnum<["primary", "secondary", "destructive", "ghost", "link"]>>;
+            /** True for password / masked inputs. */
+            secure: z.ZodOptional<z.ZodBoolean>;
+            /** True if the element is marked required in the source. */
+            required: z.ZodOptional<z.ZodBoolean>;
+            /**
+             * Optional grouping key. Elements sharing a group render inside one
+             * card/section, preserving the source's visual grouping.
+             */
+            group: z.ZodOptional<z.ZodString>;
+            /**
+             * Which band of the screen this element sits in (top nav / main / bottom
+             * bar). Defaults to "main". Lets the sketch mirror the real layout.
+             */
+            region: z.ZodOptional<z.ZodEnum<["top", "main", "bottom"]>>;
+            /**
+             * Horizontal placement within the band. Defaults sensibly by type (fields
+             * full-width, text left). Set "center" for a centered hero button/card.
+             */
+            align: z.ZodOptional<z.ZodEnum<["left", "center", "right", "full"]>>;
+            /**
+             * Whether `label` is the app's verbatim text or the extractor's SHAPE
+             * description of a dynamic region (a list/table it couldn't read literally).
+             * Defaults to "verbatim". The renderer styles "descriptive" labels distinctly
+             * so a reviewer sees "this is the tool's summary, not the app's words."
+             */
+            labelKind: z.ZodOptional<z.ZodEnum<["verbatim", "descriptive"]>>;
+            /** Free-form note the extractor wants to surface (e.g. "conditionally shown"). */
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+            label?: string | undefined;
+            placeholder?: string | undefined;
+            variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+            secure?: boolean | undefined;
+            required?: boolean | undefined;
+            group?: string | undefined;
+            region?: "top" | "main" | "bottom" | undefined;
+            align?: "left" | "center" | "right" | "full" | undefined;
+            labelKind?: "verbatim" | "descriptive" | undefined;
+            note?: string | undefined;
+        }, {
+            type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+            label?: string | undefined;
+            placeholder?: string | undefined;
+            variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+            secure?: boolean | undefined;
+            required?: boolean | undefined;
+            group?: string | undefined;
+            region?: "top" | "main" | "bottom" | undefined;
+            align?: "left" | "center" | "right" | "full" | undefined;
+            labelKind?: "verbatim" | "descriptive" | undefined;
+            note?: string | undefined;
+        }>, "many">>;
+        /** Optional short description / purpose of the screen. */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Optional label-path for this screen's section, most-general first, using
+         * " › " as the separator — e.g. "Settings › AI Settings". Groups cluster and
+         * label screens; the renderer nests group labels. Deriveable from the route.
+         * (For the overall journey SHAPE, prefer `parent` below.)
+         */
+        group: z.ZodOptional<z.ZodString>;
+        /**
+         * Optional id of the screen this one hangs beneath in the JOURNEY tree — the
+         * screen a user reaches this one *from*. This is what roots the map as a real
+         * flow: an entry screen has no parent; the auth screen's parent is the entry;
+         * each feature-section hub's parent is the dashboard; etc. When set, it
+         * overrides route-derived nesting so the tree matches how users actually
+         * navigate. Must reference another screen's `id`.
+         */
+        parent: z.ZodOptional<z.ZodString>;
+        /**
+         * Optional hint that this screen is the app's entry point / root of the
+         * journey (what the user sees first). At most one screen should set this; the
+         * renderer roots the tree here. If none is set, the renderer infers a root.
+         */
+        isEntry: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * How this screen is presented. "screen" (default) is a full page/route; the
+         * others are overlays. The renderer draws non-"screen" presentations with a
+         * distinct overlay frame and attaches them to their opener via an edge rather
+         * than the journey backbone.
+         */
+        presentation: z.ZodOptional<z.ZodEnum<["screen", "modal", "drawer", "sheet"]>>;
+        /**
+         * Optional state variant this screen represents (an empty/error/loading view
+         * of another screen). The renderer can cluster it beside its base screen.
+         */
+        state: z.ZodOptional<z.ZodEnum<["default", "empty", "error", "loading"]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        elements: {
+            type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+            label?: string | undefined;
+            placeholder?: string | undefined;
+            variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+            secure?: boolean | undefined;
+            required?: boolean | undefined;
+            group?: string | undefined;
+            region?: "top" | "main" | "bottom" | undefined;
+            align?: "left" | "center" | "right" | "full" | undefined;
+            labelKind?: "verbatim" | "descriptive" | undefined;
+            note?: string | undefined;
+        }[];
+        group?: string | undefined;
+        route?: string | undefined;
+        sourceFile?: string | undefined;
+        description?: string | undefined;
+        parent?: string | undefined;
+        isEntry?: boolean | undefined;
+        presentation?: "screen" | "modal" | "drawer" | "sheet" | undefined;
+        state?: "default" | "empty" | "error" | "loading" | undefined;
+    }, {
+        id: string;
+        name: string;
+        group?: string | undefined;
+        route?: string | undefined;
+        sourceFile?: string | undefined;
+        elements?: {
+            type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+            label?: string | undefined;
+            placeholder?: string | undefined;
+            variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+            secure?: boolean | undefined;
+            required?: boolean | undefined;
+            group?: string | undefined;
+            region?: "top" | "main" | "bottom" | undefined;
+            align?: "left" | "center" | "right" | "full" | undefined;
+            labelKind?: "verbatim" | "descriptive" | undefined;
+            note?: string | undefined;
+        }[] | undefined;
+        description?: string | undefined;
+        parent?: string | undefined;
+        isEntry?: boolean | undefined;
+        presentation?: "screen" | "modal" | "drawer" | "sheet" | undefined;
+        state?: "default" | "empty" | "error" | "loading" | undefined;
+    }>, "many">>;
+    /** The navigation transitions (edges). */
+    edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** Source screen id. */
+        from: z.ZodString;
+        /** Destination screen id. */
+        to: z.ZodString;
+        /**
+         * What triggers the transition — usually a button/link label
+         * ("Continue", "Forgot?"). Rendered as the edge label.
+         */
+        trigger: z.ZodOptional<z.ZodString>;
+        /** How the transition is expressed, if useful (e.g. "redirect", "push", "link"). */
+        kind: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        trigger?: string | undefined;
+        kind?: string | undefined;
+    }, {
+        from: string;
+        to: string;
+        trigger?: string | undefined;
+        kind?: string | undefined;
+    }>, "many">>;
+    /** Optional provenance. */
+    meta: z.ZodOptional<z.ZodObject<{
+        /** The tool version that produced the map. */
+        generator: z.ZodOptional<z.ZodString>;
+        /** Repo-relative or absolute root the map was extracted from. */
+        repoRoot: z.ZodOptional<z.ZodString>;
+        /** ISO timestamp string (set by the producer; schema stays time-agnostic). */
+        generatedAt: z.ZodOptional<z.ZodString>;
+        /** How elements were derived: "agent", "static", or "hybrid". */
+        extraction: z.ZodOptional<z.ZodEnum<["agent", "static", "hybrid", "manual"]>>;
+    }, "strip", z.ZodTypeAny, {
+        generator?: string | undefined;
+        repoRoot?: string | undefined;
+        generatedAt?: string | undefined;
+        extraction?: "agent" | "static" | "hybrid" | "manual" | undefined;
+    }, {
+        generator?: string | undefined;
+        repoRoot?: string | undefined;
+        generatedAt?: string | undefined;
+        extraction?: "agent" | "static" | "hybrid" | "manual" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: number;
+    surface: "web" | "mobile" | "crm" | "admin" | "backend" | "desktop" | "other";
+    screens: {
+        id: string;
+        name: string;
+        elements: {
+            type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+            label?: string | undefined;
+            placeholder?: string | undefined;
+            variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+            secure?: boolean | undefined;
+            required?: boolean | undefined;
+            group?: string | undefined;
+            region?: "top" | "main" | "bottom" | undefined;
+            align?: "left" | "center" | "right" | "full" | undefined;
+            labelKind?: "verbatim" | "descriptive" | undefined;
+            note?: string | undefined;
+        }[];
+        group?: string | undefined;
+        route?: string | undefined;
+        sourceFile?: string | undefined;
+        description?: string | undefined;
+        parent?: string | undefined;
+        isEntry?: boolean | undefined;
+        presentation?: "screen" | "modal" | "drawer" | "sheet" | undefined;
+        state?: "default" | "empty" | "error" | "loading" | undefined;
+    }[];
+    edges: {
+        from: string;
+        to: string;
+        trigger?: string | undefined;
+        kind?: string | undefined;
+    }[];
+    meta?: {
+        generator?: string | undefined;
+        repoRoot?: string | undefined;
+        generatedAt?: string | undefined;
+        extraction?: "agent" | "static" | "hybrid" | "manual" | undefined;
+    } | undefined;
+}, {
+    name: string;
+    surface: "web" | "mobile" | "crm" | "admin" | "backend" | "desktop" | "other";
+    version?: number | undefined;
+    screens?: {
+        id: string;
+        name: string;
+        group?: string | undefined;
+        route?: string | undefined;
+        sourceFile?: string | undefined;
+        elements?: {
+            type: "heading" | "text" | "input" | "textarea" | "button" | "checkbox" | "radio" | "toggle" | "select" | "listbox" | "card" | "image" | "list" | "divider" | "nav" | "tabs";
+            label?: string | undefined;
+            placeholder?: string | undefined;
+            variant?: "primary" | "secondary" | "destructive" | "ghost" | "link" | undefined;
+            secure?: boolean | undefined;
+            required?: boolean | undefined;
+            group?: string | undefined;
+            region?: "top" | "main" | "bottom" | undefined;
+            align?: "left" | "center" | "right" | "full" | undefined;
+            labelKind?: "verbatim" | "descriptive" | undefined;
+            note?: string | undefined;
+        }[] | undefined;
+        description?: string | undefined;
+        parent?: string | undefined;
+        isEntry?: boolean | undefined;
+        presentation?: "screen" | "modal" | "drawer" | "sheet" | undefined;
+        state?: "default" | "empty" | "error" | "loading" | undefined;
+    }[] | undefined;
+    edges?: {
+        from: string;
+        to: string;
+        trigger?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    meta?: {
+        generator?: string | undefined;
+        repoRoot?: string | undefined;
+        generatedAt?: string | undefined;
+        extraction?: "agent" | "static" | "hybrid" | "manual" | undefined;
+    } | undefined;
+}>;
+export type ProjectMap = z.infer<typeof ProjectMap>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

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