@nice2dev/ui 1.0.4 → 1.0.5

package/dist/NiceSetupWizard.doc-DdY29YdW.cjs

@@ -0,0 +1,93 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="https://nice2dev.com/schemas/component-doc-v1.json",t="NiceSetupWizard",n="Setup Wizard",i="navigation",a="wizards",o="Advanced multi-step setup wizard with schema-driven forms, conditional branching, quick mode, and full theme integration.",s="NiceSetupWizard is a powerful component for building onboarding flows, configuration wizards, and multi-step forms. It supports **schema-driven field definitions** (no manual form handling), **conditional step branching** based on user input, **quick mode** that skips optional steps, **5 layout variants**, and **progress persistence** via localStorage. Each step can render custom content or use declarative field schemas for automatic form generation.",r="2.4.0",d="stable",l=[{name:"steps",type:"SetupWizardStep[]",required:!0,description:"Array of step definitions. Each step can have custom content, schema-driven fields, or both. Steps can define conditional `nextStep` functions for branching logic.",relatedProps:["initialStep"]},{name:"layout",type:"'horizontal' | 'vertical' | 'cards' | 'minimal' | 'sidebar'",required:!1,defaultValue:"'horizontal'",description:"Visual layout of the wizard navigation. Choose based on your design needs and available space.",options:[{value:"horizontal",label:"Horizontal",description:"Top navigation bar with step indicators"},{value:"vertical",label:"Vertical",description:"Left-side step list, good for longer flows"},{value:"cards",label:"Cards",description:"Each step as a card, compact display"},{value:"minimal",label:"Minimal",description:"No visible navigation, just content with buttons"},{value:"sidebar",label:"Sidebar",description:"Full sidebar with branding space and step details"}]},{name:"onComplete",type:"(values: Record<string, unknown>) => void | Promise<void>",required:!0,description:"Called when user completes the wizard. Receives all collected values. Can be async for API calls."},{name:"onCancel",type:"() => void",required:!1,description:"Called when user cancels the wizard. Use to close the wizard or navigate away."},{name:"onStepChange",type:"(stepId: string, direction: 'forward' | 'backward') => void",required:!1,description:"Called when the current step changes. Useful for analytics or progress tracking."},{name:"initialStep",type:"string",required:!1,description:"ID of the step to start on. Defaults to first step. Use with `persistKey` to resume progress."},{name:"initialValues",type:"Record<string, unknown>",required:!1,defaultValue:"{}",description:"Pre-populated values for form fields. Merged with persisted values if `persistKey` is set."},{name:"showProgress",type:"boolean",required:!1,defaultValue:"true",description:"Show progress bar indicating completion percentage."},{name:"showStepNumbers",type:"boolean",required:!1,defaultValue:"true",description:"Display step numbers in the navigation."},{name:"showEstimatedTime",type:"boolean",required:!1,defaultValue:"false",description:"Show estimated time remaining based on step `estimatedTime` values."},{name:"showReviewStep",type:"boolean",required:!1,defaultValue:"false",description:"Automatically add a review step at the end summarizing all collected data."},{name:"allowQuickModeToggle",type:"boolean",required:!1,defaultValue:"true",description:"Allow users to toggle quick mode on/off. When enabled, shows a toggle switch."},{name:"quickModeDefault",type:"boolean",required:!1,defaultValue:"false",description:"Start with quick mode enabled. Quick mode skips steps marked with `quickModeSkip: true`."},{name:"animation",type:"'slide' | 'fade' | 'none'",required:!1,defaultValue:"'slide'",description:"Animation style for step transitions."},{name:"persistKey",type:"string",required:!1,description:"localStorage key for persisting progress. Values are saved on each step change and restored on mount."},{name:"branding",type:"React.ReactNode",required:!1,description:"Custom branding element shown in sidebar layout. Typically a logo."},{name:"size",type:"'sm' | 'md' | 'lg'",required:!1,defaultValue:"'md'",description:"Overall size scale affecting padding and font sizes."}],c=[{name:"onComplete",signature:"(values: Record<string, unknown>) => void | Promise<void>",description:"Fired when the user completes all required steps and clicks the final action button.",parameters:[{name:"values",type:"Record<string, unknown>",description:"All collected form values keyed by field ID"}]},{name:"onCancel",signature:"() => void",description:"Fired when the user clicks the cancel button."},{name:"onStepChange",signature:"(stepId: string, direction: 'forward' | 'backward') => void",description:"Fired whenever the current step changes.",parameters:[{name:"stepId",type:"string",description:"ID of the new current step"},{name:"direction",type:"'forward' | 'backward'",description:"Navigation direction"}]},{name:"onValidate",signature:"(stepId: string, values: Record<string, unknown>) => boolean | Promise<boolean>",description:"Custom validation before advancing to next step. Return false to prevent navigation.",parameters:[{name:"stepId",type:"string",description:"Current step ID"},{name:"values",type:"Record<string, unknown>",description:"Current form values"}]}],p=[{name:"content",description:"Step content render function receiving the wizard context.",props:[{name:"values",type:"Record<string, unknown>",description:"Current form values"},{name:"setValue",type:"(key: string, value: unknown) => void",description:"Update a form value"},{name:"currentStep",type:"string",description:"Current step ID"},{name:"isQuickMode",type:"boolean",description:"Whether quick mode is active"},{name:"goNext",type:"() => void",description:"Navigate to next step"},{name:"goBack",type:"() => void",description:"Navigate to previous step"}]},{name:"summary",description:"Optional summary renderer for review step, receives values.",props:[{name:"values",type:"Record<string, unknown>",description:"All collected values for this step"}]}],u=[{name:"reset",signature:"() => void",description:"Resets the wizard to initial state, clearing all values and progress.",returns:"void"},{name:"goToStep",signature:"(stepId: string) => void",description:"Programmatically navigate to a specific step.",returns:"void"},{name:"getValues",signature:"() => Record<string, unknown>",description:"Get all current form values.",returns:"Object containing all values keyed by field ID"}],m={description:"NiceSetupWizard inherits colors from NiceThemeProvider. The wizard automatically adapts to light and dark themes.",cssVariables:[{name:"--color-primary",description:"Active step indicator and buttons",defaultValue:"#6c5ce7"},{name:"--bg-primary",description:"Main wizard background",defaultValue:"#0a0a0a"},{name:"--bg-secondary",description:"Step indicator backgrounds",defaultValue:"#141414"},{name:"--border-color",description:"Step dividers and borders",defaultValue:"#2a2a2a"},{name:"--text-primary",description:"Headings and labels",defaultValue:"#ffffff"},{name:"--text-secondary",description:"Descriptions and hints",defaultValue:"#888888"}],cssClasses:[{name:"nice-setup-wizard",description:"Root container"},{name:"nice-setup-wizard--horizontal",description:"Horizontal layout modifier"},{name:"nice-setup-wizard--sidebar",description:"Sidebar layout modifier"},{name:"nice-wizard-step--active",description:"Currently active step"},{name:"nice-wizard-step--completed",description:"Completed step"}],example:`<NiceThemeProvider theme="dark">
+  <NiceSetupWizard
+    layout="sidebar"
+    branding={<Logo />}
+    steps={steps}
+    onComplete={handleComplete}
+  />
+</NiceThemeProvider>`},g={description:"All wizard UI text can be translated using NiceI18nProvider. Step titles and field labels support translation keys.",keys:[{key:"wizard.next",defaultText:"Next",context:"Next step button"},{key:"wizard.back",defaultText:"Back",context:"Previous step button"},{key:"wizard.cancel",defaultText:"Cancel",context:"Cancel wizard button"},{key:"wizard.complete",defaultText:"Complete",context:"Final step button"},{key:"wizard.quickMode",defaultText:"Quick Mode",context:"Quick mode toggle label"},{key:"wizard.skipOptional",defaultText:"Skip optional steps",context:"Quick mode description"},{key:"wizard.required",defaultText:"Required",context:"Required field indicator"},{key:"wizard.optional",defaultText:"Optional",context:"Optional step badge"}],example:`// In your i18n config:
+const translations = {
+  en: {
+    wizard: {
+      next: 'Continue',
+      complete: 'Finish Setup'
+    }
+  },
+  de: {
+    wizard: {
+      next: 'Weiter',
+      complete: 'Einrichtung abschließen'
+    }
+  }
+};`},f={role:"form",keyboard:[{key:"Enter",action:"Submit current step / advance to next"},{key:"Tab",action:"Move between form fields"},{key:"Escape",action:"Cancel wizard (if onCancel provided)"},{key:"Arrow Left/Right",action:"Navigate steps (when focus on step indicator)"}],screenReader:"Announces current step number and title on navigation. Form fields include proper labels. Progress is announced as percentage. Error messages are announced via aria-live.",wcag:"Meets WCAG 2.1 AA. Uses semantic form elements, visible focus indicators, and proper heading hierarchy. Color is not the only indicator of state."},h=[{title:"Basic 3-Step Wizard",description:"Simple wizard with custom content",code:`<NiceSetupWizard
+  steps={[
+    {
+      id: 'welcome',
+      title: 'Welcome',
+      content: <WelcomeScreen />,
+    },
+    {
+      id: 'settings',
+      title: 'Settings',
+      content: (ctx) => <SettingsForm ctx={ctx} />,
+    },
+    {
+      id: 'done',
+      title: 'Complete',
+      content: <DoneScreen />,
+    },
+  ]}
+  onComplete={(values) => console.log(values)}
+/>`,language:"tsx"},{title:"Schema-Driven Forms",description:"Define fields declaratively without manual form handling",code:`<NiceSetupWizard
+  steps={[
+    {
+      id: 'account',
+      title: 'Account',
+      fields: [
+        { id: 'email', type: 'email', label: 'Email', required: true },
+        { id: 'name', type: 'text', label: 'Full Name', required: true },
+      ],
+    },
+    {
+      id: 'preferences',
+      title: 'Preferences',
+      optional: true,
+      quickModeSkip: true,
+      fields: [
+        { id: 'theme', type: 'radio', label: 'Theme', options: [
+          { value: 'light', label: 'Light' },
+          { value: 'dark', label: 'Dark' },
+        ]},
+        { id: 'notifications', type: 'switch', label: 'Email notifications' },
+      ],
+    },
+  ]}
+  onComplete={handleComplete}
+/>`,language:"tsx"},{title:"Conditional Branching",description:"Steps can dynamically determine the next step",code:`const steps = [
+  {
+    id: 'type',
+    title: 'Project Type',
+    fields: [{ id: 'projectType', type: 'radio', options: [...] }],
+    nextStep: (values) => {
+      if (values.projectType === 'web') return 'web-config';
+      if (values.projectType === 'api') return 'api-config';
+      return 'mobile-config';
+    },
+  },
+  { id: 'web-config', ..., nextStep: 'done' },
+  { id: 'api-config', ..., nextStep: 'done' },
+  { id: 'mobile-config', ..., nextStep: 'done' },
+  { id: 'done', ... },
+];`,language:"tsx"},{title:"Full Onboarding Flow",description:"Complete onboarding with branding, persistence, and review",code:`<NiceSetupWizard
+  layout="sidebar"
+  showReviewStep
+  showEstimatedTime
+  persistKey="onboarding-v1"
+  branding={<img src="/logo.svg" alt="Logo" />}
+  steps={onboardingSteps}
+  onComplete={async (values) => {
+    await api.savePreferences(values);
+    navigate('/dashboard');
+  }}
+  onCancel={() => navigate('/')}
+/>`,language:"tsx"}],v=["Keep steps focused — one topic per step","Mark truly optional steps with `optional: true` and `quickModeSkip: true`","Use `persistKey` for long wizards to prevent data loss","Provide step `estimatedTime` for better UX with `showEstimatedTime`","Use `summary` render prop on steps for the review step","Handle async `onComplete` errors gracefully — show toast, don't lose data"],y=["Don't put too many fields in one step — break into multiple steps","Avoid circular branching logic in `nextStep` functions","Don't forget to handle the case when `persistKey` data is stale","Validation runs on 'Next' — long async validation should show loading"],b=[{name:"NiceWizard",package:"@nice2dev/ui",relationship:"Simpler wizard without schema support"},{name:"NiceStepper",package:"@nice2dev/ui",relationship:"Step indicator component"},{name:"NiceForm",package:"@nice2dev/ui",relationship:"Full-featured form component"}],w=["wizard","onboarding","setup","multi-step","form","flow","configuration"],k="2026-03-29",S={$schema:e,name:t,displayName:n,package:"@nice2dev/ui",category:i,subcategory:a,summary:o,description:s,since:r,status:d,import:{named:["NiceSetupWizard","useSetupWizard"],from:"@nice2dev/ui",types:["SetupWizardStep","SetupWizardContext","SetupWizardLayout","SetupField","SetupFieldType","SetupWizardAction"]},props:l,events:c,slots:p,methods:u,theming:m,i18n:g,accessibility:f,examples:h,bestPractices:v,pitfalls:y,related:b,tags:w,lastUpdated:k};exports.$schema=e;exports.accessibility=f;exports.bestPractices=v;exports.category=i;exports.default=S;exports.description=s;exports.displayName=n;exports.events=c;exports.examples=h;exports.i18n=g;exports.lastUpdated=k;exports.methods=u;exports.name=t;exports.pitfalls=y;exports.props=l;exports.related=b;exports.since=r;exports.slots=p;exports.status=d;exports.subcategory=a;exports.summary=o;exports.tags=w;exports.theming=m;

package/dist/NiceSetupWizard.doc-Qq9RMtnq.js

@@ -0,0 +1,143 @@
+const e = "https://nice2dev.com/schemas/component-doc-v1.json", t = "NiceSetupWizard", n = "Setup Wizard", i = "navigation", a = "wizards", o = "Advanced multi-step setup wizard with schema-driven forms, conditional branching, quick mode, and full theme integration.", s = "NiceSetupWizard is a powerful component for building onboarding flows, configuration wizards, and multi-step forms. It supports **schema-driven field definitions** (no manual form handling), **conditional step branching** based on user input, **quick mode** that skips optional steps, **5 layout variants**, and **progress persistence** via localStorage. Each step can render custom content or use declarative field schemas for automatic form generation.", r = "2.4.0", d = "stable", l = [{ name: "steps", type: "SetupWizardStep[]", required: !0, description: "Array of step definitions. Each step can have custom content, schema-driven fields, or both. Steps can define conditional `nextStep` functions for branching logic.", relatedProps: ["initialStep"] }, { name: "layout", type: "'horizontal' | 'vertical' | 'cards' | 'minimal' | 'sidebar'", required: !1, defaultValue: "'horizontal'", description: "Visual layout of the wizard navigation. Choose based on your design needs and available space.", options: [{ value: "horizontal", label: "Horizontal", description: "Top navigation bar with step indicators" }, { value: "vertical", label: "Vertical", description: "Left-side step list, good for longer flows" }, { value: "cards", label: "Cards", description: "Each step as a card, compact display" }, { value: "minimal", label: "Minimal", description: "No visible navigation, just content with buttons" }, { value: "sidebar", label: "Sidebar", description: "Full sidebar with branding space and step details" }] }, { name: "onComplete", type: "(values: Record<string, unknown>) => void | Promise<void>", required: !0, description: "Called when user completes the wizard. Receives all collected values. Can be async for API calls." }, { name: "onCancel", type: "() => void", required: !1, description: "Called when user cancels the wizard. Use to close the wizard or navigate away." }, { name: "onStepChange", type: "(stepId: string, direction: 'forward' | 'backward') => void", required: !1, description: "Called when the current step changes. Useful for analytics or progress tracking." }, { name: "initialStep", type: "string", required: !1, description: "ID of the step to start on. Defaults to first step. Use with `persistKey` to resume progress." }, { name: "initialValues", type: "Record<string, unknown>", required: !1, defaultValue: "{}", description: "Pre-populated values for form fields. Merged with persisted values if `persistKey` is set." }, { name: "showProgress", type: "boolean", required: !1, defaultValue: "true", description: "Show progress bar indicating completion percentage." }, { name: "showStepNumbers", type: "boolean", required: !1, defaultValue: "true", description: "Display step numbers in the navigation." }, { name: "showEstimatedTime", type: "boolean", required: !1, defaultValue: "false", description: "Show estimated time remaining based on step `estimatedTime` values." }, { name: "showReviewStep", type: "boolean", required: !1, defaultValue: "false", description: "Automatically add a review step at the end summarizing all collected data." }, { name: "allowQuickModeToggle", type: "boolean", required: !1, defaultValue: "true", description: "Allow users to toggle quick mode on/off. When enabled, shows a toggle switch." }, { name: "quickModeDefault", type: "boolean", required: !1, defaultValue: "false", description: "Start with quick mode enabled. Quick mode skips steps marked with `quickModeSkip: true`." }, { name: "animation", type: "'slide' | 'fade' | 'none'", required: !1, defaultValue: "'slide'", description: "Animation style for step transitions." }, { name: "persistKey", type: "string", required: !1, description: "localStorage key for persisting progress. Values are saved on each step change and restored on mount." }, { name: "branding", type: "React.ReactNode", required: !1, description: "Custom branding element shown in sidebar layout. Typically a logo." }, { name: "size", type: "'sm' | 'md' | 'lg'", required: !1, defaultValue: "'md'", description: "Overall size scale affecting padding and font sizes." }], c = [{ name: "onComplete", signature: "(values: Record<string, unknown>) => void | Promise<void>", description: "Fired when the user completes all required steps and clicks the final action button.", parameters: [{ name: "values", type: "Record<string, unknown>", description: "All collected form values keyed by field ID" }] }, { name: "onCancel", signature: "() => void", description: "Fired when the user clicks the cancel button." }, { name: "onStepChange", signature: "(stepId: string, direction: 'forward' | 'backward') => void", description: "Fired whenever the current step changes.", parameters: [{ name: "stepId", type: "string", description: "ID of the new current step" }, { name: "direction", type: "'forward' | 'backward'", description: "Navigation direction" }] }, { name: "onValidate", signature: "(stepId: string, values: Record<string, unknown>) => boolean | Promise<boolean>", description: "Custom validation before advancing to next step. Return false to prevent navigation.", parameters: [{ name: "stepId", type: "string", description: "Current step ID" }, { name: "values", type: "Record<string, unknown>", description: "Current form values" }] }], p = [{ name: "content", description: "Step content render function receiving the wizard context.", props: [{ name: "values", type: "Record<string, unknown>", description: "Current form values" }, { name: "setValue", type: "(key: string, value: unknown) => void", description: "Update a form value" }, { name: "currentStep", type: "string", description: "Current step ID" }, { name: "isQuickMode", type: "boolean", description: "Whether quick mode is active" }, { name: "goNext", type: "() => void", description: "Navigate to next step" }, { name: "goBack", type: "() => void", description: "Navigate to previous step" }] }, { name: "summary", description: "Optional summary renderer for review step, receives values.", props: [{ name: "values", type: "Record<string, unknown>", description: "All collected values for this step" }] }], u = [{ name: "reset", signature: "() => void", description: "Resets the wizard to initial state, clearing all values and progress.", returns: "void" }, { name: "goToStep", signature: "(stepId: string) => void", description: "Programmatically navigate to a specific step.", returns: "void" }, { name: "getValues", signature: "() => Record<string, unknown>", description: "Get all current form values.", returns: "Object containing all values keyed by field ID" }], m = { description: "NiceSetupWizard inherits colors from NiceThemeProvider. The wizard automatically adapts to light and dark themes.", cssVariables: [{ name: "--color-primary", description: "Active step indicator and buttons", defaultValue: "#6c5ce7" }, { name: "--bg-primary", description: "Main wizard background", defaultValue: "#0a0a0a" }, { name: "--bg-secondary", description: "Step indicator backgrounds", defaultValue: "#141414" }, { name: "--border-color", description: "Step dividers and borders", defaultValue: "#2a2a2a" }, { name: "--text-primary", description: "Headings and labels", defaultValue: "#ffffff" }, { name: "--text-secondary", description: "Descriptions and hints", defaultValue: "#888888" }], cssClasses: [{ name: "nice-setup-wizard", description: "Root container" }, { name: "nice-setup-wizard--horizontal", description: "Horizontal layout modifier" }, { name: "nice-setup-wizard--sidebar", description: "Sidebar layout modifier" }, { name: "nice-wizard-step--active", description: "Currently active step" }, { name: "nice-wizard-step--completed", description: "Completed step" }], example: `<NiceThemeProvider theme="dark">
+  <NiceSetupWizard
+    layout="sidebar"
+    branding={<Logo />}
+    steps={steps}
+    onComplete={handleComplete}
+  />
+</NiceThemeProvider>` }, g = { description: "All wizard UI text can be translated using NiceI18nProvider. Step titles and field labels support translation keys.", keys: [{ key: "wizard.next", defaultText: "Next", context: "Next step button" }, { key: "wizard.back", defaultText: "Back", context: "Previous step button" }, { key: "wizard.cancel", defaultText: "Cancel", context: "Cancel wizard button" }, { key: "wizard.complete", defaultText: "Complete", context: "Final step button" }, { key: "wizard.quickMode", defaultText: "Quick Mode", context: "Quick mode toggle label" }, { key: "wizard.skipOptional", defaultText: "Skip optional steps", context: "Quick mode description" }, { key: "wizard.required", defaultText: "Required", context: "Required field indicator" }, { key: "wizard.optional", defaultText: "Optional", context: "Optional step badge" }], example: `// In your i18n config:
+const translations = {
+  en: {
+    wizard: {
+      next: 'Continue',
+      complete: 'Finish Setup'
+    }
+  },
+  de: {
+    wizard: {
+      next: 'Weiter',
+      complete: 'Einrichtung abschließen'
+    }
+  }
+};` }, f = { role: "form", keyboard: [{ key: "Enter", action: "Submit current step / advance to next" }, { key: "Tab", action: "Move between form fields" }, { key: "Escape", action: "Cancel wizard (if onCancel provided)" }, { key: "Arrow Left/Right", action: "Navigate steps (when focus on step indicator)" }], screenReader: "Announces current step number and title on navigation. Form fields include proper labels. Progress is announced as percentage. Error messages are announced via aria-live.", wcag: "Meets WCAG 2.1 AA. Uses semantic form elements, visible focus indicators, and proper heading hierarchy. Color is not the only indicator of state." }, v = [{ title: "Basic 3-Step Wizard", description: "Simple wizard with custom content", code: `<NiceSetupWizard
+  steps={[
+    {
+      id: 'welcome',
+      title: 'Welcome',
+      content: <WelcomeScreen />,
+    },
+    {
+      id: 'settings',
+      title: 'Settings',
+      content: (ctx) => <SettingsForm ctx={ctx} />,
+    },
+    {
+      id: 'done',
+      title: 'Complete',
+      content: <DoneScreen />,
+    },
+  ]}
+  onComplete={(values) => console.log(values)}
+/>`, language: "tsx" }, { title: "Schema-Driven Forms", description: "Define fields declaratively without manual form handling", code: `<NiceSetupWizard
+  steps={[
+    {
+      id: 'account',
+      title: 'Account',
+      fields: [
+        { id: 'email', type: 'email', label: 'Email', required: true },
+        { id: 'name', type: 'text', label: 'Full Name', required: true },
+      ],
+    },
+    {
+      id: 'preferences',
+      title: 'Preferences',
+      optional: true,
+      quickModeSkip: true,
+      fields: [
+        { id: 'theme', type: 'radio', label: 'Theme', options: [
+          { value: 'light', label: 'Light' },
+          { value: 'dark', label: 'Dark' },
+        ]},
+        { id: 'notifications', type: 'switch', label: 'Email notifications' },
+      ],
+    },
+  ]}
+  onComplete={handleComplete}
+/>`, language: "tsx" }, { title: "Conditional Branching", description: "Steps can dynamically determine the next step", code: `const steps = [
+  {
+    id: 'type',
+    title: 'Project Type',
+    fields: [{ id: 'projectType', type: 'radio', options: [...] }],
+    nextStep: (values) => {
+      if (values.projectType === 'web') return 'web-config';
+      if (values.projectType === 'api') return 'api-config';
+      return 'mobile-config';
+    },
+  },
+  { id: 'web-config', ..., nextStep: 'done' },
+  { id: 'api-config', ..., nextStep: 'done' },
+  { id: 'mobile-config', ..., nextStep: 'done' },
+  { id: 'done', ... },
+];`, language: "tsx" }, { title: "Full Onboarding Flow", description: "Complete onboarding with branding, persistence, and review", code: `<NiceSetupWizard
+  layout="sidebar"
+  showReviewStep
+  showEstimatedTime
+  persistKey="onboarding-v1"
+  branding={<img src="/logo.svg" alt="Logo" />}
+  steps={onboardingSteps}
+  onComplete={async (values) => {
+    await api.savePreferences(values);
+    navigate('/dashboard');
+  }}
+  onCancel={() => navigate('/')}
+/>`, language: "tsx" }], h = ["Keep steps focused — one topic per step", "Mark truly optional steps with `optional: true` and `quickModeSkip: true`", "Use `persistKey` for long wizards to prevent data loss", "Provide step `estimatedTime` for better UX with `showEstimatedTime`", "Use `summary` render prop on steps for the review step", "Handle async `onComplete` errors gracefully — show toast, don't lose data"], y = ["Don't put too many fields in one step — break into multiple steps", "Avoid circular branching logic in `nextStep` functions", "Don't forget to handle the case when `persistKey` data is stale", "Validation runs on 'Next' — long async validation should show loading"], w = [{ name: "NiceWizard", package: "@nice2dev/ui", relationship: "Simpler wizard without schema support" }, { name: "NiceStepper", package: "@nice2dev/ui", relationship: "Step indicator component" }, { name: "NiceForm", package: "@nice2dev/ui", relationship: "Full-featured form component" }], b = ["wizard", "onboarding", "setup", "multi-step", "form", "flow", "configuration"], k = "2026-03-29", S = {
+  $schema: e,
+  name: t,
+  displayName: n,
+  package: "@nice2dev/ui",
+  category: i,
+  subcategory: a,
+  summary: o,
+  description: s,
+  since: r,
+  status: d,
+  import: { named: ["NiceSetupWizard", "useSetupWizard"], from: "@nice2dev/ui", types: ["SetupWizardStep", "SetupWizardContext", "SetupWizardLayout", "SetupField", "SetupFieldType", "SetupWizardAction"] },
+  props: l,
+  events: c,
+  slots: p,
+  methods: u,
+  theming: m,
+  i18n: g,
+  accessibility: f,
+  examples: v,
+  bestPractices: h,
+  pitfalls: y,
+  related: w,
+  tags: b,
+  lastUpdated: k
+};
+export {
+  e as $schema,
+  f as accessibility,
+  h as bestPractices,
+  i as category,
+  S as default,
+  s as description,
+  n as displayName,
+  c as events,
+  v as examples,
+  g as i18n,
+  k as lastUpdated,
+  u as methods,
+  t as name,
+  y as pitfalls,
+  l as props,
+  w as related,
+  r as since,
+  p as slots,
+  d as status,
+  a as subcategory,
+  o as summary,
+  b as tags,
+  m as theming
+};

package/dist/NiceSheet.doc-Ds4jyaRL.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="https://nice2dev.com/schemas/component-doc-v1.json",n="NiceSheet",t="Bottom sheet dialog for mobile.",o="overlay",i="1.0.0",s="stable",a=[{name:"open",type:"boolean",required:!0,description:"Sheet visibility"},{name:"children",type:"React.ReactNode",required:!0,description:"Sheet content"},{name:"snapPoints",type:"number[]",description:"Snap positions (0-1)"},{name:"defaultSnapPoint",type:"number",description:"Initial snap point"},{name:"dismissible",type:"boolean",default:"true",description:"Can be dismissed"},{name:"modal",type:"boolean",default:"true",description:"Modal behavior"},{name:"onOpenChange",type:"(open: boolean) => void",required:!0,description:"Open change callback"},{name:"onSnapChange",type:"(snap: number) => void",description:"Snap change callback"}],c=[{title:"Sheet",description:"Bottom sheet",code:`<NiceSheet
+  open={isOpen}
+  snapPoints={[0.25, 0.5, 1]}
+  defaultSnapPoint={0.5}
+  onOpenChange={setIsOpen}
+>
+  <div className="p-4">
+    <h3>Sheet Content</h3>
+    <p>Drag to resize or swipe down to dismiss.</p>
+  </div>
+</NiceSheet>`}],p={keyboard:["Tab within sheet","Escape to close"],aria:["Dialog role","Draggable handle"]},r=["NiceDrawer","NiceModal"],d={$schema:e,name:n,description:t,category:o,since:i,status:s,props:a,examples:c,accessibility:p,seeAlso:r};exports.$schema=e;exports.accessibility=p;exports.category=o;exports.default=d;exports.description=t;exports.examples=c;exports.name=n;exports.props=a;exports.seeAlso=r;exports.since=i;exports.status=s;

package/dist/NiceSheet.doc-q3dx2pwW.js

@@ -0,0 +1,35 @@
+const e = "https://nice2dev.com/schemas/component-doc-v1.json", n = "NiceSheet", t = "Bottom sheet dialog for mobile.", o = "overlay", i = "1.0.0", a = "stable", s = [{ name: "open", type: "boolean", required: !0, description: "Sheet visibility" }, { name: "children", type: "React.ReactNode", required: !0, description: "Sheet content" }, { name: "snapPoints", type: "number[]", description: "Snap positions (0-1)" }, { name: "defaultSnapPoint", type: "number", description: "Initial snap point" }, { name: "dismissible", type: "boolean", default: "true", description: "Can be dismissed" }, { name: "modal", type: "boolean", default: "true", description: "Modal behavior" }, { name: "onOpenChange", type: "(open: boolean) => void", required: !0, description: "Open change callback" }, { name: "onSnapChange", type: "(snap: number) => void", description: "Snap change callback" }], c = [{ title: "Sheet", description: "Bottom sheet", code: `<NiceSheet
+  open={isOpen}
+  snapPoints={[0.25, 0.5, 1]}
+  defaultSnapPoint={0.5}
+  onOpenChange={setIsOpen}
+>
+  <div className="p-4">
+    <h3>Sheet Content</h3>
+    <p>Drag to resize or swipe down to dismiss.</p>
+  </div>
+</NiceSheet>` }], p = { keyboard: ["Tab within sheet", "Escape to close"], aria: ["Dialog role", "Draggable handle"] }, r = ["NiceDrawer", "NiceModal"], d = {
+  $schema: e,
+  name: n,
+  description: t,
+  category: o,
+  since: i,
+  status: a,
+  props: s,
+  examples: c,
+  accessibility: p,
+  seeAlso: r
+};
+export {
+  e as $schema,
+  p as accessibility,
+  o as category,
+  d as default,
+  t as description,
+  c as examples,
+  n as name,
+  s as props,
+  r as seeAlso,
+  i as since,
+  a as status
+};

package/dist/NiceShells.doc-DYxUvmPx.js

@@ -0,0 +1,25 @@
+const e = "https://nice2dev.com/schemas/component-doc-v1.json", a = "NiceShells", t = "Application shell variants.", n = "layout", c = "1.0.0", i = "stable", s = [{ name: "variant", type: "'default' | 'admin' | 'dashboard' | 'minimal'", default: "'default'", description: "Shell variant" }, { name: "children", type: "React.ReactNode", required: !0, description: "Content" }, { name: "header", type: "React.ReactNode", description: "Header content" }, { name: "sidebar", type: "React.ReactNode", description: "Sidebar content" }], o = [{ title: "App Shell", code: '<NiceShells variant="admin" header={<Header />} sidebar={<Nav />}>{children}</NiceShells>' }], d = { keyboard: ["Landmark navigation"], aria: ["Main, nav, header regions"] }, r = ["NiceAppLayout", "NiceDashboardLayout"], l = {
+  $schema: e,
+  name: a,
+  description: t,
+  category: n,
+  since: c,
+  status: i,
+  props: s,
+  examples: o,
+  accessibility: d,
+  seeAlso: r
+};
+export {
+  e as $schema,
+  d as accessibility,
+  n as category,
+  l as default,
+  t as description,
+  o as examples,
+  a as name,
+  s as props,
+  r as seeAlso,
+  c as since,
+  i as status
+};

package/dist/NiceShells.doc-DtgR77_3.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="https://nice2dev.com/schemas/component-doc-v1.json",a="NiceShells",t="Application shell variants.",s="layout",c="1.0.0",n="stable",i=[{name:"variant",type:"'default' | 'admin' | 'dashboard' | 'minimal'",default:"'default'",description:"Shell variant"},{name:"children",type:"React.ReactNode",required:!0,description:"Content"},{name:"header",type:"React.ReactNode",description:"Header content"},{name:"sidebar",type:"React.ReactNode",description:"Sidebar content"}],o=[{title:"App Shell",code:'<NiceShells variant="admin" header={<Header />} sidebar={<Nav />}>{children}</NiceShells>'}],d={keyboard:["Landmark navigation"],aria:["Main, nav, header regions"]},r=["NiceAppLayout","NiceDashboardLayout"],l={$schema:e,name:a,description:t,category:s,since:c,status:n,props:i,examples:o,accessibility:d,seeAlso:r};exports.$schema=e;exports.accessibility=d;exports.category=s;exports.default=l;exports.description=t;exports.examples=o;exports.name=a;exports.props=i;exports.seeAlso=r;exports.since=c;exports.status=n;

package/dist/NiceShowcase.doc-CI8nZt8U.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="https://nice2dev.com/schemas/component-doc-v1.json",o="NiceShowcase",t="Component showcase for displaying and documenting UI components.",n="tools",s="1.0.0",c="stable",a=[{name:"components",type:"ShowcaseComponent[]",required:!0,description:"Components to showcase"},{name:"showCode",type:"boolean",default:"true",description:"Show source code"},{name:"showProps",type:"boolean",default:"true",description:"Show props table"},{name:"showPlayground",type:"boolean",default:"true",description:"Show interactive playground"},{name:"theme",type:"'light' | 'dark' | 'auto'",default:"'auto'",description:"Theme mode"},{name:"searchable",type:"boolean",default:"true",description:"Enable search"},{name:"groupBy",type:"string",description:"Group by field"}],i=[{title:"Component Showcase",description:"Document components",code:`<NiceShowcase
+  components={componentLibrary}
+  showCode
+  showProps
+  showPlayground
+  groupBy="category"
+/>`}],r={keyboard:["Tab through examples"],aria:["Component documentation regions"]},p=[],d={$schema:e,name:o,description:t,category:n,since:s,status:c,props:a,examples:i,accessibility:r,seeAlso:p};exports.$schema=e;exports.accessibility=r;exports.category=n;exports.default=d;exports.description=t;exports.examples=i;exports.name=o;exports.props=a;exports.seeAlso=p;exports.since=s;exports.status=c;

package/dist/NiceShowcase.doc-Drg3d0SH.js

@@ -0,0 +1,31 @@
+const o = "https://nice2dev.com/schemas/component-doc-v1.json", e = "NiceShowcase", n = "Component showcase for displaying and documenting UI components.", t = "tools", s = "1.0.0", c = "stable", a = [{ name: "components", type: "ShowcaseComponent[]", required: !0, description: "Components to showcase" }, { name: "showCode", type: "boolean", default: "true", description: "Show source code" }, { name: "showProps", type: "boolean", default: "true", description: "Show props table" }, { name: "showPlayground", type: "boolean", default: "true", description: "Show interactive playground" }, { name: "theme", type: "'light' | 'dark' | 'auto'", default: "'auto'", description: "Theme mode" }, { name: "searchable", type: "boolean", default: "true", description: "Enable search" }, { name: "groupBy", type: "string", description: "Group by field" }], p = [{ title: "Component Showcase", description: "Document components", code: `<NiceShowcase
+  components={componentLibrary}
+  showCode
+  showProps
+  showPlayground
+  groupBy="category"
+/>` }], r = { keyboard: ["Tab through examples"], aria: ["Component documentation regions"] }, i = [], d = {
+  $schema: o,
+  name: e,
+  description: n,
+  category: t,
+  since: s,
+  status: c,
+  props: a,
+  examples: p,
+  accessibility: r,
+  seeAlso: i
+};
+export {
+  o as $schema,
+  r as accessibility,
+  t as category,
+  d as default,
+  n as description,
+  p as examples,
+  e as name,
+  a as props,
+  i as seeAlso,
+  s as since,
+  c as status
+};

package/dist/NiceSidebar.doc-DO5F0AY4.js

@@ -0,0 +1,32 @@
+const e = "https://nice2dev.com/schemas/component-doc-v1.json", t = "NiceSidebar", a = "Collapsible sidebar navigation with nested menu items.", i = "navigation", o = "1.0.0", n = "stable", s = [{ name: "items", type: "SidebarItem[]", required: !0, description: "Menu items" }, { name: "collapsed", type: "boolean", default: "false", description: "Collapsed state" }, { name: "onCollapse", type: "(collapsed: boolean) => void", description: "Collapse callback" }, { name: "activeItem", type: "string", description: "Active item ID" }, { name: "onItemClick", type: "(item: SidebarItem) => void", description: "Item click callback" }, { name: "showToggle", type: "boolean", default: "true", description: "Show collapse toggle" }, { name: "width", type: "number", default: "250", description: "Expanded width" }, { name: "collapsedWidth", type: "number", default: "64", description: "Collapsed width" }, { name: "header", type: "React.ReactNode", description: "Sidebar header" }], c = [{ title: "Sidebar", description: "Navigation sidebar", code: `<NiceSidebar
+  items={menuItems}
+  collapsed={isCollapsed}
+  onCollapse={setIsCollapsed}
+  activeItem={currentRoute}
+  onItemClick={navigateTo}
+  header={<Logo />}
+/>` }], d = { keyboard: ["Tab through items", "Enter to expand/select"], aria: ["Navigation role", "Expanded state"] }, l = ["NiceMegaMenu", "NiceDrawer"], p = {
+  $schema: e,
+  name: t,
+  description: a,
+  category: i,
+  since: o,
+  status: n,
+  props: s,
+  examples: c,
+  accessibility: d,
+  seeAlso: l
+};
+export {
+  e as $schema,
+  d as accessibility,
+  i as category,
+  p as default,
+  a as description,
+  c as examples,
+  t as name,
+  s as props,
+  l as seeAlso,
+  o as since,
+  n as status
+};

package/dist/NiceSidebar.doc-Detz-pTd.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="https://nice2dev.com/schemas/component-doc-v1.json",t="NiceSidebar",a="Collapsible sidebar navigation with nested menu items.",i="navigation",o="1.0.0",s="stable",n=[{name:"items",type:"SidebarItem[]",required:!0,description:"Menu items"},{name:"collapsed",type:"boolean",default:"false",description:"Collapsed state"},{name:"onCollapse",type:"(collapsed: boolean) => void",description:"Collapse callback"},{name:"activeItem",type:"string",description:"Active item ID"},{name:"onItemClick",type:"(item: SidebarItem) => void",description:"Item click callback"},{name:"showToggle",type:"boolean",default:"true",description:"Show collapse toggle"},{name:"width",type:"number",default:"250",description:"Expanded width"},{name:"collapsedWidth",type:"number",default:"64",description:"Collapsed width"},{name:"header",type:"React.ReactNode",description:"Sidebar header"}],c=[{title:"Sidebar",description:"Navigation sidebar",code:`<NiceSidebar
+  items={menuItems}
+  collapsed={isCollapsed}
+  onCollapse={setIsCollapsed}
+  activeItem={currentRoute}
+  onItemClick={navigateTo}
+  header={<Logo />}
+/>`}],d={keyboard:["Tab through items","Enter to expand/select"],aria:["Navigation role","Expanded state"]},l=["NiceMegaMenu","NiceDrawer"],r={$schema:e,name:t,description:a,category:i,since:o,status:s,props:n,examples:c,accessibility:d,seeAlso:l};exports.$schema=e;exports.accessibility=d;exports.category=i;exports.default=r;exports.description=a;exports.examples=c;exports.name=t;exports.props=n;exports.seeAlso=l;exports.since=o;exports.status=s;

package/dist/NiceSidebarNav.doc-C9KgVtf8.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="https://nice2dev.com/schemas/component-doc-v1.json",a="NiceSidebarNav",i="Sidebar Navigation",t="1.0.0",s="stable",r="navigation",n="sidebar",o="Multi-mode navigation sidebar with roles/units/favorites and per-user localStorage persistence.",c="1.0.0",d=["web","desktop"],l=["sidebar","navigation","menu","roles","favorites"],p=[{name:"data",type:"SidebarNavDataNode[]",required:!0,description:"Full navigation tree data."},{name:"userId",type:"string",required:!1,description:"User ID for localStorage persistence."},{name:"activeRoute",type:"string",required:!1,description:"Currently active route (highlighting)."},{name:"enableModeIcons",type:"boolean",required:!1,default:"false",description:"Show mode-switch icons."},{name:"preferences",type:"Partial<SidebarNavUserPrefs>",required:!1,description:"Controlled prefs (server-side)."},{name:"width",type:"number",required:!1,default:"264",description:"Sidebar width in px."},{name:"size",type:"NiceSize",required:!1,description:"Size variant."}],u=[{name:"onNavigate",parameters:[{name:"route",type:"string"},{name:"view",type:"SidebarNavView"}],description:"Called when user clicks a view."},{name:"onPreferencesChange",parameters:[{name:"prefs",type:"SidebarNavUserPrefs"}],description:"Called when preferences change."}],m=[{name:"--nice-sidebar-bg",default:"var(--nice-surface-bg)",description:"Sidebar background"},{name:"--nice-sidebar-width",default:"264px",description:"Sidebar width"}],v=[{title:"App Sidebar",code:`<NiceSidebarNav
+  data={navigationData}
+  userId={currentUser.id}
+  activeRoute={currentRoute}
+  onNavigate={handleNavigate}
+  enableModeIcons
+/>`,language:"tsx"}],b=[{name:"NiceNavbar",relationship:"sibling"},{name:"NiceMenu",relationship:"child"}],g={$schema:e,name:a,displayName:i,version:t,status:s,category:r,subcategory:n,package:"@nicetoDev/ui",description:o,since:c,platforms:d,keywords:l,props:p,events:u,cssVariables:m,examples:v,related:b};exports.$schema=e;exports.category=r;exports.cssVariables=m;exports.default=g;exports.description=o;exports.displayName=i;exports.events=u;exports.examples=v;exports.keywords=l;exports.name=a;exports.platforms=d;exports.props=p;exports.related=b;exports.since=c;exports.status=s;exports.subcategory=n;exports.version=t;

package/dist/NiceSidebarNav.doc-D6vTFk6t.js

@@ -0,0 +1,44 @@
+const e = "https://nice2dev.com/schemas/component-doc-v1.json", a = "NiceSidebarNav", i = "Sidebar Navigation", n = "1.0.0", t = "stable", r = "navigation", s = "sidebar", o = "Multi-mode navigation sidebar with roles/units/favorites and per-user localStorage persistence.", c = "1.0.0", d = ["web", "desktop"], l = ["sidebar", "navigation", "menu", "roles", "favorites"], p = [{ name: "data", type: "SidebarNavDataNode[]", required: !0, description: "Full navigation tree data." }, { name: "userId", type: "string", required: !1, description: "User ID for localStorage persistence." }, { name: "activeRoute", type: "string", required: !1, description: "Currently active route (highlighting)." }, { name: "enableModeIcons", type: "boolean", required: !1, default: "false", description: "Show mode-switch icons." }, { name: "preferences", type: "Partial<SidebarNavUserPrefs>", required: !1, description: "Controlled prefs (server-side)." }, { name: "width", type: "number", required: !1, default: "264", description: "Sidebar width in px." }, { name: "size", type: "NiceSize", required: !1, description: "Size variant." }], u = [{ name: "onNavigate", parameters: [{ name: "route", type: "string" }, { name: "view", type: "SidebarNavView" }], description: "Called when user clicks a view." }, { name: "onPreferencesChange", parameters: [{ name: "prefs", type: "SidebarNavUserPrefs" }], description: "Called when preferences change." }], v = [{ name: "--nice-sidebar-bg", default: "var(--nice-surface-bg)", description: "Sidebar background" }, { name: "--nice-sidebar-width", default: "264px", description: "Sidebar width" }], b = [{ title: "App Sidebar", code: `<NiceSidebarNav
+  data={navigationData}
+  userId={currentUser.id}
+  activeRoute={currentRoute}
+  onNavigate={handleNavigate}
+  enableModeIcons
+/>`, language: "tsx" }], m = [{ name: "NiceNavbar", relationship: "sibling" }, { name: "NiceMenu", relationship: "child" }], g = {
+  $schema: e,
+  name: a,
+  displayName: i,
+  version: n,
+  status: t,
+  category: r,
+  subcategory: s,
+  package: "@nicetoDev/ui",
+  description: o,
+  since: c,
+  platforms: d,
+  keywords: l,
+  props: p,
+  events: u,
+  cssVariables: v,
+  examples: b,
+  related: m
+};
+export {
+  e as $schema,
+  r as category,
+  v as cssVariables,
+  g as default,
+  o as description,
+  i as displayName,
+  u as events,
+  b as examples,
+  l as keywords,
+  a as name,
+  d as platforms,
+  p as props,
+  m as related,
+  c as since,
+  t as status,
+  s as subcategory,
+  n as version
+};

package/dist/NiceSignature.doc-BRNMaNX8.js

@@ -0,0 +1,25 @@
+const e = "https://nice2dev.com/schemas/component-doc-v1.json", n = "NiceSignature", t = "Signature pad component.", a = "input", o = "1.0.0", c = "stable", i = [{ name: "value", type: "string", description: "Signature data URL" }, { name: "onChange", type: "(dataUrl: string) => void", description: "Change callback" }, { name: "penColor", type: "string", default: "'#000'", description: "Pen color" }, { name: "penWidth", type: "number", default: "2", description: "Pen width" }], s = [{ title: "Signature", code: '<NiceSignature value={signature} onChange={setSignature} penColor="#1a1a1a" />' }], r = { keyboard: ["Clear button"], aria: ["Signature canvas"] }, p = ["NiceTouchDrawing", "NiceForm"], d = {
+  $schema: e,
+  name: n,
+  description: t,
+  category: a,
+  since: o,
+  status: c,
+  props: i,
+  examples: s,
+  accessibility: r,
+  seeAlso: p
+};
+export {
+  e as $schema,
+  r as accessibility,
+  a as category,
+  d as default,
+  t as description,
+  s as examples,
+  n as name,
+  i as props,
+  p as seeAlso,
+  o as since,
+  c as status
+};

package/dist/NiceSignature.doc-CRUQvMTu.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="https://nice2dev.com/schemas/component-doc-v1.json",t="NiceSignature",n="Signature pad component.",a="input",s="1.0.0",o="stable",i=[{name:"value",type:"string",description:"Signature data URL"},{name:"onChange",type:"(dataUrl: string) => void",description:"Change callback"},{name:"penColor",type:"string",default:"'#000'",description:"Pen color"},{name:"penWidth",type:"number",default:"2",description:"Pen width"}],c=[{title:"Signature",code:'<NiceSignature value={signature} onChange={setSignature} penColor="#1a1a1a" />'}],r={keyboard:["Clear button"],aria:["Signature canvas"]},p=["NiceTouchDrawing","NiceForm"],l={$schema:e,name:t,description:n,category:a,since:s,status:o,props:i,examples:c,accessibility:r,seeAlso:p};exports.$schema=e;exports.accessibility=r;exports.category=a;exports.default=l;exports.description=n;exports.examples=c;exports.name=t;exports.props=i;exports.seeAlso=p;exports.since=s;exports.status=o;

package/dist/NiceSignaturePad.doc-8TxVtwg4.js

@@ -0,0 +1,32 @@
+const e = "https://nice2dev.com/schemas/component-doc-v1.json", t = "NiceSignaturePad", n = "Signature capture pad for e-signatures.", a = "input", i = "1.0.0", o = "stable", s = [{ name: "value", type: "string", description: "Signature data URL" }, { name: "onChange", type: "(dataUrl: string) => void", required: !0, description: "Change callback" }, { name: "width", type: "number", default: "400", description: "Canvas width" }, { name: "height", type: "number", default: "200", description: "Canvas height" }, { name: "penColor", type: "string", default: "'#000000'", description: "Pen color" }, { name: "penWidth", type: "number", default: "2", description: "Pen width" }, { name: "backgroundColor", type: "string", default: "'#ffffff'", description: "Background color" }, { name: "showClear", type: "boolean", default: "true", description: "Show clear button" }, { name: "disabled", type: "boolean", default: "false", description: "Disabled state" }], r = [{ title: "Signature Pad", description: "Capture signature", code: `<NiceSignaturePad
+  value={signature}
+  onChange={setSignature}
+  width={500}
+  height={200}
+  penColor="#1a1a1a"
+  showClear
+/>` }], c = { keyboard: ["Tab to controls"], aria: ["Drawing canvas", "Clear button"] }, d = ["NiceDrawingCanvas", "NiceFormBuilder"], u = {
+  $schema: e,
+  name: t,
+  description: n,
+  category: a,
+  since: i,
+  status: o,
+  props: s,
+  examples: r,
+  accessibility: c,
+  seeAlso: d
+};
+export {
+  e as $schema,
+  c as accessibility,
+  a as category,
+  u as default,
+  n as description,
+  r as examples,
+  t as name,
+  s as props,
+  d as seeAlso,
+  i as since,
+  o as status
+};

package/dist/NiceSignaturePad.doc-C1oef5bc.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="https://nice2dev.com/schemas/component-doc-v1.json",t="NiceSignaturePad",a="Signature capture pad for e-signatures.",n="input",i="1.0.0",o="stable",s=[{name:"value",type:"string",description:"Signature data URL"},{name:"onChange",type:"(dataUrl: string) => void",required:!0,description:"Change callback"},{name:"width",type:"number",default:"400",description:"Canvas width"},{name:"height",type:"number",default:"200",description:"Canvas height"},{name:"penColor",type:"string",default:"'#000000'",description:"Pen color"},{name:"penWidth",type:"number",default:"2",description:"Pen width"},{name:"backgroundColor",type:"string",default:"'#ffffff'",description:"Background color"},{name:"showClear",type:"boolean",default:"true",description:"Show clear button"},{name:"disabled",type:"boolean",default:"false",description:"Disabled state"}],r=[{title:"Signature Pad",description:"Capture signature",code:`<NiceSignaturePad
+  value={signature}
+  onChange={setSignature}
+  width={500}
+  height={200}
+  penColor="#1a1a1a"
+  showClear
+/>`}],c={keyboard:["Tab to controls"],aria:["Drawing canvas","Clear button"]},d=["NiceDrawingCanvas","NiceFormBuilder"],l={$schema:e,name:t,description:a,category:n,since:i,status:o,props:s,examples:r,accessibility:c,seeAlso:d};exports.$schema=e;exports.accessibility=c;exports.category=n;exports.default=l;exports.description=a;exports.examples=r;exports.name=t;exports.props=s;exports.seeAlso=d;exports.since=i;exports.status=o;