@party-stack/ontology-devtools 0.6.2 → 0.7.0

package/lib/attribution/tanstack.js

@@ -0,0 +1,81 @@
+import { queryConsumers } from "./registry.js";
+import { demandId } from "../replicationActivity.js";
+import { getCollectionDemands } from "@party-stack/ontology/tanstack";
+//#region src/attribution/tanstack.ts
+/** TanStack DB 1.0 adapter. Private inspection is confined here and fails closed.
+* No subscriptions, sync runs, queries, or row reads are created by inspection.
+*/
+function queryGraph(collection) {
+	const utils = collection.utils;
+	if (!utils) return;
+	const key = Object.getOwnPropertySymbols(utils).find((symbol) => symbol.description === "liveQueryInternal");
+	if (!key) return;
+	const utility = Reflect.get(utils, key);
+	if (typeof utility?.getBuilder !== "function") return;
+	const graph = utility.getBuilder();
+	return typeof graph?.getSourceCollections === "function" && graph.subscriptions && typeof graph.subscriptions === "object" ? graph : void 0;
+}
+function queryDemandGraph(collection) {
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (current) => {
+		if (seen.has(current)) return;
+		seen.add(current);
+		const own = (key) => Object.getOwnPropertyDescriptor(current, key)?.value;
+		const source = own("source");
+		const partition = own("partition");
+		if (source && partition && typeof own("groupKey") === "string") {
+			const partitionSource = Object.getOwnPropertyDescriptor(partition, "source")?.value;
+			const subscription = Object.getOwnPropertyDescriptor(partition, "subscription")?.value;
+			if (partitionSource !== source) return;
+			for (const demand of getCollectionDemands(source)) if (subscription && demand.subscription === subscription) result.push({
+				...demand,
+				collection: source
+			});
+			visit(source);
+			const materialized = own("collection");
+			if (materialized) visit(materialized);
+			return;
+		}
+		const graph = queryGraph(current);
+		if (!graph) return;
+		const subscriptions = new Set(Object.values(graph.subscriptions));
+		for (const source of graph.getSourceCollections()) {
+			for (const demand of getCollectionDemands(source)) if (demand.subscription && subscriptions.has(demand.subscription)) result.push({
+				...demand,
+				collection: source
+			});
+			visit(source);
+		}
+	};
+	try {
+		visit(collection);
+	} catch {
+		return [];
+	}
+	return result;
+}
+function demandOwners(demand, sources) {
+	const key = demandId(demand);
+	const roots = new Set(sources);
+	const owners = /* @__PURE__ */ new Map();
+	for (const consumer of queryConsumers()) if (queryDemandGraph(consumer.collection).some((request) => roots.has(request.collection) && demandId(request) === key)) owners.set(consumer.owner.id, consumer.owner);
+	return [...owners.values()];
+}
+function demandRequests(demand, sources) {
+	const key = demandId(demand);
+	const roots = new Set(sources);
+	const requests = /* @__PURE__ */ new Map();
+	for (const consumer of queryConsumers()) for (const request of queryDemandGraph(consumer.collection)) {
+		if (!request.requested || !roots.has(request.collection) || demandId(request) !== key) continue;
+		try {
+			const signature = JSON.stringify(request.requested, (_, value) => typeof value === "bigint" ? `${value}n` : value);
+			requests.set(signature, request);
+		} catch {}
+	}
+	return [...requests.values()];
+}
+//#endregion
+export { demandOwners, demandRequests, queryDemandGraph };
+
+//# sourceMappingURL=tanstack.js.map

package/lib/attribution/tanstack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.js","names":[],"sources":["../../src/attribution/tanstack.ts"],"sourcesContent":["import { getCollectionDemands, type CollectionDemandDiagnostic } from \"@party-stack/ontology/tanstack\";\nimport { demandId, type ReplicationDemand } from \"../replicationActivity.js\";\nimport { queryConsumers, type DemandOwner } from \"./registry.js\";\n\ninterface Graph {\n    getSourceCollections(): readonly object[];\n    readonly subscriptions: Record<string, object>;\n}\n/** TanStack DB 1.0 adapter. Private inspection is confined here and fails closed.\n * No subscriptions, sync runs, queries, or row reads are created by inspection.\n */\nfunction queryGraph(collection: object): Graph | undefined {\n    const utils = (collection as { utils?: object }).utils;\n    if (!utils) return;\n    const key = Object.getOwnPropertySymbols(utils).find(\n        (symbol) => symbol.description === \"liveQueryInternal\"\n    );\n    if (!key) return;\n    const utility = Reflect.get(utils, key) as { getBuilder?: () => Graph } | undefined;\n    if (typeof utility?.getBuilder !== \"function\") return;\n    const graph = utility.getBuilder();\n    return typeof graph?.getSourceCollections === \"function\" &&\n        graph.subscriptions &&\n        typeof graph.subscriptions === \"object\"\n        ? graph\n        : undefined;\n}\n\nexport function queryDemandGraph(\n    collection: object\n): readonly (CollectionDemandDiagnostic & { collection: object })[] {\n    const result: (CollectionDemandDiagnostic & { collection: object })[] = [];\n    const seen = new Set<object>();\n    const visit = (current: object) => {\n        if (seen.has(current)) return;\n        seen.add(current);\n        // A pooled hook result is a lazy Proxy: reading .utils would materialize\n        // another query and acquire demand. Inspect its own data descriptors only.\n        const own = (key: string) => Object.getOwnPropertyDescriptor(current, key)?.value;\n        const source = own(\"source\") as object | undefined;\n        const partition = own(\"partition\") as object | undefined;\n        if (source && partition && typeof own(\"groupKey\") === \"string\") {\n            const partitionSource = Object.getOwnPropertyDescriptor(partition, \"source\")?.value;\n            const subscription = Object.getOwnPropertyDescriptor(partition, \"subscription\")?.value;\n            if (partitionSource !== source) return;\n            for (const demand of getCollectionDemands(source))\n                if (subscription && demand.subscription === subscription)\n                    result.push({ ...demand, collection: source });\n            visit(source);\n            const materialized = own(\"collection\") as object | undefined;\n            if (materialized) visit(materialized);\n            return;\n        }\n        const graph = queryGraph(current);\n        if (!graph) return;\n        const subscriptions = new Set(Object.values(graph.subscriptions));\n        for (const source of graph.getSourceCollections()) {\n            for (const demand of getCollectionDemands(source))\n                if (demand.subscription && subscriptions.has(demand.subscription))\n                    result.push({ ...demand, collection: source });\n            visit(source);\n        }\n    };\n    try {\n        visit(collection);\n    } catch {\n        return [];\n    }\n    return result;\n}\n\nexport function demandOwners(\n    demand: Pick<ReplicationDemand, \"objectType\" | \"query\">,\n    sources: readonly object[]\n): readonly DemandOwner[] {\n    const key = demandId(demand);\n    const roots = new Set(sources);\n    const owners = new Map<string, DemandOwner>();\n    for (const consumer of queryConsumers())\n        if (\n            queryDemandGraph(consumer.collection).some(\n                (request) => roots.has(request.collection) && demandId(request) === key\n            )\n        )\n            owners.set(consumer.owner.id, consumer.owner);\n    return [...owners.values()];\n}\n\nexport function demandRequests(\n    demand: Pick<ReplicationDemand, \"objectType\" | \"query\">,\n    sources: readonly object[]\n) {\n    const key = demandId(demand);\n    const roots = new Set(sources);\n    const requests = new Map<string, CollectionDemandDiagnostic>();\n    for (const consumer of queryConsumers())\n        for (const request of queryDemandGraph(consumer.collection)) {\n            if (!request.requested || !roots.has(request.collection) || demandId(request) !== key) continue;\n            try {\n                const signature = JSON.stringify(request.requested, (_, value: unknown) =>\n                    typeof value === \"bigint\" ? `${value}n` : value\n                );\n                requests.set(signature, request);\n            } catch {\n                /* Nonportable diagnostic values cannot break the inspector. */\n            }\n        }\n    return [...requests.values()];\n}\n"],"mappings":"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"}

package/lib/chrome.d.ts

@@ -0,0 +1,9 @@
+//#region src/chrome.d.ts
+export interface OntologyDevtoolsChromeProps {
+  theme: "light" | "dark";
+}
+export declare function OntologyDevtoolsPluginName({ theme }: OntologyDevtoolsChromeProps): import("react").JSX.Element;
+export declare function OntologyDevtoolsTrigger({ theme }: OntologyDevtoolsChromeProps): import("react").JSX.Element;
+export declare function ontologyDevtoolsTrigger(_element: HTMLElement, { theme }: OntologyDevtoolsChromeProps): import("react").JSX.Element;
+//#endregion
+//# sourceMappingURL=chrome.d.ts.map

package/lib/chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","names":[],"sources":["../src/chrome.tsx"],"mappings":";iBAEiB;EACb;;wBAGY,6BAA6B,SAAS,8CAA2B,IAAA;wBAQjE,0BAA0B,SAAS,8CAA2B,IAAA;wBA8B9D,wBAAwB,UAAU,eAAe,SAAS,8CAA2B,IAAA"}

package/lib/chrome.js

@@ -0,0 +1,41 @@
+import { jsx } from "react/jsx-runtime";
+import { PartyStackLogo, PartyStackLogomark } from "@party-stack/design-system/brand";
+//#region src/chrome.tsx
+function OntologyDevtoolsPluginName({ theme }) {
+	return /* @__PURE__ */ jsx("div", {
+		style: {
+			height: 30,
+			width: 120
+		},
+		children: /* @__PURE__ */ jsx(PartyStackLogo, { theme })
+	});
+}
+function OntologyDevtoolsTrigger({ theme }) {
+	const dark = theme === "dark";
+	return /* @__PURE__ */ jsx("div", {
+		"aria-label": "Open Ontology devtools",
+		style: {
+			alignItems: "center",
+			background: dark ? "linear-gradient(145deg, #2d2d31, #171719)" : "linear-gradient(145deg, #fff, #f5f5f4)",
+			border: dark ? "1px solid rgba(255,255,255,.16)" : "1px solid rgba(23,23,23,.14)",
+			borderRadius: "999px",
+			boxSizing: "border-box",
+			boxShadow: dark ? "0 10px 30px rgba(0,0,0,.34), 0 0 0 4px rgba(141,120,235,.11)" : "0 10px 28px rgba(28,25,23,.16), 0 0 0 4px rgba(141,120,235,.09)",
+			cursor: "pointer",
+			display: "flex",
+			height: 48,
+			justifyContent: "center",
+			padding: 8,
+			width: 48
+		},
+		title: "Open Ontology devtools",
+		children: /* @__PURE__ */ jsx(PartyStackLogomark, {})
+	});
+}
+function ontologyDevtoolsTrigger(_element, { theme }) {
+	return /* @__PURE__ */ jsx(OntologyDevtoolsTrigger, { theme });
+}
+//#endregion
+export { OntologyDevtoolsPluginName, OntologyDevtoolsTrigger, ontologyDevtoolsTrigger };
+
+//# sourceMappingURL=chrome.js.map

package/lib/chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.js","names":[],"sources":["../src/chrome.tsx"],"sourcesContent":["import { PartyStackLogo, PartyStackLogomark } from \"@party-stack/design-system/brand\";\n\nexport interface OntologyDevtoolsChromeProps {\n    theme: \"light\" | \"dark\";\n}\n\nexport function OntologyDevtoolsPluginName({ theme }: OntologyDevtoolsChromeProps) {\n    return (\n        <div style={{ height: 30, width: 120 }}>\n            <PartyStackLogo theme={theme} />\n        </div>\n    );\n}\n\nexport function OntologyDevtoolsTrigger({ theme }: OntologyDevtoolsChromeProps) {\n    const dark = theme === \"dark\";\n    return (\n        <div\n            aria-label=\"Open Ontology devtools\"\n            style={{\n                alignItems: \"center\",\n                background: dark\n                    ? \"linear-gradient(145deg, #2d2d31, #171719)\"\n                    : \"linear-gradient(145deg, #fff, #f5f5f4)\",\n                border: dark ? \"1px solid rgba(255,255,255,.16)\" : \"1px solid rgba(23,23,23,.14)\",\n                borderRadius: \"999px\",\n                boxSizing: \"border-box\",\n                boxShadow: dark\n                    ? \"0 10px 30px rgba(0,0,0,.34), 0 0 0 4px rgba(141,120,235,.11)\"\n                    : \"0 10px 28px rgba(28,25,23,.16), 0 0 0 4px rgba(141,120,235,.09)\",\n                cursor: \"pointer\",\n                display: \"flex\",\n                height: 48,\n                justifyContent: \"center\",\n                padding: 8,\n                width: 48,\n            }}\n            title=\"Open Ontology devtools\"\n        >\n            <PartyStackLogomark />\n        </div>\n    );\n}\n\nexport function ontologyDevtoolsTrigger(_element: HTMLElement, { theme }: OntologyDevtoolsChromeProps) {\n    return <OntologyDevtoolsTrigger theme={theme} />;\n}\n"],"mappings":";;;AAMA,SAAgB,2BAA2B,EAAE,SAAsC;CAC/E,OACI,oBAAC,OAAD;EAAK,OAAO;GAAE,QAAQ;GAAI,OAAO;EAAI;EACjC,UAAA,oBAAC,gBAAD,EAAuB,MAAQ,CAAA;CAC9B,CAAA;AAEb;AAEA,SAAgB,wBAAwB,EAAE,SAAsC;CAC5E,MAAM,OAAO,UAAU;CACvB,OACI,oBAAC,OAAD;EACI,cAAW;EACX,OAAO;GACH,YAAY;GACZ,YAAY,OACN,8CACA;GACN,QAAQ,OAAO,oCAAoC;GACnD,cAAc;GACd,WAAW;GACX,WAAW,OACL,iEACA;GACN,QAAQ;GACR,SAAS;GACT,QAAQ;GACR,gBAAgB;GAChB,SAAS;GACT,OAAO;EACX;EACA,OAAM;EAEN,UAAA,oBAAC,oBAAD,CAAqB,CAAA;CACpB,CAAA;AAEb;AAEA,SAAgB,wBAAwB,UAAuB,EAAE,SAAsC;CACnG,OAAO,oBAAC,yBAAD,EAAgC,MAAQ,CAAA;AACnD"}

package/lib/diagnostics.d.ts

@@ -0,0 +1,15 @@
+import { LiveOntology } from "@party-stack/ontology";
+//#region src/diagnostics.d.ts
+export type Diagnostics = NonNullable<LiveOntology["diagnostics"]>;
+export type Status = NonNullable<ReturnType<Diagnostics["replica"]["getSnapshot"]>["status"]>;
+export type Demand = Status["demands"][number];
+export type Load = Status["loads"][number];
+export declare function useReplicaStatus(diagnostics?: Diagnostics): ReturnType<Diagnostics["replica"]["getSnapshot"]>;
+export declare function useTraceSpans(store?: LiveOntology["traces"]): readonly import("@party-stack/runtime/tracing").TraceRecord[];
+export declare function diagnosticTargets(diagnostics?: Diagnostics): {
+  label: string;
+  value: Diagnostics;
+}[];
+export declare const ms: (value: number) => string;
+//#endregion
+//# sourceMappingURL=diagnostics.d.ts.map

package/lib/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","names":[],"sources":["../src/diagnostics.ts"],"mappings":";;YAIY,cAAc,YAAY;YAC1B,SAAS,YAAY,WAAW;YAChC,SAAS;YACT,OAAO;wBAMH,iBAAiB,cAAc,cAMtC,WAAW;wBAEJ,cAAc,QAAQ,yEAAsB;wBAG5C,kBAAkB,cAAc;EACpB;EAAe,OAAA;;qBAQ9B,KAAE"}

package/lib/diagnostics.js

@@ -0,0 +1,31 @@
+import { useSyncExternalStore } from "react";
+//#region src/diagnostics.ts
+const empty = {};
+const noSnapshot = () => empty;
+const emptySpans = [];
+const noSpans = () => emptySpans;
+const noSubscription = () => () => void 0;
+function useReplicaStatus(diagnostics) {
+	const store = diagnostics?.replica;
+	return useSyncExternalStore(store?.subscribe ?? noSubscription, store?.getSnapshot ?? noSnapshot, noSnapshot);
+}
+function useTraceSpans(store) {
+	return useSyncExternalStore(store?.subscribe ?? noSubscription, store?.getSnapshot ?? noSpans, noSpans);
+}
+function diagnosticTargets(diagnostics) {
+	const targets = [];
+	for (let node = diagnostics; node; node = node.parent) {
+		if (targets.some((target) => target.value === node)) break;
+		const label = !targets.length ? "This tab" : node.location ?? node.label ?? "Host";
+		targets.push({
+			label,
+			value: node
+		});
+	}
+	return targets;
+}
+const ms = (value) => value < 1 ? `${(value * 1e3).toFixed(0)} µs` : `${value.toFixed(1)} ms`;
+//#endregion
+export { diagnosticTargets, ms, useReplicaStatus, useTraceSpans };
+
+//# sourceMappingURL=diagnostics.js.map

package/lib/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","names":[],"sources":["../src/diagnostics.ts"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\nimport type { PerformanceSpan } from \"./traceWaterfall.js\";\nimport type { LiveOntology } from \"@party-stack/ontology\";\n\nexport type Diagnostics = NonNullable<LiveOntology[\"diagnostics\"]>;\nexport type Status = NonNullable<ReturnType<Diagnostics[\"replica\"][\"getSnapshot\"]>[\"status\"]>;\nexport type Demand = Status[\"demands\"][number];\nexport type Load = Status[\"loads\"][number];\nconst empty = {};\nconst noSnapshot = () => empty;\nconst emptySpans: readonly PerformanceSpan[] = [];\nconst noSpans = () => emptySpans;\nconst noSubscription = () => () => undefined;\nexport function useReplicaStatus(diagnostics?: Diagnostics) {\n    const store = diagnostics?.replica;\n    return useSyncExternalStore(\n        store?.subscribe ?? noSubscription,\n        store?.getSnapshot ?? noSnapshot,\n        noSnapshot\n    ) as ReturnType<Diagnostics[\"replica\"][\"getSnapshot\"]>;\n}\nexport function useTraceSpans(store?: LiveOntology[\"traces\"]) {\n    return useSyncExternalStore(store?.subscribe ?? noSubscription, store?.getSnapshot ?? noSpans, noSpans);\n}\nexport function diagnosticTargets(diagnostics?: Diagnostics) {\n    const targets: { label: string; value: Diagnostics }[] = [];\n    for (let node = diagnostics; node; node = node.parent) {\n        if (targets.some((target) => target.value === node)) break;\n        const label = !targets.length ? \"This tab\" : (node.location ?? node.label ?? \"Host\");\n        targets.push({ label, value: node });\n    }\n    return targets;\n}\nexport const ms = (value: number) =>\n    value < 1 ? `${(value * 1000).toFixed(0)} µs` : `${value.toFixed(1)} ms`;\n"],"mappings":";;AAQA,MAAM,QAAQ,CAAC;AACf,MAAM,mBAAmB;AACzB,MAAM,aAAyC,CAAC;AAChD,MAAM,gBAAgB;AACtB,MAAM,6BAA6B,KAAA;AACnC,SAAgB,iBAAiB,aAA2B;CACxD,MAAM,QAAQ,aAAa;CAC3B,OAAO,qBACH,OAAO,aAAa,gBACpB,OAAO,eAAe,YACtB,UACJ;AACJ;AACA,SAAgB,cAAc,OAAgC;CAC1D,OAAO,qBAAqB,OAAO,aAAa,gBAAgB,OAAO,eAAe,SAAS,OAAO;AAC1G;AACA,SAAgB,kBAAkB,aAA2B;CACzD,MAAM,UAAmD,CAAC;CAC1D,KAAK,IAAI,OAAO,aAAa,MAAM,OAAO,KAAK,QAAQ;EACnD,IAAI,QAAQ,MAAM,WAAW,OAAO,UAAU,IAAI,GAAG;EACrD,MAAM,QAAQ,CAAC,QAAQ,SAAS,aAAc,KAAK,YAAY,KAAK,SAAS;EAC7E,QAAQ,KAAK;GAAE;GAAO,OAAO;EAAK,CAAC;CACvC;CACA,OAAO;AACX;AACA,MAAa,MAAM,UACf,QAAQ,IAAI,IAAI,QAAQ,IAAA,CAAM,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,QAAQ,CAAC,EAAE"}

package/lib/index.d.ts

@@ -1,2 +1,4 @@
-import { OntologyDevtoolsChromeProps, OntologyDevtoolsPanel, OntologyDevtoolsPanelProps, OntologyDevtoolsPluginName, OntologyDevtoolsPluginOptions, OntologyDevtoolsTrigger, createOntologyDevtoolsPlugin, ontologyDevtoolsTrigger } from "./OntologyDevtools.js";
-export { type OntologyDevtoolsChromeProps, OntologyDevtoolsPanel, type OntologyDevtoolsPanelProps, OntologyDevtoolsPluginName, type OntologyDevtoolsPluginOptions, OntologyDevtoolsTrigger, createOntologyDevtoolsPlugin, ontologyDevtoolsTrigger };
+import { OntologyDevtoolsPanelProps, OntologyDevtoolsPluginOptions } from "./types.js";
+import { OntologyDevtoolsChromeProps, OntologyDevtoolsPluginName, OntologyDevtoolsTrigger, ontologyDevtoolsTrigger } from "./chrome.js";
+import { OntologyDevtoolsPanel, createOntologyDevtoolsPlugin, preloadOntologyDevtools } from "./plugin.js";
+export { type OntologyDevtoolsChromeProps, OntologyDevtoolsPanel, type OntologyDevtoolsPanelProps, OntologyDevtoolsPluginName, type OntologyDevtoolsPluginOptions, OntologyDevtoolsTrigger, createOntologyDevtoolsPlugin, ontologyDevtoolsTrigger, preloadOntologyDevtools };

package/lib/index.js

@@ -1 +1,3 @@
-export { OntologyDevtoolsPanel, OntologyDevtoolsPluginName, OntologyDevtoolsTrigger, createOntologyDevtoolsPlugin, ontologyDevtoolsTrigger } from "./OntologyDevtools.js";
+import { OntologyDevtoolsPluginName, OntologyDevtoolsTrigger, ontologyDevtoolsTrigger } from "./chrome.js";
+import { OntologyDevtoolsPanel, createOntologyDevtoolsPlugin, preloadOntologyDevtools } from "./plugin.js";
+export { OntologyDevtoolsPanel, OntologyDevtoolsPluginName, OntologyDevtoolsTrigger, createOntologyDevtoolsPlugin, ontologyDevtoolsTrigger, preloadOntologyDevtools };

package/lib/plugin.d.ts

@@ -0,0 +1,11 @@
+import { OntologyDevtoolsPanelProps, OntologyDevtoolsPluginOptions } from "./types.js";
+import { OntologyDefinition } from "@party-stack/ontology";
+import { TanStackDevtoolsReactPlugin } from "@tanstack/react-devtools";
+//#region src/plugin.d.ts
+/** Warm optional inspector code after the application's first data is displayed, for offline use. */
+export declare const preloadOntologyDevtools: () => Promise<undefined>;
+/** Loading the shell must not import inspectors, schema layout or collection subscriptions. */
+export declare function OntologyDevtoolsPanel<Ontology extends OntologyDefinition, MetaOntology extends OntologyDefinition = OntologyDefinition>(props: OntologyDevtoolsPanelProps<Ontology, MetaOntology>): import("react").JSX.Element;
+export declare function createOntologyDevtoolsPlugin<Ontology extends OntologyDefinition, MetaOntology extends OntologyDefinition = OntologyDefinition>({ ontology, id, metaOntology, name, defaultOpen }: OntologyDevtoolsPluginOptions<Ontology, MetaOntology>): TanStackDevtoolsReactPlugin;
+//#endregion
+//# sourceMappingURL=plugin.d.ts.map

package/lib/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;qBAYa,+BAAuB;;wBAiBpB,sBACZ,iBAAiB,oBACjB,qBAAqB,qBAAqB,oBAC5C,OAAO,2BAA2B,UAAU,gCAAa,IAAA;wBAsB3C,6BACZ,iBAAiB,oBACjB,qBAAqB,qBAAqB,sBAE1C,UACA,IACA,cACA,MACA,eACD,8BAA8B,UAAU,gBAAgB"}

package/lib/plugin.js

@@ -0,0 +1,62 @@
+import { OntologyDevtoolsPluginName } from "./chrome.js";
+import { Fragment, jsx } from "react/jsx-runtime";
+import { Component, Suspense, lazy } from "react";
+import { PartyStackLogomark } from "@party-stack/design-system/brand";
+import { createReactPlugin } from "@tanstack/devtools-utils/react";
+//#region src/plugin.tsx
+const loadPanel = () => import("./OntologyDevtools.js");
+const Panel = lazy(() => loadPanel().then((module) => ({ default: module.OntologyDevtoolsPanel })));
+/** Warm optional inspector code after the application's first data is displayed, for offline use. */
+const preloadOntologyDevtools = () => loadPanel().then(() => void 0);
+var InspectorBoundary = class extends Component {
+	state = { failed: false };
+	static getDerivedStateFromError() {
+		return { failed: true };
+	}
+	render() {
+		return this.state.failed ? /* @__PURE__ */ jsx("p", { children: "The inspector could not load. Reconnect and reload to try again." }) : this.props.children;
+	}
+};
+/** Loading the shell must not import inspectors, schema layout or collection subscriptions. */
+function OntologyDevtoolsPanel(props) {
+	return /* @__PURE__ */ jsx(InspectorBoundary, { children: /* @__PURE__ */ jsx(Suspense, {
+		fallback: /* @__PURE__ */ jsx("div", {
+			role: "status",
+			"aria-label": "Loading inspector",
+			style: {
+				height: "100%",
+				minHeight: 160,
+				display: "grid",
+				placeItems: "center"
+			},
+			children: /* @__PURE__ */ jsx("div", {
+				style: {
+					width: 44,
+					height: 44
+				},
+				children: /* @__PURE__ */ jsx(PartyStackLogomark, {})
+			})
+		}),
+		children: /* @__PURE__ */ jsx(Panel, { ...props })
+	}) });
+}
+function createOntologyDevtoolsPlugin({ ontology, id = "party-stack-ontology", metaOntology, name, defaultOpen }) {
+	const [createPlugin] = createReactPlugin({
+		id,
+		name: "Ontology",
+		defaultOpen,
+		Component: ({ theme, devtoolsOpen }) => devtoolsOpen ? /* @__PURE__ */ jsx(OntologyDevtoolsPanel, {
+			metaOntology,
+			ontology,
+			theme
+		}) : /* @__PURE__ */ jsx(Fragment, {})
+	});
+	return {
+		...createPlugin(),
+		name: name ?? ((_element, { theme }) => /* @__PURE__ */ jsx(OntologyDevtoolsPluginName, { theme }))
+	};
+}
+//#endregion
+export { OntologyDevtoolsPanel, createOntologyDevtoolsPlugin, preloadOntologyDevtools };
+
+//# sourceMappingURL=plugin.js.map

package/lib/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":["import { PartyStackLogomark } from \"@party-stack/design-system/brand\";\nimport { createReactPlugin } from \"@tanstack/devtools-utils/react\";\nimport { Component, lazy, Suspense, type ReactNode } from \"react\";\nimport { OntologyDevtoolsPluginName } from \"./chrome.js\";\nimport type { OntologyDevtoolsPanelProps, OntologyDevtoolsPluginOptions } from \"./types.js\";\nimport type { OntologyDefinition } from \"@party-stack/ontology\";\nimport type { TanStackDevtoolsReactPlugin } from \"@tanstack/react-devtools\";\n\nconst loadPanel = () => import(\"./OntologyDevtools.js\");\nconst Panel = lazy(() => loadPanel().then((module) => ({ default: module.OntologyDevtoolsPanel })));\n\n/** Warm optional inspector code after the application's first data is displayed, for offline use. */\nexport const preloadOntologyDevtools = () => loadPanel().then(() => undefined);\n\nclass InspectorBoundary extends Component<{ children: ReactNode }, { failed: boolean }> {\n    state = { failed: false };\n    static getDerivedStateFromError() {\n        return { failed: true };\n    }\n    render() {\n        return this.state.failed ? (\n            <p>The inspector could not load. Reconnect and reload to try again.</p>\n        ) : (\n            this.props.children\n        );\n    }\n}\n\n/** Loading the shell must not import inspectors, schema layout or collection subscriptions. */\nexport function OntologyDevtoolsPanel<\n    Ontology extends OntologyDefinition,\n    MetaOntology extends OntologyDefinition = OntologyDefinition,\n>(props: OntologyDevtoolsPanelProps<Ontology, MetaOntology>) {\n    return (\n        <InspectorBoundary>\n            <Suspense\n                fallback={\n                    <div\n                        role=\"status\"\n                        aria-label=\"Loading inspector\"\n                        style={{ height: \"100%\", minHeight: 160, display: \"grid\", placeItems: \"center\" }}\n                    >\n                        <div style={{ width: 44, height: 44 }}>\n                            <PartyStackLogomark />\n                        </div>\n                    </div>\n                }\n            >\n                <Panel {...props} />\n            </Suspense>\n        </InspectorBoundary>\n    );\n}\n\nexport function createOntologyDevtoolsPlugin<\n    Ontology extends OntologyDefinition,\n    MetaOntology extends OntologyDefinition = OntologyDefinition,\n>({\n    ontology,\n    id = \"party-stack-ontology\",\n    metaOntology,\n    name,\n    defaultOpen,\n}: OntologyDevtoolsPluginOptions<Ontology, MetaOntology>): TanStackDevtoolsReactPlugin {\n    const [createPlugin] = createReactPlugin({\n        id,\n        name: \"Ontology\",\n        defaultOpen,\n        Component: ({ theme, devtoolsOpen }) =>\n            devtoolsOpen ? (\n                <OntologyDevtoolsPanel metaOntology={metaOntology} ontology={ontology} theme={theme} />\n            ) : (\n                <></>\n            ),\n    });\n    return {\n        ...createPlugin(),\n        name: name ?? ((_element, { theme }) => <OntologyDevtoolsPluginName theme={theme} />),\n    };\n}\n"],"mappings":";;;;;;AAQA,MAAM,kBAAkB,OAAO;AAC/B,MAAM,QAAQ,WAAW,UAAU,CAAC,CAAC,MAAM,YAAY,EAAE,SAAS,OAAO,sBAAsB,EAAE,CAAC;;AAGlG,MAAa,gCAAgC,UAAU,CAAC,CAAC,WAAW,KAAA,CAAS;AAE7E,IAAM,oBAAN,cAAgC,UAAwD;CACpF,QAAQ,EAAE,QAAQ,MAAM;CACxB,OAAO,2BAA2B;EAC9B,OAAO,EAAE,QAAQ,KAAK;CAC1B;CACA,SAAS;EACL,OAAO,KAAK,MAAM,SACd,oBAAC,KAAD,EAAA,UAAG,mEAAmE,CAAA,IAEtE,KAAK,MAAM;CAEnB;AACJ;;AAGA,SAAgB,sBAGd,OAA2D;CACzD,OACI,oBAAC,mBAAD,EAAA,UACI,oBAAC,UAAD;EACI,UACI,oBAAC,OAAD;GACI,MAAK;GACL,cAAW;GACX,OAAO;IAAE,QAAQ;IAAQ,WAAW;IAAK,SAAS;IAAQ,YAAY;GAAS;GAE/E,UAAA,oBAAC,OAAD;IAAK,OAAO;KAAE,OAAO;KAAI,QAAQ;IAAG;IAChC,UAAA,oBAAC,oBAAD,CAAqB,CAAA;GACpB,CAAA;EACJ,CAAA;EAGT,UAAA,oBAAC,OAAD,EAAO,GAAI,MAAQ,CAAA;CACb,CAAA,EACK,CAAA;AAE3B;AAEA,SAAgB,6BAGd,EACE,UACA,KAAK,wBACL,cACA,MACA,eACmF;CACnF,MAAM,CAAC,gBAAgB,kBAAkB;EACrC;EACA,MAAM;EACN;EACA,YAAY,EAAE,OAAO,mBACjB,eACI,oBAAC,uBAAD;GAAqC;GAAwB;GAAiB;EAAQ,CAAA,IAEtF,oBAAA,UAAA,CAAI,CAAA;CAEhB,CAAC;CACD,OAAO;EACH,GAAG,aAAa;EAChB,MAAM,UAAU,UAAU,EAAE,YAAY,oBAAC,4BAAD,EAAmC,MAAQ,CAAA;CACvF;AACJ"}

package/lib/queryIR.d.ts

@@ -0,0 +1,9 @@
+import { Demand } from "./diagnostics.js";
+import { Query } from "@party-stack/ontology";
+//#region src/queryIR.d.ts
+type Subset = NonNullable<Demand["query"]>;
+/** One renderer for portable query graphs and the engine's compiled subsets. */
+export declare function subsetQuery(objectType: string, subset?: Subset): Query;
+//#endregion
+export {};
+//# sourceMappingURL=queryIR.d.ts.map

package/lib/queryIR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryIR.d.ts","names":[],"sources":["../src/queryIR.ts"],"mappings":";;;KAIK,SAAS,YAAY;;wBAuBV,YAAY,oBAAoB,SAAS,SAAS"}

package/lib/queryIR.js

@@ -0,0 +1,69 @@
+//#region src/queryIR.ts
+const literal = (value) => ({
+	kind: "literal",
+	value: { value }
+});
+function operand(value) {
+	return value !== null && typeof value === "object" && "_tag" in value && value._tag === "Field" ? {
+		kind: "getAt",
+		value: {
+			source: {
+				kind: "localReference",
+				value: { name: "row" }
+			},
+			path: [...value.path]
+		}
+	} : literal(value);
+}
+function predicate(value) {
+	if (value.op === "and" || value.op === "or") return {
+		kind: value.op,
+		value: { expressions: value.predicates.map(predicate) }
+	};
+	if (value.op === "not") return {
+		kind: "not",
+		value: { expression: predicate(value.predicate) }
+	};
+	if (value.op === "in") return {
+		kind: "in",
+		value: {
+			left: operand(value.left),
+			right: literal(value.values)
+		}
+	};
+	return {
+		kind: value.op,
+		value: {
+			left: operand(value.left),
+			right: operand(value.right)
+		}
+	};
+}
+/** One renderer for portable query graphs and the engine's compiled subsets. */
+function subsetQuery(objectType, subset) {
+	return {
+		from: {
+			source: { objectType },
+			binding: "row"
+		},
+		where: subset?.where && predicate(subset.where),
+		orderBy: subset?.orderBy?.map((order) => ({
+			expression: operand(order.field),
+			direction: order.direction,
+			nulls: order.nulls
+		})),
+		page: subset && {
+			limit: subset.limit,
+			offset: subset.offset,
+			after: subset.after && {
+				key: subset.after.key,
+				values: [...subset.after.values]
+			}
+		},
+		select: []
+	};
+}
+//#endregion
+export { subsetQuery };
+
+//# sourceMappingURL=queryIR.js.map

package/lib/queryIR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryIR.js","names":[],"sources":["../src/queryIR.ts"],"sourcesContent":["import type { Demand } from \"./diagnostics.js\";\nimport type { QueryOperand } from \"./QueryTokens.js\";\nimport type { Expression, Query } from \"@party-stack/ontology\";\n\ntype Subset = NonNullable<Demand[\"query\"]>;\ntype Predicate = NonNullable<Subset[\"where\"]>;\nconst literal = (value: unknown): Expression => ({ kind: \"literal\", value: { value } });\n\nfunction operand(value: QueryOperand): Expression {\n    return value !== null && typeof value === \"object\" && \"_tag\" in value && value._tag === \"Field\"\n        ? {\n              kind: \"getAt\",\n              value: { source: { kind: \"localReference\", value: { name: \"row\" } }, path: [...value.path] },\n          }\n        : literal(value);\n}\n\nfunction predicate(value: Predicate): Expression {\n    if (value.op === \"and\" || value.op === \"or\")\n        return { kind: value.op, value: { expressions: value.predicates.map(predicate) } };\n    if (value.op === \"not\") return { kind: \"not\", value: { expression: predicate(value.predicate) } };\n    if (value.op === \"in\")\n        return { kind: \"in\", value: { left: operand(value.left), right: literal(value.values) } };\n    return { kind: value.op, value: { left: operand(value.left), right: operand(value.right) } };\n}\n\n/** One renderer for portable query graphs and the engine's compiled subsets. */\nexport function subsetQuery(objectType: string, subset?: Subset): Query {\n    return {\n        from: { source: { objectType }, binding: \"row\" },\n        where: subset?.where && predicate(subset.where),\n        orderBy: subset?.orderBy?.map((order) => ({\n            expression: operand(order.field),\n            direction: order.direction,\n            nulls: order.nulls,\n        })),\n        page: subset && {\n            limit: subset.limit,\n            offset: subset.offset,\n            after: subset.after && { key: subset.after.key, values: [...subset.after.values] },\n        },\n        select: [],\n    };\n}\n"],"mappings":";AAMA,MAAM,WAAW,WAAgC;CAAE,MAAM;CAAW,OAAO,EAAE,MAAM;AAAE;AAErF,SAAS,QAAQ,OAAiC;CAC9C,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,UAAU,SAAS,MAAM,SAAS,UAClF;EACI,MAAM;EACN,OAAO;GAAE,QAAQ;IAAE,MAAM;IAAkB,OAAO,EAAE,MAAM,MAAM;GAAE;GAAG,MAAM,CAAC,GAAG,MAAM,IAAI;EAAE;CAC/F,IACA,QAAQ,KAAK;AACvB;AAEA,SAAS,UAAU,OAA8B;CAC7C,IAAI,MAAM,OAAO,SAAS,MAAM,OAAO,MACnC,OAAO;EAAE,MAAM,MAAM;EAAI,OAAO,EAAE,aAAa,MAAM,WAAW,IAAI,SAAS,EAAE;CAAE;CACrF,IAAI,MAAM,OAAO,OAAO,OAAO;EAAE,MAAM;EAAO,OAAO,EAAE,YAAY,UAAU,MAAM,SAAS,EAAE;CAAE;CAChG,IAAI,MAAM,OAAO,MACb,OAAO;EAAE,MAAM;EAAM,OAAO;GAAE,MAAM,QAAQ,MAAM,IAAI;GAAG,OAAO,QAAQ,MAAM,MAAM;EAAE;CAAE;CAC5F,OAAO;EAAE,MAAM,MAAM;EAAI,OAAO;GAAE,MAAM,QAAQ,MAAM,IAAI;GAAG,OAAO,QAAQ,MAAM,KAAK;EAAE;CAAE;AAC/F;;AAGA,SAAgB,YAAY,YAAoB,QAAwB;CACpE,OAAO;EACH,MAAM;GAAE,QAAQ,EAAE,WAAW;GAAG,SAAS;EAAM;EAC/C,OAAO,QAAQ,SAAS,UAAU,OAAO,KAAK;EAC9C,SAAS,QAAQ,SAAS,KAAK,WAAW;GACtC,YAAY,QAAQ,MAAM,KAAK;GAC/B,WAAW,MAAM;GACjB,OAAO,MAAM;EACjB,EAAE;EACF,MAAM,UAAU;GACZ,OAAO,OAAO;GACd,QAAQ,OAAO;GACf,OAAO,OAAO,SAAS;IAAE,KAAK,OAAO,MAAM;IAAK,QAAQ,CAAC,GAAG,OAAO,MAAM,MAAM;GAAE;EACrF;EACA,QAAQ,CAAC;CACb;AACJ"}

package/lib/replicationActivity.d.ts

@@ -0,0 +1,52 @@
+import { PerformanceSpan } from "./traceWaterfall.js";
+import { LiveOntology } from "@party-stack/ontology";
+//#region src/replicationActivity.d.ts
+type Diagnostics = NonNullable<LiveOntology["diagnostics"]>;
+export type ReplicationStatus = NonNullable<ReturnType<Diagnostics["replica"]["getSnapshot"]>["status"]>;
+export type ReplicationLoad = ReplicationStatus["loads"][number];
+export type ReplicationDemand = ReplicationStatus["demands"][number];
+/** Keep every span for the timeline, filling only requests whose span has left the trace buffer. */
+export declare function diagnosticSpans(spans: readonly PerformanceSpan[], loads: readonly ReplicationLoad[]): readonly PerformanceSpan[];
+export declare const queryText: (value: unknown) => string;
+export declare const demandId: (demand: Pick<ReplicationDemand, "objectType" | "query">) => string;
+export declare function replicationState(status: ReplicationStatus | undefined, error?: string): "Authenticating…" | "Authentication failed" | "Awaiting confirmation" | "Connecting…" | "Idle" | "Monitoring disconnected" | "Offline" | "Outbox paused" | "Sign-in required" | "Signed out" | "Sync failed" | "Syncing";
+/** Exact recorded subset identity only; never attribute a broader/cache-covering load by type alone. */
+export declare function queryLoads(demand: Pick<ReplicationDemand, "objectType" | "query">, loads: readonly ReplicationLoad[]): {
+  readonly id: number;
+  readonly spanId?: string | undefined;
+  readonly traceId?: string | undefined;
+  readonly operation: "loadSubset" | "pullChanges";
+  readonly reason: "demand" | "journal" | "receipt" | "refresh" | "repair";
+  readonly subset?: {
+    readonly objectType: string;
+    readonly query?: import("@party-stack/ontology-storage").Query | undefined;
+  } | undefined;
+  readonly startedAt: number;
+  readonly finishedAt?: number | undefined;
+  readonly outcome: "failure" | "interrupted" | "running" | "success";
+  readonly rows?: number | undefined;
+  readonly fetchedRows?: number | undefined;
+  readonly pushdown?: {
+    readonly source: string;
+    readonly predicates: readonly {
+      readonly path: readonly number[];
+      readonly execution: "adapter" | "candidate" | "engine" | "source";
+    }[];
+    readonly sorting: "adapter" | "engine" | "none" | "source";
+    readonly pagination: "adapter" | "engine" | "none" | "source";
+    readonly rechecksFilter: boolean;
+    readonly native?: {
+      readonly language: string;
+      readonly text: string;
+    } | undefined;
+  } | undefined;
+  readonly commits?: number | undefined;
+  readonly complete?: boolean | undefined;
+  readonly error?: {
+    readonly kind: string;
+    readonly message: string;
+  } | undefined;
+}[];
+//#endregion
+export {};
+//# sourceMappingURL=replicationActivity.d.ts.map

package/lib/replicationActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicationActivity.d.ts","names":[],"sources":["../src/replicationActivity.ts"],"mappings":";;;KAGK,cAAc,YAAY;YACnB,oBAAoB,YAAY,WAAW;YAC3C,kBAAkB;YAClB,oBAAoB;;wBAEhB,gBACZ,gBAAgB,mBAChB,gBAAgB,6BACR;qBA2BC,YAAS;qBAET,WAAQ,QAAY,KAAK;wBAStB,iBAAiB,QAAQ,+BAA+B;;wBAexD,WACZ,QAAQ,KAAK,4CACb,gBAAgB"}

package/lib/replicationActivity.js

@@ -0,0 +1,54 @@
+//#region src/replicationActivity.ts
+/** Keep every span for the timeline, filling only requests whose span has left the trace buffer. */
+function diagnosticSpans(spans, loads) {
+	const retained = new Set(spans.map((span) => `${span.traceId}:${span.id}`));
+	return [...spans, ...loads.flatMap((load) => {
+		const id = load.spanId ?? `load:${load.id}`;
+		const traceId = load.traceId ?? `request:${load.id}`;
+		if (retained.has(`${traceId}:${id}`)) return [];
+		const attributes = load.subset ? { objectType: load.subset.objectType } : {};
+		return [{
+			id,
+			traceId,
+			name: `Replica.upstream.${load.operation}`,
+			startedAt: load.startedAt,
+			durationMs: load.finishedAt === void 0 ? 0 : Math.max(0, load.finishedAt - load.startedAt),
+			outcome: load.outcome,
+			...load.error ? { error: {
+				kind: "Error",
+				message: load.error.message
+			} } : {},
+			attributes
+		}];
+	})];
+}
+const queryText = (value) => JSON.stringify(value ?? {}, (_, item) => typeof item === "bigint" ? `${item}n` : item, 2);
+const demandId = (demand) => JSON.stringify({
+	objectType: demand.objectType,
+	query: demand.query
+}, (_, value) => {
+	if (typeof value === "bigint") return `${value}n`;
+	return value && typeof value === "object" && !Array.isArray(value) ? Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b))) : value;
+});
+function replicationState(status, error) {
+	if (error) return "Monitoring disconnected";
+	if (!status) return "Connecting…";
+	if (status.networkOnline === false) return "Offline";
+	if (status.authentication?.status === "needs-auth") return "Sign-in required";
+	if (status.authentication?.status === "error") return "Authentication failed";
+	if (status.authentication?.status === "inactive") return "Signed out";
+	if (status.authentication?.status === "pending") return "Authenticating…";
+	if (status.syncing) return "Syncing";
+	if (status.lastSync?.outcome === "failure") return "Sync failed";
+	if ((status.outbox.blocked ?? 0) > 0) return "Outbox paused";
+	return (status.outbox.acknowledged ?? 0) > 0 ? "Awaiting confirmation" : "Idle";
+}
+/** Exact recorded subset identity only; never attribute a broader/cache-covering load by type alone. */
+function queryLoads(demand, loads) {
+	const key = demandId(demand);
+	return loads.filter((load) => load.operation === "loadSubset" && load.subset && demandId(load.subset) === key);
+}
+//#endregion
+export { demandId, diagnosticSpans, queryLoads, queryText, replicationState };
+
+//# sourceMappingURL=replicationActivity.js.map

package/lib/replicationActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicationActivity.js","names":[],"sources":["../src/replicationActivity.ts"],"sourcesContent":["import type { PerformanceSpan } from \"./traceWaterfall.js\";\nimport type { LiveOntology } from \"@party-stack/ontology\";\n\ntype Diagnostics = NonNullable<LiveOntology[\"diagnostics\"]>;\nexport type ReplicationStatus = NonNullable<ReturnType<Diagnostics[\"replica\"][\"getSnapshot\"]>[\"status\"]>;\nexport type ReplicationLoad = ReplicationStatus[\"loads\"][number];\nexport type ReplicationDemand = ReplicationStatus[\"demands\"][number];\n/** Keep every span for the timeline, filling only requests whose span has left the trace buffer. */\nexport function diagnosticSpans(\n    spans: readonly PerformanceSpan[],\n    loads: readonly ReplicationLoad[]\n): readonly PerformanceSpan[] {\n    const retained = new Set(spans.map((span) => `${span.traceId}:${span.id}`));\n    return [\n        ...spans,\n        ...loads.flatMap((load) => {\n            const id = load.spanId ?? `load:${load.id}`;\n            const traceId = load.traceId ?? `request:${load.id}`;\n            if (retained.has(`${traceId}:${id}`)) return [];\n            const attributes: PerformanceSpan[\"attributes\"] = load.subset\n                ? { objectType: load.subset.objectType }\n                : {};\n            return [\n                {\n                    id,\n                    traceId,\n                    name: `Replica.upstream.${load.operation}`,\n                    startedAt: load.startedAt,\n                    durationMs:\n                        load.finishedAt === undefined ? 0 : Math.max(0, load.finishedAt - load.startedAt),\n                    outcome: load.outcome,\n                    ...(load.error ? { error: { kind: \"Error\" as const, message: load.error.message } } : {}),\n                    attributes,\n                },\n            ];\n        }),\n    ];\n}\nexport const queryText = (value: unknown) =>\n    JSON.stringify(value ?? {}, (_, item: unknown) => (typeof item === \"bigint\" ? `${item}n` : item), 2);\nexport const demandId = (demand: Pick<ReplicationDemand, \"objectType\" | \"query\">) =>\n    JSON.stringify({ objectType: demand.objectType, query: demand.query }, (_, value: unknown) => {\n        if (typeof value === \"bigint\") return `${value}n`;\n        // Storage copies and RPC can reorder object keys. Array order (including\n        // predicate and ordering precedence) remains significant.\n        return value && typeof value === \"object\" && !Array.isArray(value)\n            ? Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)))\n            : value;\n    });\nexport function replicationState(status: ReplicationStatus | undefined, error?: string) {\n    if (error) return \"Monitoring disconnected\";\n    if (!status) return \"Connecting…\";\n    if (status.networkOnline === false) return \"Offline\";\n    if (status.authentication?.status === \"needs-auth\") return \"Sign-in required\";\n    if (status.authentication?.status === \"error\") return \"Authentication failed\";\n    if (status.authentication?.status === \"inactive\") return \"Signed out\";\n    if (status.authentication?.status === \"pending\") return \"Authenticating…\";\n    if (status.syncing) return \"Syncing\";\n    if (status.lastSync?.outcome === \"failure\") return \"Sync failed\";\n    if ((status.outbox.blocked ?? 0) > 0) return \"Outbox paused\";\n    return (status.outbox.acknowledged ?? 0) > 0 ? \"Awaiting confirmation\" : \"Idle\";\n}\n\n/** Exact recorded subset identity only; never attribute a broader/cache-covering load by type alone. */\nexport function queryLoads(\n    demand: Pick<ReplicationDemand, \"objectType\" | \"query\">,\n    loads: readonly ReplicationLoad[]\n) {\n    const key = demandId(demand);\n    return loads.filter(\n        (load) => load.operation === \"loadSubset\" && load.subset && demandId(load.subset) === key\n    );\n}\n"],"mappings":";;AAQA,SAAgB,gBACZ,OACA,OAC0B;CAC1B,MAAM,WAAW,IAAI,IAAI,MAAM,KAAK,SAAS,GAAG,KAAK,QAAQ,GAAG,KAAK,IAAI,CAAC;CAC1E,OAAO,CACH,GAAG,OACH,GAAG,MAAM,SAAS,SAAS;EACvB,MAAM,KAAK,KAAK,UAAU,QAAQ,KAAK;EACvC,MAAM,UAAU,KAAK,WAAW,WAAW,KAAK;EAChD,IAAI,SAAS,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC;EAC9C,MAAM,aAA4C,KAAK,SACjD,EAAE,YAAY,KAAK,OAAO,WAAW,IACrC,CAAC;EACP,OAAO,CACH;GACI;GACA;GACA,MAAM,oBAAoB,KAAK;GAC/B,WAAW,KAAK;GAChB,YACI,KAAK,eAAe,KAAA,IAAY,IAAI,KAAK,IAAI,GAAG,KAAK,aAAa,KAAK,SAAS;GACpF,SAAS,KAAK;GACd,GAAI,KAAK,QAAQ,EAAE,OAAO;IAAE,MAAM;IAAkB,SAAS,KAAK,MAAM;GAAQ,EAAE,IAAI,CAAC;GACvF;EACJ,CACJ;CACJ,CAAC,CACL;AACJ;AACA,MAAa,aAAa,UACtB,KAAK,UAAU,SAAS,CAAC,IAAI,GAAG,SAAmB,OAAO,SAAS,WAAW,GAAG,KAAK,KAAK,MAAO,CAAC;AACvG,MAAa,YAAY,WACrB,KAAK,UAAU;CAAE,YAAY,OAAO;CAAY,OAAO,OAAO;AAAM,IAAI,GAAG,UAAmB;CAC1F,IAAI,OAAO,UAAU,UAAU,OAAO,GAAG,MAAM;CAG/C,OAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAC3D,OAAO,YAAY,OAAO,QAAQ,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,IAC/E;AACV,CAAC;AACL,SAAgB,iBAAiB,QAAuC,OAAgB;CACpF,IAAI,OAAO,OAAO;CAClB,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,kBAAkB,OAAO,OAAO;CAC3C,IAAI,OAAO,gBAAgB,WAAW,cAAc,OAAO;CAC3D,IAAI,OAAO,gBAAgB,WAAW,SAAS,OAAO;CACtD,IAAI,OAAO,gBAAgB,WAAW,YAAY,OAAO;CACzD,IAAI,OAAO,gBAAgB,WAAW,WAAW,OAAO;CACxD,IAAI,OAAO,SAAS,OAAO;CAC3B,IAAI,OAAO,UAAU,YAAY,WAAW,OAAO;CACnD,KAAK,OAAO,OAAO,WAAW,KAAK,GAAG,OAAO;CAC7C,QAAQ,OAAO,OAAO,gBAAgB,KAAK,IAAI,0BAA0B;AAC7E;;AAGA,SAAgB,WACZ,QACA,OACF;CACE,MAAM,MAAM,SAAS,MAAM;CAC3B,OAAO,MAAM,QACR,SAAS,KAAK,cAAc,gBAAgB,KAAK,UAAU,SAAS,KAAK,MAAM,MAAM,GAC1F;AACJ"}

package/lib/schemaLayout.d.ts

@@ -0,0 +1,35 @@
+import { Point } from "@dagrejs/dagre";
+import { ObjectTypeDef, OntologyIR } from "@party-stack/ontology";
+//#region src/schemaLayout.d.ts
+interface SchemaNode {
+  objectType: ObjectTypeDef;
+  x: number;
+  y: number;
+}
+interface SchemaEdge {
+  id: string;
+  label: string;
+  labelWidth: number;
+  labelX: number;
+  labelY: number;
+  points: Point[];
+}
+export declare function schemaLinkLabel(ir: OntologyIR, side: OntologyIR["linkTypes"][number]["source"], cardinality: "one" | "many"): string;
+/** Diagram arrows run from the referenced object to dependents, so many means one-to-many. */
+export declare function schemaRelationship(link: OntologyIR["linkTypes"][number]): {
+  id: string;
+  source: string;
+  target: string;
+  cardinality: "many" | "one";
+  label: string;
+  width: number;
+};
+export declare function layoutSchema(ir: OntologyIR): {
+  nodes: SchemaNode[];
+  edges: SchemaEdge[];
+  width: number;
+  height: number;
+};
+//#endregion
+export {};
+//# sourceMappingURL=schemaLayout.d.ts.map

package/lib/schemaLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaLayout.d.ts","names":[],"sources":["../src/schemaLayout.ts"],"mappings":";;;UAUU;EACN,YAAY;EACZ;EACA;;UAGM;EACN;EACA;EACA;EACA;EACA;EACA,QAAQ;;wBAUI,gBACZ,IAAI,YACJ,MAAM,2CACN;;wBAYY,mBAAmB,MAAM;;;;;;;;wBAYzB,aAAa,IAAI;EAC7B,OAAO;EACP,OAAO;EACP;EACA"}