@seedgrid/fe-components 2026.3.19 → 2026.3.26

package/dist/wizard/SgWizard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgWizard.d.ts","sourceRoot":"","sources":["../../src/wizard/SgWizard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CAEpD;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC;AA+EF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,2CAwI5C"}
+{"version":3,"file":"SgWizard.d.ts","sourceRoot":"","sources":["../../src/wizard/SgWizard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CAEpD;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC;AAiFF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,2CA+H5C"}

package/dist/wizard/SgWizard.js

@@ -2,17 +2,18 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
 import { t, useComponentsI18n } from "../i18n";
+import { canProceedWizardAction, clampWizardStep } from "./logic";
 export function SgWizardPage(props) {
     return _jsx("div", { className: props.className, style: props.style, children: props.children });
 }
 function CheckIcon({ className }) {
     return (_jsx("svg", { className: className, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M20 6 9 17l-5-5" }) }));
 }
-function StepperBar({ pages, currentStep, mode }) {
-    return (_jsx("nav", { "aria-label": "Progress", className: "mb-8", children: _jsx("ol", { className: "flex items-center", children: pages.map((page, i) => {
+function StepperBar({ i18n, pages, currentStep, mode }) {
+    return (_jsx("nav", { "aria-label": t(i18n, "components.wizard.progress"), className: "mb-8", children: _jsx("ol", { className: "flex items-center", children: pages.map((page, i) => {
                 const isCompleted = i < currentStep;
                 const isCurrent = i === currentStep;
-                const title = page.props.title ?? `Step ${i + 1}`;
+                const title = page.props.title ?? t(i18n, "components.wizard.step", { step: i + 1 });
                 const icon = page.props.icon;
                 const isLast = i === pages.length - 1;
                 return (_jsxs("li", { className: `flex items-center ${isLast ? "" : "flex-1"}`, children: [_jsxs("div", { className: "flex flex-col items-center", children: [_jsx("div", { className: `flex items-center justify-center rounded-full border-2 transition-colors duration-200 ${isCompleted
@@ -26,10 +27,7 @@ export function SgWizard(props) {
     const i18n = useComponentsI18n();
     const pages = React.Children.toArray(props.children).filter((child) => React.isValidElement(child) && child.type === SgWizardPage);
     const stepper = props.stepper ?? "none";
-    const [step, setStep] = React.useState(() => {
-        const idx = props.initialStep ?? 0;
-        return Math.min(Math.max(idx, 0), Math.max(pages.length - 1, 0));
-    });
+    const [step, setStep] = React.useState(() => clampWizardStep(props.initialStep, pages.length));
     const [isFinishing, setIsFinishing] = React.useState(false);
     const [isValidating, setIsValidating] = React.useState(false);
     const pageRef = React.useRef(null);
@@ -64,19 +62,14 @@ export function SgWizard(props) {
             return;
         setIsValidating(true);
         try {
-            const pageValid = await validateCurrentPage();
-            if (!pageValid)
+            const ok = await canProceedWizardAction({
+                validateCurrentPage,
+                validateStep: props.validateStep,
+                beforeAction: props.onBeforeNext,
+                step
+            });
+            if (!ok)
                 return;
-            if (props.validateStep) {
-                const ok = await props.validateStep(step);
-                if (!ok)
-                    return;
-            }
-            if (props.onBeforeNext) {
-                const ok = await props.onBeforeNext(step);
-                if (!ok)
-                    return;
-            }
             setStep((prev) => Math.min(prev + 1, pages.length - 1));
         }
         finally {
@@ -95,19 +88,14 @@ export function SgWizard(props) {
             return;
         setIsValidating(true);
         try {
-            const pageValid = await validateCurrentPage();
-            if (!pageValid)
+            const ok = await canProceedWizardAction({
+                validateCurrentPage,
+                validateStep: props.validateStep,
+                beforeAction: props.onBeforeFinish,
+                step
+            });
+            if (!ok)
                 return;
-            if (props.validateStep) {
-                const ok = await props.validateStep(step);
-                if (!ok)
-                    return;
-            }
-            if (props.onBeforeFinish) {
-                const ok = await props.onBeforeFinish(step);
-                if (!ok)
-                    return;
-            }
         }
         finally {
             setIsValidating(false);
@@ -120,5 +108,5 @@ export function SgWizard(props) {
             setIsFinishing(false);
         }
     };
-    return (_jsxs("div", { className: props.className, style: props.style, children: [stepper !== "none" ? (_jsx(StepperBar, { pages: pages, currentStep: step, mode: stepper })) : null, _jsx("div", { ref: pageRef, children: pages[step] }), _jsxs("div", { className: "mt-6 flex flex-wrap items-center justify-between gap-3", children: [_jsx("div", { children: !isFirst ? (_jsx("button", { type: "button", onClick: goPrevious, className: "inline-flex h-10 items-center justify-center rounded-full border border-border px-5 text-sm font-semibold text-foreground/80 transition hover:bg-muted/60", children: labels.previous })) : null }), _jsx("div", { className: "flex items-center gap-3", children: !isLast ? (_jsx("button", { type: "button", onClick: goNext, disabled: isValidating, className: "inline-flex h-10 items-center justify-center rounded-full bg-[hsl(var(--primary))] px-5 text-sm font-semibold text-white shadow-lg shadow-[hsl(var(--primary)/0.35)] transition hover:brightness-95 disabled:cursor-not-allowed disabled:opacity-60", children: labels.next })) : (_jsx("button", { type: "button", onClick: handleFinish, disabled: isFinishing || isValidating, className: "inline-flex h-10 items-center justify-center rounded-full bg-[hsl(var(--primary))] px-5 text-sm font-semibold text-white shadow-lg shadow-[hsl(var(--primary)/0.35)] transition hover:brightness-95 disabled:cursor-not-allowed disabled:opacity-60", children: labels.finish })) })] })] }));
+    return (_jsxs("div", { className: props.className, style: props.style, children: [stepper !== "none" ? (_jsx(StepperBar, { pages: pages, currentStep: step, mode: stepper, i18n: i18n })) : null, _jsx("div", { ref: pageRef, children: pages[step] }), _jsxs("div", { className: "mt-6 flex flex-wrap items-center justify-between gap-3", children: [_jsx("div", { children: !isFirst ? (_jsx("button", { type: "button", onClick: goPrevious, className: "inline-flex h-10 items-center justify-center rounded-full border border-border px-5 text-sm font-semibold text-foreground/80 transition hover:bg-muted/60", children: labels.previous })) : null }), _jsx("div", { className: "flex items-center gap-3", children: !isLast ? (_jsx("button", { type: "button", onClick: goNext, disabled: isValidating, className: "inline-flex h-10 items-center justify-center rounded-full bg-[hsl(var(--primary))] px-5 text-sm font-semibold text-white shadow-lg shadow-[hsl(var(--primary)/0.35)] transition hover:brightness-95 disabled:cursor-not-allowed disabled:opacity-60", children: labels.next })) : (_jsx("button", { type: "button", onClick: handleFinish, disabled: isFinishing || isValidating, className: "inline-flex h-10 items-center justify-center rounded-full bg-[hsl(var(--primary))] px-5 text-sm font-semibold text-white shadow-lg shadow-[hsl(var(--primary)/0.35)] transition hover:brightness-95 disabled:cursor-not-allowed disabled:opacity-60", children: labels.finish })) })] })] }));
 }

package/dist/wizard/logic.d.ts

@@ -0,0 +1,9 @@
+export declare function clampWizardStep(initialStep: number | undefined, pageCount: number): number;
+export type WizardGuardRunner = {
+    validateCurrentPage: () => boolean | Promise<boolean>;
+    validateStep?: (index: number) => boolean | Promise<boolean>;
+    beforeAction?: (index: number) => boolean | Promise<boolean>;
+    step: number;
+};
+export declare function canProceedWizardAction(runner: WizardGuardRunner): Promise<boolean>;
+//# sourceMappingURL=logic.d.ts.map

package/dist/wizard/logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic.d.ts","sourceRoot":"","sources":["../../src/wizard/logic.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG1F;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,mBAAmB,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAexF"}

package/dist/wizard/logic.js

@@ -0,0 +1,20 @@
+export function clampWizardStep(initialStep, pageCount) {
+    const step = initialStep ?? 0;
+    return Math.min(Math.max(step, 0), Math.max(pageCount - 1, 0));
+}
+export async function canProceedWizardAction(runner) {
+    const pageValid = await runner.validateCurrentPage();
+    if (!pageValid)
+        return false;
+    if (runner.validateStep) {
+        const stepValid = await runner.validateStep(runner.step);
+        if (!stepValid)
+            return false;
+    }
+    if (runner.beforeAction) {
+        const allowed = await runner.beforeAction(runner.step);
+        if (!allowed)
+            return false;
+    }
+    return true;
+}

package/package.json

@@ -1,78 +1,80 @@
 {
-    "name": "@seedgrid/fe-components",
-    "version": "2026.3.19",
-    "license": "MIT",
-    "type": "module",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/SeedGrid/seedgrid-fe-components.git",
-        "directory": "packages/seedgrid-fe-components"
-    },
-    "homepage": "https://github.com/SeedGrid/seedgrid-fe-components/tree/main/packages/seedgrid-fe-components",
-    "bugs": {
-        "url": "https://github.com/SeedGrid/seedgrid-fe-components/issues"
-    },
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "default": "./dist/index.js"
-        }
-    },
-    "sideEffects": false,
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
-        "build": "pnpm run clean && tsc -p tsconfig.json && pnpm run build:sandbox",
-        "build:sandbox": "tsup --config tsup.sandbox.config.ts",
-        "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
-        "typecheck": "tsc -p tsconfig.json --noEmit"
-    },
-    "peerDependencies": {
-        "@tiptap/core": "^2.9.1",
-        "@tiptap/extension-color": "^2.9.1",
-        "@tiptap/extension-font-family": "^2.9.1",
-        "@tiptap/extension-highlight": "^2.9.1",
-        "@tiptap/extension-image": "^2.9.1",
-        "@tiptap/extension-link": "^2.9.1",
-        "@tiptap/pm": "^2.9.1",
-        "@tiptap/extension-subscript": "^2.9.1",
-        "@tiptap/extension-superscript": "^2.9.1",
-        "@tiptap/extension-text-align": "^2.9.1",
-        "@tiptap/extension-text-style": "^2.9.1",
-        "@tiptap/extension-underline": "^2.9.1",
-        "@tiptap/react": "^2.9.1",
-        "@tiptap/starter-kit": "^2.9.1",
-        "lucide-react": "^0.468.0",
-        "react": "^18.2.0 || ^19.0.0",
-        "react-hook-form": "^7.0.0"
-    },
-    "devDependencies": {
-        "tsup": "^8.4.0",
-        "@tiptap/core": "^2.9.1",
-        "@tiptap/extension-color": "^2.9.1",
-        "@tiptap/extension-font-family": "^2.9.1",
-        "@tiptap/extension-highlight": "^2.9.1",
-        "@tiptap/extension-image": "^2.9.1",
-        "@tiptap/extension-link": "^2.9.1",
-        "@tiptap/pm": "^2.9.1",
-        "@tiptap/extension-subscript": "^2.9.1",
-        "@tiptap/extension-superscript": "^2.9.1",
-        "@tiptap/extension-text-align": "^2.9.1",
-        "@tiptap/extension-text-style": "^2.9.1",
-        "@tiptap/extension-underline": "^2.9.1",
-        "@tiptap/react": "^2.9.1",
-        "@tiptap/starter-kit": "^2.9.1",
-        "lucide-react": "^0.468.0",
-        "react": "19.0.0",
-        "react-dom": "19.0.0",
-        "react-hook-form": "^7.0.0"
-    },
-    "dependencies": {
-        "@pqina/flip": "^1.8.4",
-        "qrcode.react": "^4.2.0"
+  "name": "@seedgrid/fe-components",
+  "version": "2026.3.26",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SeedGrid/seedgrid-fe-components.git",
+    "directory": "packages/seedgrid-fe-components"
+  },
+  "homepage": "https://github.com/SeedGrid/seedgrid-fe-components/tree/main/packages/seedgrid-fe-components",
+  "bugs": {
+    "url": "https://github.com/SeedGrid/seedgrid-fe-components/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
-}
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@tiptap/core": "^2.9.1",
+    "@tiptap/extension-color": "^2.9.1",
+    "@tiptap/extension-font-family": "^2.9.1",
+    "@tiptap/extension-highlight": "^2.9.1",
+    "@tiptap/extension-image": "^2.9.1",
+    "@tiptap/extension-link": "^2.9.1",
+    "@tiptap/extension-subscript": "^2.9.1",
+    "@tiptap/extension-superscript": "^2.9.1",
+    "@tiptap/extension-text-align": "^2.9.1",
+    "@tiptap/extension-text-style": "^2.9.1",
+    "@tiptap/extension-underline": "^2.9.1",
+    "@tiptap/pm": "^2.9.1",
+    "@tiptap/react": "^2.9.1",
+    "@tiptap/starter-kit": "^2.9.1",
+    "lucide-react": "^0.468.0",
+    "react": "^18.2.0 || ^19.0.0",
+    "react-hook-form": "^7.0.0"
+  },
+  "devDependencies": {
+    "@tiptap/core": "^2.9.1",
+    "@tiptap/extension-color": "^2.9.1",
+    "@tiptap/extension-font-family": "^2.9.1",
+    "@tiptap/extension-highlight": "^2.9.1",
+    "@tiptap/extension-image": "^2.9.1",
+    "@tiptap/extension-link": "^2.9.1",
+    "@tiptap/extension-subscript": "^2.9.1",
+    "@tiptap/extension-superscript": "^2.9.1",
+    "@tiptap/extension-text-align": "^2.9.1",
+    "@tiptap/extension-text-style": "^2.9.1",
+    "@tiptap/extension-underline": "^2.9.1",
+    "@tiptap/pm": "^2.9.1",
+    "@tiptap/react": "^2.9.1",
+    "@tiptap/starter-kit": "^2.9.1",
+    "jsdom": "^29.0.1",
+    "lucide-react": "^0.468.0",
+    "react": "19.0.0",
+    "react-dom": "19.0.0",
+    "react-hook-form": "^7.0.0",
+    "tsup": "^8.4.0"
+  },
+  "dependencies": {
+    "@pqina/flip": "^1.8.4",
+    "qrcode.react": "^4.2.0"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "pnpm run clean && tsc -p tsconfig.json && pnpm run build:sandbox",
+    "build:sandbox": "tsup --config tsup.sandbox.config.ts",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test tests/i18n.test.mjs tests/rhf.test.mjs tests/rhf-components-contract.test.mjs tests/i18n-components-contract.test.mjs tests/providers-hooks.test.mjs tests/providers-hooks-dom.test.mjs tests/commons.test.mjs tests/overlay.test.mjs tests/overlay-dom.test.mjs tests/buttons-menus.test.mjs tests/buttons-menus-dom.test.mjs tests/menu-logic.test.mjs tests/inputs-i18n.test.mjs tests/gadgets.test.mjs tests/gadgets-dom.test.mjs tests/gauge-math.test.mjs tests/clock-theme-picker.test.mjs tests/wizard.test.mjs tests/wizard-logic.test.mjs tests/utils.test.mjs"
+  }
+}