@ydtb/tk-scope-app 0.14.7

package/dist/src/lib/types.js

@@ -0,0 +1,47 @@
+/**
+ * App-owned type definitions — replaces type-only imports from @ydtb/plugin-sdk.
+ *
+ * These are simple interfaces that the YDTB app owns. They were previously
+ * imported from plugin-sdk but are now inlined here to remove the dependency.
+ *
+ * @see migration/audit/AUDIT_003_post-m7-pre-m8-gate.md — Category B remediation
+ */
+/** Public routes — no auth, no scope, no permissions, no onboarding. */
+function publicGuard() {
+    return { auth: "none", scope: null, permissions: "none", onboarding: false };
+}
+/** Auth shell routes (login/signup) — no gates applied. */
+function authOnly() {
+    return { auth: "none", scope: null, permissions: "none", onboarding: false };
+}
+/** Authenticated routes — session required, but no scope or permissions. */
+function authenticated() {
+    return { auth: "session", scope: null, permissions: "none", onboarding: false };
+}
+/** Scoped routes — session + scope resolution, but no permission checks or onboarding. */
+function scoped(type) {
+    return { auth: "session", scope: type, permissions: "none", onboarding: false };
+}
+/** Fully guarded routes — session + scope + auto permissions + onboarding. */
+function guarded(type) {
+    return { auth: "session", scope: type, permissions: "auto", onboarding: true };
+}
+/** Custom auth strategy with optional scope. */
+function custom(strategy, type) {
+    return {
+        auth: strategy,
+        scope: type ?? null,
+        permissions: "none",
+        onboarding: false,
+    };
+}
+/** Guard preset functions for declarative route shell configuration. */
+export const guardPresets = {
+    public: publicGuard,
+    authOnly,
+    authenticated,
+    scoped,
+    guarded,
+    custom,
+};
+//# sourceMappingURL=types.js.map

package/dist/src/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqIH,wEAAwE;AACxE,SAAS,WAAW;IAClB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAC9E,CAAC;AAED,2DAA2D;AAC3D,SAAS,QAAQ;IACf,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAC9E,CAAC;AAED,4EAA4E;AAC5E,SAAS,aAAa;IACpB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AACjF,CAAC;AAED,0FAA0F;AAC1F,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AACjF,CAAC;AAED,8EAA8E;AAC9E,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;AAChF,CAAC;AAED,gDAAgD;AAChD,SAAS,MAAM,CAAC,QAAgB,EAAE,IAAa;IAC7C,OAAO;QACL,IAAI,EAAE,QAA+B;QACrC,KAAK,EAAE,IAAI,IAAI,IAAI;QACnB,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,KAAK;KAClB,CAAA;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,WAAW;IACnB,QAAQ;IACR,aAAa;IACb,MAAM;IACN,OAAO;IACP,MAAM;CACE,CAAA"}

package/dist/src/lib/withDashboardChrome.d.ts

@@ -0,0 +1,18 @@
+import type { ComponentType, ReactNode } from "react";
+import { type LayoutConfig } from "../dashboard/layout/DashboardLayout.tsx";
+export type { LayoutConfig };
+/**
+ * Higher-order component that wraps a layout with the standard dashboard chrome:
+ * sidebar, command palette, help panel, chat bubble, error boundary.
+ *
+ * Accepts one of three layout forms:
+ * - LayoutConfig object → tweaks the default DashboardLayout (cssClass, accentBar, slot overrides)
+ * - ComponentType → full replacement layout (bypasses default chrome entirely)
+ * - undefined → default DashboardLayout with no tweaks
+ */
+export declare function withDashboardChrome(layout: ComponentType<{
+    children: ReactNode;
+}> | LayoutConfig | undefined, NavigationProviderComponent: ComponentType<{
+    children: ReactNode;
+}>): () => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=withDashboardChrome.d.ts.map

package/dist/src/lib/withDashboardChrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withDashboardChrome.d.ts","sourceRoot":"","sources":["../../../src/lib/withDashboardChrome.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAUrD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,yCAAyC,CAAA;AAE5F,YAAY,EAAE,YAAY,EAAE,CAAA;AAE5B;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAAC,GAAG,YAAY,GAAG,SAAS,EACzE,2BAA2B,EAAE,aAAa,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAAC,iDA+CpE"}

package/dist/src/lib/withDashboardChrome.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Outlet } from "@tanstack/react-router";
+import { SidebarProvider } from "../contexts/sidebar/use-sidebar.js";
+import { CommandProvider } from "../contexts/command/CommandContext.js";
+import { SearchPanelProvider } from "../contexts/command/SearchPanelContext.js";
+import { CommandDialog } from "../dashboard/command/CommandDialog.js";
+import { HelpProvider } from "../contexts/help/HelpContext.js";
+import { PortalProvider, ScopeProvider as FrameworkScopeProvider } from "@ydtb/core-client";
+import { useScopeContext } from "../contexts/scope/ScopeContext.js";
+import { ErrorBoundary } from "../components/ErrorBoundary.js";
+import { DashboardLayout } from "../dashboard/layout/DashboardLayout.js";
+/**
+ * Higher-order component that wraps a layout with the standard dashboard chrome:
+ * sidebar, command palette, help panel, chat bubble, error boundary.
+ *
+ * Accepts one of three layout forms:
+ * - LayoutConfig object → tweaks the default DashboardLayout (cssClass, accentBar, slot overrides)
+ * - ComponentType → full replacement layout (bypasses default chrome entirely)
+ * - undefined → default DashboardLayout with no tweaks
+ */
+export function withDashboardChrome(layout, NavigationProviderComponent) {
+    // Determine what to render: config object tweaks default, component replaces entirely, undefined uses default
+    let LayoutComponent;
+    if (layout === undefined) {
+        // No config — use default DashboardLayout
+        LayoutComponent = DashboardLayout;
+    }
+    else if (typeof layout === "object" && !("$$typeof" in layout)) {
+        // LayoutConfig object — wrap default DashboardLayout with config
+        const config = layout;
+        LayoutComponent = function ConfiguredDashboardLayout({ children }) {
+            return _jsx(DashboardLayout, { config: config, children: children });
+        };
+    }
+    else {
+        // ComponentType — full replacement
+        LayoutComponent = layout;
+    }
+    return function ChromeWrapped() {
+        // Bridge app scope context → framework ScopeProvider so tools
+        // can use useScopeContext() from @ydtb/core-client
+        const { scopeId, scopeType } = useScopeContext();
+        return (_jsx(SidebarProvider, { children: _jsx(NavigationProviderComponent, { children: _jsx(HelpProvider, { children: _jsx(CommandProvider, { children: _jsx(SearchPanelProvider, { children: _jsxs(PortalProvider, { children: [_jsx(FrameworkScopeProvider, { scopeId: scopeId, scopeType: scopeType, children: _jsx(LayoutComponent, { children: _jsx(ErrorBoundary, { children: _jsx(Outlet, {}) }) }) }), _jsx(CommandDialog, {})] }) }) }) }) }) }));
+    };
+}
+//# sourceMappingURL=withDashboardChrome.js.map

package/dist/src/lib/withDashboardChrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withDashboardChrome.js","sourceRoot":"","sources":["../../../src/lib/withDashboardChrome.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAqC,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAwC,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA4C,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAwC,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAkC,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,aAAa,IAAI,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAoC,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAiC,CAAA;AAC/D,OAAO,EAAE,eAAe,EAAqB,MAAM,wCAAyC,CAAA;AAI5F;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAyE,EACzE,2BAAmE;IAEnE,8GAA8G;IAC9G,IAAI,eAAuD,CAAA;IAE3D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,0CAA0C;QAC1C,eAAe,GAAG,eAAe,CAAA;IACnC,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,EAAE,CAAC;QACjE,iEAAiE;QACjE,MAAM,MAAM,GAAG,MAAM,CAAA;QACrB,eAAe,GAAG,SAAS,yBAAyB,CAAC,EAAE,QAAQ,EAA2B;YACxF,OAAO,KAAC,eAAe,IAAC,MAAM,EAAE,MAAM,YAAG,QAAQ,GAAmB,CAAA;QACtE,CAAC,CAAA;IACH,CAAC;SAAM,CAAC;QACN,mCAAmC;QACnC,eAAe,GAAG,MAAgD,CAAA;IACpE,CAAC;IAED,OAAO,SAAS,aAAa;QAC3B,8DAA8D;QAC9D,mDAAmD;QACnD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAAA;QAEhD,OAAO,CACL,KAAC,eAAe,cACd,KAAC,2BAA2B,cAC1B,KAAC,YAAY,cACX,KAAC,eAAe,cACd,KAAC,mBAAmB,cAClB,MAAC,cAAc,eACb,KAAC,sBAAsB,IAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,YAC5D,KAAC,eAAe,cACd,KAAC,aAAa,cACZ,KAAC,MAAM,KAAG,GACI,GACA,GACK,EACzB,KAAC,aAAa,KAAG,IACF,GACG,GACN,GACL,GACa,GACd,CACnB,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/src/onboarding/CreateScopeWizardStep.d.ts

@@ -0,0 +1,14 @@
+import type { StepProps } from "./StepProps.ts";
+interface CreateScopeWizardStepProps extends StepProps {
+    childType: string;
+    parentScopeId: string | null;
+    parentScopeType: string | null;
+}
+/**
+ * Built-in wizard step that creates a scope entity (name + slug).
+ * After successful creation, sets the new scopeId on the WizardContext
+ * so subsequent onboarding steps can operate on the new scope.
+ */
+export declare function CreateScopeWizardStep({ childType, parentScopeId, parentScopeType, onNext, stepIndex, totalSteps, }: CreateScopeWizardStepProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=CreateScopeWizardStep.d.ts.map

package/dist/src/onboarding/CreateScopeWizardStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateScopeWizardStep.d.ts","sourceRoot":"","sources":["../../../src/onboarding/CreateScopeWizardStep.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG/C,UAAU,0BAA2B,SAAQ,SAAS;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,aAAa,EACb,eAAe,EACf,MAAM,EACN,SAAS,EACT,UAAU,GACX,EAAE,0BAA0B,2CA+L5B"}

package/dist/src/onboarding/CreateScopeWizardStep.js

@@ -0,0 +1,109 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useEffect, useRef } from "react";
+import { Loader2, Check, X, Plus, ArrowRight } from "lucide-react";
+import { useQueryClient } from "@ydtb/tk-scope-query-client";
+import { checkSlugAvailability, createScope } from "../hooks/useCreateScope.js";
+import { useScopeLabel } from "@ydtb/tk-scope/client";
+import { useWizard } from "./WizardContext.js";
+import { WizardPage } from "./WizardPage.js";
+import { slugify } from "@ydtb/tk-scope-lib/slug";
+/**
+ * Built-in wizard step that creates a scope entity (name + slug).
+ * After successful creation, sets the new scopeId on the WizardContext
+ * so subsequent onboarding steps can operate on the new scope.
+ */
+export function CreateScopeWizardStep({ childType, parentScopeId, parentScopeType, onNext, stepIndex, totalSteps, }) {
+    const queryClient = useQueryClient();
+    const { setScopeId } = useWizard();
+    const childLabel = useScopeLabel(childType);
+    const parentLabel = useScopeLabel(parentScopeType ?? "");
+    const [name, setName] = useState("");
+    const [slug, setSlug] = useState("");
+    const [slugEdited, setSlugEdited] = useState(false);
+    const [submitting, setSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const [slugStatus, setSlugStatus] = useState("idle");
+    const checkTimerRef = useRef(null);
+    const lastCheckedRef = useRef("");
+    useEffect(() => {
+        if (!slugEdited) {
+            setSlug(slugify(name));
+        }
+    }, [name, slugEdited]);
+    useEffect(() => {
+        if (slug.length < 3) {
+            setSlugStatus("idle");
+            lastCheckedRef.current = "";
+            return;
+        }
+        if (slug === lastCheckedRef.current)
+            return;
+        setSlugStatus("checking");
+        if (checkTimerRef.current)
+            clearTimeout(checkTimerRef.current);
+        checkTimerRef.current = setTimeout(async () => {
+            try {
+                const available = await checkSlugAvailability(childType, slug);
+                lastCheckedRef.current = slug;
+                setSlugStatus(available ? "available" : "taken");
+            }
+            catch {
+                lastCheckedRef.current = slug;
+                setSlugStatus("taken");
+            }
+        }, 400);
+        return () => {
+            if (checkTimerRef.current)
+                clearTimeout(checkTimerRef.current);
+        };
+    }, [slug, childType]);
+    const isSlugTaken = slugStatus === "taken";
+    const handleSlugChange = (value) => {
+        setSlugEdited(true);
+        setSlug(value
+            .toLowerCase()
+            .replace(/[^a-z0-9-]+/g, "-")
+            .replace(/^-|-$/g, "")
+            .slice(0, 50));
+    };
+    const isValid = name.trim().length > 0 && slug.length >= 3 && slug.length <= 50;
+    const handleSubmit = async (e) => {
+        e.preventDefault();
+        if (!isValid || submitting || isSlugTaken)
+            return;
+        setSubmitting(true);
+        setError(null);
+        try {
+            const result = await createScope({
+                type: childType,
+                name: name.trim(),
+                slug,
+                ...(parentScopeId ? { parentScopeId } : {}),
+            });
+            const newScopeId = result?.scope?.id;
+            if (newScopeId) {
+                setScopeId(newScopeId);
+            }
+            await queryClient.invalidateQueries();
+            onNext();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : `Failed to create ${childLabel.singular.toLowerCase()}`;
+            if (message.toLowerCase().includes("slug") &&
+                (message.toLowerCase().includes("taken") ||
+                    message.toLowerCase().includes("exists") ||
+                    message.toLowerCase().includes("unique") ||
+                    message.toLowerCase().includes("duplicate"))) {
+                setError("This slug is already taken. Please choose a different one.");
+            }
+            else {
+                setError(message);
+            }
+            setSubmitting(false);
+        }
+    };
+    return (_jsx(WizardPage, { icon: Plus, title: `Create ${childLabel.singular}`, subtitle: `Set up a new ${childLabel.singular.toLowerCase()}${parentScopeType ? ` in this ${parentLabel.singular.toLowerCase()}` : ""}.`, steps: totalSteps, currentStep: stepIndex, children: _jsxs("form", { onSubmit: handleSubmit, className: "space-y-4", children: [_jsxs("div", { className: "space-y-2", children: [_jsxs("label", { htmlFor: "scope-name", className: "text-sm font-medium text-foreground", children: [childLabel.singular, " Name"] }), _jsx("input", { id: "scope-name", type: "text", required: true, autoFocus: true, value: name, onChange: (e) => setName(e.target.value), placeholder: `My ${childLabel.singular}`, className: "w-full h-10 px-3 rounded-md border border-border bg-transparent text-sm text-foreground placeholder:text-muted-foreground outline-none focus:ring-2 focus:ring-primary/20 focus:border-primary" })] }), _jsxs("div", { className: "space-y-2", children: [_jsx("label", { htmlFor: "scope-slug", className: "text-sm font-medium text-foreground", children: "Slug" }), _jsx("input", { id: "scope-slug", type: "text", required: true, value: slug, onChange: (e) => handleSlugChange(e.target.value), placeholder: `my-${childLabel.singular.toLowerCase()}`, className: `w-full h-10 px-3 rounded-md border text-sm bg-transparent outline-none font-mono focus:ring-2 focus:ring-primary/20 focus:border-primary transition-colors ${error || isSlugTaken
+                                ? "border-destructive focus:ring-destructive/20 focus:border-destructive"
+                                : "border-border"}` }), error && _jsx("p", { className: "text-xs text-destructive", children: error }), !error && isSlugTaken && (_jsxs("p", { className: "text-xs text-destructive inline-flex items-center gap-1", children: [_jsx(X, { className: "h-3 w-3" }), "This slug is already taken."] })), !error && slugStatus === "checking" && (_jsxs("p", { className: "text-xs inline-flex items-center gap-1 text-muted-foreground", children: [_jsx(Loader2, { className: "h-3 w-3 animate-spin" }), "Checking availability..."] })), !error && slugStatus === "available" && (_jsxs("p", { className: "text-xs inline-flex items-center gap-1 text-emerald-600", children: [_jsx(Check, { className: "h-3 w-3" }), "Slug is available."] })), !error && slugStatus === "idle" && slug.length > 0 && slug.length < 3 && (_jsx("p", { className: "text-xs text-muted-foreground", children: "Slug must be at least 3 characters." }))] }), _jsx("button", { type: "submit", disabled: !isValid || submitting || isSlugTaken, className: "w-full h-10 rounded-md text-sm font-semibold transition-colors disabled:opacity-50 bg-primary text-primary-foreground inline-flex items-center justify-center gap-2", children: submitting ? (_jsxs(_Fragment, { children: [_jsx(Loader2, { className: "h-4 w-4 animate-spin" }), "Creating..."] })) : (_jsxs(_Fragment, { children: [totalSteps && totalSteps > 1 ? `Create & Continue` : `Create ${childLabel.singular}`, _jsx(ArrowRight, { className: "h-4 w-4" })] })) })] }) }));
+}
+//# sourceMappingURL=CreateScopeWizardStep.js.map

package/dist/src/onboarding/CreateScopeWizardStep.js.map

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

package/dist/src/onboarding/ResolveStep.d.ts

@@ -0,0 +1,17 @@
+import type { OnboardingStepDefinition } from "../lib/types.ts";
+export interface ResolveStepProps {
+    steps: OnboardingStepDefinition[];
+    scope: string;
+    scopeId: string;
+    onComplete: (metadata: Record<string, unknown>) => void;
+}
+/**
+ * ResolveStep — runs all step.resolve() handlers after data collection.
+ *
+ * Iterates over the sorted step list, skipping any step whose condition
+ * returned false (step was not shown), and runs each resolve() function
+ * in sequence. Shows a progress UI with per-resolver status. Calls
+ * onComplete(accumulatedMetadata) when all resolvers finish.
+ */
+export declare function ResolveStep({ steps, scope, scopeId, onComplete }: ResolveStepProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ResolveStep.d.ts.map

package/dist/src/onboarding/ResolveStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolveStep.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ResolveStep.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAkB/D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,wBAAwB,EAAE,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CACxD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,gBAAgB,2CAmLlF"}

package/dist/src/onboarding/ResolveStep.js

@@ -0,0 +1,101 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useCallback, useRef } from "react";
+import { Loader2, Check, AlertCircle } from "lucide-react";
+import { useWizard } from "./WizardContext.js";
+/**
+ * ResolveStep — runs all step.resolve() handlers after data collection.
+ *
+ * Iterates over the sorted step list, skipping any step whose condition
+ * returned false (step was not shown), and runs each resolve() function
+ * in sequence. Shows a progress UI with per-resolver status. Calls
+ * onComplete(accumulatedMetadata) when all resolvers finish.
+ */
+export function ResolveStep({ steps, scope, scopeId, onComplete }) {
+    const { wizardMetadata } = useWizard();
+    // Collect steps that have a resolve function and whose condition passed
+    const resolvableSteps = steps.filter((step) => {
+        const s = step;
+        if (!s.resolve)
+            return false;
+        // Evaluate condition if present — skip step if condition returns false
+        if (s.condition) {
+            const passes = s.condition({
+                previouslyCompletedSteps: [],
+                wizardMetadata,
+                scope,
+                scopeId,
+                userId: "",
+            });
+            if (!passes)
+                return false;
+        }
+        return true;
+    });
+    const [resolverStates, setResolverStates] = useState(() => resolvableSteps.map((s) => ({
+        id: s.id,
+        label: s.label ?? s.id,
+        status: "pending",
+    })));
+    const [errorMessage, setErrorMessage] = useState(null);
+    const [failedIndex, setFailedIndex] = useState(null);
+    const hasStarted = useRef(false);
+    const runResolvers = useCallback(async (startIndex) => {
+        if (resolvableSteps.length === 0) {
+            onComplete({});
+            return;
+        }
+        let accumulated = {};
+        setErrorMessage(null);
+        setFailedIndex(null);
+        for (let i = startIndex; i < resolvableSteps.length; i++) {
+            const step = resolvableSteps[i];
+            // Mark as running
+            setResolverStates((prev) => prev.map((r, idx) => (idx === i ? { ...r, status: "running" } : r)));
+            try {
+                const result = await step.resolve(wizardMetadata);
+                if (result && typeof result === "object") {
+                    accumulated = { ...accumulated, ...result };
+                }
+                // Mark as complete
+                setResolverStates((prev) => prev.map((r, idx) => (idx === i ? { ...r, status: "complete" } : r)));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : "An error occurred";
+                setErrorMessage(message);
+                setFailedIndex(i);
+                setResolverStates((prev) => prev.map((r, idx) => (idx === i ? { ...r, status: "failed" } : r)));
+                return;
+            }
+        }
+        onComplete(accumulated);
+    }, [resolvableSteps, wizardMetadata, onComplete]);
+    // Start resolvers on mount (once)
+    useEffect(() => {
+        if (hasStarted.current)
+            return;
+        hasStarted.current = true;
+        runResolvers(0);
+    }, [runResolvers]);
+    // Retry handler — re-run from the failed resolver
+    const handleRetry = useCallback(() => {
+        if (failedIndex === null)
+            return;
+        hasStarted.current = true;
+        // Reset failed + pending resolvers to pending
+        setResolverStates((prev) => prev.map((r, idx) => (idx >= failedIndex ? { ...r, status: "pending" } : r)));
+        runResolvers(failedIndex);
+    }, [failedIndex, runResolvers]);
+    // If there are no resolvable steps, show a brief "complete" indicator
+    // (the onComplete call happens in useEffect above)
+    if (resolvableSteps.length === 0) {
+        return (_jsx("div", { className: "mx-auto flex w-full max-w-2xl flex-col items-center px-4 py-12", children: _jsx("div", { className: "w-full rounded-lg border border-border bg-card p-6 shadow-sm", children: _jsxs("div", { className: "flex items-center gap-3", children: [_jsx("div", { className: "flex h-6 w-6 items-center justify-center rounded-full bg-primary/10", children: _jsx(Check, { className: "h-3.5 w-3.5 text-primary" }) }), _jsx("p", { className: "text-sm text-muted-foreground", children: "All set!" })] }) }) }));
+    }
+    return (_jsxs("div", { className: "mx-auto flex w-full max-w-2xl flex-col items-center px-4 py-12", children: [_jsxs("div", { className: "mb-6 text-center", children: [_jsx("h2", { className: "text-xl font-semibold text-foreground", children: "Setting things up" }), _jsx("p", { className: "mt-1 text-sm text-muted-foreground", children: "Almost there \u2014 running final setup steps\u2026" })] }), _jsxs("div", { className: "w-full rounded-lg border border-border bg-card p-6 shadow-sm", children: [_jsx("ul", { className: "space-y-3", children: resolverStates.map((resolver) => (_jsxs("li", { className: "flex items-center gap-3", children: [_jsxs("span", { className: "flex h-6 w-6 shrink-0 items-center justify-center", children: [resolver.status === "running" && (_jsx(Loader2, { className: "h-4 w-4 animate-spin text-primary" })), resolver.status === "complete" && (_jsx("span", { className: "flex h-5 w-5 items-center justify-center rounded-full bg-primary/10", children: _jsx(Check, { className: "h-3 w-3 text-primary" }) })), resolver.status === "failed" && (_jsx("span", { className: "flex h-5 w-5 items-center justify-center rounded-full bg-destructive/10", children: _jsx(AlertCircle, { className: "h-3 w-3 text-destructive" }) })), resolver.status === "pending" && (_jsx("span", { className: "h-2 w-2 rounded-full bg-muted-foreground/30" }))] }), _jsx("span", { className: `text-sm ${resolver.status === "complete"
+                                        ? "text-muted-foreground line-through"
+                                        : resolver.status === "failed"
+                                            ? "text-destructive"
+                                            : resolver.status === "running"
+                                                ? "font-medium text-foreground"
+                                                : "text-muted-foreground"}`, children: resolver.label })] }, resolver.id))) }), errorMessage && (_jsxs("div", { className: "mt-5 rounded-md border border-destructive/30 bg-destructive/5 p-4", children: [_jsx("p", { className: "text-sm text-destructive", children: errorMessage }), _jsx("button", { type: "button", onClick: handleRetry, className: "mt-3 inline-flex items-center gap-1.5 rounded-md bg-primary px-4 py-2 text-sm font-semibold text-primary-foreground shadow-sm transition-colors hover:bg-primary/90", children: "Retry" })] }))] })] }));
+}
+//# sourceMappingURL=ResolveStep.js.map

package/dist/src/onboarding/ResolveStep.js.map

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

package/dist/src/onboarding/StepProps.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Props passed to each onboarding step component by the WizardShell.
+ */
+export interface StepProps {
+    onNext: () => void;
+    onBack?: () => void;
+    stepIndex?: number;
+    totalSteps?: number;
+}
+//# sourceMappingURL=StepProps.d.ts.map

package/dist/src/onboarding/StepProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepProps.d.ts","sourceRoot":"","sources":["../../../src/onboarding/StepProps.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/src/onboarding/StepProps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StepProps.js.map

package/dist/src/onboarding/StepProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepProps.js","sourceRoot":"","sources":["../../../src/onboarding/StepProps.ts"],"names":[],"mappings":""}

package/dist/src/onboarding/WizardContext.d.ts

@@ -0,0 +1,20 @@
+interface WizardContextValue {
+    /** Arbitrary metadata collected during wizard steps, keyed by step id or field name */
+    wizardMetadata: Record<string, unknown>;
+    setWizardMetadata: React.Dispatch<React.SetStateAction<Record<string, unknown>>>;
+    /** The scope this wizard is operating in */
+    scope: string;
+    /** The scope entity id — may start empty in create mode and be set after creation */
+    scopeId: string;
+    /** Update scopeId mid-wizard (used by create mode after scope entity is created) */
+    setScopeId: (id: string) => void;
+}
+interface WizardProviderProps {
+    children: React.ReactNode;
+    scope?: string;
+    scopeId?: string;
+}
+export declare function WizardProvider({ children, scope, scopeId: initialScopeId, }: WizardProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useWizard(): WizardContextValue;
+export {};
+//# sourceMappingURL=WizardContext.d.ts.map

package/dist/src/onboarding/WizardContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardContext.d.ts","sourceRoot":"","sources":["../../../src/onboarding/WizardContext.tsx"],"names":[],"mappings":"AAEA,UAAU,kBAAkB;IAC1B,uFAAuF;IACvF,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IAChF,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAA;IACf,oFAAoF;IACpF,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAID,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,KAAU,EACV,OAAO,EAAE,cAAmB,GAC7B,EAAE,mBAAmB,2CAUrB;AAED,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C"}

package/dist/src/onboarding/WizardContext.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useState, useMemo } from "react";
+const WizardCtx = createContext(null);
+export function WizardProvider({ children, scope = "", scopeId: initialScopeId = "", }) {
+    const [wizardMetadata, setWizardMetadata] = useState({});
+    const [scopeId, setScopeId] = useState(initialScopeId);
+    const value = useMemo(() => ({ wizardMetadata, setWizardMetadata, scope, scopeId, setScopeId }), [wizardMetadata, scope, scopeId]);
+    return _jsx(WizardCtx.Provider, { value: value, children: children });
+}
+export function useWizard() {
+    const context = useContext(WizardCtx);
+    if (!context) {
+        throw new Error("useWizard must be used within a WizardProvider");
+    }
+    return context;
+}
+//# sourceMappingURL=WizardContext.js.map

package/dist/src/onboarding/WizardContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardContext.js","sourceRoot":"","sources":["../../../src/onboarding/WizardContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAcpE,MAAM,SAAS,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAA;AAQhE,MAAM,UAAU,cAAc,CAAC,EAC7B,QAAQ,EACR,KAAK,GAAG,EAAE,EACV,OAAO,EAAE,cAAc,GAAG,EAAE,GACR;IACpB,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAA0B,EAAE,CAAC,CAAA;IACjF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAA;IAEtD,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EACzE,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CACjC,CAAA;IAED,OAAO,KAAC,SAAS,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAsB,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/src/onboarding/WizardPage.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from "react";
+interface WizardPageProps {
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    title: string;
+    subtitle: string;
+    steps?: number;
+    currentStep?: number;
+    children: ReactNode;
+}
+export declare function ProgressBar({ current, total }: {
+    current: number;
+    total: number;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function WizardPage({ icon: Icon, title, subtitle, steps, currentStep, children, }: WizardPageProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=WizardPage.d.ts.map

package/dist/src/onboarding/WizardPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardPage.d.ts","sourceRoot":"","sources":["../../../src/onboarding/WizardPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,2CAkBjF;AAED,wBAAgB,UAAU,CAAC,EACzB,IAAI,EAAE,IAAI,EACV,KAAK,EACL,QAAQ,EACR,KAAK,EACL,WAAW,EACX,QAAQ,GACT,EAAE,eAAe,2CA8BjB"}

package/dist/src/onboarding/WizardPage.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function ProgressBar({ current, total }) {
+    return (_jsx("div", { className: "flex items-center justify-center gap-1.5", role: "group", "aria-label": `Step ${current + 1} of ${total}`, children: Array.from({ length: total }, (_, i) => (_jsx("div", { "aria-hidden": "true", className: `h-1.5 rounded-full transition-all duration-300 ${i === current ? "w-8 bg-primary" : "w-4 bg-border"}` }, i))) }));
+}
+export function WizardPage({ icon: Icon, title, subtitle, steps, currentStep, children, }) {
+    const showStepper = steps != null && steps > 1;
+    return (_jsxs("div", { className: "flex w-full flex-col items-center", children: [showStepper && _jsx(ProgressBar, { current: currentStep ?? 0, total: steps }), Icon && (_jsx("div", { className: `flex h-12 w-12 items-center justify-center rounded-xl bg-primary/10 text-primary${showStepper ? " mt-6 sm:mt-8" : ""}`, children: _jsx(Icon, { className: "h-6 w-6" }) })), _jsx("h1", { className: `text-center text-2xl font-bold tracking-tight text-foreground sm:text-3xl${Icon ? " mt-4" : showStepper ? " mt-6 sm:mt-8" : ""}`, children: title }), _jsx("p", { className: "mt-2 text-center text-sm text-muted-foreground", children: subtitle }), _jsx("div", { className: "mt-10 w-full", children: children })] }));
+}
+//# sourceMappingURL=WizardPage.js.map

package/dist/src/onboarding/WizardPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardPage.js","sourceRoot":"","sources":["../../../src/onboarding/WizardPage.tsx"],"names":[],"mappings":";AAWA,MAAM,UAAU,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAsC;IAChF,OAAO,CACL,cACE,SAAS,EAAC,0CAA0C,EACpD,IAAI,EAAC,OAAO,gBACA,QAAQ,OAAO,GAAG,CAAC,OAAO,KAAK,EAAE,YAE5C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CACvC,6BAEc,MAAM,EAClB,SAAS,EAAE,kDACT,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eACrC,EAAE,IAJG,CAAC,CAKN,CACH,CAAC,GACE,CACP,CAAA;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EACzB,IAAI,EAAE,IAAI,EACV,KAAK,EACL,QAAQ,EACR,KAAK,EACL,WAAW,EACX,QAAQ,GACQ;IAChB,MAAM,WAAW,GAAG,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,CAAA;IAE9C,OAAO,CACL,eAAK,SAAS,EAAC,mCAAmC,aAC/C,WAAW,IAAI,KAAC,WAAW,IAAC,OAAO,EAAE,WAAW,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,GAAI,EAEvE,IAAI,IAAI,CACP,cACE,SAAS,EAAE,mFACT,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAClC,EAAE,YAEF,KAAC,IAAI,IAAC,SAAS,EAAC,SAAS,GAAG,GACxB,CACP,EAED,aACE,SAAS,EAAE,4EACT,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EACnD,EAAE,YAED,KAAK,GACH,EAEL,YAAG,SAAS,EAAC,gDAAgD,YAAE,QAAQ,GAAK,EAE5E,cAAK,SAAS,EAAC,cAAc,YAAE,QAAQ,GAAO,IAC1C,CACP,CAAA;AACH,CAAC"}

package/dist/src/onboarding/WizardShell.d.ts

@@ -0,0 +1,43 @@
+import type { OnboardingStepDefinition } from "../lib/types.ts";
+/**
+ * Configuration for create mode — prepends a scope creation step
+ * before the onboarding steps.
+ */
+export interface CreateConfig {
+    /** The child scope type being created */
+    childType: string;
+    /** Parent scope id (the scope creating the child) */
+    parentScopeId: string | null;
+    /** Parent scope type */
+    parentScopeType: string | null;
+}
+/**
+ * WizardShell — props-based coordinator for the onboarding wizard.
+ *
+ * Receives scope and scopeId as props (no URL detection).
+ * Handles step ordering (topological sort, conditions, wizardMetadata filtering),
+ * current index state, and server-side API calls.
+ * All UI is delegated to step components via props.
+ *
+ * When `create` is provided, the wizard starts with a scope creation step
+ * and `scopeId` begins empty. After the creation step creates the entity,
+ * it sets `scopeId` via WizardContext and subsequent onboarding steps
+ * operate on the new scope. If the user bails out after creation but
+ * before finishing onboarding, the guard will catch it on next scope access.
+ */
+export interface WizardShellProps {
+    /** Steps to render — if not provided, collected from hooks */
+    steps?: OnboardingStepDefinition[];
+    /** The configured scope type for this onboarding flow */
+    scope: string;
+    /** The scope entity id (may be empty in create mode) */
+    scopeId?: string;
+    /** Called when onboarding completes. In create mode, receives the new scopeId. */
+    onComplete: (scopeId?: string) => void;
+    /** For tool-level gating — filter steps to this tool */
+    toolId?: string;
+    /** When set, prepends a scope creation step before onboarding */
+    create?: CreateConfig;
+}
+export declare function WizardShell(props: WizardShellProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WizardShell.d.ts.map

package/dist/src/onboarding/WizardShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardShell.d.ts","sourceRoot":"","sources":["../../../src/onboarding/WizardShell.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAO/D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,wBAAwB;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,wBAAwB,EAAE,CAAA;IAClC,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kFAAkF;IAClF,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAMlD"}