@fallen-8/studio 0.0.32

package/dist-lib/types/app/AppShell.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from "react";
+/**
+ * App shell: left icon rail + top bar with the instance / namespace pair (FR-1b +
+ * feature graph-namespaces). Every screen renders under a bar that names the active
+ * instance, the active namespace, and the resulting endpoint prefix, so production is
+ * never mistaken for local and namespaces are never implicit.
+ */
+export declare function AppShell({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist-lib/types/app/NamespaceScope.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Layout under /q/$ns/… (feature graph-namespaces): keeps the registry's active namespace
+ * in sync with the URL (the URL is the deep-link source of truth), and renders the
+ * "recreate or switch" recover state — never a blank screen — when the URL names a
+ * namespace this Fallen-8 does not hold (dropped elsewhere, stale link).
+ *
+ * Its third branch is a namespace that EXISTS but was not loaded into the running process
+ * (feature namespace-startup-load), which is a different situation with a different answer:
+ * see the comment on that branch for why it must not reuse the recover state.
+ */
+export declare function NamespaceScope(): import("react").JSX.Element;

package/dist-lib/types/app/applyStudioConfig.d.ts

@@ -0,0 +1,18 @@
+import { type StudioConfig } from "./studioConfig";
+/**
+ * Make a mount's config the active one BEFORE anything renders (feature studio-embeddable).
+ *
+ * The three module-level persisted stores are re-pointed at the (possibly prefixed) storage
+ * keys and hydrated - their first and only hydration, since they skip the import-time one -
+ * which also injects the host's managed instances and namespace pin via the registry's
+ * merge. Each of those merges derives its persisted fields from storage plus config alone,
+ * so a mount that switches `storageNamespace` starts clean instead of inheriting the
+ * previous mount's state. The per-instance workspace stores bake their key in at creation,
+ * so the previous mount's memoized ones are dropped here rather than handed to this one.
+ *
+ * localStorage is synchronous, so all of this state is in place when the first render reads
+ * it. Idempotent on purpose: StrictMode double-invokes the initializer that calls it.
+ *
+ * Lives outside mount.tsx so it is exercisable (and testable) without the React shell.
+ */
+export declare function applyStudioConfig(config: StudioConfig): void;

package/dist-lib/types/app/mount.d.ts

@@ -0,0 +1,19 @@
+import { QueryClient } from "@tanstack/react-query";
+import { type StudioConfig } from "./studioConfig";
+import "../index.css";
+/**
+ * How to mount Studio: `mountStudio(container, config?)` for an imperative or
+ * framework-free host, `<F8Studio config={...}/>` for a React host, and no config at all
+ * for the standalone app (main.tsx). The config is read once per mount, so changing it
+ * means remounting; the contract itself lives in ./studioConfig.ts.
+ */
+/** Studio's own QueryClient - the exact defaults the standalone app has always used. */
+export declare function createStudioQueryClient(): QueryClient;
+/** React-host embedding. No StrictMode wrapper - that is the host's call. */
+export declare function F8Studio({ config }: {
+    config?: StudioConfig;
+}): import("react").JSX.Element;
+/** Imperative mounting - the standalone entry (main.tsx) and framework-free hosts. */
+export declare function mountStudio(el: HTMLElement, config?: StudioConfig): {
+    unmount(): void;
+};

package/dist-lib/types/app/nav.d.ts

@@ -0,0 +1,91 @@
+/**
+ * The Studio navigation: the single source of truth for the shell's icon rail and for anything
+ * keyed by section (e.g. the per-section help in lib/sectionHelp.ts). Connect, Save games and
+ * Integrations are Fallen-8-level (flat routes); the rest operate on the ACTIVE NAMESPACE and
+ * live under /q/{ns}/… (feature graph-namespaces).
+ *
+ * An entry may declare a `capability`, which the shell reads to HIDE it rather than disable it. Only
+ * one does: an instance either has an integrations runtime or has nothing to say about integrations,
+ * and a permanently disabled icon would advertise a deployable that is not there.
+ */
+export declare const NAV: readonly [{
+    readonly leaf: "/";
+    readonly label: "Connect";
+    readonly icon: "◉";
+    readonly scoped: false;
+}, {
+    readonly leaf: "dashboard";
+    readonly label: "Dashboard";
+    readonly icon: "▦";
+    readonly scoped: true;
+}, {
+    readonly leaf: "samples";
+    readonly label: "Samples";
+    readonly icon: "◈";
+    readonly scoped: true;
+}, {
+    readonly leaf: "/save-games";
+    readonly label: "Save games";
+    readonly icon: "⭯";
+    readonly scoped: false;
+}, {
+    readonly leaf: "browser";
+    readonly label: "Browser";
+    readonly icon: "☰";
+    readonly scoped: true;
+}, {
+    readonly leaf: "query";
+    readonly label: "Query";
+    readonly icon: "∴";
+    readonly scoped: true;
+}, {
+    readonly leaf: "indexes";
+    readonly label: "Indexes";
+    readonly icon: "⌗";
+    readonly scoped: true;
+}, {
+    readonly leaf: "path";
+    readonly label: "Path";
+    readonly icon: "↝";
+    readonly scoped: true;
+}, {
+    readonly leaf: "subgraphs";
+    readonly label: "Subgraph";
+    readonly icon: "◫";
+    readonly scoped: true;
+}, {
+    readonly leaf: "analytics";
+    readonly label: "Analytics";
+    readonly icon: "∑";
+    readonly scoped: true;
+}, {
+    readonly leaf: "plugins";
+    readonly label: "Plugins";
+    readonly icon: "⧉";
+    readonly scoped: true;
+}, {
+    readonly leaf: "canvas";
+    readonly label: "Canvas";
+    readonly icon: "❉";
+    readonly scoped: true;
+}, {
+    readonly leaf: "benchmarks";
+    readonly label: "Benchmark";
+    readonly icon: "◔";
+    readonly scoped: true;
+}, {
+    readonly leaf: "knowledge";
+    readonly label: "Knowledge";
+    readonly icon: "▤";
+    readonly scoped: true;
+}, {
+    readonly leaf: "/integrations";
+    readonly label: "Integrations";
+    readonly icon: "⇄";
+    readonly scoped: false;
+    readonly capability: "integrations";
+}];
+/** One navigation entry. */
+export type NavItem = (typeof NAV)[number];
+/** The capability an entry needs, or undefined when it always belongs in the rail. */
+export declare function navCapability(item: NavItem): "integrations" | undefined;

package/dist-lib/types/app/routes.d.ts

@@ -0,0 +1,9 @@
+import type { StudioConfig } from "./studioConfig";
+/**
+ * The router, parameterized by the embed seams (feature studio-embeddable): `basepath`
+ * mounts every route under the host's prefix (default "": root, as standalone), and
+ * `history: "memory"` keeps Studio out of the address bar when the host owns the URL.
+ */
+export declare function createStudioRouter(config?: Pick<StudioConfig, "basepath" | "history">): import("@tanstack/router-core").RouterCore<import("@tanstack/router-core").Route<import("@tanstack/react-router").Register, any, "/", "/", string, "__root__", undefined, {}, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, readonly [import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", string, "/", undefined, import("@tanstack/router-core").ResolveParams<"/">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/save-games", "/save-games", string, "/save-games", undefined, import("@tanstack/router-core").ResolveParams<"/save-games">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/integrations", "/integrations", string, "/integrations", undefined, import("@tanstack/router-core").ResolveParams<"/integrations">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/router-core").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, readonly [import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "dashboard", "/q/$ns/dashboard", string, "/q/$ns/dashboard", undefined, import("@tanstack/router-core").ResolveParams<"dashboard">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "samples", "/q/$ns/samples", string, "/q/$ns/samples", undefined, import("@tanstack/router-core").ResolveParams<"samples">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "browser", "/q/$ns/browser", string, "/q/$ns/browser", undefined, import("@tanstack/router-core").ResolveParams<"browser">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "knowledge", "/q/$ns/knowledge", string, "/q/$ns/knowledge", undefined, import("@tanstack/router-core").ResolveParams<"knowledge">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "documents", "/q/$ns/documents", string, "/q/$ns/documents", undefined, import("@tanstack/router-core").ResolveParams<"documents">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, ({ params }: import("@tanstack/router-core").BeforeLoadContextOptions<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, undefined, import("@tanstack/router-core").ResolveParams<"documents">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, "/q/$ns/documents", unknown, undefined>) => never, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "query", "/q/$ns/query", string, "/q/$ns/query", undefined, import("@tanstack/router-core").ResolveParams<"query">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "indexes", "/q/$ns/indexes", string, "/q/$ns/indexes", undefined, import("@tanstack/router-core").ResolveParams<"indexes">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "path", "/q/$ns/path", string, "/q/$ns/path", undefined, import("@tanstack/router-core").ResolveParams<"path">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "subgraphs", "/q/$ns/subgraphs", string, "/q/$ns/subgraphs", undefined, import("@tanstack/router-core").ResolveParams<"subgraphs">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "analytics", "/q/$ns/analytics", string, "/q/$ns/analytics", undefined, import("@tanstack/router-core").ResolveParams<"analytics">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "plugins", "/q/$ns/plugins", string, "/q/$ns/plugins", undefined, import("@tanstack/router-core").ResolveParams<"plugins">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "canvas", "/q/$ns/canvas", string, "/q/$ns/canvas", undefined, import("@tanstack/router-core").ResolveParams<"canvas">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "benchmarks", "/q/$ns/benchmarks", string, "/q/$ns/benchmarks", undefined, import("@tanstack/router-core").ResolveParams<"benchmarks">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>], unknown, unknown, unknown, undefined>, ...import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/dashboard" | "/browser" | "/query" | "/indexes" | "/path" | "/subgraphs" | "/analytics" | "/canvas" | "/benchmarks", "/dashboard" | "/browser" | "/query" | "/indexes" | "/path" | "/subgraphs" | "/analytics" | "/canvas" | "/benchmarks", string, "/dashboard" | "/browser" | "/query" | "/indexes" | "/path" | "/subgraphs" | "/analytics" | "/canvas" | "/benchmarks", undefined, import("@tanstack/router-core").ResolveParams<"/dashboard" | "/browser" | "/query" | "/indexes" | "/path" | "/subgraphs" | "/analytics" | "/canvas" | "/benchmarks">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, () => never, {}, undefined, unknown, unknown, unknown, unknown, undefined>[]], unknown, unknown, unknown, undefined>, "never", false, import("@tanstack/history").RouterHistory, Record<string, any>>;
+/** The standalone router: root basepath, browser history - exactly the pre-seam behavior. */
+export declare const router: import("@tanstack/router-core").RouterCore<import("@tanstack/router-core").Route<import("@tanstack/react-router").Register, any, "/", "/", string, "__root__", undefined, {}, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, readonly [import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", string, "/", undefined, import("@tanstack/router-core").ResolveParams<"/">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/save-games", "/save-games", string, "/save-games", undefined, import("@tanstack/router-core").ResolveParams<"/save-games">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/integrations", "/integrations", string, "/integrations", undefined, import("@tanstack/router-core").ResolveParams<"/integrations">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/router-core").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, readonly [import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "dashboard", "/q/$ns/dashboard", string, "/q/$ns/dashboard", undefined, import("@tanstack/router-core").ResolveParams<"dashboard">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "samples", "/q/$ns/samples", string, "/q/$ns/samples", undefined, import("@tanstack/router-core").ResolveParams<"samples">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "browser", "/q/$ns/browser", string, "/q/$ns/browser", undefined, import("@tanstack/router-core").ResolveParams<"browser">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "knowledge", "/q/$ns/knowledge", string, "/q/$ns/knowledge", undefined, import("@tanstack/router-core").ResolveParams<"knowledge">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "documents", "/q/$ns/documents", string, "/q/$ns/documents", undefined, import("@tanstack/router-core").ResolveParams<"documents">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, ({ params }: import("@tanstack/router-core").BeforeLoadContextOptions<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, undefined, import("@tanstack/router-core").ResolveParams<"documents">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, "/q/$ns/documents", unknown, undefined>) => never, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "query", "/q/$ns/query", string, "/q/$ns/query", undefined, import("@tanstack/router-core").ResolveParams<"query">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "indexes", "/q/$ns/indexes", string, "/q/$ns/indexes", undefined, import("@tanstack/router-core").ResolveParams<"indexes">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "path", "/q/$ns/path", string, "/q/$ns/path", undefined, import("@tanstack/router-core").ResolveParams<"path">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "subgraphs", "/q/$ns/subgraphs", string, "/q/$ns/subgraphs", undefined, import("@tanstack/router-core").ResolveParams<"subgraphs">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "analytics", "/q/$ns/analytics", string, "/q/$ns/analytics", undefined, import("@tanstack/router-core").ResolveParams<"analytics">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "plugins", "/q/$ns/plugins", string, "/q/$ns/plugins", undefined, import("@tanstack/router-core").ResolveParams<"plugins">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "canvas", "/q/$ns/canvas", string, "/q/$ns/canvas", undefined, import("@tanstack/router-core").ResolveParams<"canvas">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/q/$ns", "/q/$ns", string, "/q/$ns", undefined, import("@tanstack/router-core").ResolveParams<"/q/$ns">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "benchmarks", "/q/$ns/benchmarks", string, "/q/$ns/benchmarks", undefined, import("@tanstack/router-core").ResolveParams<"benchmarks">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>], unknown, unknown, unknown, undefined>, ...import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/dashboard" | "/browser" | "/query" | "/indexes" | "/path" | "/subgraphs" | "/analytics" | "/canvas" | "/benchmarks", "/dashboard" | "/browser" | "/query" | "/indexes" | "/path" | "/subgraphs" | "/analytics" | "/canvas" | "/benchmarks", string, "/dashboard" | "/browser" | "/query" | "/indexes" | "/path" | "/subgraphs" | "/analytics" | "/canvas" | "/benchmarks", undefined, import("@tanstack/router-core").ResolveParams<"/dashboard" | "/browser" | "/query" | "/indexes" | "/path" | "/subgraphs" | "/analytics" | "/canvas" | "/benchmarks">, import("@tanstack/router-core").AnyContext, import("@tanstack/router-core").AnyContext, () => never, {}, undefined, unknown, unknown, unknown, unknown, undefined>[]], unknown, unknown, unknown, undefined>, "never", false, import("@tanstack/history").RouterHistory, Record<string, any>>;

package/dist-lib/types/app/studioConfig.d.ts

@@ -0,0 +1,106 @@
+import type { QueryClient } from "@tanstack/react-query";
+import type { InstanceConfig } from "../instances/types";
+/**
+ * The host-facing embed contract (feature studio-embeddable) and its runtime state: the
+ * active config, the live-mount count, and the `storageKey` prefix every persisted key goes
+ * through. Every field is optional and omitting it reproduces the standalone app's behavior.
+ * How to mount is documented on ./mount.tsx; the feature's story is in
+ * features/done/studio-embeddable/spec.md.
+ */
+/**
+ * The themable design tokens: the `@theme` custom properties in index.css, camel-cased.
+ * Overrides land as inline CSS variables on the `.f8-studio` root, so they win over the
+ * stylesheet defaults without touching it (Tailwind v4 utilities resolve through var()).
+ */
+export interface ThemeTokens {
+    ink: string;
+    panel: string;
+    panel2: string;
+    line: string;
+    fg: string;
+    fgDim: string;
+    fgFaint: string;
+    accent: string;
+    accent2: string;
+    warn: string;
+    danger: string;
+    fontMono: string;
+}
+export interface StudioConfig {
+    /** Host-supplied managed instances (default: the config.js-seeded same-origin instance). */
+    instances?: InstanceConfig[];
+    activeInstanceId?: string;
+    /** Hide the register/edit/remove affordances when the host owns the instance list. */
+    lockInstances?: boolean;
+    /** Seed the active namespace for the host-supplied instances (default: "default"). */
+    namespace?: string;
+    /** Hide the namespace switcher and management when the embed is scoped to one graph. */
+    lockNamespace?: boolean;
+    /** Router basepath (default "": root, as standalone). */
+    basepath?: string;
+    /** "memory" keeps Studio out of the address bar when the host owns the URL. */
+    history?: "browser" | "memory";
+    /** Prefix for every persisted localStorage key (default "": today's bare f8.* keys). */
+    storageNamespace?: string;
+    /** Token overrides; anything omitted keeps today's dark defaults. */
+    theme?: Partial<ThemeTokens>;
+    /** Reuse the host's QueryClient (default: Studio creates its own, as today). */
+    queryClient?: QueryClient;
+    /**
+     * NL-assist policy for an embed. "disabled" removes the NL panels entirely;
+     * "instance-only" locks the model transport to the active instance's POST /chat. Both
+     * hold structurally, not just in the UI: the browser-direct transports (chatWithModel and
+     * the reachability probe) refuse under any policy, and the NL store is policy-resolved at
+     * rehydrate (the persist merge in delegate/nl/config.ts), so an instance-only embed
+     * neither holds nor re-persists a custom-mode config or its third-party key. Consequence
+     * when an embed shares an UNPREFIXED storage with a standalone Studio on the same origin:
+     * a settings write from inside the embed persists the policy-clean shape, dropping any
+     * stored custom key rather than carrying it. Absent: standalone behavior (instance mode
+     * default, custom mode available).
+     */
+    nlAssist?: "disabled" | "instance-only";
+}
+export declare function getStudioConfig(): StudioConfig;
+export declare function setStudioConfig(config: StudioConfig): void;
+/**
+ * Registers a mounted tree; the returned callback releases it on unmount. Throws on a
+ * second LIVE registration: setStudioConfig's guard is identity-based (it must tolerate
+ * StrictMode re-rendering the same config object), so two mounts sharing one config object
+ * would slip past it - this count-based guard catches that shape too, in the second tree's
+ * mount effect. StrictMode's mount/cleanup/mount cycle is sequential and never trips it.
+ */
+export declare function registerStudioMount(): () => void;
+/**
+ * Returns the module-level config to the standalone default once no mount is live, so a
+ * dead embed's policy and storage prefix cannot outlive it (an in-flight store write after
+ * teardown would otherwise still go through the old tenant's storageKey prefix). Called
+ * from mountStudio's unmount handle - the imperative path is the one that can know teardown
+ * is real; a React host's effect cleanup cannot distinguish StrictMode's rehearsal from a
+ * genuine unmount, so <F8Studio> keeps the config until the next mount replaces it.
+ */
+export declare function resetStudioConfig(): void;
+/**
+ * Every persisted localStorage key goes through here (registry, workspace stores, NL-assist,
+ * first-run), so a host embed with `storageNamespace` keeps its state separate from a
+ * standalone Studio on the same origin. Default prefix is empty: existing users' f8.* keys
+ * are untouched. Separation holds for what is WRITTEN under the prefix; the module-level
+ * stores additionally skip their import-time hydration so bare-key state cannot bleed in
+ * (see the persist options in instances/registry.ts).
+ */
+export declare function storageKey(name: string): string;
+/** The config.theme overrides as inline style variables for the `.f8-studio` root. */
+export declare function themeStyle(theme: Partial<ThemeTokens> | undefined): Record<string, string>;
+/**
+ * Component access to the mount's config. Defaults to the standalone config, so components
+ * rendered without a provider (unit tests, storybooks) behave exactly like today's app.
+ */
+export declare const StudioConfigContext: import("react").Context<StudioConfig>;
+export declare function useStudioConfig(): StudioConfig;
+/**
+ * Where Radix portals render. The mount supplies the `.f8-studio` root so overlays stay
+ * inside the scoped, themable subtree (required once the style primitives are scoped to it,
+ * and it keeps modals inside a host region instead of escaping to document.body). Without a
+ * provider (unit tests rendering a dialog directly) Radix falls back to document.body.
+ */
+export declare const PortalContainerContext: import("react").Context<HTMLElement | undefined>;
+export declare function usePortalContainer(): HTMLElement | undefined;

package/dist-lib/types/canvas/Canvas2D.d.ts

@@ -0,0 +1,18 @@
+import { type Ref } from "react";
+import { type CanvasEdge, type CanvasNode } from "../state/instanceStore";
+import type { StyleConfig } from "./styleConfig";
+import type { ResolvedStyles } from "./styleEngine";
+import { type ElementRef, type F8GraphCanvasHandle } from "./GraphCanvas";
+/**
+ * Sigma.js (WebGL) 2D projection. Renders resolved styles only — the mapping rules
+ * live in styleEngine.ts; the layout/label/arrow options come from the style config.
+ */
+export declare function Canvas2D({ nodes, edges, styles, config, highlightId, onSelect, ref, }: {
+    nodes: Record<number, CanvasNode>;
+    edges: Record<number, CanvasEdge>;
+    styles: ResolvedStyles;
+    config: StyleConfig;
+    highlightId?: number | null;
+    onSelect: (ref: ElementRef | null) => void;
+    ref?: Ref<F8GraphCanvasHandle>;
+}): import("react").JSX.Element;

package/dist-lib/types/canvas/Canvas3D.d.ts

@@ -0,0 +1,14 @@
+import { type Ref } from "react";
+import { type CanvasEdge, type CanvasNode } from "../state/instanceStore";
+import type { StyleConfig } from "./styleConfig";
+import type { ResolvedStyles } from "./styleEngine";
+import { type ElementRef, type F8GraphCanvasHandle } from "./GraphCanvas";
+export declare function Canvas3D({ nodes, edges, styles, config, highlightId, onSelect, ref, }: {
+    nodes: Record<number, CanvasNode>;
+    edges: Record<number, CanvasEdge>;
+    styles: ResolvedStyles;
+    config: StyleConfig;
+    highlightId?: number | null;
+    onSelect: (ref: ElementRef | null) => void;
+    ref?: Ref<F8GraphCanvasHandle>;
+}): import("react").JSX.Element;

package/dist-lib/types/canvas/ConnectPanel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Canvas "Connect" tab (feature canvas-find-connect): connect the vertices already on the canvas
+ * by running Fallen-8's shortest-path search (BLS) over every unordered pair, up to a max-hop
+ * bound, then add or retract each found path selectively. The whole pairwise sweep must fit under
+ * CONNECT_PAIR_CAP - a partial sweep would falsely report "unreachable" for pairs it never tried,
+ * so above the cap the run is refused and the pick list is the way to narrow. Add/remove is
+ * reference-counted against the run baseline (connectPaths.ts): a shared intermediate survives
+ * until the last path claiming it is removed. Inputs persist; picks and results are ephemeral.
+ */
+export declare function ConnectPanel(): import("react").JSX.Element;

package/dist-lib/types/canvas/FindPanel.d.ts

@@ -0,0 +1,14 @@
+import type { ElementRef } from "./GraphCanvas";
+/**
+ * Canvas "Find" tab (feature canvas-find-connect): the all-property discovery search
+ * (POST /scan/graph/properties, the same primitive the Query screen's "any property" scope
+ * uses) brought onto the canvas so you can grow the working set without leaving. Results show
+ * whether each element is already on the canvas and add it (or all of them) in one click; a row
+ * click selects the element into the Detail panel for the full property view. Inputs persist in
+ * the per-instance canvasToolsDraft; results are ephemeral (re-run on demand).
+ */
+export declare function FindPanel({ onSelect, onHover, }: {
+    onSelect: (ref: ElementRef) => void;
+    /** Spotlight the hovered result's node on the canvas (feature canvas-find-connect). */
+    onHover?: (ref: ElementRef | null) => void;
+}): import("react").JSX.Element;

package/dist-lib/types/canvas/GraphCanvas.d.ts

@@ -0,0 +1,66 @@
+import { type Ref } from "react";
+import type { CanvasEdge, CanvasNode } from "../state/instanceStore";
+import type { PathREST } from "../api/types";
+import type { StyleConfig } from "./styleConfig";
+export type ElementRef = {
+    kind: "node" | "edge";
+    id: number;
+};
+/**
+ * Imperative camera control on a mounted canvas (feature canvas-host-controls). A host embedding
+ * the canvas has no other way to reach the camera, so this is the whole surface: frame everything,
+ * read the zoom, set the zoom.
+ *
+ * `ratio` is sigma's camera ratio in BOTH renderers: 1 means the graph just fits the padded
+ * viewport and 2 is twice as far out. It is DERIVED on every call rather than stored, so 1 still
+ * means "fits" after the graph grows, the container changes, or the renderer remounts.
+ *
+ * Multiplying it by k spreads the layout over 1/k of the distance but shrinks each element to
+ * 1/sqrt(k) of its size, because sigma scales lengths by `sqrt(ratio)` (`scaleSize`) while it scales
+ * positions by the ratio itself. So zooming out is not a uniform shrink, and a host computing sizes
+ * needs the square root. Labels do not scale at all.
+ *
+ * Two renderer differences worth knowing. `setCameraRatio` keeps the pan in 2D but re-aims at the
+ * graph origin in 3D (which is what a fit does there). And only 3D bounds the number: its orbit
+ * controls cap the camera distance at the sky radius, whereas 2D applies any finite positive ratio
+ * verbatim, because sigma's `minCameraRatio`/`maxCameraRatio` are left unset. A host driving the
+ * ratio from a slider therefore owns the range check in 2D; `fitToView()` is always the way back.
+ *
+ * `paddingPx` is CSS px of inset around the graph, and omitting it asks for the renderer's own
+ * framing rather than a shared number: 2D uses sigma's live `stagePadding`, 3D uses
+ * `FIT_PADDING_PX`. The two are not comparable (3D padding shrinks the field of view against
+ * container HEIGHT only), so copying one renderer's digit into the other would be false precision.
+ * The arithmetic for both lives in canvas/eclipse.ts.
+ */
+export interface F8GraphCanvasHandle {
+    fitToView(durationMs?: number, paddingPx?: number): void;
+    getCameraRatio(): number;
+    setCameraRatio(ratio: number): void;
+}
+/** Fit tween length in ms. Canvas3D has framed its mount auto-fit at 600 since day one. */
+export declare const FIT_DURATION_MS = 600;
+/** Elements to emphasize with the overlay visuals WITHOUT dimming the rest (adjacency-preview). */
+type EmphasisSet = {
+    nodeIds: readonly number[];
+    edgeIds: readonly number[];
+};
+/**
+ * The one renderer boundary (design §4): everything outside talks CanvasNode/CanvasEdge +
+ * callbacks. Styles are resolved once here (styleEngine) and handed to the projection the
+ * style config selects — Sigma (2D) or three.js (3D) — so path/subgraph overlays and all
+ * "send to canvas" flows behave identically in both (studio-canvas-viz FR-9).
+ */
+export declare function GraphCanvas({ nodes, edges, config, pathOverlay, emphasis, highlight, onSelect, ref, }: {
+    nodes: Record<number, CanvasNode>;
+    edges: Record<number, CanvasEdge>;
+    config: StyleConfig;
+    pathOverlay: PathREST | null;
+    emphasis?: EmphasisSet | null;
+    /** Transient hover spotlight (feature canvas-find-connect): the "eclipse" corona is drawn over
+     *  this node while a Find result row is hovered. Only a node kind spotlights; edges are ignored. */
+    highlight?: ElementRef | null;
+    onSelect: (ref: ElementRef | null) => void;
+    /** Camera handle, forwarded to whichever renderer is mounted (React 19 passes ref as a prop). */
+    ref?: Ref<F8GraphCanvasHandle>;
+}): import("react").JSX.Element;
+export {};

package/dist-lib/types/canvas/StylePanel.d.ts

@@ -0,0 +1,7 @@
+import type { StyleConfig } from "./styleConfig";
+export declare function StylePanel({ config, onChange, nodePropertyKeys, edgePropertyKeys, }: {
+    config: StyleConfig;
+    onChange: (patch: Partial<StyleConfig>) => void;
+    nodePropertyKeys: string[];
+    edgePropertyKeys: string[];
+}): import("react").JSX.Element;