react-wizard-engine 0.1.0

package/dist/shadcn/index.cjs

@@ -0,0 +1,311 @@
+"use client";
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/shadcn/index.ts
+var shadcn_exports = {};
+__export(shadcn_exports, {
+  WizardComponentsProviderWithDefaults: () => WizardComponentsProviderWithDefaults,
+  WizardLayout: () => WizardLayout,
+  WizardLayoutContext: () => WizardLayoutContext,
+  WizardTopBar: () => WizardTopBar,
+  defaultBackArrowIcon: () => defaultBackArrowIcon,
+  defaultButton: () => defaultButton
+});
+module.exports = __toCommonJS(shadcn_exports);
+
+// src/react/components-provider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var FallbackButton = (props) => {
+  const { children, asChild: _asChild, variant: _variant, size: _size, ...rest } = props;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { ...rest, type: props.type ?? "button", children });
+};
+var FallbackBackArrowIcon = ({ className }) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("svg", { className, width: "16", height: "16", viewBox: "0 0 16 16", fill: "currentColor", "aria-hidden": true, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("path", { d: "M10 4 L6 8 L10 12", stroke: "currentColor", strokeWidth: "1.5", fill: "none" }) });
+var defaults = { Button: FallbackButton, BackArrowIcon: FallbackBackArrowIcon };
+var WizardComponentsContext = (0, import_react.createContext)(defaults);
+function WizardComponentsProvider(props) {
+  const { Button, BackArrowIcon, children } = props;
+  const value = {
+    Button: Button ?? defaults.Button,
+    BackArrowIcon: BackArrowIcon ?? defaults.BackArrowIcon
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(WizardComponentsContext.Provider, { value, children });
+}
+function useWizardComponents() {
+  return (0, import_react.useContext)(WizardComponentsContext);
+}
+
+// src/utils/cn.ts
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+function cn(...inputs) {
+  return (0, import_tailwind_merge.twMerge)((0, import_clsx.clsx)(...inputs));
+}
+
+// src/shadcn/default-back-arrow-icon.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function defaultBackArrowIcon({ className, ...rest }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    "svg",
+    {
+      className: cn(
+        "h-4 w-4 transition-transform duration-150 group-hover:-translate-x-0.5",
+        className
+      ),
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: 1.75,
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      viewBox: "0 0 16 16",
+      "aria-hidden": true,
+      ...rest,
+      children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M10 4 L6 8 L10 12" })
+    }
+  );
+}
+
+// src/shadcn/default-button.tsx
+var import_react_slot = require("@radix-ui/react-slot");
+var import_class_variance_authority = require("class-variance-authority");
+var import_react2 = require("react");
+var import_jsx_runtime3 = require("react/jsx-runtime");
+var buttonVariants = (0, import_class_variance_authority.cva)(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        ghost: "hover:bg-accent hover:text-accent-foreground"
+      },
+      size: {
+        default: "h-9 px-4 py-2",
+        "icon-sm": "h-8 w-8"
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default"
+    }
+  }
+);
+var defaultButton = (0, import_react2.forwardRef)(function DefaultButton({ asChild, className, size, variant, type, ...rest }, ref) {
+  const Comp = asChild ? import_react_slot.Slot : "button";
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+    Comp,
+    {
+      ref,
+      type: asChild ? void 0 : type ?? "button",
+      className: cn(buttonVariants({ size, variant }), className),
+      ...rest
+    }
+  );
+});
+
+// src/shadcn/components-provider-with-defaults.tsx
+var import_jsx_runtime4 = require("react/jsx-runtime");
+function WizardComponentsProviderWithDefaults({ children }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(WizardComponentsProvider, { Button: defaultButton, BackArrowIcon: defaultBackArrowIcon, children });
+}
+
+// src/shadcn/wizard-layout.tsx
+var Dialog = __toESM(require("@radix-ui/react-dialog"), 1);
+var import_react4 = require("react");
+
+// src/shadcn/wizard-layout.context.ts
+var import_react3 = require("react");
+var WizardLayoutContext = (0, import_react3.createContext)(null);
+
+// src/shadcn/wizard-layout.tsx
+var import_jsx_runtime5 = require("react/jsx-runtime");
+function WizardLayout(props) {
+  const { children, className, defaultRailTitle = "Wizard steps", rail, railTitle, ref, topBar } = props;
+  const [mobileSheetOpen, setMobileSheetOpen] = (0, import_react4.useState)(false);
+  const closeMobileSheet = () => setMobileSheetOpen(false);
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(WizardLayoutContext.Provider, { value: { mobileSheetOpen, setMobileSheetOpen }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: cn("flex h-full min-h-0 w-full flex-1 bg-sidebar", className), "data-slot": "wizard-layout-outer", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
+      "div",
+      {
+        className: "flex flex-1 overflow-hidden bg-background text-foreground shadow-sm ring-1 ring-foreground/10 md:rounded-xl",
+        "data-slot": "wizard-layout",
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
+            "aside",
+            {
+              className: "hidden w-[280px] shrink-0 flex-col gap-4 border-r border-border px-4 py-6 md:flex",
+              "data-slot": "wizard-layout-rail",
+              children: [
+                railTitle && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "px-3 text-base font-semibold text-foreground", children: railTitle }),
+                rail
+              ]
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "flex min-w-0 flex-1 flex-col", children: [
+            topBar,
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+              "div",
+              {
+                className: "min-h-0 flex-1 overflow-y-auto px-4 py-6 sm:px-8",
+                "data-slot": "wizard-layout-scroll",
+                ref,
+                children
+              }
+            )
+          ] })
+        ]
+      }
+    ) }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Dialog.Root, { onOpenChange: setMobileSheetOpen, open: mobileSheetOpen, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Dialog.Portal, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Dialog.Overlay, { className: "fixed inset-0 z-50 bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0" }),
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
+        Dialog.Content,
+        {
+          "aria-describedby": void 0,
+          className: "fixed inset-y-0 left-0 z-50 flex w-3/4 max-w-sm flex-col gap-4 border-r border-border bg-background px-4 py-6 shadow-lg data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left",
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Dialog.Title, { className: "px-3 text-base font-semibold", children: railTitle ?? defaultRailTitle }),
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { onClickCapture: closeMobileSheet, children: rail })
+          ]
+        }
+      )
+    ] }) })
+  ] });
+}
+
+// src/shadcn/wizard-top-bar.tsx
+var import_lucide_react = require("lucide-react");
+var import_react7 = require("react");
+
+// src/react/use-wizard.ts
+var import_react6 = require("react");
+
+// src/core/errors/wizard.error.ts
+var WizardError = class extends Error {
+  name = "WizardError";
+  constructor(message) {
+    super(message);
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/react/context.ts
+var import_react5 = require("react");
+var WizardEngineContext = (0, import_react5.createContext)(null);
+
+// src/react/use-wizard.ts
+function useWizard() {
+  const engine = (0, import_react6.useContext)(WizardEngineContext);
+  if (!engine) {
+    throw new WizardError("useWizard must be used inside <WizardProvider>");
+  }
+  (0, import_react6.useSyncExternalStore)(engine.subscribe, engine.getTreeSnapshot, engine.getTreeSnapshot);
+  return engine;
+}
+
+// src/shadcn/wizard-top-bar.tsx
+var import_jsx_runtime6 = require("react/jsx-runtime");
+function WizardTopBar(props) {
+  const { backLabel, className, closeLabel, disabled, extraActions, finishLabel, menuLabel, nextLabel, onClose } = props;
+  const wizard = useWizard();
+  const layout = (0, import_react7.useContext)(WizardLayoutContext);
+  const { Button, BackArrowIcon } = useWizardComponents();
+  const config = wizard.configOptions;
+  const tree = wizard.tree;
+  const isFirstStep = tree.activeBranch.prevCategory == null && tree.activeCategory.prevStep == null;
+  const isLastStep = tree.activeBranch.nextCategory == null && tree.activeCategory.nextStep == null;
+  const resolvedBackLabel = backLabel ?? config.backBtnText;
+  const resolvedFinishLabel = finishLabel ?? config.finishText;
+  const resolvedNextLabel = nextLabel ?? config.nextBtnText;
+  const resolvedMenuLabel = menuLabel ?? "Open wizard steps";
+  const resolvedCloseLabel = closeLabel ?? "Close";
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+    "div",
+    {
+      className: cn("flex h-14 items-center gap-3 border-b border-border bg-background px-4 sm:px-6", className),
+      "data-slot": "wizard-top-bar",
+      children: [
+        layout && /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+          Button,
+          {
+            "aria-label": resolvedMenuLabel,
+            className: "md:hidden",
+            onClick: () => layout.setMobileSheetOpen(true),
+            size: "icon-sm",
+            type: "button",
+            variant: "ghost",
+            children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_lucide_react.MenuIcon, {})
+          }
+        ),
+        !isFirstStep && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+          "button",
+          {
+            "aria-label": typeof resolvedBackLabel === "string" ? resolvedBackLabel : void 0,
+            className: "group inline-flex items-center gap-1 rounded-md py-1 pr-2.5 pl-3.5 text-sm font-normal text-muted-foreground transition-colors duration-150 hover:bg-muted hover:text-foreground",
+            onClick: () => {
+              void wizard.back();
+            },
+            type: "button",
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(BackArrowIcon, {}),
+              /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { children: resolvedBackLabel })
+            ]
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "flex flex-1 items-center justify-end gap-2", children: [
+          extraActions,
+          isLastStep ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Button, { disabled, type: "submit", variant: "default", children: resolvedFinishLabel }, "wizard-finish") : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+            Button,
+            {
+              disabled,
+              onClick: () => {
+                void wizard.next();
+              },
+              type: "button",
+              variant: "default",
+              children: resolvedNextLabel
+            },
+            "wizard-next"
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Button, { "aria-label": resolvedCloseLabel, onClick: onClose, size: "icon-sm", type: "button", variant: "ghost", children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_lucide_react.XIcon, {}) })
+        ] })
+      ]
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WizardComponentsProviderWithDefaults,
+  WizardLayout,
+  WizardLayoutContext,
+  WizardTopBar,
+  defaultBackArrowIcon,
+  defaultButton
+});
+//# sourceMappingURL=index.cjs.map

package/dist/shadcn/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shadcn/index.ts","../../src/react/components-provider.tsx","../../src/utils/cn.ts","../../src/shadcn/default-back-arrow-icon.tsx","../../src/shadcn/default-button.tsx","../../src/shadcn/components-provider-with-defaults.tsx","../../src/shadcn/wizard-layout.tsx","../../src/shadcn/wizard-layout.context.ts","../../src/shadcn/wizard-top-bar.tsx","../../src/react/use-wizard.ts","../../src/core/errors/wizard.error.ts","../../src/react/context.ts"],"sourcesContent":["export { WizardComponentsProviderWithDefaults } from './components-provider-with-defaults';\nexport { defaultBackArrowIcon } from './default-back-arrow-icon';\nexport { defaultButton } from './default-button';\nexport { WizardLayout } from './wizard-layout';\nexport { WizardLayoutContext } from './wizard-layout.context';\nexport { WizardTopBar } from './wizard-top-bar';\n","'use client';\n\nimport { type ComponentType, createContext, type ReactNode, useContext } from 'react';\n\nexport interface IWizardButtonProps {\n\tasChild?: boolean;\n\tchildren?: ReactNode;\n\tclassName?: string;\n\tdisabled?: boolean;\n\tonClick?: () => void;\n\ttype?: 'button' | 'submit';\n\tvariant?: 'default' | 'ghost';\n\tsize?: 'default' | 'icon-sm';\n\t'aria-label'?: string;\n}\n\nexport interface IWizardBackArrowIconProps {\n\tclassName?: string;\n}\n\nexport interface IWizardComponents {\n\tButton: ComponentType<IWizardButtonProps>;\n\tBackArrowIcon: ComponentType<IWizardBackArrowIconProps>;\n}\n\nconst FallbackButton: ComponentType<IWizardButtonProps> = (props) => {\n\tconst { children, asChild: _asChild, variant: _variant, size: _size, ...rest } = props;\n\treturn (\n\t\t<button {...rest} type={props.type ?? 'button'}>\n\t\t\t{children}\n\t\t</button>\n\t);\n};\n\nconst FallbackBackArrowIcon: ComponentType<IWizardBackArrowIconProps> = ({ className }) => (\n\t<svg className={className} width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"currentColor\" aria-hidden>\n\t\t<path d=\"M10 4 L6 8 L10 12\" stroke=\"currentColor\" strokeWidth=\"1.5\" fill=\"none\" />\n\t</svg>\n);\n\nconst defaults: IWizardComponents = { Button: FallbackButton, BackArrowIcon: FallbackBackArrowIcon };\n\nconst WizardComponentsContext = createContext<IWizardComponents>(defaults);\n\nexport function WizardComponentsProvider(props: {\n\tButton?: ComponentType<IWizardButtonProps>;\n\tBackArrowIcon?: ComponentType<IWizardBackArrowIconProps>;\n\tchildren: ReactNode;\n}) {\n\tconst { Button, BackArrowIcon, children } = props;\n\tconst value: IWizardComponents = {\n\t\tButton: Button ?? defaults.Button,\n\t\tBackArrowIcon: BackArrowIcon ?? defaults.BackArrowIcon,\n\t};\n\treturn <WizardComponentsContext.Provider value={value}>{children}</WizardComponentsContext.Provider>;\n}\n\nexport function useWizardComponents(): IWizardComponents {\n\treturn useContext(WizardComponentsContext);\n}\n","import { clsx, type ClassValue } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(...inputs));\n}\n","'use client';\n\nimport { type ComponentProps } from 'react';\n\nimport { cn } from '~/utils/cn';\n\n/** Animated back-arrow icon. The arrow translates -2px on the parent's group-hover. */\nexport function defaultBackArrowIcon({ className, ...rest }: ComponentProps<'svg'>) {\n\treturn (\n\t\t<svg\n\t\t\tclassName={cn(\n\t\t\t\t'h-4 w-4 transition-transform duration-150 group-hover:-translate-x-0.5',\n\t\t\t\tclassName\n\t\t\t)}\n\t\t\tfill=\"none\"\n\t\t\tstroke=\"currentColor\"\n\t\t\tstrokeWidth={1.75}\n\t\t\tstrokeLinecap=\"round\"\n\t\t\tstrokeLinejoin=\"round\"\n\t\t\tviewBox=\"0 0 16 16\"\n\t\t\taria-hidden\n\t\t\t{...rest}\n\t\t>\n\t\t\t<path d=\"M10 4 L6 8 L10 12\" />\n\t\t</svg>\n\t);\n}\n","'use client';\n\nimport { Slot } from '@radix-ui/react-slot';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { forwardRef, type ReactNode } from 'react';\n\nimport { cn } from '~/utils/cn';\nimport { type IWizardButtonProps } from '../react/components-provider';\n\nconst buttonVariants = cva(\n\t'inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50',\n\t{\n\t\tvariants: {\n\t\t\tvariant: {\n\t\t\t\tdefault: 'bg-primary text-primary-foreground hover:bg-primary/90',\n\t\t\t\tghost: 'hover:bg-accent hover:text-accent-foreground',\n\t\t\t},\n\t\t\tsize: {\n\t\t\t\tdefault: 'h-9 px-4 py-2',\n\t\t\t\t'icon-sm': 'h-8 w-8',\n\t\t\t},\n\t\t},\n\t\tdefaultVariants: {\n\t\t\tvariant: 'default',\n\t\t\tsize: 'default',\n\t\t},\n\t}\n);\n\ntype InternalProps = Omit<IWizardButtonProps, 'size' | 'variant'> &\n\tVariantProps<typeof buttonVariants> & {\n\t\tchildren?: ReactNode;\n\t};\n\nexport const defaultButton = forwardRef<HTMLButtonElement, InternalProps>(function DefaultButton(\n\t{ asChild, className, size, variant, type, ...rest },\n\tref\n) {\n\tconst Comp: any = asChild ? Slot : 'button';\n\treturn (\n\t\t<Comp\n\t\t\tref={ref}\n\t\t\ttype={asChild ? undefined : (type ?? 'button')}\n\t\t\tclassName={cn(buttonVariants({ size, variant }), className)}\n\t\t\t{...rest}\n\t\t/>\n\t);\n});\n","'use client';\n\nimport { type ReactNode } from 'react';\n\nimport { WizardComponentsProvider } from '../react/components-provider';\nimport { defaultBackArrowIcon } from './default-back-arrow-icon';\nimport { defaultButton } from './default-button';\n\n/**\n * Convenience wrapper around `WizardComponentsProvider` that wires in the\n * package-shipped `defaultButton` and `defaultBackArrowIcon`. Use this if\n * you want the styled adapter out of the box; use `WizardComponentsProvider`\n * directly if you want to pass your own.\n */\nexport function WizardComponentsProviderWithDefaults({ children }: { children: ReactNode }) {\n\treturn (\n\t\t<WizardComponentsProvider Button={defaultButton} BackArrowIcon={defaultBackArrowIcon}>\n\t\t\t{children}\n\t\t</WizardComponentsProvider>\n\t);\n}\n","'use client';\n\nimport * as Dialog from '@radix-ui/react-dialog';\nimport { type ReactNode, type Ref, useState } from 'react';\n\nimport { cn } from '~/utils/cn';\nimport { WizardLayoutContext } from './wizard-layout.context';\n\ninterface IWizardLayoutProps {\n\tchildren: ReactNode;\n\tclassName?: string;\n\tdefaultRailTitle?: string;\n\trail: ReactNode;\n\trailTitle?: ReactNode;\n\tref?: Ref<HTMLDivElement>;\n\ttopBar: ReactNode;\n}\n\n/**\n * Full-page wizard shell. Renders a top bar across the right column on\n * desktop, a vertical rail on the left, and a scrollable content area for\n * the active step. Below the `md` breakpoint the rail collapses into a\n * left-side dialog whose open state is exposed via `WizardLayoutContext`\n * so the top bar's hamburger button can drive it.\n */\nexport function WizardLayout(props: IWizardLayoutProps) {\n\tconst { children, className, defaultRailTitle = 'Wizard steps', rail, railTitle, ref, topBar } = props;\n\tconst [mobileSheetOpen, setMobileSheetOpen] = useState(false);\n\n\tconst closeMobileSheet = () => setMobileSheetOpen(false);\n\n\treturn (\n\t\t<WizardLayoutContext.Provider value={{ mobileSheetOpen, setMobileSheetOpen }}>\n\t\t\t<div className={cn('flex h-full min-h-0 w-full flex-1 bg-sidebar', className)} data-slot=\"wizard-layout-outer\">\n\t\t\t\t<div\n\t\t\t\t\tclassName=\"flex flex-1 overflow-hidden bg-background text-foreground shadow-sm ring-1 ring-foreground/10 md:rounded-xl\"\n\t\t\t\t\tdata-slot=\"wizard-layout\"\n\t\t\t\t>\n\t\t\t\t\t<aside\n\t\t\t\t\t\tclassName=\"hidden w-[280px] shrink-0 flex-col gap-4 border-r border-border px-4 py-6 md:flex\"\n\t\t\t\t\t\tdata-slot=\"wizard-layout-rail\"\n\t\t\t\t\t>\n\t\t\t\t\t\t{railTitle && <div className=\"px-3 text-base font-semibold text-foreground\">{railTitle}</div>}\n\t\t\t\t\t\t{rail}\n\t\t\t\t\t</aside>\n\n\t\t\t\t\t<div className=\"flex min-w-0 flex-1 flex-col\">\n\t\t\t\t\t\t{topBar}\n\t\t\t\t\t\t<div\n\t\t\t\t\t\t\tclassName=\"min-h-0 flex-1 overflow-y-auto px-4 py-6 sm:px-8\"\n\t\t\t\t\t\t\tdata-slot=\"wizard-layout-scroll\"\n\t\t\t\t\t\t\tref={ref}\n\t\t\t\t\t\t>\n\t\t\t\t\t\t\t{children}\n\t\t\t\t\t\t</div>\n\t\t\t\t\t</div>\n\t\t\t\t</div>\n\t\t\t</div>\n\n\t\t\t<Dialog.Root onOpenChange={setMobileSheetOpen} open={mobileSheetOpen}>\n\t\t\t\t<Dialog.Portal>\n\t\t\t\t\t<Dialog.Overlay className=\"fixed inset-0 z-50 bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\" />\n\t\t\t\t\t<Dialog.Content\n\t\t\t\t\t\taria-describedby={undefined}\n\t\t\t\t\t\tclassName=\"fixed inset-y-0 left-0 z-50 flex w-3/4 max-w-sm flex-col gap-4 border-r border-border bg-background px-4 py-6 shadow-lg data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left\"\n\t\t\t\t\t>\n\t\t\t\t\t\t<Dialog.Title className=\"px-3 text-base font-semibold\">{railTitle ?? defaultRailTitle}</Dialog.Title>\n\t\t\t\t\t\t<div onClickCapture={closeMobileSheet}>{rail}</div>\n\t\t\t\t\t</Dialog.Content>\n\t\t\t\t</Dialog.Portal>\n\t\t\t</Dialog.Root>\n\t\t</WizardLayoutContext.Provider>\n\t);\n}\n","'use client';\n\nimport { createContext } from 'react';\n\nexport interface IWizardLayoutContextValue {\n\tmobileSheetOpen: boolean;\n\tsetMobileSheetOpen: (open: boolean) => void;\n}\n\n/**\n * Communicates the rail's mobile-Sheet open state from `WizardLayout` to\n * `WizardTopBar`. Null outside a layout — consumers (top bar's hamburger\n * button) silently no-op when context is missing, so the top bar stays usable\n * outside `WizardLayout`.\n */\nexport const WizardLayoutContext = createContext<IWizardLayoutContextValue | null>(null);\n","'use client';\n\nimport { MenuIcon, XIcon } from 'lucide-react';\nimport { type ReactNode, useContext } from 'react';\n\nimport { useWizardComponents } from '../react/components-provider';\nimport { useWizard } from '../react/use-wizard';\nimport { cn } from '~/utils/cn';\nimport { WizardLayoutContext } from './wizard-layout.context';\n\ninterface IWizardTopBarProps {\n\tbackLabel?: ReactNode;\n\tclassName?: string;\n\tcloseLabel?: string;\n\tdisabled?: boolean;\n\textraActions?: ReactNode;\n\tfinishLabel?: ReactNode;\n\tmenuLabel?: string;\n\tnextLabel?: ReactNode;\n\tonClose: () => void;\n}\n\n/**\n * Header bar for full-page wizard layouts. Renders Back / primary action /\n * extras / close X. Reads `useWizard` for first/last-step detection. The\n * primary action is `type=\"submit\"` on the last step (lets the parent form\n * own submission) and dispatches `wizard.next()` otherwise. Hamburger only\n * surfaces when wrapped by a `WizardLayout`.\n */\nexport function WizardTopBar(props: IWizardTopBarProps) {\n\tconst { backLabel, className, closeLabel, disabled, extraActions, finishLabel, menuLabel, nextLabel, onClose } =\n\t\tprops;\n\tconst wizard = useWizard();\n\tconst layout = useContext(WizardLayoutContext);\n\tconst { Button, BackArrowIcon } = useWizardComponents();\n\n\tconst config = wizard.configOptions;\n\tconst tree = wizard.tree;\n\tconst isFirstStep = tree.activeBranch.prevCategory == null && tree.activeCategory.prevStep == null;\n\tconst isLastStep = tree.activeBranch.nextCategory == null && tree.activeCategory.nextStep == null;\n\n\tconst resolvedBackLabel = backLabel ?? config.backBtnText;\n\tconst resolvedFinishLabel = finishLabel ?? config.finishText;\n\tconst resolvedNextLabel = nextLabel ?? config.nextBtnText;\n\tconst resolvedMenuLabel = menuLabel ?? 'Open wizard steps';\n\tconst resolvedCloseLabel = closeLabel ?? 'Close';\n\n\treturn (\n\t\t<div\n\t\t\tclassName={cn('flex h-14 items-center gap-3 border-b border-border bg-background px-4 sm:px-6', className)}\n\t\t\tdata-slot=\"wizard-top-bar\"\n\t\t>\n\t\t\t{layout && (\n\t\t\t\t<Button\n\t\t\t\t\taria-label={resolvedMenuLabel}\n\t\t\t\t\tclassName=\"md:hidden\"\n\t\t\t\t\tonClick={() => layout.setMobileSheetOpen(true)}\n\t\t\t\t\tsize=\"icon-sm\"\n\t\t\t\t\ttype=\"button\"\n\t\t\t\t\tvariant=\"ghost\"\n\t\t\t\t>\n\t\t\t\t\t<MenuIcon />\n\t\t\t\t</Button>\n\t\t\t)}\n\n\t\t\t{!isFirstStep && (\n\t\t\t\t<button\n\t\t\t\t\taria-label={typeof resolvedBackLabel === 'string' ? resolvedBackLabel : undefined}\n\t\t\t\t\tclassName=\"group inline-flex items-center gap-1 rounded-md py-1 pr-2.5 pl-3.5 text-sm font-normal text-muted-foreground transition-colors duration-150 hover:bg-muted hover:text-foreground\"\n\t\t\t\t\tonClick={() => {\n\t\t\t\t\t\tvoid wizard.back();\n\t\t\t\t\t}}\n\t\t\t\t\ttype=\"button\"\n\t\t\t\t>\n\t\t\t\t\t<BackArrowIcon />\n\t\t\t\t\t<span>{resolvedBackLabel}</span>\n\t\t\t\t</button>\n\t\t\t)}\n\n\t\t\t<div className=\"flex flex-1 items-center justify-end gap-2\">\n\t\t\t\t{extraActions}\n\t\t\t\t{isLastStep ? (\n\t\t\t\t\t<Button disabled={disabled} key=\"wizard-finish\" type=\"submit\" variant=\"default\">\n\t\t\t\t\t\t{resolvedFinishLabel}\n\t\t\t\t\t</Button>\n\t\t\t\t) : (\n\t\t\t\t\t<Button\n\t\t\t\t\t\tdisabled={disabled}\n\t\t\t\t\t\tkey=\"wizard-next\"\n\t\t\t\t\t\tonClick={() => {\n\t\t\t\t\t\t\tvoid wizard.next();\n\t\t\t\t\t\t}}\n\t\t\t\t\t\ttype=\"button\"\n\t\t\t\t\t\tvariant=\"default\"\n\t\t\t\t\t>\n\t\t\t\t\t\t{resolvedNextLabel}\n\t\t\t\t\t</Button>\n\t\t\t\t)}\n\t\t\t\t<Button aria-label={resolvedCloseLabel} onClick={onClose} size=\"icon-sm\" type=\"button\" variant=\"ghost\">\n\t\t\t\t\t<XIcon />\n\t\t\t\t</Button>\n\t\t\t</div>\n\t\t</div>\n\t);\n}\n","'use client';\n\nimport { useContext, useSyncExternalStore } from 'react';\n\nimport type { WizardEngine } from '../core/wizard-engine';\n\nimport { WizardError } from '../core/errors';\nimport { WizardEngineContext } from './context';\n\n/**\n * Returns the active `WizardEngine` instance and re-renders the consumer on\n * every tree change. Throws if used outside a `<WizardProvider>`.\n *\n * Engine identity is stable across renders.\n */\nexport function useWizard<Step extends string, Category extends string, Branch extends string = string>(): WizardEngine<\n\tStep,\n\tCategory,\n\tBranch\n> {\n\tconst engine = useContext(WizardEngineContext) as null | WizardEngine<Step, Category, Branch>;\n\tif (!engine) {\n\t\tthrow new WizardError('useWizard must be used inside <WizardProvider>');\n\t}\n\tuseSyncExternalStore(engine.subscribe, engine.getTreeSnapshot, engine.getTreeSnapshot);\n\treturn engine;\n}\n","export class WizardError extends Error {\n\tpublic override readonly name: string = 'WizardError';\n\n\tconstructor(message?: string) {\n\t\tsuper(message);\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\nexport class WizardInitializationError extends WizardError {\n\tpublic override readonly name: string = 'WizardInitializationError';\n}\n\nexport class WizardNavigationError extends WizardError {\n\tpublic override readonly name: string = 'WizardNavigationError';\n}\n\nexport class WizardResolverError extends WizardError {\n\tpublic override readonly name: string = 'WizardResolverError';\n}\n","'use client';\n\nimport { createContext } from 'react';\n\nimport type { WizardEngine } from '../core/wizard-engine';\n\n/**\n * React context exposing the active `WizardEngine` instance to descendants.\n * `null` outside a `<WizardProvider>` — `useWizard()` throws a clear error.\n */\nexport const WizardEngineContext = createContext<null | WizardEngine<string, string, string>>(null);\n"],"mappings":"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","names":["import_jsx_runtime","import_react","import_jsx_runtime","import_jsx_runtime","import_react","import_react","import_jsx_runtime","import_react","import_react","import_react","import_jsx_runtime"]}

package/dist/shadcn/index.d.cts

@@ -0,0 +1,78 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode, ComponentProps, Ref } from 'react';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+import { a as IWizardButtonProps } from '../components-provider-bC3_zfyb.cjs';
+
+/**
+ * Convenience wrapper around `WizardComponentsProvider` that wires in the
+ * package-shipped `defaultButton` and `defaultBackArrowIcon`. Use this if
+ * you want the styled adapter out of the box; use `WizardComponentsProvider`
+ * directly if you want to pass your own.
+ */
+declare function WizardComponentsProviderWithDefaults({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+/** Animated back-arrow icon. The arrow translates -2px on the parent's group-hover. */
+declare function defaultBackArrowIcon({ className, ...rest }: ComponentProps<'svg'>): react_jsx_runtime.JSX.Element;
+
+declare const defaultButton: react.ForwardRefExoticComponent<Omit<IWizardButtonProps, "variant" | "size"> & VariantProps<(props?: ({
+    variant?: "default" | "ghost" | null | undefined;
+    size?: "default" | "icon-sm" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string> & {
+    children?: ReactNode;
+} & react.RefAttributes<HTMLButtonElement>>;
+
+interface IWizardLayoutProps {
+    children: ReactNode;
+    className?: string;
+    defaultRailTitle?: string;
+    rail: ReactNode;
+    railTitle?: ReactNode;
+    ref?: Ref<HTMLDivElement>;
+    topBar: ReactNode;
+}
+/**
+ * Full-page wizard shell. Renders a top bar across the right column on
+ * desktop, a vertical rail on the left, and a scrollable content area for
+ * the active step. Below the `md` breakpoint the rail collapses into a
+ * left-side dialog whose open state is exposed via `WizardLayoutContext`
+ * so the top bar's hamburger button can drive it.
+ */
+declare function WizardLayout(props: IWizardLayoutProps): react_jsx_runtime.JSX.Element;
+
+interface IWizardLayoutContextValue {
+    mobileSheetOpen: boolean;
+    setMobileSheetOpen: (open: boolean) => void;
+}
+/**
+ * Communicates the rail's mobile-Sheet open state from `WizardLayout` to
+ * `WizardTopBar`. Null outside a layout — consumers (top bar's hamburger
+ * button) silently no-op when context is missing, so the top bar stays usable
+ * outside `WizardLayout`.
+ */
+declare const WizardLayoutContext: react.Context<IWizardLayoutContextValue | null>;
+
+interface IWizardTopBarProps {
+    backLabel?: ReactNode;
+    className?: string;
+    closeLabel?: string;
+    disabled?: boolean;
+    extraActions?: ReactNode;
+    finishLabel?: ReactNode;
+    menuLabel?: string;
+    nextLabel?: ReactNode;
+    onClose: () => void;
+}
+/**
+ * Header bar for full-page wizard layouts. Renders Back / primary action /
+ * extras / close X. Reads `useWizard` for first/last-step detection. The
+ * primary action is `type="submit"` on the last step (lets the parent form
+ * own submission) and dispatches `wizard.next()` otherwise. Hamburger only
+ * surfaces when wrapped by a `WizardLayout`.
+ */
+declare function WizardTopBar(props: IWizardTopBarProps): react_jsx_runtime.JSX.Element;
+
+export { WizardComponentsProviderWithDefaults, WizardLayout, WizardLayoutContext, WizardTopBar, defaultBackArrowIcon, defaultButton };

package/dist/shadcn/index.d.ts

@@ -0,0 +1,78 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode, ComponentProps, Ref } from 'react';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+import { a as IWizardButtonProps } from '../components-provider-bC3_zfyb.js';
+
+/**
+ * Convenience wrapper around `WizardComponentsProvider` that wires in the
+ * package-shipped `defaultButton` and `defaultBackArrowIcon`. Use this if
+ * you want the styled adapter out of the box; use `WizardComponentsProvider`
+ * directly if you want to pass your own.
+ */
+declare function WizardComponentsProviderWithDefaults({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+/** Animated back-arrow icon. The arrow translates -2px on the parent's group-hover. */
+declare function defaultBackArrowIcon({ className, ...rest }: ComponentProps<'svg'>): react_jsx_runtime.JSX.Element;
+
+declare const defaultButton: react.ForwardRefExoticComponent<Omit<IWizardButtonProps, "variant" | "size"> & VariantProps<(props?: ({
+    variant?: "default" | "ghost" | null | undefined;
+    size?: "default" | "icon-sm" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string> & {
+    children?: ReactNode;
+} & react.RefAttributes<HTMLButtonElement>>;
+
+interface IWizardLayoutProps {
+    children: ReactNode;
+    className?: string;
+    defaultRailTitle?: string;
+    rail: ReactNode;
+    railTitle?: ReactNode;
+    ref?: Ref<HTMLDivElement>;
+    topBar: ReactNode;
+}
+/**
+ * Full-page wizard shell. Renders a top bar across the right column on
+ * desktop, a vertical rail on the left, and a scrollable content area for
+ * the active step. Below the `md` breakpoint the rail collapses into a
+ * left-side dialog whose open state is exposed via `WizardLayoutContext`
+ * so the top bar's hamburger button can drive it.
+ */
+declare function WizardLayout(props: IWizardLayoutProps): react_jsx_runtime.JSX.Element;
+
+interface IWizardLayoutContextValue {
+    mobileSheetOpen: boolean;
+    setMobileSheetOpen: (open: boolean) => void;
+}
+/**
+ * Communicates the rail's mobile-Sheet open state from `WizardLayout` to
+ * `WizardTopBar`. Null outside a layout — consumers (top bar's hamburger
+ * button) silently no-op when context is missing, so the top bar stays usable
+ * outside `WizardLayout`.
+ */
+declare const WizardLayoutContext: react.Context<IWizardLayoutContextValue | null>;
+
+interface IWizardTopBarProps {
+    backLabel?: ReactNode;
+    className?: string;
+    closeLabel?: string;
+    disabled?: boolean;
+    extraActions?: ReactNode;
+    finishLabel?: ReactNode;
+    menuLabel?: string;
+    nextLabel?: ReactNode;
+    onClose: () => void;
+}
+/**
+ * Header bar for full-page wizard layouts. Renders Back / primary action /
+ * extras / close X. Reads `useWizard` for first/last-step detection. The
+ * primary action is `type="submit"` on the last step (lets the parent form
+ * own submission) and dispatches `wizard.next()` otherwise. Hamburger only
+ * surfaces when wrapped by a `WizardLayout`.
+ */
+declare function WizardTopBar(props: IWizardTopBarProps): react_jsx_runtime.JSX.Element;
+
+export { WizardComponentsProviderWithDefaults, WizardLayout, WizardLayoutContext, WizardTopBar, defaultBackArrowIcon, defaultButton };