@consciousclouds/operator-shell 0.1.0

package/dist/workspace/GraphWorkspace.js

@@ -0,0 +1,147 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Graph workspace type — the built-in entity-relationship exploration
+ * workspace: a typed nodes/edges contract rendered as ADJACENCY-STYLE
+ * exploration (select an entity → see its connections → traverse), composed
+ * entirely from registry primitives. No visualization dependency: the
+ * license allowlist is the open shadcn registry + Radix/CVA/lucide + the CC
+ * SDKs, so force-directed canvases (react-flow/d3) are deliberately outside
+ * this workspace's vocabulary — a master-detail adjacency browser is
+ * legitimate graph exploration without them.
+ *
+ * MECHANISM ONLY. The framework owns the hosting state machine
+ * (error → loading → empty → ready), the index/detail composition, selection,
+ * and traversal; the PRODUCT owns every node, edge, kind, and label — what an
+ * entity IS and what a relationship MEANS arrive fully resolved via the
+ * mount input. No routes, no fetching, no brand.
+ *
+ * FAIL-CLOSED details:
+ * - `error` renders the error state and NO graph (a failed read never shows
+ *   a misleading empty graph).
+ * - An edge endpoint that names an id not present in `nodes` renders as an
+ *   explicit UNRESOLVED connection — visible but not traversable. The
+ *   workspace never fabricates a node for a dangling reference.
+ *
+ * Frame-free by design (Separation Law): imports only React and the UI
+ * primitives — never the shell frame.
+ */
+import * as React from "react";
+import { Badge, Card, EmptyState, FailClosed, SectionHeading, Skeleton, cn, } from "@consciousclouds/ui";
+/** Neutral default while the product's reads are in flight. */
+function DefaultLoading() {
+    return (_jsxs("div", { className: "grid gap-4 lg:grid-cols-[280px_1fr]", children: [_jsx(Skeleton, { className: "h-72" }), _jsx(Skeleton, { className: "h-72" })] }));
+}
+function resolveGraph(nodes, edges, kinds) {
+    const byId = new Map();
+    for (const n of nodes)
+        if (!byId.has(n.id))
+            byId.set(n.id, n);
+    const outgoing = new Map();
+    const incoming = new Map();
+    const push = (map, key, e) => {
+        const list = map.get(key);
+        if (list)
+            list.push(e);
+        else
+            map.set(key, [e]);
+    };
+    for (const e of edges) {
+        push(outgoing, e.source, e);
+        push(incoming, e.target, e);
+    }
+    const kindLabel = new Map();
+    const order = [];
+    for (const k of kinds) {
+        if (!kindLabel.has(k.id)) {
+            kindLabel.set(k.id, k.label);
+            order.push(k.id);
+        }
+    }
+    for (const n of byId.values()) {
+        if (!kindLabel.has(n.kind)) {
+            kindLabel.set(n.kind, n.kind);
+            order.push(n.kind);
+        }
+    }
+    const groups = order
+        .map((id) => ({
+        id,
+        label: kindLabel.get(id),
+        nodes: [...byId.values()].filter((n) => n.kind === id),
+    }))
+        .filter((g) => g.nodes.length > 0);
+    return { byId, outgoing, incoming, groups, kindLabel };
+}
+/** One connection row: the relationship + the far endpoint (traversable when
+ * resolved; an explicit unresolved marker when the endpoint id is unknown). */
+function ConnectionRow({ edge, direction, resolved, onTraverse, }) {
+    const farId = direction === "outgoing" ? edge.target : edge.source;
+    const far = resolved.byId.get(farId);
+    const relation = edge.label ?? "related to";
+    if (!far) {
+        // FAIL-CLOSED: a dangling endpoint is shown, never fabricated or hidden.
+        return (_jsxs("li", { "data-graph-connection": edge.id, "data-graph-unresolved": farId, className: "flex items-center gap-2 rounded-md border border-dashed border-border px-3 py-2 text-sm text-muted-foreground", children: [_jsx("span", { className: "text-xs uppercase tracking-wide", children: relation }), _jsx("code", { className: "font-mono text-xs", children: farId }), _jsx(Badge, { variant: "warn", children: "not in this graph" })] }));
+    }
+    return (_jsx("li", { "data-graph-connection": edge.id, children: _jsxs("button", { type: "button", onClick: () => onTraverse(far.id), className: "flex w-full items-center gap-2 rounded-md border border-border px-3 py-2 text-left text-sm transition-colors hover:border-primary/40 hover:bg-accent", children: [_jsx("span", { className: "shrink-0 text-[11px] uppercase tracking-wide text-muted-foreground", children: direction === "outgoing" ? relation : `${relation} from` }), _jsx("span", { className: "min-w-0 flex-1 truncate font-medium", children: far.label }), _jsx(Badge, { variant: "muted", children: resolved.kindLabel.get(far.kind) ?? far.kind })] }) }));
+}
+/**
+ * The graph workspace component. Selection, traversal, and grouping are the
+ * framework's; every entity, relationship, and label is the product's.
+ */
+export function GraphWorkspace({ input, }) {
+    const { error, loading, nodes, edges, kinds, initialNodeId, emptyMessage, slots } = input;
+    // Hooks run unconditionally (state may flip between renders of one mount).
+    const resolved = React.useMemo(() => resolveGraph(nodes ?? [], edges ?? [], kinds ?? []), [nodes, edges, kinds]);
+    const [selectedId, setSelectedId] = React.useState(null);
+    // The traversal trail — where the operator came from (ids, oldest first).
+    const [trail, setTrail] = React.useState([]);
+    const firstId = resolved.groups[0]?.nodes[0]?.id ?? null;
+    const effectiveId = selectedId != null && resolved.byId.has(selectedId)
+        ? selectedId
+        : initialNodeId != null && resolved.byId.has(initialNodeId)
+            ? initialNodeId
+            : firstId;
+    const selected = effectiveId != null ? resolved.byId.get(effectiveId) : undefined;
+    if (error != null) {
+        return (_jsx("div", { "data-graph-workspace-state": "error", children: slots?.error ? slots.error(error) : _jsx(FailClosed, { what: "this graph", detail: error }) }));
+    }
+    if (loading) {
+        return (_jsx("div", { "data-graph-workspace-state": "loading", children: slots?.loading ?? _jsx(DefaultLoading, {}) }));
+    }
+    if (!selected) {
+        return (_jsx("div", { "data-graph-workspace-state": "empty", children: slots?.empty ?? (_jsx(EmptyState, { children: emptyMessage ?? "This graph has no entities yet." })) }));
+    }
+    const select = (id) => {
+        setTrail([]);
+        setSelectedId(id);
+    };
+    const traverse = (id) => {
+        if (effectiveId != null)
+            setTrail((t) => [...t, effectiveId]);
+        setSelectedId(id);
+    };
+    const jumpBack = (index) => {
+        const id = trail[index];
+        if (id == null)
+            return;
+        setTrail((t) => t.slice(0, index));
+        setSelectedId(id);
+    };
+    const out = resolved.outgoing.get(selected.id) ?? [];
+    const inc = resolved.incoming.get(selected.id) ?? [];
+    return (_jsxs("div", { "data-graph-workspace-state": "ready", className: "grid items-start gap-4 lg:grid-cols-[280px_1fr]", children: [_jsx(Card, { "data-graph-node-index": "", className: "gap-0 p-2", children: resolved.groups.map((group) => (_jsxs("div", { className: "px-1 pb-2", children: [_jsx(SectionHeading, { className: "px-2 pb-1", children: group.label }), _jsx("ul", { className: "space-y-0.5", children: group.nodes.map((node) => (_jsx("li", { children: _jsx("button", { type: "button", "data-graph-index-node": node.id, "aria-current": node.id === selected.id ? "true" : undefined, onClick: () => select(node.id), className: cn("w-full truncate rounded-md px-2 py-1.5 text-left text-sm transition-colors hover:bg-accent", node.id === selected.id
+                                        ? "bg-accent font-medium"
+                                        : "text-muted-foreground"), children: node.label }) }, node.id))) })] }, group.id))) }), _jsxs(Card, { "data-graph-node-detail": selected.id, className: "gap-0 p-4", children: [trail.length > 0 ? (_jsxs("nav", { "data-graph-trail": "", "aria-label": "Traversal trail", className: "mb-3 flex flex-wrap items-center gap-1 text-xs text-muted-foreground", children: [trail.map((id, i) => (_jsxs(React.Fragment, { children: [_jsx("button", { type: "button", onClick: () => jumpBack(i), className: "rounded px-1 py-0.5 underline-offset-2 transition-colors hover:bg-accent hover:underline", children: resolved.byId.get(id)?.label ?? id }), _jsx("span", { "aria-hidden": "true", children: "/" })] }, `${id}-${i}`))), _jsx("span", { className: "px-1 font-medium text-foreground", children: selected.label })] })) : null, _jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "min-w-0", children: [_jsx("h2", { className: "truncate text-lg font-semibold tracking-tight", children: selected.label }), _jsx("code", { className: "font-mono text-xs text-muted-foreground", children: selected.id })] }), _jsx(Badge, { variant: "active", children: resolved.kindLabel.get(selected.kind) ?? selected.kind })] }), selected.attributes && selected.attributes.length > 0 ? (_jsx("dl", { className: "mt-4 grid gap-x-6 gap-y-1.5 text-sm sm:grid-cols-2", children: selected.attributes.map((attr) => (_jsxs("div", { className: "flex items-baseline justify-between gap-3 sm:justify-start", children: [_jsx("dt", { className: "shrink-0 text-xs uppercase tracking-wide text-muted-foreground", children: attr.label }), _jsx("dd", { className: "min-w-0 truncate", children: attr.value })] }, attr.id))) })) : null, _jsx("div", { className: "mt-5 space-y-4", children: _jsxs("section", { children: [_jsx(SectionHeading, { className: "pb-2", children: "Connections" }), out.length === 0 && inc.length === 0 ? (_jsx("p", { "data-graph-no-connections": "", className: "text-sm text-muted-foreground", children: "This entity has no recorded connections." })) : (_jsxs("div", { className: "space-y-3", children: [out.length > 0 ? (_jsx("ul", { "data-graph-outgoing": "", className: "space-y-1.5", children: out.map((edge) => (_jsx(ConnectionRow, { edge: edge, direction: "outgoing", resolved: resolved, onTraverse: traverse }, edge.id))) })) : null, inc.length > 0 ? (_jsx("ul", { "data-graph-incoming": "", className: "space-y-1.5", children: inc.map((edge) => (_jsx(ConnectionRow, { edge: edge, direction: "incoming", resolved: resolved, onTraverse: traverse }, edge.id))) })) : null] }))] }) })] })] }));
+}
+/**
+ * The registered `graph` workspace type — compose it into the app's registry
+ * via `createWorkspaceRegistry([..., graphWorkspaceType])`.
+ */
+export const graphWorkspaceType = {
+    id: "graph",
+    displayName: "Graph",
+    description: "Entity-relationship exploration over a typed nodes/edges contract — select an entity, see its connections, traverse; dangling references fail closed.",
+    Component: GraphWorkspace,
+};
+//# sourceMappingURL=GraphWorkspace.js.map

package/dist/workspace/GraphWorkspace.js.map

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

package/dist/workspace/TableWorkspace.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Table workspace type — the built-in tabular-exploration workspace: hosts
+ * the graduated InteractiveDataTable composite (@consciousclouds/ui's
+ * interactive tier — registry `table` primitive + @tanstack/react-table)
+ * with client-side sorting, pagination, and explicit loading/empty states.
+ *
+ * MECHANISM ONLY. The framework owns the hosting state machine — a
+ * fail-closed `error` state layered ABOVE the composite's own loading/empty
+ * handling — and delegates everything tabular to InteractiveDataTable
+ * (consumed, never rebuilt). The PRODUCT owns the columns (typed
+ * `ColumnDef`s, sortable headers via DataTableColumnHeader), the rows, and
+ * the empty-state wording. No routes, no fetching, no brand: data arrives
+ * fully resolved via the mount input.
+ *
+ * Frame-free by design (Separation Law): imports only React and the UI
+ * primitives — never the shell frame.
+ */
+import type * as React from "react";
+import { type ColumnDef, type SortingState } from "@consciousclouds/ui";
+import type { WorkspaceComponentProps, WorkspaceType } from "./types.js";
+/** Product-supplied state content; a neutral fail-closed default otherwise. */
+export interface TableWorkspaceSlots {
+    /** Rendered when `error` is set; receives the error message. */
+    error?: (message: string) => React.ReactNode;
+}
+/**
+ * The table workspace mount input. Precedence (fail-closed first): `error` →
+ * the composite's own states (`loading` skeleton rows → empty message →
+ * rows). Column/row typing is erased at the registry boundary (see
+ * AnyWorkspaceType); each mount re-establishes `TData` at the call site.
+ */
+export interface TableWorkspaceInput<TData = unknown> {
+    /**
+     * A load-failure message. When set, the workspace renders the error state
+     * and NO table — a failed read fails closed rather than show a misleading
+     * empty result set.
+     */
+    error?: string | null;
+    /** The read is still in flight — the composite draws skeleton rows. */
+    loading?: boolean;
+    /** Typed column definitions (sortable headers via DataTableColumnHeader). */
+    columns: ColumnDef<TData, any>[];
+    /** The resolved rows. */
+    data: TData[];
+    /** Optional title bar above the table. */
+    title?: React.ReactNode;
+    /** The honest zero state when a completed read has no rows. */
+    emptyMessage?: React.ReactNode;
+    /** Client-side page size (controls appear only past one page). */
+    pageSize?: number;
+    /** Initial sort, e.g. `[{ id: "name", desc: false }]`. */
+    initialSorting?: SortingState;
+    /** Stable row identity (defaults to the row index). */
+    getRowId?: (row: TData, index: number) => string;
+    /**
+     * Row activation — click/Enter/Space on a data row (e.g. the page opens
+     * the shell's inspector on the row's entity). Forwarded to the composite;
+     * the framework never interprets the row.
+     */
+    onRowClick?: (row: TData) => void;
+    /** Product-supplied state content; a neutral default otherwise. */
+    slots?: TableWorkspaceSlots;
+}
+/**
+ * The table workspace component. The framework selects the state; the
+ * composite renders the table; the product means the columns and rows.
+ */
+export declare function TableWorkspace<TData = unknown>({ input, }: WorkspaceComponentProps<TableWorkspaceInput<TData>>): import("react/jsx-runtime").JSX.Element;
+/**
+ * The registered `table` workspace type — compose it into the app's registry
+ * via `createWorkspaceRegistry([..., tableWorkspaceType])`.
+ */
+export declare const tableWorkspaceType: WorkspaceType<TableWorkspaceInput>;
+//# sourceMappingURL=TableWorkspace.d.ts.map

package/dist/workspace/TableWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableWorkspace.d.ts","sourceRoot":"","sources":["../../src/workspace/TableWorkspace.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,GAAG,OAAO;IAClD;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAE7E,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;IACjC,yBAAyB;IACzB,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,mEAAmE;IACnE,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,OAAO,EAAE,EAC9C,KAAK,GACN,EAAE,uBAAuB,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,2CA0CrD;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,mBAAmB,CAMjE,CAAC"}

package/dist/workspace/TableWorkspace.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { FailClosed, InteractiveDataTable, } from "@consciousclouds/ui";
+/**
+ * The table workspace component. The framework selects the state; the
+ * composite renders the table; the product means the columns and rows.
+ */
+export function TableWorkspace({ input, }) {
+    const { error, loading, columns, data, title, emptyMessage, pageSize, initialSorting, getRowId, onRowClick, slots, } = input;
+    if (error != null) {
+        return (_jsx("div", { "data-table-workspace-state": "error", children: slots?.error ? (slots.error(error)) : (_jsx(FailClosed, { what: "this table", detail: error })) }));
+    }
+    return (_jsx("div", { "data-table-workspace-state": loading ? "loading" : "ready", children: _jsx(InteractiveDataTable, { columns: columns, data: data, title: title, loading: loading, emptyMessage: emptyMessage, pageSize: pageSize, initialSorting: initialSorting, getRowId: getRowId, onRowClick: onRowClick }) }));
+}
+/**
+ * The registered `table` workspace type — compose it into the app's registry
+ * via `createWorkspaceRegistry([..., tableWorkspaceType])`.
+ */
+export const tableWorkspaceType = {
+    id: "table",
+    displayName: "Data Table",
+    description: "Tabular data exploration over the interactive data-table composite — client-side sorting, pagination, explicit loading/empty states.",
+    Component: TableWorkspace,
+};
+//# sourceMappingURL=TableWorkspace.js.map

package/dist/workspace/TableWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableWorkspace.js","sourceRoot":"","sources":["../../src/workspace/TableWorkspace.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAsBb,OAAO,EACL,UAAU,EACV,oBAAoB,GAGrB,MAAM,qBAAqB,CAAC;AAkD7B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAkB,EAC9C,KAAK,GAC+C;IACpD,MAAM,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,UAAU,EACV,KAAK,GACN,GAAG,KAAK,CAAC;IAEV,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,CACL,4CAAgC,OAAO,YACpC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CACd,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CACnB,CAAC,CAAC,CAAC,CACF,KAAC,UAAU,IAAC,IAAI,EAAC,YAAY,EAAC,MAAM,EAAE,KAAK,GAAI,CAChD,GACG,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,4CAAiC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,YAC5D,KAAC,oBAAoB,IACnB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,GACtB,GACE,CACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAuC;IACpE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,YAAY;IACzB,WAAW,EACT,sIAAsI;IACxI,SAAS,EAAE,cAAc;CAC1B,CAAC"}

package/dist/workspace/WorkspaceHost.d.ts

@@ -0,0 +1,26 @@
+import type { WorkspaceRegistry } from "./registry.js";
+export interface WorkspaceHostProps<TInput = unknown> {
+    /** The composed registry (shell built-ins + product additions). */
+    registry: WorkspaceRegistry;
+    /**
+     * The workspace type to mount — runtime data (a route/flavor says what the
+     * main region is), so any string is accepted and unknowns fail closed.
+     */
+    typeId: string;
+    /** Optional instance title, passed through to the mounted component. */
+    title?: string;
+    /** The mount's input data — opaque to the host, typed by the workspace type. */
+    input: TInput;
+    /** Extra classes for the host wrapper. */
+    className?: string;
+}
+/**
+ * The neutral unavailable state an unknown/unregistered type id renders.
+ * Exported so products can present the same state for their own gated
+ * workspace affordances (one vocabulary of "not available here").
+ */
+export declare function WorkspaceUnavailable({ typeId }: {
+    typeId: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function WorkspaceHost<TInput = unknown>({ registry, typeId, title, input, className, }: WorkspaceHostProps<TInput>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkspaceHost.d.ts.map

package/dist/workspace/WorkspaceHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceHost.d.ts","sourceRoot":"","sources":["../../src/workspace/WorkspaceHost.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,kBAAkB,CAAC,MAAM,GAAG,OAAO;IAClD,mEAAmE;IACnE,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,2CAkBlE;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,EAC9C,QAAQ,EACR,MAAM,EACN,KAAK,EACL,KAAK,EACL,SAAS,GACV,EAAE,kBAAkB,CAAC,MAAM,CAAC,2CAe5B"}

package/dist/workspace/WorkspaceHost.js

@@ -0,0 +1,21 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@consciousclouds/ui";
+import { CircleAlert } from "lucide-react";
+/**
+ * The neutral unavailable state an unknown/unregistered type id renders.
+ * Exported so products can present the same state for their own gated
+ * workspace affordances (one vocabulary of "not available here").
+ */
+export function WorkspaceUnavailable({ typeId }) {
+    return (_jsxs(Card, { "data-workspace-unavailable": typeId, className: "border-dashed", children: [_jsxs(CardHeader, { children: [_jsxs(CardTitle, { className: "flex items-center gap-2 text-muted-foreground", children: [_jsx(CircleAlert, { className: "size-4", "aria-hidden": "true" }), "Workspace unavailable"] }), _jsxs(CardDescription, { children: ["No workspace type is registered for ", _jsx("code", { className: "font-mono", children: typeId }), "."] })] }), _jsx(CardContent, { className: "text-sm text-muted-foreground", children: "This surface declared a workspace the console has not registered. Nothing was rendered \u2014 unregistered workspace types fail closed." })] }));
+}
+export function WorkspaceHost({ registry, typeId, title, input, className, }) {
+    const type = registry.get(typeId);
+    if (!type) {
+        return _jsx(WorkspaceUnavailable, { typeId: typeId });
+    }
+    const Component = type.Component;
+    return (_jsx("div", { "data-workspace-type": typeId, className: className, children: _jsx(Component, { typeId: typeId, title: title, input: input }) }));
+}
+//# sourceMappingURL=WorkspaceHost.js.map

package/dist/workspace/WorkspaceHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceHost.js","sourceRoot":"","sources":["../../src/workspace/WorkspaceHost.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAmBb,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAoB3C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,MAAM,EAAsB;IACjE,OAAO,CACL,MAAC,IAAI,kCAA6B,MAAM,EAAE,SAAS,EAAC,eAAe,aACjE,MAAC,UAAU,eACT,MAAC,SAAS,IAAC,SAAS,EAAC,+CAA+C,aAClE,KAAC,WAAW,IAAC,SAAS,EAAC,QAAQ,iBAAa,MAAM,GAAG,6BAE3C,EACZ,MAAC,eAAe,uDACsB,eAAM,SAAS,EAAC,WAAW,YAAE,MAAM,GAAQ,SAC/D,IACP,EACb,KAAC,WAAW,IAAC,SAAS,EAAC,+BAA+B,wJAGxC,IACT,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAmB,EAC9C,QAAQ,EACR,MAAM,EACN,KAAK,EACL,KAAK,EACL,SAAS,GACkB;IAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAC,oBAAoB,IAAC,MAAM,EAAE,MAAM,GAAI,CAAC;IAClD,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAIrB,CAAC;IACH,OAAO,CACL,qCAA0B,MAAM,EAAE,SAAS,EAAE,SAAS,YACpD,KAAC,SAAS,IAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAI,GACrD,CACP,CAAC;AACJ,CAAC"}

package/dist/workspace/registry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Workspace Framework — the type registry.
+ *
+ * A value-based, immutable registry (no module-global mutable state): the
+ * app composes shell built-ins + product-registered types ONCE and hands
+ * the result to the WorkspaceHost. Registration is compile-time honest
+ * (ids come from the declared vocabulary); resolution accepts any string —
+ * runtime data — and FAILS CLOSED on an unknown/unregistered id.
+ *
+ * Frame-free by design (Separation Law): nothing here imports the shell.
+ */
+import type { AnyWorkspaceType } from "./types.js";
+/** An immutable, resolved set of workspace types. */
+export interface WorkspaceRegistry {
+    /** Resolve a type by id; `undefined` for anything not registered. */
+    get(id: string): AnyWorkspaceType | undefined;
+    /** Is this id registered? */
+    has(id: string): boolean;
+    /** The registered ids, in registration order. */
+    ids(): readonly string[];
+}
+/**
+ * Build a registry from workspace types (shell built-ins first, then product
+ * additions, combined by the caller). A DUPLICATE id throws — registration
+ * is composition-time, so a collision is a programming error, never a
+ * runtime negotiation (last-write-wins would let a product silently replace
+ * a shell built-in).
+ */
+export declare function createWorkspaceRegistry(types: readonly AnyWorkspaceType[]): WorkspaceRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/workspace/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/workspace/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC9C,6BAA6B;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,iDAAiD;IACjD,GAAG,IAAI,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GACjC,iBAAiB,CAenB"}

package/dist/workspace/registry.js

@@ -0,0 +1,33 @@
+/**
+ * Workspace Framework — the type registry.
+ *
+ * A value-based, immutable registry (no module-global mutable state): the
+ * app composes shell built-ins + product-registered types ONCE and hands
+ * the result to the WorkspaceHost. Registration is compile-time honest
+ * (ids come from the declared vocabulary); resolution accepts any string —
+ * runtime data — and FAILS CLOSED on an unknown/unregistered id.
+ *
+ * Frame-free by design (Separation Law): nothing here imports the shell.
+ */
+/**
+ * Build a registry from workspace types (shell built-ins first, then product
+ * additions, combined by the caller). A DUPLICATE id throws — registration
+ * is composition-time, so a collision is a programming error, never a
+ * runtime negotiation (last-write-wins would let a product silently replace
+ * a shell built-in).
+ */
+export function createWorkspaceRegistry(types) {
+    const byId = new Map();
+    for (const type of types) {
+        if (byId.has(type.id)) {
+            throw new Error(`createWorkspaceRegistry: duplicate workspace type id "${type.id}"`);
+        }
+        byId.set(type.id, type);
+    }
+    return {
+        get: (id) => byId.get(id),
+        has: (id) => byId.has(id),
+        ids: () => [...byId.keys()],
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/workspace/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/workspace/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAkC;IAElC,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,yDAAyD,IAAI,CAAC,EAAE,GAAG,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO;QACL,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/workspace/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Workspace Framework — the type contract (the shell's main-region seam).
+ *
+ * The shell's main region is a WORKSPACE, not a page body: an operator
+ * surface is an AI-native operating environment, and what fills its main
+ * region is a typed, registered workspace — a canvas, a graph exploration,
+ * a data table, a form, a dashboard — mounted through one host
+ * (docs/design/frontend-platform-v1-mission.md, the Workspace Framework
+ * correction).
+ *
+ * This subtree is deliberately SELF-CONTAINED: it imports nothing from the
+ * shell frame (frame/header/sidebar/nav/flavor/guard/icons), so a future
+ * extraction into its own package is a photograph, not a negotiation
+ * (Separation Law, docs/design/separation-law.md).
+ */
+import type * as React from "react";
+/**
+ * The full V1 workspace-type vocabulary, declared NOW so later types are
+ * additions, never surgery:
+ *
+ * - `canvas`    — a Canvas workspace over @consciousclouds/canvas-sdk +
+ *                 canvas-runtime (first-class; consumed, never rebuilt).
+ * - `dashboard` — stat/overview composition (built-in, this mission).
+ * - `table`     — tabular data exploration (built-in, this mission).
+ * - `form`      — structured input/editing (built-in, this mission).
+ * - `graph`     — entity-relationship exploration over existing reads.
+ * - `map`       — geographic workspace (typed seam; no honest data source
+ *                 yet — deferred implementation).
+ * - `timeline`  — temporal/event workspace (typed seam; deferred).
+ * - `workflow`  — durable-process workspace (typed seam; deferred — see
+ *                 docs/design/workflow-contract.md for the backend dual).
+ * - `ai-session`— a reasoning/AI-session workspace (typed seam; deferred).
+ */
+export declare const WORKSPACE_TYPE_IDS: readonly ["canvas", "dashboard", "table", "form", "graph", "map", "timeline", "workflow", "ai-session"];
+/** One of the nine declared workspace-type ids. */
+export type WorkspaceTypeId = (typeof WORKSPACE_TYPE_IDS)[number];
+/** Type guard: is this string one of the declared V1 workspace-type ids? */
+export declare function isWorkspaceTypeId(id: string): id is WorkspaceTypeId;
+/**
+ * The mount contract — what every workspace component receives from the
+ * host. `input` is the page/route-supplied data for THIS mount (typed per
+ * workspace type); the framework carries it opaquely and never interprets it.
+ */
+export interface WorkspaceComponentProps<TInput = unknown> {
+    /** The type id this component was registered under. */
+    typeId: string;
+    /** Optional instance title (display only; the host renders no chrome for it). */
+    title?: string;
+    /** The mount's input data — meaning belongs to the workspace type. */
+    input: TInput;
+}
+/**
+ * A registered workspace type: id + display metadata + the component the
+ * host mounts. Registration is composition-time (shell built-ins + product
+ * additions); resolution at render time is fail-closed.
+ */
+export interface WorkspaceType<TInput = unknown> {
+    /** One of the declared vocabulary ids (compile-time checked). */
+    id: WorkspaceTypeId;
+    /** Human display name (e.g. `Canvas`, `Data Table`). */
+    displayName: string;
+    /** One-line description of what this workspace type presents. */
+    description?: string;
+    /**
+     * Icon by NAME, resolved through the shell's icon registry by whoever
+     * renders workspace chrome — never an imported component here (the
+     * subtree stays frame-free).
+     */
+    icon?: string;
+    /** The component the WorkspaceHost mounts for this type. */
+    Component: React.ComponentType<WorkspaceComponentProps<TInput>>;
+}
+/**
+ * A workspace type as stored/resolved — input typing is erased at the
+ * registry boundary (heterogeneous types share one registry; each mount
+ * re-establishes its own `TInput`).
+ */
+export type AnyWorkspaceType = WorkspaceType<any>;
+//# sourceMappingURL=types.d.ts.map

package/dist/workspace/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,yGAUrB,CAAC;AAEX,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,eAAe,CAEnE;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,OAAO;IACvD,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM,GAAG,OAAO;IAC7C,iEAAiE;IACjE,EAAE,EAAE,eAAe,CAAC;IACpB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;CACjE;AAED;;;;GAIG;AAEH,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC"}

package/dist/workspace/types.js

@@ -0,0 +1,48 @@
+/**
+ * Workspace Framework — the type contract (the shell's main-region seam).
+ *
+ * The shell's main region is a WORKSPACE, not a page body: an operator
+ * surface is an AI-native operating environment, and what fills its main
+ * region is a typed, registered workspace — a canvas, a graph exploration,
+ * a data table, a form, a dashboard — mounted through one host
+ * (docs/design/frontend-platform-v1-mission.md, the Workspace Framework
+ * correction).
+ *
+ * This subtree is deliberately SELF-CONTAINED: it imports nothing from the
+ * shell frame (frame/header/sidebar/nav/flavor/guard/icons), so a future
+ * extraction into its own package is a photograph, not a negotiation
+ * (Separation Law, docs/design/separation-law.md).
+ */
+/**
+ * The full V1 workspace-type vocabulary, declared NOW so later types are
+ * additions, never surgery:
+ *
+ * - `canvas`    — a Canvas workspace over @consciousclouds/canvas-sdk +
+ *                 canvas-runtime (first-class; consumed, never rebuilt).
+ * - `dashboard` — stat/overview composition (built-in, this mission).
+ * - `table`     — tabular data exploration (built-in, this mission).
+ * - `form`      — structured input/editing (built-in, this mission).
+ * - `graph`     — entity-relationship exploration over existing reads.
+ * - `map`       — geographic workspace (typed seam; no honest data source
+ *                 yet — deferred implementation).
+ * - `timeline`  — temporal/event workspace (typed seam; deferred).
+ * - `workflow`  — durable-process workspace (typed seam; deferred — see
+ *                 docs/design/workflow-contract.md for the backend dual).
+ * - `ai-session`— a reasoning/AI-session workspace (typed seam; deferred).
+ */
+export const WORKSPACE_TYPE_IDS = [
+    "canvas",
+    "dashboard",
+    "table",
+    "form",
+    "graph",
+    "map",
+    "timeline",
+    "workflow",
+    "ai-session",
+];
+/** Type guard: is this string one of the declared V1 workspace-type ids? */
+export function isWorkspaceTypeId(id) {
+    return WORKSPACE_TYPE_IDS.includes(id);
+}
+//# sourceMappingURL=types.js.map

package/dist/workspace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,WAAW;IACX,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,UAAU;IACV,UAAU;IACV,YAAY;CACJ,CAAC;AAKX,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@consciousclouds/operator-shell",
+  "version": "0.1.0",
+  "description": "ConsciousClouds Operator Shell — the operator-console shell archetype: frame, header, sidebar, nav engine, icon registry, OperatorFlavor types, permission-guard slot, and the Chief region (panel chrome over assistant-surface; transport injected via TurnAdapter — the product owns the wire). Layer 4 of the Frontend Platform.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles/source.css": "./styles/source.css"
+  },
+  "files": [
+    "dist",
+    "styles",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "test": "bun test",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "bun run clean && bun run build && bun run type-check"
+  },
+  "dependencies": {
+    "@consciousclouds/assistant-surface": "0.2.0",
+    "@consciousclouds/brand": "0.1.0",
+    "@consciousclouds/canvas-runtime": "0.2.0",
+    "@consciousclouds/canvas-sdk": "0.2.0",
+    "@consciousclouds/conductor-react": "0.1.0",
+    "@consciousclouds/conductor-sdk": "0.1.0",
+    "@consciousclouds/frontend-runtime": "0.2.0",
+    "@consciousclouds/ui": "0.1.0",
+    "lucide-react": "^1.7.0"
+  },
+  "peerDependencies": {
+    "@consciousclouds/tokens": "0.1.0",
+    "next": ">=15.0.0 <17.0.0",
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@consciousclouds/tokens": "0.1.0",
+    "@happy-dom/global-registrator": "^20.10.3",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.1",
+    "happy-dom": "^20.10.3",
+    "next": "^16.1.6",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.0.0",
+    "node": ">=18.0.0"
+  }
+}

package/styles/source.css

@@ -0,0 +1,16 @@
+/*
+ * @consciousclouds/operator-shell — Tailwind v4 source registration.
+ *
+ * Tailwind v4 does not scan node_modules: without this, utility classes that
+ * exist ONLY inside this package's components would be missing from an app's
+ * generated CSS. Import from the app's Tailwind entry stylesheet, after
+ * Tailwind itself:
+ *
+ *   @import "tailwindcss";
+ *   @import "@consciousclouds/operator-shell/styles/source.css";
+ *
+ * The path is relative to THIS file, so it resolves inside the installed
+ * package regardless of where the consuming app lives.
+ */
+
+@source "../dist";