@consciousclouds/operator-shell 0.1.0

package/dist/sidebar/OperatorSidebar.js

@@ -0,0 +1,30 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+import { Sidebar, SidebarContent, SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarRail, } from "@consciousclouds/ui";
+import { collectPermissionRefs } from "../guard/permissions.js";
+import { usePermissionDecisions } from "../guard/PermissionProvider.js";
+import { resolveIcon } from "../icons/registry.js";
+import { deriveGatedNavGroups, isNavItemActive } from "../nav/routes.js";
+export function OperatorSidebar({ flavor, resolvePermission, icons, iconFamily, workspaceSwitcher, }) {
+    const pathname = usePathname();
+    const { product } = flavor;
+    // One batch resolution for the whole tree — each reference resolved once,
+    // sync decisions on the first render, async ones settling from `loading`.
+    const permissionRefs = collectPermissionRefs(flavor.nav.flatMap((group) => group.items));
+    const decisions = usePermissionDecisions(permissionRefs, resolvePermission);
+    // The pure derivation (nav/routes.ts): denied items don't exist, loading
+    // items keep a slot, emptied groups vanish.
+    const groups = deriveGatedNavGroups(flavor.nav, decisions);
+    return (_jsxs(Sidebar, { collapsible: "icon", className: "top-(--header-height) h-[calc(100svh-var(--header-height))]!", children: [_jsxs(SidebarHeader, { className: "border-b border-sidebar-border px-4 py-3 group-data-[collapsible=icon]:hidden", children: [workspaceSwitcher, product.label && (_jsx("div", { className: "text-[10px] font-semibold tracking-wider text-primary uppercase", children: product.label })), _jsx("div", { className: "truncate text-sm font-semibold text-sidebar-foreground", children: product.name }), product.note && (_jsx("div", { className: "text-[11px] leading-snug text-muted-foreground", children: product.note }))] }), _jsx(SidebarContent, { children: groups.map(({ group, items }) => (_jsxs(SidebarGroup, { children: [_jsx(SidebarGroupLabel, { children: group.label }), _jsx(SidebarGroupContent, { children: _jsx(SidebarMenu, { children: items.map(({ item, status }) => {
+                                    if (status === "loading") {
+                                        // The decision is in flight: hold the slot, never flash
+                                        // a destination the resolver may take away.
+                                        return (_jsx(SidebarMenuItem, { "data-slot": "nav-permission-loading", children: _jsx(SidebarMenuSkeleton, { showIcon: true }) }, item.id));
+                                    }
+                                    const Icon = resolveIcon(item.icon, icons, iconFamily);
+                                    return (_jsx(SidebarMenuItem, { children: _jsx(SidebarMenuButton, { asChild: true, isActive: isNavItemActive(item.href, pathname), tooltip: item.label, children: _jsxs(Link, { href: item.href, children: [_jsx(Icon, {}), _jsx("span", { children: item.label })] }) }) }, item.id));
+                                }) }) })] }, group.id))) }), _jsx(SidebarRail, {})] }));
+}
+//# sourceMappingURL=OperatorSidebar.js.map

package/dist/sidebar/OperatorSidebar.js.map

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

package/dist/workspace/CanvasWorkspace.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Canvas workspace type — the FIRST-CLASS canvas workspace (the mission's
+ * AI-native correction made real: a Canvas is a peer workspace in the main
+ * region, not a bolt-on page).
+ *
+ * MECHANISM ONLY. The framework owns the hosting state machine
+ * (error → loading → empty → ready) and delegates rendering to the published
+ * @consciousclouds/canvas-runtime CanvasRenderer — consumed as-is, never
+ * rebuilt (the renderer keeps its own fail-closed behavior: unknown/removed/
+ * unmapped node types render placeholders, permission-filtered nodes drop).
+ *
+ * MEANING stays with the product: the product fetches the CanvasDefinition
+ * (it owns routes/BFF — no URL ever enters this package), supplies the
+ * ComponentMap for approved node types, and may supply loading/error/empty
+ * slot content in its own words. The framework's default slot content is
+ * neutral and fail-closed.
+ *
+ * Frame-free by design (Separation Law): imports only React, the UI
+ * primitives, and the canvas SDKs — never the shell frame.
+ */
+import type * as React from "react";
+import { type ActionHandler, type ComponentMap } from "@consciousclouds/canvas-runtime";
+import type { CanvasDefinition } from "@consciousclouds/canvas-sdk";
+import type { WorkspaceComponentProps, WorkspaceType } from "./types.js";
+/**
+ * Product-supplied state content. Each slot replaces the framework's neutral
+ * default for that state — the product speaks in its own words (fail-closed
+ * copy, domain-specific empty states) while the framework decides WHICH
+ * state renders.
+ */
+export interface CanvasWorkspaceSlots {
+    /** Rendered while `definition` is still null and no error is set. */
+    loading?: React.ReactNode;
+    /** Rendered when `error` is set; receives the error message. */
+    error?: (message: string) => React.ReactNode;
+    /** Rendered when the definition resolved but has zero nodes. */
+    empty?: React.ReactNode;
+}
+/**
+ * The canvas workspace mount input. The product owns the fetch lifecycle and
+ * hands the framework its current state; the framework owns the state
+ * machine and the renderer mount.
+ *
+ * Precedence (fail-closed first): `error` → loading (`definition === null`)
+ * → empty (zero nodes) → ready (CanvasRenderer).
+ */
+export interface CanvasWorkspaceInput {
+    /** The canvas to render; `null` while the product is still loading it. */
+    definition: CanvasDefinition | null;
+    /**
+     * A load-failure message. When set, the workspace renders the error slot
+     * and NOTHING else — a failed read fails closed rather than showing a
+     * misleading empty surface.
+     */
+    error?: string | null;
+    /** Product implementations of approved canvas node types (renderer-injected). */
+    componentMap: ComponentMap;
+    /** Receives dispatched node actions (the renderer never navigates directly). */
+    onAction?: ActionHandler;
+    /**
+     * Caller permissions, forwarded verbatim to CanvasRenderer's node-level
+     * permission filtering. Omitted = filtering not engaged (renderer default).
+     */
+    permissions?: string[];
+    /** Product-supplied state content; neutral defaults otherwise. */
+    slots?: CanvasWorkspaceSlots;
+}
+/**
+ * The canvas workspace component. State selection is the framework's; state
+ * content and canvas meaning are the product's.
+ */
+export declare function CanvasWorkspace({ input, }: WorkspaceComponentProps<CanvasWorkspaceInput>): import("react/jsx-runtime").JSX.Element;
+/**
+ * The registered `canvas` workspace type — compose it into the app's
+ * registry via `createWorkspaceRegistry([canvasWorkspaceType, ...])`.
+ */
+export declare const canvasWorkspaceType: WorkspaceType<CanvasWorkspaceInput>;
+//# sourceMappingURL=CanvasWorkspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasWorkspace.d.ts","sourceRoot":"","sources":["../../src/workspace/CanvasWorkspace.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7C,gEAAgE;IAChE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iFAAiF;IACjF,YAAY,EAAE,YAAY,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,kEAAkE;IAClE,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAmCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,GACN,EAAE,uBAAuB,CAAC,oBAAoB,CAAC,2CAqC/C;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,oBAAoB,CAMnE,CAAC"}

package/dist/workspace/CanvasWorkspace.js

@@ -0,0 +1,44 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CanvasRenderer, } from "@consciousclouds/canvas-runtime";
+import { Skeleton } from "@consciousclouds/ui";
+/** Neutral default while the product's canvas read is in flight. */
+function DefaultLoading() {
+    return (_jsxs("div", { className: "space-y-3", children: [_jsx(Skeleton, { className: "h-7 w-44" }), _jsx(Skeleton, { className: "h-16 w-full" }), _jsx(Skeleton, { className: "h-16 w-full" })] }));
+}
+/** Neutral default when the product's canvas read failed — explicit, never blank. */
+function DefaultError({ message }) {
+    return (_jsxs("div", { role: "alert", className: "rounded-lg border border-destructive/30 bg-destructive/5 p-4 text-sm text-destructive", children: ["Couldn't load this canvas (", message, "). The workspace fails closed rather than render a misleading empty surface."] }));
+}
+/** Neutral default when the canvas resolved with zero nodes. */
+function DefaultEmpty() {
+    return (_jsx("div", { className: "rounded-lg border border-border bg-card p-4 text-sm text-muted-foreground", children: "This canvas has no content yet." }));
+}
+/**
+ * The canvas workspace component. State selection is the framework's; state
+ * content and canvas meaning are the product's.
+ */
+export function CanvasWorkspace({ input, }) {
+    const { definition, error, componentMap, onAction, permissions, slots } = input;
+    if (error != null) {
+        return (_jsx("div", { "data-canvas-workspace-state": "error", children: slots?.error ? slots.error(error) : _jsx(DefaultError, { message: error }) }));
+    }
+    if (definition === null) {
+        return (_jsx("div", { "data-canvas-workspace-state": "loading", children: slots?.loading ?? _jsx(DefaultLoading, {}) }));
+    }
+    if (definition.nodes.length === 0) {
+        return (_jsx("div", { "data-canvas-workspace-state": "empty", children: slots?.empty ?? _jsx(DefaultEmpty, {}) }));
+    }
+    return (_jsx("div", { "data-canvas-workspace-state": "ready", children: _jsx(CanvasRenderer, { definition: definition, componentMap: componentMap, onAction: onAction, permissions: permissions }) }));
+}
+/**
+ * The registered `canvas` workspace type — compose it into the app's
+ * registry via `createWorkspaceRegistry([canvasWorkspaceType, ...])`.
+ */
+export const canvasWorkspaceType = {
+    id: "canvas",
+    displayName: "Canvas",
+    description: "Renders a CanvasDefinition through the published canvas-runtime with a product-injected component map.",
+    Component: CanvasWorkspace,
+};
+//# sourceMappingURL=CanvasWorkspace.js.map

package/dist/workspace/CanvasWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasWorkspace.js","sourceRoot":"","sources":["../../src/workspace/CanvasWorkspace.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAyBb,OAAO,EACL,cAAc,GAGf,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAiD/C,oEAAoE;AACpE,SAAS,cAAc;IACrB,OAAO,CACL,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,GAAG,EACjC,KAAC,QAAQ,IAAC,SAAS,EAAC,aAAa,GAAG,EACpC,KAAC,QAAQ,IAAC,SAAS,EAAC,aAAa,GAAG,IAChC,CACP,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,SAAS,YAAY,CAAC,EAAE,OAAO,EAAuB;IACpD,OAAO,CACL,eACE,IAAI,EAAC,OAAO,EACZ,SAAS,EAAC,uFAAuF,4CAEhE,OAAO,oFAEpC,CACP,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAS,YAAY;IACnB,OAAO,CACL,cAAK,SAAS,EAAC,2EAA2E,gDAEpF,CACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,GACyC;IAC9C,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAEhF,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,CACL,6CAAiC,OAAO,YACrC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAC,YAAY,IAAC,OAAO,EAAE,KAAK,GAAI,GACjE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CACL,6CAAiC,SAAS,YACvC,KAAK,EAAE,OAAO,IAAI,KAAC,cAAc,KAAG,GACjC,CACP,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CACL,6CAAiC,OAAO,YACrC,KAAK,EAAE,KAAK,IAAI,KAAC,YAAY,KAAG,GAC7B,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,6CAAiC,OAAO,YACtC,KAAC,cAAc,IACb,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACxB,GACE,CACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwC;IACtE,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,QAAQ;IACrB,WAAW,EACT,wGAAwG;IAC1G,SAAS,EAAE,eAAe;CAC3B,CAAC"}

package/dist/workspace/DashboardWorkspace.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Dashboard workspace type — the built-in stat/overview workspace: a
+ * widget-slot composition of the GRADUATED workspace components (StatCard ·
+ * SectionHeading · EmptyState · FailClosed from @consciousclouds/ui).
+ *
+ * MECHANISM ONLY. The framework owns the hosting state machine
+ * (error → loading → empty → ready) and the composition order (notice strip →
+ * stat grid → titled widget sections); the PRODUCT owns every value: stat
+ * labels/values/trends (favorability is the caller's judgment — see
+ * StatCardTrend), the notice wording (e.g. data-freshness honesty), and each
+ * section's widget content (tables, charts, lists — arbitrary ReactNode
+ * slots). 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 StatCardTrend } from "@consciousclouds/ui";
+import type { WorkspaceComponentProps, WorkspaceType } from "./types.js";
+/** One stat tile in the dashboard's stat grid — rendered through StatCard. */
+export interface DashboardWorkspaceStat {
+    /** Stable key for the tile. */
+    id: string;
+    label: React.ReactNode;
+    /** Nullish/empty renders as an em dash (StatCard's honest missing state). */
+    value?: React.ReactNode;
+    /** Previous-period / context line under the label. */
+    hint?: React.ReactNode;
+    /** Trend delta badge — supply ONLY when the data honestly carries a trend. */
+    trend?: StatCardTrend;
+    /** Footnote under the value (e.g. "vs last month"). */
+    caption?: React.ReactNode;
+}
+/** One titled widget section below the stat grid. */
+export interface DashboardWorkspaceSection {
+    /** Stable key for the section. */
+    id: string;
+    /** Optional section heading (rendered through SectionHeading). */
+    heading?: React.ReactNode;
+    /**
+     * The widget slot — product-supplied content (a DataTable, a chart, a
+     * list…). The framework places it; the product means it.
+     */
+    content: React.ReactNode;
+}
+/** Product-supplied state content; neutral fail-closed defaults otherwise. */
+export interface DashboardWorkspaceSlots {
+    /** Rendered while `loading` is true and no error is set. */
+    loading?: React.ReactNode;
+    /** Rendered when `error` is set; receives the error message. */
+    error?: (message: string) => React.ReactNode;
+    /** Rendered when a completed read yields zero stats AND zero sections. */
+    empty?: React.ReactNode;
+}
+/**
+ * The dashboard workspace mount input. Precedence (fail-closed first):
+ * `error` → `loading` → empty (no stats, no sections) → ready.
+ */
+export interface DashboardWorkspaceInput {
+    /**
+     * A load-failure message. When set, the workspace renders the error state
+     * and NOTHING else — a failed read fails closed rather than show a
+     * misleading empty dashboard.
+     */
+    error?: string | null;
+    /** The read is still in flight. */
+    loading?: boolean;
+    /**
+     * An annotation strip above the stat grid — the product's honesty seam
+     * (e.g. "since boot · in-memory" freshness wording). Optional.
+     */
+    notice?: React.ReactNode;
+    /** The stat grid (2-up, 4-up from `sm`). */
+    stats?: DashboardWorkspaceStat[];
+    /** Titled widget sections below the stat grid, in order. */
+    sections?: DashboardWorkspaceSection[];
+    /** Product-supplied state content; neutral defaults otherwise. */
+    slots?: DashboardWorkspaceSlots;
+}
+/**
+ * The dashboard workspace component. State selection and composition order
+ * are the framework's; every value is the product's.
+ */
+export declare function DashboardWorkspace({ input, }: WorkspaceComponentProps<DashboardWorkspaceInput>): import("react/jsx-runtime").JSX.Element;
+/**
+ * The registered `dashboard` workspace type — compose it into the app's
+ * registry via `createWorkspaceRegistry([..., dashboardWorkspaceType])`.
+ */
+export declare const dashboardWorkspaceType: WorkspaceType<DashboardWorkspaceInput>;
+//# sourceMappingURL=DashboardWorkspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardWorkspace.d.ts","sourceRoot":"","sources":["../../src/workspace/DashboardWorkspace.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,sDAAsD;IACtD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,qDAAqD;AACrD,MAAM,WAAW,yBAAyB;IACxC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7C,0EAA0E;IAC1E,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACvC,kEAAkE;IAClE,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAiBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,GACN,EAAE,uBAAuB,CAAC,uBAAuB,CAAC,2CAiElD;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,uBAAuB,CAMzE,CAAC"}

package/dist/workspace/DashboardWorkspace.js

@@ -0,0 +1,39 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { EmptyState, FailClosed, SectionHeading, Skeleton, StatCard, } from "@consciousclouds/ui";
+/** Neutral default while the product's read is in flight. */
+function DefaultLoading() {
+    return (_jsxs("div", { className: "space-y-3", children: [_jsxs("div", { className: "grid grid-cols-2 gap-3 sm:grid-cols-4", children: [_jsx(Skeleton, { className: "h-20" }), _jsx(Skeleton, { className: "h-20" }), _jsx(Skeleton, { className: "h-20" }), _jsx(Skeleton, { className: "h-20" })] }), _jsx(Skeleton, { className: "h-40 w-full" })] }));
+}
+/**
+ * The dashboard workspace component. State selection and composition order
+ * are the framework's; every value is the product's.
+ */
+export function DashboardWorkspace({ input, }) {
+    const { error, loading, notice, stats, sections, slots } = input;
+    if (error != null) {
+        return (_jsx("div", { "data-dashboard-workspace-state": "error", children: slots?.error ? (slots.error(error)) : (_jsx(FailClosed, { what: "this dashboard", detail: error })) }));
+    }
+    if (loading) {
+        return (_jsx("div", { "data-dashboard-workspace-state": "loading", children: slots?.loading ?? _jsx(DefaultLoading, {}) }));
+    }
+    const hasStats = (stats?.length ?? 0) > 0;
+    const hasSections = (sections?.length ?? 0) > 0;
+    if (!hasStats && !hasSections) {
+        return (_jsx("div", { "data-dashboard-workspace-state": "empty", children: slots?.empty ?? (_jsx(EmptyState, { children: "This dashboard has no data yet." })) }));
+    }
+    return (_jsxs("div", { "data-dashboard-workspace-state": "ready", className: "space-y-4", children: [notice != null ? _jsx("div", { children: notice }) : null, hasStats ? (_jsx("div", { className: "grid grid-cols-2 gap-3 sm:grid-cols-4", children: stats.map((s) => (_jsx(StatCard, { label: s.label, value: s.value, hint: s.hint, trend: s.trend, caption: s.caption, size: "lg" }, s.id))) })) : null, hasSections
+                ? sections.map((section) => (_jsxs("section", { className: "space-y-4", children: [section.heading != null ? (_jsx(SectionHeading, { children: section.heading })) : null, section.content] }, section.id)))
+                : null] }));
+}
+/**
+ * The registered `dashboard` workspace type — compose it into the app's
+ * registry via `createWorkspaceRegistry([..., dashboardWorkspaceType])`.
+ */
+export const dashboardWorkspaceType = {
+    id: "dashboard",
+    displayName: "Dashboard",
+    description: "Stat/overview composition of the graduated workspace components — a stat grid plus titled widget-slot sections.",
+    Component: DashboardWorkspace,
+};
+//# sourceMappingURL=DashboardWorkspace.js.map

package/dist/workspace/DashboardWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardWorkspace.js","sourceRoot":"","sources":["../../src/workspace/DashboardWorkspace.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAsBb,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,QAAQ,EACR,QAAQ,GAET,MAAM,qBAAqB,CAAC;AAoE7B,6DAA6D;AAC7D,SAAS,cAAc;IACrB,OAAO,CACL,eAAK,SAAS,EAAC,WAAW,aACxB,eAAK,SAAS,EAAC,uCAAuC,aACpD,KAAC,QAAQ,IAAC,SAAS,EAAC,MAAM,GAAG,EAC7B,KAAC,QAAQ,IAAC,SAAS,EAAC,MAAM,GAAG,EAC7B,KAAC,QAAQ,IAAC,SAAS,EAAC,MAAM,GAAG,EAC7B,KAAC,QAAQ,IAAC,SAAS,EAAC,MAAM,GAAG,IACzB,EACN,KAAC,QAAQ,IAAC,SAAS,EAAC,aAAa,GAAG,IAChC,CACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,KAAK,GAC4C;IACjD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAEjE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,CACL,gDAAoC,OAAO,YACxC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CACd,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CACnB,CAAC,CAAC,CAAC,CACF,KAAC,UAAU,IAAC,IAAI,EAAC,gBAAgB,EAAC,MAAM,EAAE,KAAK,GAAI,CACpD,GACG,CACP,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CACL,gDAAoC,SAAS,YAC1C,KAAK,EAAE,OAAO,IAAI,KAAC,cAAc,KAAG,GACjC,CACP,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,CACL,gDAAoC,OAAO,YACxC,KAAK,EAAE,KAAK,IAAI,CACf,KAAC,UAAU,kDAA6C,CACzD,GACG,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,iDAAoC,OAAO,EAAC,SAAS,EAAC,WAAW,aAC9D,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,wBAAM,MAAM,GAAO,CAAC,CAAC,CAAC,IAAI,EAC3C,QAAQ,CAAC,CAAC,CAAC,CACV,cAAK,SAAS,EAAC,uCAAuC,YACnD,KAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACjB,KAAC,QAAQ,IAEP,KAAK,EAAE,CAAC,CAAC,KAAK,EACd,KAAK,EAAE,CAAC,CAAC,KAAK,EACd,IAAI,EAAE,CAAC,CAAC,IAAI,EACZ,KAAK,EAAE,CAAC,CAAC,KAAK,EACd,OAAO,EAAE,CAAC,CAAC,OAAO,EAClB,IAAI,EAAC,IAAI,IANJ,CAAC,CAAC,EAAE,CAOT,CACH,CAAC,GACE,CACP,CAAC,CAAC,CAAC,IAAI,EACP,WAAW;gBACV,CAAC,CAAC,QAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACzB,mBAA0B,SAAS,EAAC,WAAW,aAC5C,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CACzB,KAAC,cAAc,cAAE,OAAO,CAAC,OAAO,GAAkB,CACnD,CAAC,CAAC,CAAC,IAAI,EACP,OAAO,CAAC,OAAO,KAJJ,OAAO,CAAC,EAAE,CAKd,CACX,CAAC;gBACJ,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2C;IAC5E,EAAE,EAAE,WAAW;IACf,WAAW,EAAE,WAAW;IACxB,WAAW,EACT,iHAAiH;IACnH,SAAS,EAAE,kBAAkB;CAC9B,CAAC"}

package/dist/workspace/FormWorkspace.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Form workspace type — the built-in structured-input workspace: hosts the
+ * graduated forms set's PRESENTATIONAL tier (Field / FieldGroup / FieldSet /
+ * FieldLegend / FieldLabel / FieldDescription / FieldError from
+ * @consciousclouds/ui — no form-state library).
+ *
+ * MECHANISM ONLY, two deliberate tiers (mirroring the ui forms-set tiers):
+ * this workspace composes the Field vocabulary — sections of labelled,
+ * described, error-annotated fields around PRODUCT-SUPPLIED controls — and
+ * owns the hosting state machine (error → loading → empty → ready) plus the
+ * `<form>` element. Controlled validation state stays the PRODUCT's: a
+ * product that needs react-hook-form composes ui's `Form`/`FormField`
+ * primitives inside its control nodes (or its own workspace type) — the
+ * framework never owns form state, schemas, or submission transport
+ * (`onSubmit` is a seam; the product owns the wire).
+ *
+ * Ships as mechanism: CCU currently has no honest write surface (the gateway
+ * admin plane is read-only), so no CCU page exercises this type yet — it is
+ * registered, fail-closed, and ready for the first real write surface.
+ *
+ * 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 { WorkspaceComponentProps, WorkspaceType } from "./types.js";
+/** One field: label + optional description/error chrome around a product control. */
+export interface FormWorkspaceField {
+    /** Stable key for the field. */
+    id: string;
+    label: React.ReactNode;
+    /** Connects the label to the control — supply the control's element id. */
+    htmlFor?: string;
+    /** Helper text under the control. */
+    description?: React.ReactNode;
+    /**
+     * The control slot — a product-supplied control (Input, Select, Textarea,
+     * Checkbox, a react-hook-form-wired composition, …). The framework renders
+     * chrome around it; it never inspects it.
+     */
+    control: React.ReactNode;
+    /**
+     * A validation message. When set, the field renders FieldError and marks
+     * itself invalid — the JUDGMENT (what is invalid) is the product's.
+     */
+    error?: React.ReactNode;
+    /** Field layout; matches the ui Field orientations. @default "vertical" */
+    orientation?: "vertical" | "horizontal" | "responsive";
+}
+/** One fieldset: optional legend/description + its fields, in order. */
+export interface FormWorkspaceSection {
+    /** Stable key for the section. */
+    id: string;
+    /** Optional fieldset legend. */
+    legend?: React.ReactNode;
+    /** Optional description under the legend. */
+    description?: React.ReactNode;
+    fields: FormWorkspaceField[];
+}
+/** Product-supplied state content; neutral fail-closed defaults otherwise. */
+export interface FormWorkspaceSlots {
+    /** Rendered while `loading` is true and no error is set. */
+    loading?: React.ReactNode;
+    /** Rendered when `error` is set; receives the error message. */
+    error?: (message: string) => React.ReactNode;
+    /** Rendered when the input declares zero sections. */
+    empty?: React.ReactNode;
+}
+/**
+ * The form workspace mount input. Precedence (fail-closed first): `error`
+ * (the LOAD failure — distinct from per-field validation errors) → `loading`
+ * → empty (zero sections) → ready.
+ */
+export interface FormWorkspaceInput {
+    /**
+     * A load-failure message (the read that seeds the form failed). When set,
+     * the workspace renders the error state and NO form — never a form over
+     * data that didn't load.
+     */
+    error?: string | null;
+    /** The seeding read is still in flight. */
+    loading?: boolean;
+    /** The fieldsets, in order. */
+    sections: FormWorkspaceSection[];
+    /**
+     * The actions slot (submit/cancel buttons) — product-supplied, rendered
+     * after the last section.
+     */
+    actions?: React.ReactNode;
+    /**
+     * Submit seam. The framework calls `preventDefault()` first — submission
+     * transport is the product's, never a browser navigation.
+     */
+    onSubmit?: (event: React.FormEvent<HTMLFormElement>) => void;
+    /** Product-supplied state content; neutral defaults otherwise. */
+    slots?: FormWorkspaceSlots;
+}
+/**
+ * The form workspace component. The framework owns chrome + state selection;
+ * the product owns controls, validation judgment, and submission transport.
+ */
+export declare function FormWorkspace({ input, }: WorkspaceComponentProps<FormWorkspaceInput>): import("react/jsx-runtime").JSX.Element;
+/**
+ * The registered `form` workspace type — compose it into the app's registry
+ * via `createWorkspaceRegistry([..., formWorkspaceType])`.
+ */
+export declare const formWorkspaceType: WorkspaceType<FormWorkspaceInput>;
+//# sourceMappingURL=FormWorkspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormWorkspace.d.ts","sourceRoot":"","sources":["../../src/workspace/FormWorkspace.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAepC,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B;;;;OAIG;IACH,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;CACxD;AAED,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7C,sDAAsD;IACtD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;IAC7D,kEAAkE;IAClE,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAcD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,GACN,EAAE,uBAAuB,CAAC,kBAAkB,CAAC,2CAwE7C;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,kBAAkB,CAM/D,CAAC"}

package/dist/workspace/FormWorkspace.js

@@ -0,0 +1,38 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { EmptyState, FailClosed, Field, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSet, Skeleton, } from "@consciousclouds/ui";
+/** Neutral default while the product's seeding read is in flight. */
+function DefaultLoading() {
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(Skeleton, { className: "h-5 w-40" }), _jsx(Skeleton, { className: "h-9 w-full" }), _jsx(Skeleton, { className: "h-9 w-full" }), _jsx(Skeleton, { className: "h-9 w-2/3" })] }));
+}
+/**
+ * The form workspace component. The framework owns chrome + state selection;
+ * the product owns controls, validation judgment, and submission transport.
+ */
+export function FormWorkspace({ input, }) {
+    const { error, loading, sections, actions, onSubmit, slots } = input;
+    if (error != null) {
+        return (_jsx("div", { "data-form-workspace-state": "error", children: slots?.error ? (slots.error(error)) : (_jsx(FailClosed, { what: "this form", detail: error })) }));
+    }
+    if (loading) {
+        return (_jsx("div", { "data-form-workspace-state": "loading", children: slots?.loading ?? _jsx(DefaultLoading, {}) }));
+    }
+    if (sections.length === 0) {
+        return (_jsx("div", { "data-form-workspace-state": "empty", children: slots?.empty ?? _jsx(EmptyState, { children: "This form has no fields." }) }));
+    }
+    return (_jsx("form", { "data-form-workspace-state": "ready", onSubmit: (event) => {
+            event.preventDefault();
+            onSubmit?.(event);
+        }, children: _jsxs(FieldGroup, { children: [sections.map((section) => (_jsxs(FieldSet, { children: [section.legend != null ? (_jsx(FieldLegend, { children: section.legend })) : null, section.description != null ? (_jsx(FieldDescription, { children: section.description })) : null, _jsx(FieldGroup, { children: section.fields.map((field) => (_jsxs(Field, { orientation: field.orientation, "data-invalid": field.error != null ? true : undefined, children: [_jsx(FieldLabel, { htmlFor: field.htmlFor, children: field.label }), field.control, field.description != null ? (_jsx(FieldDescription, { children: field.description })) : null, field.error != null ? (_jsx(FieldError, { children: field.error })) : null] }, field.id))) })] }, section.id))), actions != null ? _jsx(Field, { orientation: "horizontal", children: actions }) : null] }) }));
+}
+/**
+ * The registered `form` workspace type — compose it into the app's registry
+ * via `createWorkspaceRegistry([..., formWorkspaceType])`.
+ */
+export const formWorkspaceType = {
+    id: "form",
+    displayName: "Form",
+    description: "Structured input over the presentational forms set — sections of labelled fields around product-supplied controls; form state and submission stay product-owned.",
+    Component: FormWorkspace,
+};
+//# sourceMappingURL=FormWorkspace.js.map

package/dist/workspace/FormWorkspace.js.map

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

package/dist/workspace/GraphWorkspace.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 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 type { WorkspaceComponentProps, WorkspaceType } from "./types.js";
+/** One attribute row on a node's detail panel — the product's resolved fact. */
+export interface GraphWorkspaceNodeAttribute {
+    /** Stable key for the row. */
+    id: string;
+    label: React.ReactNode;
+    value: React.ReactNode;
+}
+/** One entity in the graph. `kind` is a product-defined vocabulary id. */
+export interface GraphWorkspaceNode {
+    /** Globally unique node id (edges reference it). */
+    id: string;
+    /** Display name. */
+    label: string;
+    /** Product-defined kind id (grouped in the index; labeled via `kinds`). */
+    kind: string;
+    /** Resolved facts shown on the detail panel. */
+    attributes?: GraphWorkspaceNodeAttribute[];
+}
+/** One directed relationship. `label` is the product's relationship name. */
+export interface GraphWorkspaceEdge {
+    /** Stable edge id (dedupe/dedup keys belong to the product). */
+    id: string;
+    /** Source node id. */
+    source: string;
+    /** Target node id. */
+    target: string;
+    /** Relationship name (e.g. `grants`, `uses`); shown on connection rows. */
+    label?: string;
+}
+/** Display metadata for a node kind — order here orders the index groups. */
+export interface GraphWorkspaceKind {
+    id: string;
+    /** Group heading in the index (e.g. `Products`). */
+    label: string;
+}
+/** Product-supplied state content; neutral fail-closed defaults otherwise. */
+export interface GraphWorkspaceSlots {
+    /** Rendered while `loading` is true and no error is set. */
+    loading?: React.ReactNode;
+    /** Rendered when `error` is set; receives the error message. */
+    error?: (message: string) => React.ReactNode;
+    /** Rendered when a completed read yields zero nodes. */
+    empty?: React.ReactNode;
+}
+/**
+ * The graph workspace mount input. Precedence (fail-closed first): `error` →
+ * `loading` → empty (zero nodes) → ready.
+ */
+export interface GraphWorkspaceInput {
+    /**
+     * A load-failure message. When set, the workspace renders the error state
+     * and NO graph — a failed read fails closed rather than show a misleading
+     * empty graph.
+     */
+    error?: string | null;
+    /** The read is still in flight. */
+    loading?: boolean;
+    /** The entities. */
+    nodes?: GraphWorkspaceNode[];
+    /** The directed relationships between them. */
+    edges?: GraphWorkspaceEdge[];
+    /**
+     * Kind display metadata; index groups follow this order, then any kinds
+     * not listed here in order of first appearance (labeled by their raw id).
+     */
+    kinds?: GraphWorkspaceKind[];
+    /** The initially selected node; unknown ids fall back to the first node. */
+    initialNodeId?: string;
+    /** The honest zero state when a completed read has no entities. */
+    emptyMessage?: React.ReactNode;
+    /** Product-supplied state content; neutral defaults otherwise. */
+    slots?: GraphWorkspaceSlots;
+}
+/**
+ * The graph workspace component. Selection, traversal, and grouping are the
+ * framework's; every entity, relationship, and label is the product's.
+ */
+export declare function GraphWorkspace({ input, }: WorkspaceComponentProps<GraphWorkspaceInput>): import("react/jsx-runtime").JSX.Element;
+/**
+ * The registered `graph` workspace type — compose it into the app's registry
+ * via `createWorkspaceRegistry([..., graphWorkspaceType])`.
+ */
+export declare const graphWorkspaceType: WorkspaceType<GraphWorkspaceInput>;
+//# sourceMappingURL=GraphWorkspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GraphWorkspace.d.ts","sourceRoot":"","sources":["../../src/workspace/GraphWorkspace.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,gFAAgF;AAChF,MAAM,WAAW,2BAA2B;IAC1C,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,UAAU,CAAC,EAAE,2BAA2B,EAAE,CAAC;CAC5C;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7C,wDAAwD;IACxD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB;IACpB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,kEAAkE;IAClE,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAkHD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,GACN,EAAE,uBAAuB,CAAC,mBAAmB,CAAC,2CA+L9C;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,mBAAmB,CAMjE,CAAC"}