@syncropel/projections 0.1.0

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoDH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,MAAM;IACN,SAAS;IACT,MAAM;IACN,MAAM;IACN,WAAW;IACX,QAAQ;IACR,aAAa;IACb,aAAa;IACb,QAAQ;IACR,aAAa;IACb,aAAa;IACb,UAAU;CACF,CAAC","sourcesContent":["/**\n * SRP v0.1 — TypeScript schema types.\n *\n * The Syncropel Rendering Protocol is a narrow JSON schema of block-level\n * primitives for declarative UI documents. See the spec and examples at\n * https://syncropel.com.\n */\n\n// ---------------------------------------------------------------------------\n// Document envelope\n// ---------------------------------------------------------------------------\n\n/**\n * An SRP v0.1 document — the top-level envelope a Tier-1 extension emits.\n */\nexport interface SRPDocument {\n  srp: \"0.1\";\n  meta?: SRPMeta;\n  root: SRPNode;\n}\n\nexport interface SRPMeta {\n  name?: string;\n  version?: string;\n  description?: string;\n  publisher?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Discriminated union of all 19 node types\n// ---------------------------------------------------------------------------\n\nexport type SRPNode =\n  // Containers (5)\n  | ColumnNode\n  | RowNode\n  | GridNode\n  | CardNode\n  | DividerNode\n  // Record rendering (3)\n  | RecordLineNode\n  | RecordLineListNode\n  | ChipNode\n  // Data display (4)\n  | HeadingNode\n  | TextNode\n  | StatNode\n  | KeyValueNode\n  // Interactive (4)\n  | ButtonNode\n  | IconButtonNode\n  | CopyButtonNode\n  | SelectNode\n  // Feedback (3)\n  | EmptyStateNode\n  | ErrorStateNode\n  | SkeletonNode;\n\n/**\n * The 19 canonical node-type discriminator strings.\n */\nexport const NODE_TYPES = [\n  \"column\",\n  \"row\",\n  \"grid\",\n  \"card\",\n  \"divider\",\n  \"record-line\",\n  \"record-line-list\",\n  \"chip\",\n  \"heading\",\n  \"text\",\n  \"stat\",\n  \"key-value\",\n  \"button\",\n  \"icon-button\",\n  \"copy-button\",\n  \"select\",\n  \"empty-state\",\n  \"error-state\",\n  \"skeleton\",\n] as const;\n\nexport type NodeType = (typeof NODE_TYPES)[number];\n\n// ---------------------------------------------------------------------------\n// Fields every node may carry\n// ---------------------------------------------------------------------------\n\ninterface NodeBase {\n  when?: string;\n  bind?: Record<string, unknown>;\n  actions?: Record<string, ActionDesc>;\n}\n\n// ---------------------------------------------------------------------------\n// Token unions (mirror @syncropel/react token scales)\n// ---------------------------------------------------------------------------\n\nexport type Gap = \"none\" | \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\nexport type Padding = \"none\" | \"xs\" | \"sm\" | \"md\" | \"lg\";\nexport type DividerSpacing = \"none\" | \"xs\" | \"sm\" | \"md\" | \"lg\";\nexport type Cols = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;\n\nexport type ColumnAlign = \"start\" | \"center\" | \"end\" | \"stretch\";\nexport type RowAlign = \"start\" | \"center\" | \"end\" | \"stretch\" | \"baseline\";\nexport type Justify =\n  | \"start\"\n  | \"center\"\n  | \"end\"\n  | \"between\"\n  | \"around\"\n  | \"evenly\";\n\nexport type RecordLineVariant =\n  | \"feed\"\n  | \"compact\"\n  | \"detail\"\n  | \"search\"\n  | \"thread\";\n\nexport type ChipTone = \"default\" | \"info\" | \"warn\" | \"error\";\n\nexport type TextSize = \"xs\" | \"sm\" | \"md\" | \"lg\";\nexport type TextWeight = \"normal\" | \"medium\" | \"semibold\";\nexport type TextTone =\n  | \"primary\"\n  | \"secondary\"\n  | \"muted\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\";\n\nexport type ButtonVariant = \"primary\" | \"secondary\" | \"ghost\" | \"danger\";\nexport type ButtonSize = \"xs\" | \"sm\" | \"md\";\n\nexport type SkeletonShape = \"rect\" | \"circle\" | \"text\";\n\n/**\n * Glyph kinds — the closed enumeration of semantic symbols the palette renders.\n * Covers act types, domain objects, thread states, and the AITL marker.\n */\nexport type GlyphKind =\n  // Act types (coordination)\n  | \"INTEND\"\n  | \"DO\"\n  | \"KNOW\"\n  | \"LEARN\"\n  // Act types (effects)\n  | \"GET\"\n  | \"PUT\"\n  | \"CALL\"\n  | \"MAP\"\n  // AITL marker\n  | \"AITL\"\n  // Domain objects\n  | \"thread\"\n  | \"fork\"\n  | \"record-parent\"\n  | \"namespace\"\n  | \"actor\"\n  | \"file\"\n  | \"pattern\"\n  | \"page\"\n  | \"view\"\n  // Thread states\n  | \"state-open\"\n  | \"state-active\"\n  | \"state-converged\"\n  | \"state-closed\"\n  | \"state-abandoned\";\n\n// ---------------------------------------------------------------------------\n// Actions + queries\n// ---------------------------------------------------------------------------\n\nexport interface ActionDesc {\n  intent: string;\n  payload?: Record<string, unknown>;\n}\n\n/**\n * VQL (Value Query Language) — the query shape a Syncropel server resolves\n * against its record store. Used by `record-line-list` nodes that bind to\n * a live query rather than a static list of record ids.\n *\n * The shape is deliberately open (index signature) — additional fields\n * are protocol extensions the server understands.\n */\nexport interface VQLQuery {\n  act?: string;\n  actor?: string;\n  thread?: string;\n  kind?: string;\n  since?: number;\n  limit?: number;\n  [k: string]: unknown;\n}\n\n// ---------------------------------------------------------------------------\n// Container node definitions (5)\n// ---------------------------------------------------------------------------\n\nexport interface ColumnNode extends NodeBase {\n  type: \"column\";\n  props?: { gap?: Gap; align?: ColumnAlign; justify?: Justify };\n  children?: SRPNode[];\n}\n\nexport interface RowNode extends NodeBase {\n  type: \"row\";\n  props?: {\n    gap?: Gap;\n    align?: RowAlign;\n    justify?: Justify;\n    wrap?: boolean;\n  };\n  children?: SRPNode[];\n}\n\nexport interface GridNode extends NodeBase {\n  type: \"grid\";\n  props: { cols: Cols; gap?: Gap; rowGap?: Gap; colGap?: Gap };\n  children?: SRPNode[];\n}\n\nexport interface CardNode extends NodeBase {\n  type: \"card\";\n  props?: { padding?: Padding; interactive?: boolean };\n  children?: SRPNode[];\n}\n\nexport interface DividerNode extends NodeBase {\n  type: \"divider\";\n  props?: { orientation?: \"horizontal\" | \"vertical\"; spacing?: DividerSpacing };\n}\n\n// ---------------------------------------------------------------------------\n// Record-rendering (3)\n// ---------------------------------------------------------------------------\n\nexport interface RecordLineNode extends NodeBase {\n  type: \"record-line\";\n  props: { variant: RecordLineVariant };\n  bind: { record: string };\n}\n\nexport interface RecordLineListNode extends NodeBase {\n  type: \"record-line-list\";\n  props: { variant: RecordLineVariant; max?: number; empty?: string };\n  bind: { query: VQLQuery } | { items: string[] };\n}\n\nexport interface ChipNode extends NodeBase {\n  type: \"chip\";\n  props: { label: string; tone?: ChipTone; glyph?: GlyphKind };\n}\n\n// ---------------------------------------------------------------------------\n// Data display (4)\n// ---------------------------------------------------------------------------\n\nexport interface HeadingNode extends NodeBase {\n  type: \"heading\";\n  props: { level: 1 | 2 | 3 | 4 | 5 | 6; text: string };\n}\n\nexport interface TextNode extends NodeBase {\n  type: \"text\";\n  props: {\n    text: string;\n    size?: TextSize;\n    weight?: TextWeight;\n    tone?: TextTone;\n    inline?: boolean;\n  };\n}\n\nexport interface StatNode extends NodeBase {\n  type: \"stat\";\n  props: {\n    label: string;\n    value: string | number;\n    delta?: string | number;\n    deltaTone?: \"auto\" | \"neutral\";\n  };\n}\n\nexport interface KeyValueNode extends NodeBase {\n  type: \"key-value\";\n  props: { label: string; value: string };\n}\n\n// ---------------------------------------------------------------------------\n// Interactive (4)\n// ---------------------------------------------------------------------------\n\nexport interface ButtonNode extends NodeBase {\n  type: \"button\";\n  props: {\n    label: string;\n    variant?: ButtonVariant;\n    size?: ButtonSize;\n    disabled?: boolean;\n    loading?: boolean;\n  };\n  actions?: { onClick?: ActionDesc };\n}\n\nexport interface IconButtonNode extends NodeBase {\n  type: \"icon-button\";\n  props: {\n    glyph: GlyphKind;\n    ariaLabel: string;\n    variant?: ButtonVariant;\n    size?: ButtonSize;\n    disabled?: boolean;\n    loading?: boolean;\n  };\n  actions?: { onClick?: ActionDesc };\n}\n\nexport interface CopyButtonNode extends NodeBase {\n  type: \"copy-button\";\n  props: { value: string; label?: string };\n}\n\nexport interface SelectNode extends NodeBase {\n  type: \"select\";\n  props: { options: { label: string; value: string }[] };\n  bind: { value: string };\n  actions?: { onChange?: ActionDesc };\n}\n\n// ---------------------------------------------------------------------------\n// Feedback (3)\n// ---------------------------------------------------------------------------\n\nexport interface EmptyStateNode extends NodeBase {\n  type: \"empty-state\";\n  props: {\n    message: string;\n    action?: { label: string; intent: string };\n  };\n}\n\nexport interface ErrorStateNode extends NodeBase {\n  type: \"error-state\";\n  props: {\n    message: string;\n    retry?: { intent: string };\n  };\n}\n\nexport interface SkeletonNode extends NodeBase {\n  type: \"skeleton\";\n  props?: {\n    shape?: SkeletonShape;\n    width?: string | number | \"full\";\n    height?: string | number;\n  };\n}\n"]}

package/dist/validators.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Runtime validators for SRP v0.1 documents.
+ *
+ * Pure functions — no dependencies. Return a ValidationResult with either a
+ * `valid: true` flag or a list of errors keyed by path.
+ */
+import type { SRPDocument, SRPNode } from "./schema.js";
+export interface ValidationError {
+    /** JSON-pointer-style path to the offending node, e.g. "/root/children/0". */
+    path: string;
+    /** Human-readable message. */
+    message: string;
+    /** Machine-readable code for programmatic handling. */
+    code: ValidationErrorCode;
+}
+export type ValidationErrorCode = "SRP_VERSION_INVALID" | "ROOT_MISSING" | "NODE_NOT_OBJECT" | "NODE_TYPE_MISSING" | "NODE_TYPE_UNKNOWN" | "PROPS_MISSING_REQUIRED" | "PROPS_INVALID_VALUE" | "CHILDREN_NOT_ARRAY" | "CHILDREN_NOT_ALLOWED" | "BIND_MISSING_REQUIRED" | "BIND_INVALID_SHAPE";
+export type ValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    errors: ValidationError[];
+};
+/**
+ * Validate a full SRP document.
+ *
+ * Returns `{ valid: true }` when the document conforms to SRP v0.1.
+ * Returns `{ valid: false, errors }` with every violation keyed by a
+ * JSON-pointer-style path when it doesn't.
+ */
+export declare function validateSRP(doc: unknown): ValidationResult;
+/**
+ * Validate a single node (used internally and useful standalone for
+ * incremental SRP authoring).
+ */
+export declare function validateNode(node: unknown, path: string): ValidationResult;
+/**
+ * Type guard: true when `doc` is a well-formed SRP document.
+ * Useful in adapter code that receives untrusted JSON.
+ */
+export declare function isSRPDocument(doc: unknown): doc is SRPDocument;
+/**
+ * Type guard: true when `node` is a well-formed SRP node.
+ */
+export declare function isSRPNode(node: unknown): node is SRPNode;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAOxD,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAC3B,qBAAqB,GACrB,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,GACnB,wBAAwB,GACxB,qBAAqB,GACrB,oBAAoB,GACpB,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAahD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CA4B1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAM1E;AA0dD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAG9D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,OAAO,CAGxD"}

package/dist/validators.js

@@ -0,0 +1,312 @@
+/**
+ * Runtime validators for SRP v0.1 documents.
+ *
+ * Pure functions — no dependencies. Return a ValidationResult with either a
+ * `valid: true` flag or a list of errors keyed by path.
+ */
+import { NODE_TYPES } from "./schema.js";
+class Collector {
+    errors = [];
+    add(path, code, message) {
+        this.errors.push({ path, code, message });
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Validate a full SRP document.
+ *
+ * Returns `{ valid: true }` when the document conforms to SRP v0.1.
+ * Returns `{ valid: false, errors }` with every violation keyed by a
+ * JSON-pointer-style path when it doesn't.
+ */
+export function validateSRP(doc) {
+    const c = new Collector();
+    if (typeof doc !== "object" || doc === null) {
+        c.add("", "NODE_NOT_OBJECT", "SRP document must be an object");
+        return { valid: false, errors: c.errors };
+    }
+    const d = doc;
+    if (d.srp !== "0.1") {
+        c.add("/srp", "SRP_VERSION_INVALID", `srp field must be the exact string "0.1", got ${JSON.stringify(d.srp)}`);
+    }
+    if (!("root" in d)) {
+        c.add("/root", "ROOT_MISSING", "SRP document must have a root node");
+        return { valid: false, errors: c.errors };
+    }
+    validateNodeInto(d.root, "/root", c);
+    return c.errors.length === 0
+        ? { valid: true }
+        : { valid: false, errors: c.errors };
+}
+/**
+ * Validate a single node (used internally and useful standalone for
+ * incremental SRP authoring).
+ */
+export function validateNode(node, path) {
+    const c = new Collector();
+    validateNodeInto(node, path, c);
+    return c.errors.length === 0
+        ? { valid: true }
+        : { valid: false, errors: c.errors };
+}
+function validateNodeInto(node, path, c) {
+    if (typeof node !== "object" || node === null) {
+        c.add(path, "NODE_NOT_OBJECT", `Node at ${path} must be an object`);
+        return;
+    }
+    const n = node;
+    if (typeof n.type !== "string") {
+        c.add(`${path}/type`, "NODE_TYPE_MISSING", `Node at ${path} must have a string "type" field`);
+        return;
+    }
+    if (!NODE_TYPES.includes(n.type)) {
+        c.add(`${path}/type`, "NODE_TYPE_UNKNOWN", `Unknown node type "${n.type}" at ${path}. Allowed: ${NODE_TYPES.join(", ")}`);
+        return;
+    }
+    // Per-type validation dispatched below
+    switch (n.type) {
+        case "column":
+        case "row":
+        case "card":
+            validateContainer(n, path, c);
+            break;
+        case "grid":
+            validateGrid(n, path, c);
+            break;
+        case "divider":
+            validateDivider(n, path, c);
+            break;
+        case "record-line":
+            validateRecordLine(n, path, c);
+            break;
+        case "record-line-list":
+            validateRecordLineList(n, path, c);
+            break;
+        case "chip":
+            validateChip(n, path, c);
+            break;
+        case "heading":
+            validateHeading(n, path, c);
+            break;
+        case "text":
+            validateText(n, path, c);
+            break;
+        case "stat":
+            validateStat(n, path, c);
+            break;
+        case "key-value":
+            validateKeyValue(n, path, c);
+            break;
+        case "button":
+            validateButton(n, path, c);
+            break;
+        case "icon-button":
+            validateIconButton(n, path, c);
+            break;
+        case "copy-button":
+            validateCopyButton(n, path, c);
+            break;
+        case "select":
+            validateSelect(n, path, c);
+            break;
+        case "empty-state":
+            validateEmptyState(n, path, c);
+            break;
+        case "error-state":
+            validateErrorState(n, path, c);
+            break;
+        case "skeleton":
+            validateSkeleton(n, path, c);
+            break;
+    }
+}
+// ---------------------------------------------------------------------------
+// Per-node validators
+// ---------------------------------------------------------------------------
+function validateContainer(n, path, c) {
+    if ("children" in n && n.children !== undefined) {
+        if (!Array.isArray(n.children)) {
+            c.add(`${path}/children`, "CHILDREN_NOT_ARRAY", `${n.type} "children" must be an array`);
+        }
+        else {
+            n.children.forEach((child, i) => {
+                validateNodeInto(child, `${path}/children/${i}`, c);
+            });
+        }
+    }
+}
+function validateGrid(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.cols !== "number" || !Number.isInteger(props.cols)) {
+        c.add(`${path}/props/cols`, "PROPS_MISSING_REQUIRED", `grid requires "props.cols" to be an integer`);
+    }
+    else if (props.cols < 1 || props.cols > 12) {
+        c.add(`${path}/props/cols`, "PROPS_INVALID_VALUE", `grid "props.cols" must be between 1 and 12, got ${props.cols}`);
+    }
+    validateContainer(n, path, c);
+}
+function validateDivider(n, path, c) {
+    if ("children" in n) {
+        c.add(`${path}/children`, "CHILDREN_NOT_ALLOWED", `divider cannot have children`);
+    }
+}
+function validateRecordLine(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.variant !== "string") {
+        c.add(`${path}/props/variant`, "PROPS_MISSING_REQUIRED", `record-line requires "props.variant"`);
+    }
+    const bind = n.bind;
+    if (!bind || typeof bind.record !== "string") {
+        c.add(`${path}/bind/record`, "BIND_MISSING_REQUIRED", `record-line requires "bind.record" (a record id string)`);
+    }
+}
+function validateRecordLineList(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.variant !== "string") {
+        c.add(`${path}/props/variant`, "PROPS_MISSING_REQUIRED", `record-line-list requires "props.variant"`);
+    }
+    const bind = n.bind;
+    if (!bind) {
+        c.add(`${path}/bind`, "BIND_MISSING_REQUIRED", `record-line-list requires "bind.query" or "bind.items"`);
+        return;
+    }
+    const hasQuery = "query" in bind;
+    const hasItems = "items" in bind;
+    if (!hasQuery && !hasItems) {
+        c.add(`${path}/bind`, "BIND_INVALID_SHAPE", `record-line-list "bind" must contain either "query" or "items"`);
+    }
+    else if (hasQuery && hasItems) {
+        c.add(`${path}/bind`, "BIND_INVALID_SHAPE", `record-line-list "bind" cannot contain both "query" and "items"`);
+    }
+    else if (hasItems && !Array.isArray(bind.items)) {
+        c.add(`${path}/bind/items`, "BIND_INVALID_SHAPE", `record-line-list "bind.items" must be an array of record ids`);
+    }
+}
+function validateChip(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.label !== "string") {
+        c.add(`${path}/props/label`, "PROPS_MISSING_REQUIRED", `chip requires "props.label"`);
+    }
+}
+function validateHeading(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.level !== "number" || !Number.isInteger(props.level)) {
+        c.add(`${path}/props/level`, "PROPS_MISSING_REQUIRED", `heading requires "props.level" to be an integer`);
+    }
+    else if (props.level < 1 || props.level > 6) {
+        c.add(`${path}/props/level`, "PROPS_INVALID_VALUE", `heading "props.level" must be 1-6, got ${props.level}`);
+    }
+    if (typeof props.text !== "string") {
+        c.add(`${path}/props/text`, "PROPS_MISSING_REQUIRED", `heading requires "props.text"`);
+    }
+}
+function validateText(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.text !== "string") {
+        c.add(`${path}/props/text`, "PROPS_MISSING_REQUIRED", `text requires "props.text"`);
+    }
+}
+function validateStat(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.label !== "string") {
+        c.add(`${path}/props/label`, "PROPS_MISSING_REQUIRED", `stat requires "props.label"`);
+    }
+    if (typeof props.value !== "string" && typeof props.value !== "number") {
+        c.add(`${path}/props/value`, "PROPS_MISSING_REQUIRED", `stat requires "props.value" (string or number)`);
+    }
+}
+function validateKeyValue(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.label !== "string") {
+        c.add(`${path}/props/label`, "PROPS_MISSING_REQUIRED", `key-value requires "props.label"`);
+    }
+    if (typeof props.value !== "string") {
+        c.add(`${path}/props/value`, "PROPS_MISSING_REQUIRED", `key-value requires "props.value"`);
+    }
+}
+function validateButton(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.label !== "string") {
+        c.add(`${path}/props/label`, "PROPS_MISSING_REQUIRED", `button requires "props.label"`);
+    }
+}
+function validateIconButton(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.glyph !== "string") {
+        c.add(`${path}/props/glyph`, "PROPS_MISSING_REQUIRED", `icon-button requires "props.glyph" (Glyph kind string)`);
+    }
+    if (typeof props.ariaLabel !== "string" || props.ariaLabel.length === 0) {
+        c.add(`${path}/props/ariaLabel`, "PROPS_MISSING_REQUIRED", `icon-button requires a non-empty "props.ariaLabel" (WCAG 2.1 AA)`);
+    }
+}
+function validateCopyButton(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.value !== "string") {
+        c.add(`${path}/props/value`, "PROPS_MISSING_REQUIRED", `copy-button requires "props.value"`);
+    }
+}
+function validateSelect(n, path, c) {
+    const props = (n.props ?? {});
+    if (!Array.isArray(props.options)) {
+        c.add(`${path}/props/options`, "PROPS_MISSING_REQUIRED", `select requires "props.options" (array of {label, value})`);
+        return;
+    }
+    props.options.forEach((opt, i) => {
+        if (typeof opt !== "object" || opt === null) {
+            c.add(`${path}/props/options/${i}`, "PROPS_INVALID_VALUE", `select option must be an object`);
+            return;
+        }
+        const o = opt;
+        if (typeof o.label !== "string" || typeof o.value !== "string") {
+            c.add(`${path}/props/options/${i}`, "PROPS_INVALID_VALUE", `select option must have string "label" and "value"`);
+        }
+    });
+}
+function validateEmptyState(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.message !== "string") {
+        c.add(`${path}/props/message`, "PROPS_MISSING_REQUIRED", `empty-state requires "props.message"`);
+    }
+}
+function validateErrorState(n, path, c) {
+    const props = (n.props ?? {});
+    if (typeof props.message !== "string") {
+        c.add(`${path}/props/message`, "PROPS_MISSING_REQUIRED", `error-state requires "props.message"`);
+    }
+}
+function validateSkeleton(n, path, c) {
+    const props = (n.props ?? {});
+    if (props && typeof props.shape === "string") {
+        const allowed = ["rect", "circle", "text"];
+        if (!allowed.includes(props.shape)) {
+            c.add(`${path}/props/shape`, "PROPS_INVALID_VALUE", `skeleton "props.shape" must be one of ${allowed.join(" | ")}, got ${props.shape}`);
+        }
+        if (props.shape === "rect" &&
+            props.height === undefined) {
+            c.add(`${path}/props/height`, "PROPS_MISSING_REQUIRED", `skeleton shape='rect' requires "props.height"`);
+        }
+    }
+    // Returned silently — suppress unused-param warning
+    void n;
+}
+// ---------------------------------------------------------------------------
+// Helpers for library consumers
+// ---------------------------------------------------------------------------
+/**
+ * Type guard: true when `doc` is a well-formed SRP document.
+ * Useful in adapter code that receives untrusted JSON.
+ */
+export function isSRPDocument(doc) {
+    const result = validateSRP(doc);
+    return result.valid;
+}
+/**
+ * Type guard: true when `node` is a well-formed SRP node.
+ */
+export function isSRPNode(node) {
+    const result = validateNode(node, "");
+    return result.valid;
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runtime validators for SRP v0.1 documents.\n *\n * Pure functions — no dependencies. Return a ValidationResult with either a\n * `valid: true` flag or a list of errors keyed by path.\n */\n\nimport type { SRPDocument, SRPNode } from \"./schema.js\";\nimport { NODE_TYPES } from \"./schema.js\";\n\n// ---------------------------------------------------------------------------\n// Result types\n// ---------------------------------------------------------------------------\n\nexport interface ValidationError {\n  /** JSON-pointer-style path to the offending node, e.g. \"/root/children/0\". */\n  path: string;\n  /** Human-readable message. */\n  message: string;\n  /** Machine-readable code for programmatic handling. */\n  code: ValidationErrorCode;\n}\n\nexport type ValidationErrorCode =\n  | \"SRP_VERSION_INVALID\"\n  | \"ROOT_MISSING\"\n  | \"NODE_NOT_OBJECT\"\n  | \"NODE_TYPE_MISSING\"\n  | \"NODE_TYPE_UNKNOWN\"\n  | \"PROPS_MISSING_REQUIRED\"\n  | \"PROPS_INVALID_VALUE\"\n  | \"CHILDREN_NOT_ARRAY\"\n  | \"CHILDREN_NOT_ALLOWED\"\n  | \"BIND_MISSING_REQUIRED\"\n  | \"BIND_INVALID_SHAPE\";\n\nexport type ValidationResult =\n  | { valid: true }\n  | { valid: false; errors: ValidationError[] };\n\nclass Collector {\n  errors: ValidationError[] = [];\n  add(path: string, code: ValidationErrorCode, message: string): void {\n    this.errors.push({ path, code, message });\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Validate a full SRP document.\n *\n * Returns `{ valid: true }` when the document conforms to SRP v0.1.\n * Returns `{ valid: false, errors }` with every violation keyed by a\n * JSON-pointer-style path when it doesn't.\n */\nexport function validateSRP(doc: unknown): ValidationResult {\n  const c = new Collector();\n\n  if (typeof doc !== \"object\" || doc === null) {\n    c.add(\"\", \"NODE_NOT_OBJECT\", \"SRP document must be an object\");\n    return { valid: false, errors: c.errors };\n  }\n\n  const d = doc as Record<string, unknown>;\n\n  if (d.srp !== \"0.1\") {\n    c.add(\n      \"/srp\",\n      \"SRP_VERSION_INVALID\",\n      `srp field must be the exact string \"0.1\", got ${JSON.stringify(d.srp)}`,\n    );\n  }\n\n  if (!(\"root\" in d)) {\n    c.add(\"/root\", \"ROOT_MISSING\", \"SRP document must have a root node\");\n    return { valid: false, errors: c.errors };\n  }\n\n  validateNodeInto(d.root, \"/root\", c);\n\n  return c.errors.length === 0\n    ? { valid: true }\n    : { valid: false, errors: c.errors };\n}\n\n/**\n * Validate a single node (used internally and useful standalone for\n * incremental SRP authoring).\n */\nexport function validateNode(node: unknown, path: string): ValidationResult {\n  const c = new Collector();\n  validateNodeInto(node, path, c);\n  return c.errors.length === 0\n    ? { valid: true }\n    : { valid: false, errors: c.errors };\n}\n\nfunction validateNodeInto(\n  node: unknown,\n  path: string,\n  c: Collector,\n): void {\n  if (typeof node !== \"object\" || node === null) {\n    c.add(path, \"NODE_NOT_OBJECT\", `Node at ${path} must be an object`);\n    return;\n  }\n\n  const n = node as Record<string, unknown>;\n\n  if (typeof n.type !== \"string\") {\n    c.add(\n      `${path}/type`,\n      \"NODE_TYPE_MISSING\",\n      `Node at ${path} must have a string \"type\" field`,\n    );\n    return;\n  }\n\n  if (!(NODE_TYPES as readonly string[]).includes(n.type)) {\n    c.add(\n      `${path}/type`,\n      \"NODE_TYPE_UNKNOWN\",\n      `Unknown node type \"${n.type}\" at ${path}. Allowed: ${NODE_TYPES.join(\", \")}`,\n    );\n    return;\n  }\n\n  // Per-type validation dispatched below\n  switch (n.type) {\n    case \"column\":\n    case \"row\":\n    case \"card\":\n      validateContainer(n, path, c);\n      break;\n    case \"grid\":\n      validateGrid(n, path, c);\n      break;\n    case \"divider\":\n      validateDivider(n, path, c);\n      break;\n    case \"record-line\":\n      validateRecordLine(n, path, c);\n      break;\n    case \"record-line-list\":\n      validateRecordLineList(n, path, c);\n      break;\n    case \"chip\":\n      validateChip(n, path, c);\n      break;\n    case \"heading\":\n      validateHeading(n, path, c);\n      break;\n    case \"text\":\n      validateText(n, path, c);\n      break;\n    case \"stat\":\n      validateStat(n, path, c);\n      break;\n    case \"key-value\":\n      validateKeyValue(n, path, c);\n      break;\n    case \"button\":\n      validateButton(n, path, c);\n      break;\n    case \"icon-button\":\n      validateIconButton(n, path, c);\n      break;\n    case \"copy-button\":\n      validateCopyButton(n, path, c);\n      break;\n    case \"select\":\n      validateSelect(n, path, c);\n      break;\n    case \"empty-state\":\n      validateEmptyState(n, path, c);\n      break;\n    case \"error-state\":\n      validateErrorState(n, path, c);\n      break;\n    case \"skeleton\":\n      validateSkeleton(n, path, c);\n      break;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Per-node validators\n// ---------------------------------------------------------------------------\n\nfunction validateContainer(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  if (\"children\" in n && n.children !== undefined) {\n    if (!Array.isArray(n.children)) {\n      c.add(\n        `${path}/children`,\n        \"CHILDREN_NOT_ARRAY\",\n        `${n.type} \"children\" must be an array`,\n      );\n    } else {\n      n.children.forEach((child, i) => {\n        validateNodeInto(child, `${path}/children/${i}`, c);\n      });\n    }\n  }\n}\n\nfunction validateGrid(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.cols !== \"number\" || !Number.isInteger(props.cols)) {\n    c.add(\n      `${path}/props/cols`,\n      \"PROPS_MISSING_REQUIRED\",\n      `grid requires \"props.cols\" to be an integer`,\n    );\n  } else if (props.cols < 1 || props.cols > 12) {\n    c.add(\n      `${path}/props/cols`,\n      \"PROPS_INVALID_VALUE\",\n      `grid \"props.cols\" must be between 1 and 12, got ${props.cols}`,\n    );\n  }\n  validateContainer(n, path, c);\n}\n\nfunction validateDivider(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  if (\"children\" in n) {\n    c.add(\n      `${path}/children`,\n      \"CHILDREN_NOT_ALLOWED\",\n      `divider cannot have children`,\n    );\n  }\n}\n\nfunction validateRecordLine(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.variant !== \"string\") {\n    c.add(\n      `${path}/props/variant`,\n      \"PROPS_MISSING_REQUIRED\",\n      `record-line requires \"props.variant\"`,\n    );\n  }\n\n  const bind = n.bind as Record<string, unknown> | undefined;\n  if (!bind || typeof bind.record !== \"string\") {\n    c.add(\n      `${path}/bind/record`,\n      \"BIND_MISSING_REQUIRED\",\n      `record-line requires \"bind.record\" (a record id string)`,\n    );\n  }\n}\n\nfunction validateRecordLineList(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.variant !== \"string\") {\n    c.add(\n      `${path}/props/variant`,\n      \"PROPS_MISSING_REQUIRED\",\n      `record-line-list requires \"props.variant\"`,\n    );\n  }\n\n  const bind = n.bind as Record<string, unknown> | undefined;\n  if (!bind) {\n    c.add(\n      `${path}/bind`,\n      \"BIND_MISSING_REQUIRED\",\n      `record-line-list requires \"bind.query\" or \"bind.items\"`,\n    );\n    return;\n  }\n\n  const hasQuery = \"query\" in bind;\n  const hasItems = \"items\" in bind;\n  if (!hasQuery && !hasItems) {\n    c.add(\n      `${path}/bind`,\n      \"BIND_INVALID_SHAPE\",\n      `record-line-list \"bind\" must contain either \"query\" or \"items\"`,\n    );\n  } else if (hasQuery && hasItems) {\n    c.add(\n      `${path}/bind`,\n      \"BIND_INVALID_SHAPE\",\n      `record-line-list \"bind\" cannot contain both \"query\" and \"items\"`,\n    );\n  } else if (hasItems && !Array.isArray(bind.items)) {\n    c.add(\n      `${path}/bind/items`,\n      \"BIND_INVALID_SHAPE\",\n      `record-line-list \"bind.items\" must be an array of record ids`,\n    );\n  }\n}\n\nfunction validateChip(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.label !== \"string\") {\n    c.add(\n      `${path}/props/label`,\n      \"PROPS_MISSING_REQUIRED\",\n      `chip requires \"props.label\"`,\n    );\n  }\n}\n\nfunction validateHeading(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.level !== \"number\" || !Number.isInteger(props.level)) {\n    c.add(\n      `${path}/props/level`,\n      \"PROPS_MISSING_REQUIRED\",\n      `heading requires \"props.level\" to be an integer`,\n    );\n  } else if (props.level < 1 || props.level > 6) {\n    c.add(\n      `${path}/props/level`,\n      \"PROPS_INVALID_VALUE\",\n      `heading \"props.level\" must be 1-6, got ${props.level}`,\n    );\n  }\n  if (typeof props.text !== \"string\") {\n    c.add(\n      `${path}/props/text`,\n      \"PROPS_MISSING_REQUIRED\",\n      `heading requires \"props.text\"`,\n    );\n  }\n}\n\nfunction validateText(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.text !== \"string\") {\n    c.add(\n      `${path}/props/text`,\n      \"PROPS_MISSING_REQUIRED\",\n      `text requires \"props.text\"`,\n    );\n  }\n}\n\nfunction validateStat(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.label !== \"string\") {\n    c.add(\n      `${path}/props/label`,\n      \"PROPS_MISSING_REQUIRED\",\n      `stat requires \"props.label\"`,\n    );\n  }\n  if (typeof props.value !== \"string\" && typeof props.value !== \"number\") {\n    c.add(\n      `${path}/props/value`,\n      \"PROPS_MISSING_REQUIRED\",\n      `stat requires \"props.value\" (string or number)`,\n    );\n  }\n}\n\nfunction validateKeyValue(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.label !== \"string\") {\n    c.add(\n      `${path}/props/label`,\n      \"PROPS_MISSING_REQUIRED\",\n      `key-value requires \"props.label\"`,\n    );\n  }\n  if (typeof props.value !== \"string\") {\n    c.add(\n      `${path}/props/value`,\n      \"PROPS_MISSING_REQUIRED\",\n      `key-value requires \"props.value\"`,\n    );\n  }\n}\n\nfunction validateButton(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.label !== \"string\") {\n    c.add(\n      `${path}/props/label`,\n      \"PROPS_MISSING_REQUIRED\",\n      `button requires \"props.label\"`,\n    );\n  }\n}\n\nfunction validateIconButton(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.glyph !== \"string\") {\n    c.add(\n      `${path}/props/glyph`,\n      \"PROPS_MISSING_REQUIRED\",\n      `icon-button requires \"props.glyph\" (Glyph kind string)`,\n    );\n  }\n  if (typeof props.ariaLabel !== \"string\" || props.ariaLabel.length === 0) {\n    c.add(\n      `${path}/props/ariaLabel`,\n      \"PROPS_MISSING_REQUIRED\",\n      `icon-button requires a non-empty \"props.ariaLabel\" (WCAG 2.1 AA)`,\n    );\n  }\n}\n\nfunction validateCopyButton(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.value !== \"string\") {\n    c.add(\n      `${path}/props/value`,\n      \"PROPS_MISSING_REQUIRED\",\n      `copy-button requires \"props.value\"`,\n    );\n  }\n}\n\nfunction validateSelect(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (!Array.isArray(props.options)) {\n    c.add(\n      `${path}/props/options`,\n      \"PROPS_MISSING_REQUIRED\",\n      `select requires \"props.options\" (array of {label, value})`,\n    );\n    return;\n  }\n  props.options.forEach((opt, i) => {\n    if (typeof opt !== \"object\" || opt === null) {\n      c.add(\n        `${path}/props/options/${i}`,\n        \"PROPS_INVALID_VALUE\",\n        `select option must be an object`,\n      );\n      return;\n    }\n    const o = opt as Record<string, unknown>;\n    if (typeof o.label !== \"string\" || typeof o.value !== \"string\") {\n      c.add(\n        `${path}/props/options/${i}`,\n        \"PROPS_INVALID_VALUE\",\n        `select option must have string \"label\" and \"value\"`,\n      );\n    }\n  });\n}\n\nfunction validateEmptyState(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.message !== \"string\") {\n    c.add(\n      `${path}/props/message`,\n      \"PROPS_MISSING_REQUIRED\",\n      `empty-state requires \"props.message\"`,\n    );\n  }\n}\n\nfunction validateErrorState(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown>;\n  if (typeof props.message !== \"string\") {\n    c.add(\n      `${path}/props/message`,\n      \"PROPS_MISSING_REQUIRED\",\n      `error-state requires \"props.message\"`,\n    );\n  }\n}\n\nfunction validateSkeleton(\n  n: Record<string, unknown>,\n  path: string,\n  c: Collector,\n): void {\n  const props = (n.props ?? {}) as Record<string, unknown> | undefined;\n  if (props && typeof props.shape === \"string\") {\n    const allowed = [\"rect\", \"circle\", \"text\"];\n    if (!allowed.includes(props.shape)) {\n      c.add(\n        `${path}/props/shape`,\n        \"PROPS_INVALID_VALUE\",\n        `skeleton \"props.shape\" must be one of ${allowed.join(\" | \")}, got ${props.shape}`,\n      );\n    }\n    if (\n      props.shape === \"rect\" &&\n      props.height === undefined\n    ) {\n      c.add(\n        `${path}/props/height`,\n        \"PROPS_MISSING_REQUIRED\",\n        `skeleton shape='rect' requires \"props.height\"`,\n      );\n    }\n  }\n\n  // Returned silently — suppress unused-param warning\n  void n;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers for library consumers\n// ---------------------------------------------------------------------------\n\n/**\n * Type guard: true when `doc` is a well-formed SRP document.\n * Useful in adapter code that receives untrusted JSON.\n */\nexport function isSRPDocument(doc: unknown): doc is SRPDocument {\n  const result = validateSRP(doc);\n  return result.valid;\n}\n\n/**\n * Type guard: true when `node` is a well-formed SRP node.\n */\nexport function isSRPNode(node: unknown): node is SRPNode {\n  const result = validateNode(node, \"\");\n  return result.valid;\n}\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@syncropel/projections",
+  "version": "0.1.0",
+  "description": "TypeScript schema + validators for the Syncropel Rendering Protocol (SRP v0.1) — declarative UI documents for query-driven and AI-generated interfaces.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test tests/*.test.ts",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "syncropel",
+    "projections",
+    "srp",
+    "schema",
+    "declarative-ui"
+  ],
+  "license": "Apache-2.0",
+  "author": "Syncropic, Inc. <hello@syncropic.com>",
+  "homepage": "https://syncropel.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/syncropic/syncropel-core.git",
+    "directory": "sdks/typescript-projections"
+  },
+  "bugs": {
+    "url": "https://github.com/syncropic/syncropel-core/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.0"
+  }
+}