@wakastellar/ui 3.5.0 → 4.0.0-dev.0

package/src/blocks/release-notes/ReleaseNotes.mdx

@@ -0,0 +1,101 @@
+import { Meta, Canvas, Controls, Source, ArgTypes } from '@storybook/addon-docs/blocks'
+import * as Stories from './ReleaseNotes.stories'
+
+<Meta of={Stories} />
+
+# ReleaseNotes
+
+Release notes block with version timeline, change categories, and compare-versions selector.
+
+## Installation
+
+The component is exported from the root entry point of `@wakastellar/ui`:
+
+<Source language="tsx" code={`import { ReleaseNotes } from '@wakastellar/ui'`} />
+
+If you use the CLI scaffolder:
+
+<Source language="bash" code={`npx wakastellar-ui add release-notes`} />
+
+## Usage
+
+<Canvas of={Stories.Default} />
+
+<Controls of={Stories.Default} />
+
+## Examples
+
+### Single Release
+
+<Canvas of={Stories.SingleRelease} />
+
+### Many Releases
+
+<Canvas of={Stories.ManyReleases} />
+
+### With Breaking Changes
+
+<Canvas of={Stories.WithBreakingChanges} />
+
+### Draft Release
+
+<Canvas of={Stories.DraftRelease} />
+
+### Scheduled Release
+
+<Canvas of={Stories.ScheduledRelease} />
+
+### All Change Types
+
+<Canvas of={Stories.AllChangeTypes} />
+
+### With Pull Requests
+
+<Canvas of={Stories.WithPullRequests} />
+
+### Empty State
+
+<Canvas of={Stories.EmptyState} />
+
+### Read Only
+
+<Canvas of={Stories.ReadOnly} />
+
+### Interactive
+
+<Canvas of={Stories.Interactive} />
+
+### Project Changelog
+
+<Canvas of={Stories.ProjectChangelog} />
+
+### With Filters
+
+<Canvas of={Stories.WithFilters} />
+
+
+## API Reference
+
+<ArgTypes of={Stories.Default} />
+
+## Accessibility
+
+- Full keyboard navigation (Tab, Shift+Tab, Enter, Space, Arrow keys where applicable).
+- Compatible with screen readers via Radix UI primitives.
+- Focus ring visible at all times; never `outline: none` without a replacement.
+- Color contrast meets WCAG AA in both light and dark themes.
+
+## Theming
+
+All visual tokens are CSS custom properties consumed via Tailwind v4. Override
+in your app's `globals.css` to customize:
+
+<Source language="css" code={`:root {
+  --primary: oklch(0.65 0.18 250);
+  --primary-foreground: oklch(0.98 0 0);
+}`} />
+
+## Related
+
+- See the audit fiche: \`docs/audit/blocks/release-notes.md\`
+- See the [accessibility dimension report](?path=/docs/dimensions-accessibility--docs)

package/src/blocks/release-notes/ReleaseNotes.stories.tsx

@@ -15,7 +15,6 @@ const meta: Meta<typeof ReleaseNotes> = {
       },
     },
   },
-  tags: ['autodocs'],
   argTypes: {
     showEditor: {
       control: 'boolean',
@@ -429,3 +428,14 @@ export const WithFilters: Story = {
     )
   },
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  args: {
+    showEditor: false,
+  },
+  render: (args) => <ReleaseNotes {...args} />,
+}

package/src/blocks/scan-history-log/ScanHistoryLog.stories.tsx

@@ -229,3 +229,11 @@ export const WithPagination: Story = {
     onExport: () => console.log("Export triggered"),
   },
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  render: (args) => <ScanHistoryLog {...args} />,
+}

package/src/blocks/scan-history-log/index.tsx

@@ -1,3 +1,17 @@
+/**
+ * @deprecated SP1.relocates — Phase 1
+ *
+ * This surface has been relocated to `@wakastellar/ui-blocks-internal` (workspace package
+ * `packages/ui-blocks-internal`). The core `@wakastellar/ui` retains the original
+ * implementation for backward compatibility during phases 1–3 of the
+ * relocation plan; the duplicate will be removed in v4.0.
+ *
+ * Migration:
+ *   - Old: import { ... } from '@wakastellar/ui'
+ *   - New: import { ... } from '@wakastellar/ui-blocks-internal'
+ *
+ * @deprecated Moved to `@wakastellar/ui-blocks-internal` in v3.6 — core copy will be removed in v4.0.
+ */
 "use client"
 
 import { useState } from "react"

package/src/blocks/scan-policy-editor/ScanPolicyEditor.stories.tsx

@@ -104,3 +104,11 @@ export const StrictPolicy: Story = {
     },
   },
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  render: (args) => <ScanPolicyEditor {...args} />,
+}

package/src/blocks/scan-policy-editor/index.tsx

@@ -1,3 +1,17 @@
+/**
+ * @deprecated SP1.relocates — Phase 1
+ *
+ * This surface has been relocated to `@wakastellar/ui-blocks-internal` (workspace package
+ * `packages/ui-blocks-internal`). The core `@wakastellar/ui` retains the original
+ * implementation for backward compatibility during phases 1–3 of the
+ * relocation plan; the duplicate will be removed in v4.0.
+ *
+ * Migration:
+ *   - Old: import { ... } from '@wakastellar/ui'
+ *   - New: import { ... } from '@wakastellar/ui-blocks-internal'
+ *
+ * @deprecated Moved to `@wakastellar/ui-blocks-internal` in v3.6 — core copy will be removed in v4.0.
+ */
 "use client"
 
 import { useState } from "react"

package/src/blocks/scan-report-generator/ScanReportGenerator.stories.tsx

@@ -230,3 +230,11 @@ export const HighThreatActivity: Story = {
     },
   },
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  render: (args) => <ScanReportGenerator {...args} />,
+}

package/src/blocks/scan-report-generator/index.tsx

@@ -1,3 +1,17 @@
+/**
+ * @deprecated SP1.relocates — Phase 1
+ *
+ * This surface has been relocated to `@wakastellar/ui-blocks-internal` (workspace package
+ * `packages/ui-blocks-internal`). The core `@wakastellar/ui` retains the original
+ * implementation for backward compatibility during phases 1–3 of the
+ * relocation plan; the duplicate will be removed in v4.0.
+ *
+ * Migration:
+ *   - Old: import { ... } from '@wakastellar/ui'
+ *   - New: import { ... } from '@wakastellar/ui-blocks-internal'
+ *
+ * @deprecated Moved to `@wakastellar/ui-blocks-internal` in v3.6 — core copy will be removed in v4.0.
+ */
 "use client"
 
 import { useState } from "react"

package/src/blocks/settings/Settings.stories.tsx

@@ -27,7 +27,6 @@ const meta: Meta<typeof WakaSettings> = {
       },
     },
   },
-  tags: ['autodocs'],
   argTypes: {
     useTabs: {
       control: 'boolean',
@@ -518,3 +517,16 @@ export const InPageContext: Story = {
     </div>
   ),
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  args: {
+    useTabs: false,
+    showSaveButton: false,
+    showDeleteAccount: false,
+  },
+  render: (args) => <WakaSettings {...args} />,
+}

package/src/blocks/settings/WakaSettings.mdx

@@ -0,0 +1,89 @@
+import { Meta, Canvas, Controls, Source, ArgTypes } from '@storybook/addon-docs/blocks'
+import * as Stories from './Settings.stories'
+
+<Meta of={Stories} />
+
+# WakaSettings
+
+Settings surface with sectioned navigation (account, billing, notifications, security, etc.) and form layouts.
+
+## Installation
+
+The component is exported from the root entry point of `@wakastellar/ui`:
+
+<Source language="tsx" code={`import { WakaSettings } from '@wakastellar/ui'`} />
+
+If you use the CLI scaffolder:
+
+<Source language="bash" code={`npx wakastellar-ui add settings`} />
+
+## Usage
+
+<Canvas of={Stories.Default} />
+
+<Controls of={Stories.Default} />
+
+## Examples
+
+### With Delete Account
+
+<Canvas of={Stories.WithDeleteAccount} />
+
+### Without Tabs
+
+<Canvas of={Stories.WithoutTabs} />
+
+### Custom Tabs
+
+<Canvas of={Stories.CustomTabs} />
+
+### Security Settings
+
+<Canvas of={Stories.SecuritySettings} />
+
+### Interactive
+
+<Canvas of={Stories.Interactive} />
+
+### No Save Button
+
+<Canvas of={Stories.NoSaveButton} />
+
+### Read Only
+
+<Canvas of={Stories.ReadOnly} />
+
+### Single Section
+
+<Canvas of={Stories.SingleSection} />
+
+### In Page Context
+
+<Canvas of={Stories.InPageContext} />
+
+
+## API Reference
+
+<ArgTypes of={Stories.Default} />
+
+## Accessibility
+
+- Full keyboard navigation (Tab, Shift+Tab, Enter, Space, Arrow keys where applicable).
+- Compatible with screen readers via Radix UI primitives.
+- Focus ring visible at all times; never `outline: none` without a replacement.
+- Color contrast meets WCAG AA in both light and dark themes.
+
+## Theming
+
+All visual tokens are CSS custom properties consumed via Tailwind v4. Override
+in your app's `globals.css` to customize:
+
+<Source language="css" code={`:root {
+  --primary: oklch(0.65 0.18 250);
+  --primary-foreground: oklch(0.98 0 0);
+}`} />
+
+## Related
+
+- See the audit fiche: \`docs/audit/blocks/settings.md\`
+- See the [accessibility dimension report](?path=/docs/dimensions-accessibility--docs)

package/src/blocks/sidebar/WakaSidebar.mdx

@@ -0,0 +1,101 @@
+import { Meta, Canvas, Controls, Source, ArgTypes } from '@storybook/addon-docs/blocks'
+import * as Stories from './WakaSidebar.stories'
+
+<Meta of={Stories} />
+
+# WakaSidebar
+
+Application sidebar with collapsible groups, nested items, badges, and footer slot.
+
+## Installation
+
+The component is exported from the root entry point of `@wakastellar/ui`:
+
+<Source language="tsx" code={`import { WakaSidebar } from '@wakastellar/ui'`} />
+
+If you use the CLI scaffolder:
+
+<Source language="bash" code={`npx wakastellar-ui add sidebar`} />
+
+## Usage
+
+<Canvas of={Stories.Default} />
+
+<Controls of={Stories.Default} />
+
+## Examples
+
+### With Logo Image
+
+<Canvas of={Stories.WithLogoImage} />
+
+### User On Top
+
+<Canvas of={Stories.UserOnTop} />
+
+### No User
+
+<Canvas of={Stories.NoUser} />
+
+### Long Menu
+
+<Canvas of={Stories.LongMenu} />
+
+### With Footer
+
+<Canvas of={Stories.WithFooter} />
+
+### With Header
+
+<Canvas of={Stories.WithHeader} />
+
+### Custom Width
+
+<Canvas of={Stories.CustomWidth} />
+
+### Disabled Items
+
+<Canvas of={Stories.DisabledItems} />
+
+### Sidebar Layout Example
+
+<Canvas of={Stories.SidebarLayoutExample} />
+
+### Interactive Menu
+
+<Canvas of={Stories.InteractiveMenu} />
+
+### Custom User Actions
+
+<Canvas of={Stories.CustomUserActions} />
+
+### Application Layout
+
+<Canvas of={Stories.ApplicationLayout} />
+
+
+## API Reference
+
+<ArgTypes of={Stories.Default} />
+
+## Accessibility
+
+- Full keyboard navigation (Tab, Shift+Tab, Enter, Space, Arrow keys where applicable).
+- Compatible with screen readers via Radix UI primitives.
+- Focus ring visible at all times; never `outline: none` without a replacement.
+- Color contrast meets WCAG AA in both light and dark themes.
+
+## Theming
+
+All visual tokens are CSS custom properties consumed via Tailwind v4. Override
+in your app's `globals.css` to customize:
+
+<Source language="css" code={`:root {
+  --primary: oklch(0.65 0.18 250);
+  --primary-foreground: oklch(0.98 0 0);
+}`} />
+
+## Related
+
+- See the audit fiche: \`docs/audit/blocks/sidebar.md\`
+- See the [accessibility dimension report](?path=/docs/dimensions-accessibility--docs)

package/src/blocks/sidebar/WakaSidebar.stories.tsx

@@ -113,7 +113,6 @@ const meta: Meta<typeof WakaSidebar> = {
       },
     },
   },
-  tags: ['autodocs'],
   argTypes: {
     userPosition: {
       control: 'select',
@@ -511,3 +510,15 @@ export const ApplicationLayout: Story = {
     </div>
   ),
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  args: {
+    userPosition: "top",
+    position: "fixed",
+  },
+  render: (args) => <WakaSidebar {...args} />,
+}

package/src/blocks/sidebar/index.tsx

@@ -596,8 +596,6 @@ export function WakaSidebar({
     "bg-[var(--sidebar-bg)] text-[var(--sidebar-text)]",
     "[&_.bg-sidebar-active]:bg-[var(--sidebar-active)]",
     "[&_.text-sidebar-active-foreground]:text-[var(--sidebar-active-foreground)]",
-    "[&_.text-sidebar-foreground\\/70]:text-[var(--sidebar-text)]",
-    "[&_.text-sidebar-foreground\\/70]:opacity-70",
     "[&_.border-sidebar-active]:border-[var(--sidebar-active)]",
     contentClassName
   )

package/src/blocks/signature-database-manager/SignatureDatabaseManager.stories.tsx

@@ -277,3 +277,11 @@ export const RecentFailure: Story = {
     ],
   },
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  render: (args) => <SignatureDatabaseManager {...args} />,
+}

package/src/blocks/signature-database-manager/index.tsx

@@ -1,3 +1,17 @@
+/**
+ * @deprecated SP1.relocates — Phase 1
+ *
+ * This surface has been relocated to `@wakastellar/ui-blocks-internal` (workspace package
+ * `packages/ui-blocks-internal`). The core `@wakastellar/ui` retains the original
+ * implementation for backward compatibility during phases 1–3 of the
+ * relocation plan; the duplicate will be removed in v4.0.
+ *
+ * Migration:
+ *   - Old: import { ... } from '@wakastellar/ui'
+ *   - New: import { ... } from '@wakastellar/ui-blocks-internal'
+ *
+ * @deprecated Moved to `@wakastellar/ui-blocks-internal` in v3.6 — core copy will be removed in v4.0.
+ */
 "use client"
 
 import { Badge } from "../../components/badge"

package/src/blocks/theme-creator-block/ThemeCreatorBlock.stories.tsx

@@ -368,3 +368,11 @@ export const BrandingEditor: Story = {
     )
   },
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  render: (args) => <WakaThemeCreatorBlock {...args} />,
+}

package/src/blocks/theme-creator-block/index.tsx

@@ -1,3 +1,17 @@
+/**
+ * @deprecated SP1.relocates — Phase 1
+ *
+ * This surface has been relocated to `@wakastellar/ui-blocks-internal` (workspace package
+ * `packages/ui-blocks-internal`). The core `@wakastellar/ui` retains the original
+ * implementation for backward compatibility during phases 1–3 of the
+ * relocation plan; the duplicate will be removed in v4.0.
+ *
+ * Migration:
+ *   - Old: import { ... } from '@wakastellar/ui'
+ *   - New: import { ... } from '@wakastellar/ui-blocks-internal'
+ *
+ * @deprecated Moved to `@wakastellar/ui-blocks-internal` in v3.6 — core copy will be removed in v4.0.
+ */
 "use client"
 
 import * as React from "react"

package/src/blocks/threat-alert-banner/ThreatAlertBanner.stories.tsx

@@ -150,3 +150,11 @@ export const ManyAlerts: Story = {
     },
   },
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  render: (args) => <ThreatAlertBanner {...args} />,
+}

package/src/blocks/threat-alert-banner/index.tsx

@@ -1,3 +1,17 @@
+/**
+ * @deprecated SP1.relocates — Phase 1
+ *
+ * This surface has been relocated to `@wakastellar/ui-blocks-internal` (workspace package
+ * `packages/ui-blocks-internal`). The core `@wakastellar/ui` retains the original
+ * implementation for backward compatibility during phases 1–3 of the
+ * relocation plan; the duplicate will be removed in v4.0.
+ *
+ * Migration:
+ *   - Old: import { ... } from '@wakastellar/ui'
+ *   - New: import { ... } from '@wakastellar/ui-blocks-internal'
+ *
+ * @deprecated Moved to `@wakastellar/ui-blocks-internal` in v3.6 — core copy will be removed in v4.0.
+ */
 "use client"
 
 import { useState } from "react"

package/src/blocks/user-management/UserManagement.stories.tsx

@@ -409,3 +409,16 @@ export const AdminPanel: Story = {
     )
   },
 }
+
+/**
+ * Playground — generated to make the Storybook Controls panel functional.
+ * Exposes a default arg set wired to the component via {...args}.
+ */
+export const Playground: Story = {
+  args: {
+    showBulkActions: false,
+    showCreateButton: false,
+    loading: false,
+  },
+  render: (args) => <WakaUserManagement {...args} />,
+}

package/src/blocks/user-management/index.tsx

@@ -1,3 +1,17 @@
+/**
+ * @deprecated SP1.relocates — Phase 1
+ *
+ * This surface has been relocated to `@wakastellar/ui-blocks-internal` (workspace package
+ * `packages/ui-blocks-internal`). The core `@wakastellar/ui` retains the original
+ * implementation for backward compatibility during phases 1–3 of the
+ * relocation plan; the duplicate will be removed in v4.0.
+ *
+ * Migration:
+ *   - Old: import { ... } from '@wakastellar/ui'
+ *   - New: import { ... } from '@wakastellar/ui-blocks-internal'
+ *
+ * @deprecated Moved to `@wakastellar/ui-blocks-internal` in v3.6 — core copy will be removed in v4.0.
+ */
 "use client"
 
 import * as React from "react"

package/src/blocks/waka-doc-shell/WakaDocShell.mdx

@@ -0,0 +1,61 @@
+import { Meta, Canvas, Controls, Source, ArgTypes } from '@storybook/addon-docs/blocks'
+import * as Stories from './WakaDocShell.stories'
+
+<Meta of={Stories} />
+
+# WakaDocShell
+
+Documentation site shell (header + sidebar nav + content + ToC) used by the WakaDoc renderer.
+
+## Installation
+
+The component is exported from the root entry point of `@wakastellar/ui`:
+
+<Source language="tsx" code={`import { WakaDocShell } from '@wakastellar/ui'`} />
+
+If you use the CLI scaffolder:
+
+<Source language="bash" code={`npx wakastellar-ui add waka-doc-shell`} />
+
+## Usage
+
+<Canvas of={Stories.ViewMode} />
+
+<Controls of={Stories.ViewMode} />
+
+## Examples
+
+### Edit Mode
+
+<Canvas of={Stories.EditMode} />
+
+### Minimal View Only
+
+<Canvas of={Stories.MinimalViewOnly} />
+
+
+## API Reference
+
+<ArgTypes of={Stories.ViewMode} />
+
+## Accessibility
+
+- Full keyboard navigation (Tab, Shift+Tab, Enter, Space, Arrow keys where applicable).
+- Compatible with screen readers via Radix UI primitives.
+- Focus ring visible at all times; never `outline: none` without a replacement.
+- Color contrast meets WCAG AA in both light and dark themes.
+
+## Theming
+
+All visual tokens are CSS custom properties consumed via Tailwind v4. Override
+in your app's `globals.css` to customize:
+
+<Source language="css" code={`:root {
+  --primary: oklch(0.65 0.18 250);
+  --primary-foreground: oklch(0.98 0 0);
+}`} />
+
+## Related
+
+- See the audit fiche: \`docs/audit/blocks/waka-doc-shell.md\`
+- See the [accessibility dimension report](?path=/docs/dimensions-accessibility--docs)