@loomwork/blueprint-runtime 0.0.0-stage → 0.1.0

package/dist/widgets.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricCard = MetricCard;
+exports.Timeline = Timeline;
+exports.ApprovalCard = ApprovalCard;
+exports.StatusBadge = StatusBadge;
+exports.ProgressBar = ProgressBar;
+exports.DataTable = DataTable;
+exports.AlertCard = AlertCard;
+exports.StreamingText = StreamingText;
+// A derived id, used when the caller supplies none. It is an IDENTITY, not a
+// content address: a 32-bit non-cryptographic hash, scoped to one blueprint.
+// Never treat it as an audit anchor for "which view was this" — use a real digest
+// (`contentAddress` in @loomwork/plugin-content) for that.
+//
+// Because it is derived from the props, it CHANGES when any prop changes. That is
+// correct for a view that is authored once and wrong for one a composer revises,
+// which is why every builder accepts an explicit `id`.
+function stableId(kind, props) {
+    const str = kind + JSON.stringify(props, Object.keys(props).sort());
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        hash = (Math.imul(31, hash) + str.charCodeAt(i)) | 0;
+    }
+    return `${kind}-${(hash >>> 0).toString(16)}`;
+}
+function MetricCard(props) {
+    const { title, id, ...rest } = props;
+    return {
+        _tag: "Widget",
+        id: id ?? stableId("MetricCard", props),
+        kind: "MetricCard",
+        title,
+        props: rest,
+        binding: props.binding,
+    };
+}
+function Timeline(props) {
+    const { title, id, ...rest } = props;
+    return {
+        _tag: "Widget",
+        id: id ?? stableId("Timeline", props),
+        kind: "Timeline",
+        ...(title !== undefined && { title }),
+        props: rest,
+        binding: props.binding,
+    };
+}
+function ApprovalCard(props) {
+    const { title, id, ...rest } = props;
+    return {
+        _tag: "Widget",
+        id: id ?? stableId("ApprovalCard", props),
+        kind: "ApprovalCard",
+        title,
+        props: rest,
+        binding: props.binding,
+    };
+}
+function StatusBadge(props) {
+    const { title, id, ...rest } = props;
+    return {
+        _tag: "Widget",
+        id: id ?? stableId("StatusBadge", props),
+        kind: "StatusBadge",
+        ...(title !== undefined && { title }),
+        props: rest,
+        binding: props.binding,
+    };
+}
+function ProgressBar(props) {
+    const { title, id, ...rest } = props;
+    return {
+        _tag: "Widget",
+        id: id ?? stableId("ProgressBar", props),
+        kind: "ProgressBar",
+        ...(title !== undefined && { title }),
+        props: rest,
+        binding: props.binding,
+    };
+}
+function DataTable(props) {
+    const { title, id, ...rest } = props;
+    return {
+        _tag: "Widget",
+        id: id ?? stableId("DataTable", props),
+        kind: "DataTable",
+        ...(title !== undefined && { title }),
+        props: rest,
+        binding: props.binding,
+    };
+}
+function AlertCard(props) {
+    const { title, id, ...rest } = props;
+    return {
+        _tag: "Widget",
+        id: id ?? stableId("AlertCard", props),
+        kind: "AlertCard",
+        ...(title !== undefined && { title }),
+        props: rest,
+        binding: props.binding,
+    };
+}
+function StreamingText(props) {
+    const { title, id, ...rest } = props;
+    return {
+        _tag: "Widget",
+        id: id ?? stableId("StreamingText", props),
+        kind: "StreamingText",
+        ...(title !== undefined && { title }),
+        props: rest,
+        binding: props.binding,
+    };
+}
+//# sourceMappingURL=widgets.js.map

package/dist/widgets.js.map

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

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@loomwork/blueprint-runtime",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Schema-driven UI blueprint generation — pure JSON-serializable types",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/esm/index.js",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "node": "./dist/index.js",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@loomwork/core": "^0.1.0",
+    "@loomwork/scheduler": "^0.1.0",
+    "@loomwork/classify": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chhetrisushil/loom.git",
+    "directory": "packages/blueprint-runtime"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "!src/**/__fixtures__",
+    "!src/**/__snapshots__",
+    "!src/**/__golden__",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build && rm -rf dist/esm && tsc -p tsconfig.esm.json",
+    "build:esm": "rm -rf dist/esm && tsc -p tsconfig.esm.json",
+    "dev": "tsc --build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "bench": "vitest bench --run",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck:tests": "tsc -p tsconfig.test.json"
+  }
 }

package/src/Blueprint.ts

@@ -0,0 +1,28 @@
+import { BLUEPRINT_IR_VERSION } from "./irVersion";
+import type { Blueprint, Layout } from "./types";
+
+export interface BlueprintConfig {
+  id: string;
+  title: string;
+  layout: Layout;
+  projections: string[];
+  /**
+   * ADR 0095 — the declared versions of the projections this view binds to, at composition.
+   * `projectionRuntime.pins()` is where they come from. See {@link Blueprint.projectionVersions}.
+   */
+  projectionVersions?: Readonly<Record<string, string>>;
+}
+
+export function blueprint$(config: BlueprintConfig): Blueprint {
+  return {
+    _tag: "Blueprint",
+    irVersion: BLUEPRINT_IR_VERSION,
+    id: config.id,
+    title: config.title,
+    layout: config.layout,
+    projections: config.projections,
+    ...(config.projectionVersions !== undefined && {
+      projectionVersions: config.projectionVersions,
+    }),
+  };
+}

package/src/RendererRegistry.ts

@@ -0,0 +1,38 @@
+// Generic widget registry — framework-agnostic.
+// TRenderer is narrowed by each framework adapter:
+//   React:   RendererRegistry<React.FC<WidgetRendererProps>>
+//   Angular: RendererRegistry<Type<unknown>>
+//   DOM:     RendererRegistry<(el: HTMLElement, props: WidgetRendererProps) => void>
+
+export class RendererRegistry<TRenderer> {
+  private readonly renderers = new Map<string, TRenderer>();
+
+  register(kind: string, renderer: TRenderer): this {
+    this.renderers.set(kind, renderer);
+    return this;
+  }
+
+  get(kind: string): TRenderer | undefined {
+    return this.renderers.get(kind);
+  }
+
+  has(kind: string): boolean {
+    return this.renderers.has(kind);
+  }
+
+  kinds(): string[] {
+    return Array.from(this.renderers.keys());
+  }
+
+  // Returns a new registry that contains all renderers from both registries.
+  // Entries in `other` win on conflicts.
+  merge(other: RendererRegistry<TRenderer>): RendererRegistry<TRenderer> {
+    const merged = new RendererRegistry<TRenderer>();
+    for (const [kind, r] of this.renderers) merged.register(kind, r);
+    for (const kind of other.kinds()) {
+      const r = other.get(kind);
+      if (r !== undefined) merged.register(kind, r);
+    }
+    return merged;
+  }
+}