@typicalday/firegraph 0.1.0

package/dist/react.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react.ts
+var react_exports = {};
+__export(react_exports, {
+  wrapReact: () => wrapReact
+});
+module.exports = __toCommonJS(react_exports);
+function getBaseClass() {
+  const g = globalThis;
+  return g.HTMLElement ?? class {
+  };
+}
+function wrapReact(Component, meta) {
+  let React = null;
+  let ReactDOM = null;
+  let loaded = false;
+  async function ensureReact() {
+    if (loaded) return;
+    const [r, rd] = await Promise.all([
+      Function('return import("react")')(),
+      Function('return import("react-dom/client")')()
+    ]);
+    React = r;
+    ReactDOM = rd;
+    loaded = true;
+  }
+  const Base = getBaseClass();
+  const Cls = class extends Base {
+    static viewName = meta.viewName;
+    static description = meta.description;
+    _data = {};
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _root = null;
+    _mounted = false;
+    set data(v) {
+      this._data = v;
+      this._render();
+    }
+    get data() {
+      return this._data;
+    }
+    connectedCallback() {
+      this._mounted = true;
+      this._render();
+    }
+    disconnectedCallback() {
+      this._mounted = false;
+      this._root?.unmount();
+      this._root = null;
+    }
+    async _render() {
+      if (!this._mounted) return;
+      await ensureReact();
+      if (!this._mounted) return;
+      if (!this._root) {
+        this._root = ReactDOM.createRoot(this);
+      }
+      this._root.render(React.createElement(Component, { data: this._data }));
+    }
+  };
+  return Cls;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  wrapReact
+});
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React adapter for firegraph views.\n *\n * Wraps a React function component into a Web Component (HTMLElement) that\n * satisfies the firegraph `ViewComponentClass` contract. Import from\n * `firegraph/react`:\n *\n * @example\n * ```tsx\n * import { wrapReact } from 'firegraph/react';\n *\n * const TaskCard = wrapReact(({ data }) => (\n *   <div style={{ padding: 12 }}>\n *     <strong>{String(data.title ?? '')}</strong>\n *   </div>\n * ), { viewName: 'card', description: 'Compact task card' });\n *\n * export default [TaskCard];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n/** A React function component that receives entity data. */\nexport type ReactViewComponent = (props: { data: Record<string, unknown> }) => unknown;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a React function component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `react` and\n * `react-dom/client` at render time. React is resolved from the project's\n * own `node_modules` — firegraph does not bundle or depend on React itself.\n */\nexport function wrapReact(\n  Component: ReactViewComponent,\n  meta: ViewMeta,\n): ViewComponentClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let React: any = null;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let ReactDOM: any = null;\n  let loaded = false;\n\n  async function ensureReact() {\n    if (loaded) return;\n    // Dynamic imports — resolved from project's node_modules at runtime\n    const [r, rd] = await Promise.all([\n      Function('return import(\"react\")')() as Promise<unknown>,\n      Function('return import(\"react-dom/client\")')() as Promise<unknown>,\n    ]);\n    React = r;\n    ReactDOM = rd;\n    loaded = true;\n  }\n\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _root: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      this._render();\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._render();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      this._root?.unmount();\n      this._root = null;\n    }\n\n    async _render() {\n      if (!this._mounted) return;\n      await ensureReact();\n      if (!this._mounted) return; // may have disconnected while awaiting\n\n      if (!this._root) {\n        this._root = ReactDOM.createRoot(this);\n      }\n      this._root.render(React.createElement(Component, { data: this._data }));\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA0CA,SAAS,eAAyB;AAEhC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AASO,SAAS,UACd,WACA,MACoB;AAEpB,MAAI,QAAa;AAEjB,MAAI,WAAgB;AACpB,MAAI,SAAS;AAEb,iBAAe,cAAc;AAC3B,QAAI,OAAQ;AAEZ,UAAM,CAAC,GAAG,EAAE,IAAI,MAAM,QAAQ,IAAI;AAAA,MAChC,SAAS,wBAAwB,EAAE;AAAA,MACnC,SAAS,mCAAmC,EAAE;AAAA,IAChD,CAAC;AACD,YAAQ;AACR,eAAW;AACX,aAAS;AAAA,EACX;AAEA,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA;AAAA,IAElC,QAAa;AAAA,IACb,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,WAAK,OAAO,QAAQ;AACpB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,MAAM,UAAU;AACd,UAAI,CAAC,KAAK,SAAU;AACpB,YAAM,YAAY;AAClB,UAAI,CAAC,KAAK,SAAU;AAEpB,UAAI,CAAC,KAAK,OAAO;AACf,aAAK,QAAQ,SAAS,WAAW,IAAI;AAAA,MACvC;AACA,WAAK,MAAM,OAAO,MAAM,cAAc,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACxE;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/react.d.cts

@@ -0,0 +1,44 @@
+import { V as ViewComponentClass } from './views-DL60k0cf.cjs';
+
+/**
+ * React adapter for firegraph views.
+ *
+ * Wraps a React function component into a Web Component (HTMLElement) that
+ * satisfies the firegraph `ViewComponentClass` contract. Import from
+ * `firegraph/react`:
+ *
+ * @example
+ * ```tsx
+ * import { wrapReact } from 'firegraph/react';
+ *
+ * const TaskCard = wrapReact(({ data }) => (
+ *   <div style={{ padding: 12 }}>
+ *     <strong>{String(data.title ?? '')}</strong>
+ *   </div>
+ * ), { viewName: 'card', description: 'Compact task card' });
+ *
+ * export default [TaskCard];
+ * ```
+ */
+
+/** Metadata required for every firegraph view. */
+interface ViewMeta {
+    /** Short identifier (e.g. 'card', 'detail'). */
+    viewName: string;
+    /** Optional human-readable description. */
+    description?: string;
+}
+/** A React function component that receives entity data. */
+type ReactViewComponent = (props: {
+    data: Record<string, unknown>;
+}) => unknown;
+/**
+ * Wrap a React function component into a firegraph `ViewComponentClass`.
+ *
+ * The returned class extends `HTMLElement` and lazily imports `react` and
+ * `react-dom/client` at render time. React is resolved from the project's
+ * own `node_modules` — firegraph does not bundle or depend on React itself.
+ */
+declare function wrapReact(Component: ReactViewComponent, meta: ViewMeta): ViewComponentClass;
+
+export { type ReactViewComponent, type ViewMeta, wrapReact };

package/dist/react.d.ts

@@ -0,0 +1,44 @@
+import { V as ViewComponentClass } from './views-DL60k0cf.js';
+
+/**
+ * React adapter for firegraph views.
+ *
+ * Wraps a React function component into a Web Component (HTMLElement) that
+ * satisfies the firegraph `ViewComponentClass` contract. Import from
+ * `firegraph/react`:
+ *
+ * @example
+ * ```tsx
+ * import { wrapReact } from 'firegraph/react';
+ *
+ * const TaskCard = wrapReact(({ data }) => (
+ *   <div style={{ padding: 12 }}>
+ *     <strong>{String(data.title ?? '')}</strong>
+ *   </div>
+ * ), { viewName: 'card', description: 'Compact task card' });
+ *
+ * export default [TaskCard];
+ * ```
+ */
+
+/** Metadata required for every firegraph view. */
+interface ViewMeta {
+    /** Short identifier (e.g. 'card', 'detail'). */
+    viewName: string;
+    /** Optional human-readable description. */
+    description?: string;
+}
+/** A React function component that receives entity data. */
+type ReactViewComponent = (props: {
+    data: Record<string, unknown>;
+}) => unknown;
+/**
+ * Wrap a React function component into a firegraph `ViewComponentClass`.
+ *
+ * The returned class extends `HTMLElement` and lazily imports `react` and
+ * `react-dom/client` at render time. React is resolved from the project's
+ * own `node_modules` — firegraph does not bundle or depend on React itself.
+ */
+declare function wrapReact(Component: ReactViewComponent, meta: ViewMeta): ViewComponentClass;
+
+export { type ReactViewComponent, type ViewMeta, wrapReact };

package/dist/react.js

@@ -0,0 +1,60 @@
+// src/react.ts
+function getBaseClass() {
+  const g = globalThis;
+  return g.HTMLElement ?? class {
+  };
+}
+function wrapReact(Component, meta) {
+  let React = null;
+  let ReactDOM = null;
+  let loaded = false;
+  async function ensureReact() {
+    if (loaded) return;
+    const [r, rd] = await Promise.all([
+      Function('return import("react")')(),
+      Function('return import("react-dom/client")')()
+    ]);
+    React = r;
+    ReactDOM = rd;
+    loaded = true;
+  }
+  const Base = getBaseClass();
+  const Cls = class extends Base {
+    static viewName = meta.viewName;
+    static description = meta.description;
+    _data = {};
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _root = null;
+    _mounted = false;
+    set data(v) {
+      this._data = v;
+      this._render();
+    }
+    get data() {
+      return this._data;
+    }
+    connectedCallback() {
+      this._mounted = true;
+      this._render();
+    }
+    disconnectedCallback() {
+      this._mounted = false;
+      this._root?.unmount();
+      this._root = null;
+    }
+    async _render() {
+      if (!this._mounted) return;
+      await ensureReact();
+      if (!this._mounted) return;
+      if (!this._root) {
+        this._root = ReactDOM.createRoot(this);
+      }
+      this._root.render(React.createElement(Component, { data: this._data }));
+    }
+  };
+  return Cls;
+}
+export {
+  wrapReact
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React adapter for firegraph views.\n *\n * Wraps a React function component into a Web Component (HTMLElement) that\n * satisfies the firegraph `ViewComponentClass` contract. Import from\n * `firegraph/react`:\n *\n * @example\n * ```tsx\n * import { wrapReact } from 'firegraph/react';\n *\n * const TaskCard = wrapReact(({ data }) => (\n *   <div style={{ padding: 12 }}>\n *     <strong>{String(data.title ?? '')}</strong>\n *   </div>\n * ), { viewName: 'card', description: 'Compact task card' });\n *\n * export default [TaskCard];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n/** A React function component that receives entity data. */\nexport type ReactViewComponent = (props: { data: Record<string, unknown> }) => unknown;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a React function component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `react` and\n * `react-dom/client` at render time. React is resolved from the project's\n * own `node_modules` — firegraph does not bundle or depend on React itself.\n */\nexport function wrapReact(\n  Component: ReactViewComponent,\n  meta: ViewMeta,\n): ViewComponentClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let React: any = null;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let ReactDOM: any = null;\n  let loaded = false;\n\n  async function ensureReact() {\n    if (loaded) return;\n    // Dynamic imports — resolved from project's node_modules at runtime\n    const [r, rd] = await Promise.all([\n      Function('return import(\"react\")')() as Promise<unknown>,\n      Function('return import(\"react-dom/client\")')() as Promise<unknown>,\n    ]);\n    React = r;\n    ReactDOM = rd;\n    loaded = true;\n  }\n\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _root: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      this._render();\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._render();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      this._root?.unmount();\n      this._root = null;\n    }\n\n    async _render() {\n      if (!this._mounted) return;\n      await ensureReact();\n      if (!this._mounted) return; // may have disconnected while awaiting\n\n      if (!this._root) {\n        this._root = ReactDOM.createRoot(this);\n      }\n      this._root.render(React.createElement(Component, { data: this._data }));\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";AA0CA,SAAS,eAAyB;AAEhC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AASO,SAAS,UACd,WACA,MACoB;AAEpB,MAAI,QAAa;AAEjB,MAAI,WAAgB;AACpB,MAAI,SAAS;AAEb,iBAAe,cAAc;AAC3B,QAAI,OAAQ;AAEZ,UAAM,CAAC,GAAG,EAAE,IAAI,MAAM,QAAQ,IAAI;AAAA,MAChC,SAAS,wBAAwB,EAAE;AAAA,MACnC,SAAS,mCAAmC,EAAE;AAAA,IAChD,CAAC;AACD,YAAQ;AACR,eAAW;AACX,aAAS;AAAA,EACX;AAEA,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA;AAAA,IAElC,QAAa;AAAA,IACb,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,WAAK,OAAO,QAAQ;AACpB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,MAAM,UAAU;AACd,UAAI,CAAC,KAAK,SAAU;AACpB,YAAM,YAAY;AAClB,UAAI,CAAC,KAAK,SAAU;AAEpB,UAAI,CAAC,KAAK,OAAO;AACf,aAAK,QAAQ,SAAS,WAAW,IAAI;AAAA,MACvC;AACA,WAAK,MAAM,OAAO,MAAM,cAAc,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACxE;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/svelte.cjs

@@ -0,0 +1,90 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/svelte.ts
+var svelte_exports = {};
+__export(svelte_exports, {
+  wrapSvelte: () => wrapSvelte
+});
+module.exports = __toCommonJS(svelte_exports);
+function getBaseClass() {
+  const g = globalThis;
+  return g.HTMLElement ?? class {
+  };
+}
+function wrapSvelte(Component, meta) {
+  const Base = getBaseClass();
+  const Cls = class extends Base {
+    static viewName = meta.viewName;
+    static description = meta.description;
+    _data = {};
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _instance = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _props = null;
+    _mounted = false;
+    set data(v) {
+      this._data = v;
+      if (this._props) {
+        this._props.data = v;
+      } else if (this._mounted) {
+        this._mount();
+      }
+    }
+    get data() {
+      return this._data;
+    }
+    connectedCallback() {
+      this._mounted = true;
+      this._mount();
+    }
+    disconnectedCallback() {
+      this._mounted = false;
+      if (this._instance) {
+        Function('return import("svelte")')().then(
+          ({ unmount }) => {
+            if (this._instance) {
+              unmount(this._instance);
+              this._instance = null;
+              this._props = null;
+            }
+          }
+        );
+      }
+    }
+    async _mount() {
+      const svelte = await Function('return import("svelte")')();
+      if (!this._mounted) return;
+      if (this._instance) {
+        svelte.unmount(this._instance);
+      }
+      this._props = { data: this._data };
+      this._instance = svelte.mount(Component, {
+        target: this,
+        props: this._props
+      });
+    }
+  };
+  return Cls;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  wrapSvelte
+});
+//# sourceMappingURL=svelte.cjs.map

package/dist/svelte.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/svelte.ts"],"sourcesContent":["/**\n * Svelte 5 adapter for firegraph views.\n *\n * Wraps a Svelte component into a Web Component (HTMLElement) that satisfies\n * the firegraph `ViewComponentClass` contract. Import from `firegraph/svelte`:\n *\n * @example\n * ```ts\n * import { wrapSvelte } from 'firegraph/svelte';\n * import TaskCard from './TaskCard.svelte';\n *\n * export default [\n *   wrapSvelte(TaskCard, { viewName: 'card', description: 'Compact task card' }),\n * ];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a Svelte 5 component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `svelte` at\n * mount time. Svelte is resolved from the project's own `node_modules` —\n * firegraph does not bundle or depend on Svelte itself.\n *\n * The Svelte component should accept a `data` prop:\n * ```svelte\n * <script>\n *   let { data } = $props();\n * </script>\n * ```\n *\n * Props are updated by mutating the props object — Svelte 5's reactivity\n * system picks up the changes automatically.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function wrapSvelte(Component: any, meta: ViewMeta): ViewComponentClass {\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _instance: any = null;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _props: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      if (this._props) {\n        // Svelte 5: mutating the props object triggers reactivity\n        this._props.data = v;\n      } else if (this._mounted) {\n        this._mount();\n      }\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._mount();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      if (this._instance) {\n        // Dynamic import — resolved from project's node_modules at runtime\n        (Function('return import(\"svelte\")')() as Promise<{ unmount: Function }>).then(\n          ({ unmount }) => {\n            if (this._instance) {\n              unmount(this._instance);\n              this._instance = null;\n              this._props = null;\n            }\n          },\n        );\n      }\n    }\n\n    async _mount() {\n      // Dynamic import — resolved from project's node_modules at runtime\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const svelte: any = await (Function('return import(\"svelte\")')() as Promise<unknown>);\n      if (!this._mounted) return; // disconnected while awaiting\n\n      // Clean up previous instance\n      if (this._instance) {\n        svelte.unmount(this._instance);\n      }\n\n      // Svelte 5: pass a props object — mutating it later triggers re-renders\n      this._props = { data: this._data };\n      this._instance = svelte.mount(Component, {\n        target: this,\n        props: this._props,\n      });\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCA,SAAS,eAAyB;AAEhC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AAoBO,SAAS,WAAW,WAAgB,MAAoC;AAC7E,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA;AAAA,IAElC,YAAiB;AAAA;AAAA,IAEjB,SAAc;AAAA,IACd,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,UAAI,KAAK,QAAQ;AAEf,aAAK,OAAO,OAAO;AAAA,MACrB,WAAW,KAAK,UAAU;AACxB,aAAK,OAAO;AAAA,MACd;AAAA,IACF;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,OAAO;AAAA,IACd;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,UAAI,KAAK,WAAW;AAElB,QAAC,SAAS,yBAAyB,EAAE,EAAqC;AAAA,UACxE,CAAC,EAAE,QAAQ,MAAM;AACf,gBAAI,KAAK,WAAW;AAClB,sBAAQ,KAAK,SAAS;AACtB,mBAAK,YAAY;AACjB,mBAAK,SAAS;AAAA,YAChB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,SAAS;AAGb,YAAM,SAAc,MAAO,SAAS,yBAAyB,EAAE;AAC/D,UAAI,CAAC,KAAK,SAAU;AAGpB,UAAI,KAAK,WAAW;AAClB,eAAO,QAAQ,KAAK,SAAS;AAAA,MAC/B;AAGA,WAAK,SAAS,EAAE,MAAM,KAAK,MAAM;AACjC,WAAK,YAAY,OAAO,MAAM,WAAW;AAAA,QACvC,QAAQ;AAAA,QACR,OAAO,KAAK;AAAA,MACd,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/svelte.d.cts

@@ -0,0 +1,46 @@
+import { V as ViewComponentClass } from './views-DL60k0cf.cjs';
+
+/**
+ * Svelte 5 adapter for firegraph views.
+ *
+ * Wraps a Svelte component into a Web Component (HTMLElement) that satisfies
+ * the firegraph `ViewComponentClass` contract. Import from `firegraph/svelte`:
+ *
+ * @example
+ * ```ts
+ * import { wrapSvelte } from 'firegraph/svelte';
+ * import TaskCard from './TaskCard.svelte';
+ *
+ * export default [
+ *   wrapSvelte(TaskCard, { viewName: 'card', description: 'Compact task card' }),
+ * ];
+ * ```
+ */
+
+/** Metadata required for every firegraph view. */
+interface ViewMeta {
+    /** Short identifier (e.g. 'card', 'detail'). */
+    viewName: string;
+    /** Optional human-readable description. */
+    description?: string;
+}
+/**
+ * Wrap a Svelte 5 component into a firegraph `ViewComponentClass`.
+ *
+ * The returned class extends `HTMLElement` and lazily imports `svelte` at
+ * mount time. Svelte is resolved from the project's own `node_modules` —
+ * firegraph does not bundle or depend on Svelte itself.
+ *
+ * The Svelte component should accept a `data` prop:
+ * ```svelte
+ * <script>
+ *   let { data } = $props();
+ * </script>
+ * ```
+ *
+ * Props are updated by mutating the props object — Svelte 5's reactivity
+ * system picks up the changes automatically.
+ */
+declare function wrapSvelte(Component: any, meta: ViewMeta): ViewComponentClass;
+
+export { type ViewMeta, wrapSvelte };

package/dist/svelte.d.ts

@@ -0,0 +1,46 @@
+import { V as ViewComponentClass } from './views-DL60k0cf.js';
+
+/**
+ * Svelte 5 adapter for firegraph views.
+ *
+ * Wraps a Svelte component into a Web Component (HTMLElement) that satisfies
+ * the firegraph `ViewComponentClass` contract. Import from `firegraph/svelte`:
+ *
+ * @example
+ * ```ts
+ * import { wrapSvelte } from 'firegraph/svelte';
+ * import TaskCard from './TaskCard.svelte';
+ *
+ * export default [
+ *   wrapSvelte(TaskCard, { viewName: 'card', description: 'Compact task card' }),
+ * ];
+ * ```
+ */
+
+/** Metadata required for every firegraph view. */
+interface ViewMeta {
+    /** Short identifier (e.g. 'card', 'detail'). */
+    viewName: string;
+    /** Optional human-readable description. */
+    description?: string;
+}
+/**
+ * Wrap a Svelte 5 component into a firegraph `ViewComponentClass`.
+ *
+ * The returned class extends `HTMLElement` and lazily imports `svelte` at
+ * mount time. Svelte is resolved from the project's own `node_modules` —
+ * firegraph does not bundle or depend on Svelte itself.
+ *
+ * The Svelte component should accept a `data` prop:
+ * ```svelte
+ * <script>
+ *   let { data } = $props();
+ * </script>
+ * ```
+ *
+ * Props are updated by mutating the props object — Svelte 5's reactivity
+ * system picks up the changes automatically.
+ */
+declare function wrapSvelte(Component: any, meta: ViewMeta): ViewComponentClass;
+
+export { type ViewMeta, wrapSvelte };

package/dist/svelte.js

@@ -0,0 +1,65 @@
+// src/svelte.ts
+function getBaseClass() {
+  const g = globalThis;
+  return g.HTMLElement ?? class {
+  };
+}
+function wrapSvelte(Component, meta) {
+  const Base = getBaseClass();
+  const Cls = class extends Base {
+    static viewName = meta.viewName;
+    static description = meta.description;
+    _data = {};
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _instance = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _props = null;
+    _mounted = false;
+    set data(v) {
+      this._data = v;
+      if (this._props) {
+        this._props.data = v;
+      } else if (this._mounted) {
+        this._mount();
+      }
+    }
+    get data() {
+      return this._data;
+    }
+    connectedCallback() {
+      this._mounted = true;
+      this._mount();
+    }
+    disconnectedCallback() {
+      this._mounted = false;
+      if (this._instance) {
+        Function('return import("svelte")')().then(
+          ({ unmount }) => {
+            if (this._instance) {
+              unmount(this._instance);
+              this._instance = null;
+              this._props = null;
+            }
+          }
+        );
+      }
+    }
+    async _mount() {
+      const svelte = await Function('return import("svelte")')();
+      if (!this._mounted) return;
+      if (this._instance) {
+        svelte.unmount(this._instance);
+      }
+      this._props = { data: this._data };
+      this._instance = svelte.mount(Component, {
+        target: this,
+        props: this._props
+      });
+    }
+  };
+  return Cls;
+}
+export {
+  wrapSvelte
+};
+//# sourceMappingURL=svelte.js.map

package/dist/svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/svelte.ts"],"sourcesContent":["/**\n * Svelte 5 adapter for firegraph views.\n *\n * Wraps a Svelte component into a Web Component (HTMLElement) that satisfies\n * the firegraph `ViewComponentClass` contract. Import from `firegraph/svelte`:\n *\n * @example\n * ```ts\n * import { wrapSvelte } from 'firegraph/svelte';\n * import TaskCard from './TaskCard.svelte';\n *\n * export default [\n *   wrapSvelte(TaskCard, { viewName: 'card', description: 'Compact task card' }),\n * ];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a Svelte 5 component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `svelte` at\n * mount time. Svelte is resolved from the project's own `node_modules` —\n * firegraph does not bundle or depend on Svelte itself.\n *\n * The Svelte component should accept a `data` prop:\n * ```svelte\n * <script>\n *   let { data } = $props();\n * </script>\n * ```\n *\n * Props are updated by mutating the props object — Svelte 5's reactivity\n * system picks up the changes automatically.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function wrapSvelte(Component: any, meta: ViewMeta): ViewComponentClass {\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _instance: any = null;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _props: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      if (this._props) {\n        // Svelte 5: mutating the props object triggers reactivity\n        this._props.data = v;\n      } else if (this._mounted) {\n        this._mount();\n      }\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._mount();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      if (this._instance) {\n        // Dynamic import — resolved from project's node_modules at runtime\n        (Function('return import(\"svelte\")')() as Promise<{ unmount: Function }>).then(\n          ({ unmount }) => {\n            if (this._instance) {\n              unmount(this._instance);\n              this._instance = null;\n              this._props = null;\n            }\n          },\n        );\n      }\n    }\n\n    async _mount() {\n      // Dynamic import — resolved from project's node_modules at runtime\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const svelte: any = await (Function('return import(\"svelte\")')() as Promise<unknown>);\n      if (!this._mounted) return; // disconnected while awaiting\n\n      // Clean up previous instance\n      if (this._instance) {\n        svelte.unmount(this._instance);\n      }\n\n      // Svelte 5: pass a props object — mutating it later triggers re-renders\n      this._props = { data: this._data };\n      this._instance = svelte.mount(Component, {\n        target: this,\n        props: this._props,\n      });\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";AAmCA,SAAS,eAAyB;AAEhC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AAoBO,SAAS,WAAW,WAAgB,MAAoC;AAC7E,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA;AAAA,IAElC,YAAiB;AAAA;AAAA,IAEjB,SAAc;AAAA,IACd,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,UAAI,KAAK,QAAQ;AAEf,aAAK,OAAO,OAAO;AAAA,MACrB,WAAW,KAAK,UAAU;AACxB,aAAK,OAAO;AAAA,MACd;AAAA,IACF;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,OAAO;AAAA,IACd;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,UAAI,KAAK,WAAW;AAElB,QAAC,SAAS,yBAAyB,EAAE,EAAqC;AAAA,UACxE,CAAC,EAAE,QAAQ,MAAM;AACf,gBAAI,KAAK,WAAW;AAClB,sBAAQ,KAAK,SAAS;AACtB,mBAAK,YAAY;AACjB,mBAAK,SAAS;AAAA,YAChB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,SAAS;AAGb,YAAM,SAAc,MAAO,SAAS,yBAAyB,EAAE;AAC/D,UAAI,CAAC,KAAK,SAAU;AAGpB,UAAI,KAAK,WAAW;AAClB,eAAO,QAAQ,KAAK,SAAS;AAAA,MAC/B;AAGA,WAAK,SAAS,EAAE,MAAM,KAAK,MAAM;AACjC,WAAK,YAAY,OAAO,MAAM,WAAW;AAAA,QACvC,QAAQ;AAAA,QACR,OAAO,KAAK;AAAA,MACd,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/views-DL60k0cf.d.cts

@@ -0,0 +1,91 @@
+/**
+ * Model Views — framework-agnostic view definitions for graph entities.
+ *
+ * Projects define Web Components that render entity data in purpose-driven
+ * ways. Each view class declares a static `viewName`, and receives the
+ * entity's `data` payload via a `data` property setter.
+ *
+ * @example
+ * ```ts
+ * import { defineViews } from 'firegraph';
+ *
+ * class UserCard extends HTMLElement {
+ *   static viewName = 'card';
+ *   static description = 'Compact user card';
+ *   private _data: Record<string, unknown> = {};
+ *   set data(v: Record<string, unknown>) { this._data = v; this.render(); }
+ *   connectedCallback() { this.render(); }
+ *   private render() {
+ *     this.innerHTML = `<strong>${this._data.displayName ?? ''}</strong>`;
+ *   }
+ * }
+ *
+ * export default defineViews({
+ *   nodes: { user: { views: [UserCard] } },
+ * });
+ * ```
+ */
+/**
+ * A Web Component class used as a view. The class must have a static
+ * `viewName` and must be constructable. It will be registered as a custom
+ * element via `customElements.define()` in browser environments.
+ *
+ * Note: this interface avoids referencing `HTMLElement` directly so the
+ * library can compile without DOM lib types. Consumer code (which has DOM)
+ * will satisfy this constraint naturally.
+ */
+interface ViewComponentClass {
+    new (...args: any[]): {
+        data: Record<string, unknown>;
+    };
+    /** Short identifier for this view (e.g. 'card', 'profile'). */
+    viewName: string;
+    /** Optional human-readable description. */
+    description?: string;
+}
+/** Configuration for all views of a single entity type. */
+interface EntityViewConfig {
+    /** View component classes to register. */
+    views: ViewComponentClass[];
+    /**
+     * Optional sample data for the gallery. A single object matching
+     * the entity's JSON Schema — shared across all views.
+     */
+    sampleData?: Record<string, unknown>;
+}
+/** Input shape accepted by `defineViews()`. */
+interface ViewRegistryInput {
+    /** Node views keyed by aType (e.g. 'user', 'tour'). */
+    nodes?: Record<string, EntityViewConfig>;
+    /** Edge views keyed by axbType (e.g. 'hasDeparture'). */
+    edges?: Record<string, EntityViewConfig>;
+}
+/** Serialisable metadata for a single view. */
+interface ViewMeta {
+    /** Custom element tag name (e.g. 'fg-user-card'). */
+    tagName: string;
+    /** Short identifier matching the component's static viewName. */
+    viewName: string;
+    /** Optional human-readable description. */
+    description?: string;
+}
+/** Serialisable metadata for all views of a single entity type. */
+interface EntityViewMeta {
+    views: ViewMeta[];
+    sampleData?: Record<string, unknown>;
+}
+/** The resolved view registry returned by `defineViews()`. */
+interface ViewRegistry {
+    nodes: Record<string, EntityViewMeta>;
+    edges: Record<string, EntityViewMeta>;
+}
+/**
+ * Build a `ViewRegistry` from component classes.
+ *
+ * In the browser the components are registered as custom elements with
+ * deterministic tag names (`fg-{entityType}-{viewName}`). On the server
+ * (Node.js) only metadata is returned — no custom element registration.
+ */
+declare function defineViews(input: ViewRegistryInput): ViewRegistry;
+
+export { type EntityViewConfig as E, type ViewComponentClass as V, type EntityViewMeta as a, type ViewMeta as b, type ViewRegistry as c, type ViewRegistryInput as d, defineViews as e };