@arbor-education/design-system.components 0.15.0 → 0.16.1

package/dist/components/table/TableFooter.stories.js

@@ -0,0 +1,137 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Controls, Heading as DocHeading, Markdown, Primary as DocPrimary, Stories, Subtitle, Title, } from '@storybook/addon-docs/blocks';
+import { fn } from 'storybook/test';
+import { TableFooter } from './TableFooter';
+import { PaginationPanel } from './pagination/PaginationPanel';
+// ---------------------------------------------------------------------------
+// Docs page content
+// ---------------------------------------------------------------------------
+const DESCRIPTION_INTRO = [
+    '`TableFooter` is the pre-composed footer slot for the Arbor data table.',
+    'It renders a `<footer>` element and accepts any `children` (typically a `<PaginationPanel />` element).',
+    '',
+    'Pass the entire `<TableFooter />` element as the `footerContent` prop of `<Table />`.',
+].join('\n');
+const USAGE_GUIDANCE = [
+    '### When to use',
+    '',
+    '- As the `footerContent` of a `<Table />` when you need a standard footer region',
+    '- When you want to wrap `<PaginationPanel />` in the footer slot',
+    '- When you need custom footer content beyond pagination controls',
+    '',
+    '---',
+    '',
+    '### When NOT to use',
+    '',
+    '| Situation | Alternative |',
+    '|---|---|',
+    '| You only need pagination | Pass `<PaginationPanel />` directly as `footerContent` |',
+    '| The table has no footer | Omit `footerContent` entirely |',
+    '',
+    '---',
+    '',
+    '### Props summary',
+    '',
+    '| Prop | Description |',
+    '|---|---|',
+    '| `children` | Content rendered inside the footer — typically `<PaginationPanel />` |',
+    '| `className` | Additional CSS class name(s) on the root `<footer>` element |',
+].join('\n');
+const DEVELOPER_NOTES = [
+    '### Wiring into `<Table />`',
+    '',
+    '```tsx',
+    "import { Table, TableFooter, PaginationPanel } from '@arbor-education/design-system.components';",
+    '',
+    'function MyTable() {',
+    '  return (',
+    '    <Table',
+    '      rowData={rows}',
+    '      columnDefs={colDefs}',
+    '      footerContent={(',
+    '        <TableFooter>',
+    '          <PaginationPanel',
+    '            availableSizes={[10, 25, 50, 100]}',
+    '            initialPageSize={25}',
+    '            onPageSizeChange={setPageSize}',
+    '          />',
+    '        </TableFooter>',
+    '      )}',
+    '    />',
+    '  );',
+    '}',
+    '```',
+    '',
+    '---',
+    '',
+    '### `TableFooter` vs passing `<PaginationPanel />` directly',
+    '',
+    '`<TableFooter />` adds the `ds-table__footer` class and `<footer>` semantic element around its',
+    'children. If you only need pagination, passing `<PaginationPanel />` directly as `footerContent`',
+    'is also valid — `<Table />` renders `footerContent` inside its own footer region.',
+].join('\n');
+const RELATED_COMPONENTS = [
+    '## Related components',
+    '',
+    '[Table](?path=/docs/components-table--docs) · [PaginationPanel](?path=/docs/components-table-paginationpanel--docs) · [TableHeader](?path=/docs/components-table-tableheader--docs)',
+].join('\n');
+const PROPS_INTRO = 'The preview below is wired to the **Controls** panel. `TableFooter` is a thin layout wrapper — its main value is the semantic `<footer>` element and `ds-table__footer` class it applies around its children.';
+// ---------------------------------------------------------------------------
+// Custom DocsPage
+// ---------------------------------------------------------------------------
+function TableFooterDocsPage() {
+    return (_jsxs(_Fragment, { children: [_jsx(Title, {}), _jsx(Subtitle, {}), _jsx(Markdown, { children: DESCRIPTION_INTRO }), _jsx(DocHeading, { children: "Interactive example" }), _jsx(Markdown, { children: PROPS_INTRO }), _jsx(DocPrimary, {}), _jsx(Controls, {}), _jsx(DocHeading, { children: "Usage guidance" }), _jsx(Markdown, { children: USAGE_GUIDANCE }), _jsx(DocHeading, { children: "Developer notes" }), _jsx(Markdown, { children: DEVELOPER_NOTES }), _jsx(DocHeading, { children: "Examples" }), _jsx(Stories, { title: "" }), _jsx(Markdown, { children: RELATED_COMPONENTS })] }));
+}
+// ---------------------------------------------------------------------------
+// Meta
+// ---------------------------------------------------------------------------
+const meta = {
+    title: 'Components/Table/TableFooter',
+    component: TableFooter,
+    tags: ['autodocs'],
+    parameters: {
+        layout: 'padded',
+        docs: { page: TableFooterDocsPage },
+    },
+    argTypes: {
+        children: {
+            description: 'Content rendered inside the footer. Typically a `<PaginationPanel />` element.',
+            control: false,
+            table: { type: { summary: 'ReactNode' }, defaultValue: { summary: 'undefined' } },
+        },
+        className: {
+            description: 'Additional CSS class name(s) to apply to the root `<footer>` element.',
+            control: 'text',
+            table: { type: { summary: 'string' }, defaultValue: { summary: 'undefined' } },
+        },
+    },
+};
+export default meta;
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+const withDescription = (story, description) => ({
+    ...story,
+    parameters: {
+        ...story.parameters,
+        docs: { ...story.parameters?.docs, description: { story: description } },
+    },
+});
+// ---------------------------------------------------------------------------
+// Stories
+// ---------------------------------------------------------------------------
+export const Default = withDescription({
+    args: {
+        children: (_jsx(PaginationPanel, { totalPages: 10, onPageChange: fn(), availableSizes: [10, 25, 50, 100], initialPageSize: 25, onPageSizeChange: fn() })),
+    },
+}, 'The canonical usage — `TableFooter` wrapping a `<PaginationPanel />`. '
+    + '`RowCountInfo` (the row count text) is not visible in this standalone preview because it '
+    + 'requires `GridApiContext` provided by a wrapping `<Table />`.');
+export const WithCustomContent = withDescription({
+    parameters: { controls: { disable: true } },
+    args: {
+        children: (_jsx("span", { style: { padding: '8px 16px', fontSize: '14px', color: 'var(--color-neutral-500)' }, children: "Custom footer content \u2014 e.g. totals, status messages, or secondary actions" })),
+    },
+}, '`TableFooter` accepts any `ReactNode` as `children` — not just `PaginationPanel`. '
+    + 'Use it to add totals rows, status messages, or any other custom footer content.');
+//# sourceMappingURL=TableFooter.stories.js.map

package/dist/components/table/TableFooter.stories.js.map

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

package/dist/components/table/TableHeader.stories.d.ts

@@ -0,0 +1,93 @@
+import React from 'react';
+import type { StoryObj } from '@storybook/react-vite';
+import { TableHeader } from './TableHeader';
+declare function TableHeaderDocsPage(): import("react/jsx-runtime").JSX.Element;
+declare const meta: {
+    title: string;
+    component: (props: {
+        className?: string;
+        hasSearch?: boolean;
+        searchValue?: string;
+        setSearchValue?: (searchValue: string) => void;
+        children?: React.ReactNode;
+        'data-testid'?: string;
+    }) => import("react/jsx-runtime").JSX.Element;
+    tags: string[];
+    parameters: {
+        layout: string;
+        docs: {
+            page: typeof TableHeaderDocsPage;
+        };
+    };
+    argTypes: {
+        children: {
+            description: string;
+            control: false;
+            table: {
+                type: {
+                    summary: string;
+                };
+                defaultValue: {
+                    summary: string;
+                };
+            };
+        };
+        hasSearch: {
+            description: string;
+            control: "boolean";
+            table: {
+                type: {
+                    summary: string;
+                };
+                defaultValue: {
+                    summary: string;
+                };
+            };
+        };
+        searchValue: {
+            description: string;
+            control: "text";
+            table: {
+                type: {
+                    summary: string;
+                };
+                defaultValue: {
+                    summary: string;
+                };
+            };
+        };
+        setSearchValue: {
+            description: string;
+            control: false;
+            table: {
+                type: {
+                    summary: string;
+                };
+                defaultValue: {
+                    summary: string;
+                };
+            };
+        };
+        className: {
+            description: string;
+            control: "text";
+            table: {
+                type: {
+                    summary: string;
+                };
+                defaultValue: {
+                    summary: string;
+                };
+            };
+        };
+    };
+    args: {
+        setSearchValue: import("@vitest/spy").Mock<(...args: any[]) => any>;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof TableHeader>;
+export declare const Default: Story;
+export declare const WithSearch: Story;
+export declare const ChildrenOnly: Story;
+//# sourceMappingURL=TableHeader.stories.d.ts.map

package/dist/components/table/TableHeader.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableHeader.stories.d.ts","sourceRoot":"","sources":["../../../src/components/table/TableHeader.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAW5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA8F5C,iBAAS,mBAAmB,4CAmB3B;AAMD,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsC0B,CAAC;AAErC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,WAAW,CAAC,CAAC;AAkB1C,eAAO,MAAM,OAAO,EAAE,KAkBrB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAoBxB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAkB1B,CAAC"}

package/dist/components/table/TableHeader.stories.js

@@ -0,0 +1,176 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Controls, Heading as DocHeading, Markdown, Primary as DocPrimary, Stories, Subtitle, Title, } from '@storybook/addon-docs/blocks';
+import { fn } from 'storybook/test';
+import { TableHeader } from './TableHeader';
+import { TableControls } from './tableControls/TableControls';
+// ---------------------------------------------------------------------------
+// Docs page content
+// ---------------------------------------------------------------------------
+const DESCRIPTION_INTRO = [
+    '`TableHeader` is the pre-composed header slot for the Arbor data table.',
+    'It renders a `<header>` element and accepts any `children` (typically a `<TableControls />` element)',
+    'plus an optional built-in `<SearchBar />` via the `hasSearch` prop.',
+    '',
+    'Pass the entire `<TableHeader />` element as the `headerContent` prop of `<Table />`.',
+].join('\n');
+const USAGE_GUIDANCE = [
+    '### When to use',
+    '',
+    '- As the `headerContent` of a `<Table />` when you need a standard header region',
+    '- When you want to combine a toolbar (`<TableControls />`) with a search bar in one slot',
+    '- When you need custom header content that is not covered by `<TableControls />`',
+    '',
+    '---',
+    '',
+    '### When NOT to use',
+    '',
+    '| Situation | Alternative |',
+    '|---|---|',
+    '| You only need a toolbar | Pass `<TableControls />` directly as `headerContent` |',
+    '| You only need a search bar | Pass `<SearchBar />` directly as `headerContent` |',
+    '| The table has no header | Omit `headerContent` entirely |',
+    '',
+    '---',
+    '',
+    '### Props summary',
+    '',
+    '| Prop | Description |',
+    '|---|---|',
+    '| `children` | Content rendered before the `SearchBar` — typically `<TableControls />` |',
+    '| `hasSearch` | When `true`, renders a `<SearchBar />` at the end of the header |',
+    '| `searchValue` | Controlled value for the `SearchBar` |',
+    '| `setSearchValue` | Called with the new search string when the user types |',
+].join('\n');
+const DEVELOPER_NOTES = [
+    '### Wiring into `<Table />`',
+    '',
+    '```tsx',
+    "import { useState } from 'react';",
+    "import { Table, TableHeader, TableControls } from '@arbor-education/design-system.components';",
+    '',
+    'function MyTable() {',
+    "  const [search, setSearch] = useState('');",
+    '',
+    '  return (',
+    '    <Table',
+    '      rowData={rows}',
+    '      columnDefs={colDefs}',
+    '      quickFilterText={search}',
+    '      headerContent={(',
+    '        <TableHeader hasSearch searchValue={search} setSearchValue={setSearch}>',
+    '          <TableControls',
+    '            onUndo={handleUndo}',
+    '            onDownload={handleDownload}',
+    '            showSettings',
+    '          />',
+    '        </TableHeader>',
+    '      )}',
+    '    />',
+    '  );',
+    '}',
+    '```',
+    '',
+    '---',
+    '',
+    '### `hasSearch` vs passing `<SearchBar />` directly',
+    '',
+    'Both approaches are equivalent. `TableHeader` with `hasSearch` is more concise when you already',
+    'have `TableHeader` for the `children` slot. If you only need a search bar and no other header',
+    'content, pass `<SearchBar />` directly as `headerContent` without wrapping it in `TableHeader`.',
+].join('\n');
+const RELATED_COMPONENTS = [
+    '## Related components',
+    '',
+    '[Table](?path=/docs/components-table--docs) · [TableControls](?path=/docs/components-table-tablecontrols--docs) · [TableFooter](?path=/docs/components-table-tablefooter--docs) · [SearchBar](?path=/docs/components-searchbar--docs)',
+].join('\n');
+const PROPS_INTRO = 'The preview below is wired to the **Controls** panel — toggle `hasSearch` to add or remove the search bar.';
+// ---------------------------------------------------------------------------
+// Custom DocsPage
+// ---------------------------------------------------------------------------
+function TableHeaderDocsPage() {
+    return (_jsxs(_Fragment, { children: [_jsx(Title, {}), _jsx(Subtitle, {}), _jsx(Markdown, { children: DESCRIPTION_INTRO }), _jsx(DocHeading, { children: "Interactive example" }), _jsx(Markdown, { children: PROPS_INTRO }), _jsx(DocPrimary, {}), _jsx(Controls, {}), _jsx(DocHeading, { children: "Usage guidance" }), _jsx(Markdown, { children: USAGE_GUIDANCE }), _jsx(DocHeading, { children: "Developer notes" }), _jsx(Markdown, { children: DEVELOPER_NOTES }), _jsx(DocHeading, { children: "Examples" }), _jsx(Stories, { title: "" }), _jsx(Markdown, { children: RELATED_COMPONENTS })] }));
+}
+// ---------------------------------------------------------------------------
+// Meta
+// ---------------------------------------------------------------------------
+const meta = {
+    title: 'Components/Table/TableHeader',
+    component: TableHeader,
+    tags: ['autodocs'],
+    parameters: {
+        layout: 'padded',
+        docs: { page: TableHeaderDocsPage },
+    },
+    argTypes: {
+        children: {
+            description: 'Content rendered inside the header before the `SearchBar`. Typically a `<TableControls />` element.',
+            control: false,
+            table: { type: { summary: 'ReactNode' }, defaultValue: { summary: 'undefined' } },
+        },
+        hasSearch: {
+            description: 'When `true`, renders a `<SearchBar />` at the end of the header.',
+            control: 'boolean',
+            table: { type: { summary: 'boolean' }, defaultValue: { summary: 'false' } },
+        },
+        searchValue: {
+            description: 'Controlled value for the `SearchBar`. Only used when `hasSearch` is `true`.',
+            control: 'text',
+            table: { type: { summary: 'string' }, defaultValue: { summary: 'undefined' } },
+        },
+        setSearchValue: {
+            description: 'Called with the new search string when the user types. Only used when `hasSearch` is `true`.',
+            control: false,
+            table: { type: { summary: '(searchValue: string) => void' }, defaultValue: { summary: 'undefined' } },
+        },
+        className: {
+            description: 'Additional CSS class name(s) to apply to the root `<header>` element.',
+            control: 'text',
+            table: { type: { summary: 'string' }, defaultValue: { summary: 'undefined' } },
+        },
+    },
+    args: {
+        setSearchValue: fn(),
+    },
+};
+export default meta;
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+const withDescription = (story, description) => ({
+    ...story,
+    parameters: {
+        ...story.parameters,
+        docs: { ...story.parameters?.docs, description: { story: description } },
+    },
+});
+// ---------------------------------------------------------------------------
+// Stories
+// ---------------------------------------------------------------------------
+export const Default = withDescription({
+    args: {
+        hasSearch: false,
+        children: (_jsx(TableControls, { onUndo: fn(), onRedo: fn(), onDownload: fn(), showSettings: true, onHelp: fn(), onExpandToggle: fn() })),
+    },
+}, 'The interactive canvas — `TableHeader` wrapping a `<TableControls />` element, which is the canonical usage. '
+    + 'Toggle `hasSearch` in the Controls panel to add the built-in `SearchBar`.');
+export const WithSearch = withDescription({
+    parameters: { controls: { disable: true } },
+    render: () => {
+        const [search, setSearch] = React.useState('');
+        return (_jsx(TableHeader, { hasSearch: true, searchValue: search, setSearchValue: setSearch, children: _jsx(TableControls, { onUndo: fn(), onRedo: fn(), onDownload: fn(), showSettings: true }) }));
+    },
+}, '`hasSearch={true}` adds a `SearchBar` at the end of the header. '
+    + '`searchValue` and `setSearchValue` give you controlled access to the search string — '
+    + "pass it as `quickFilterText` to `<Table />` to drive AG Grid's built-in text filtering.");
+export const ChildrenOnly = withDescription({
+    parameters: { controls: { disable: true } },
+    args: {
+        children: (_jsx(TableControls, { bulkActions: [
+                { displayName: 'Export selected', callback: fn() },
+                { displayName: 'Delete selected', callback: fn(), disabled: true },
+            ], onUndo: fn(), onRedo: fn() })),
+    },
+}, 'The header slot with only `children` — no built-in search bar. '
+    + 'Any `ReactNode` is accepted as `children`; `<TableControls />` is the most common choice.');
+//# sourceMappingURL=TableHeader.stories.js.map

package/dist/components/table/TableHeader.stories.js.map

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

package/dist/components/table/cellEditors/DateCellEditor.stories.d.ts

@@ -0,0 +1,44 @@
+import type { StoryObj } from '@storybook/react-vite';
+import type { CustomCellEditorProps } from 'ag-grid-react';
+import { DateCellEditor } from './DateCellEditor';
+declare function DateCellEditorDocsPage(): import("react/jsx-runtime").JSX.Element;
+declare const meta: {
+    title: string;
+    component: (props: CustomCellEditorProps) => import("react/jsx-runtime").JSX.Element;
+    tags: string[];
+    parameters: {
+        layout: string;
+        docs: {
+            page: typeof DateCellEditorDocsPage;
+        };
+    };
+    argTypes: {
+        value: {
+            description: string;
+            control: false;
+            table: {
+                type: {
+                    summary: string;
+                };
+                defaultValue: {
+                    summary: string;
+                };
+            };
+        };
+        onValueChange: {
+            description: string;
+            control: false;
+            table: {
+                type: {
+                    summary: string;
+                };
+            };
+        };
+    };
+};
+export default meta;
+type Story = StoryObj<typeof DateCellEditor>;
+export declare const Default: Story;
+export declare const WithExistingDate: Story;
+export declare const InATable: Story;
+//# sourceMappingURL=DateCellEditor.stories.d.ts.map

package/dist/components/table/cellEditors/DateCellEditor.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateCellEditor.stories.d.ts","sourceRoot":"","sources":["../../../../src/components/table/cellEditors/DateCellEditor.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAW5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAuElD,iBAAS,sBAAsB,4CAiB9B;AAgBD,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB6B,CAAC;AAExC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,cAAc,CAAC,CAAC;AAc7C,eAAO,MAAM,OAAO,EAAE,KAKrB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAM9B,CAAC;AASF,eAAO,MAAM,QAAQ,EAAE,KAqEtB,CAAC"}

package/dist/components/table/cellEditors/DateCellEditor.stories.js

@@ -0,0 +1,186 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Controls, Heading as DocHeading, Markdown, Primary as DocPrimary, Stories, Subtitle, Title, } from '@storybook/addon-docs/blocks';
+import { fn } from 'storybook/test';
+import { DateCellEditor } from './DateCellEditor';
+import { Table } from '../../table/Table';
+// ---------------------------------------------------------------------------
+// Docs page content
+// ---------------------------------------------------------------------------
+const DESCRIPTION_INTRO = [
+    '`DateCellEditor` is an AG Grid cell editor component that renders an Arbor `DatePicker` inside a table cell.',
+    'It is invoked when a user begins editing a date column (e.g. by pressing Enter or double-clicking the cell).',
+    '',
+    'Register it via the AG Grid `cellEditor` column definition property.',
+].join('\n');
+const USAGE_GUIDANCE = [
+    '### When to use',
+    '',
+    '- On date columns that need an inline date-picker editor',
+    '- When users should be able to edit a date value directly in the table without leaving the row',
+    '',
+    '---',
+    '',
+    '### Registration',
+    '',
+    '```tsx',
+    "import { DateCellEditor } from '@arbor-education/design-system.components';",
+    '',
+    'const colDefs = [',
+    '  {',
+    "    field: 'dob',",
+    "    headerName: 'Date of birth',",
+    '    cellEditor: DateCellEditor,',
+    '    // or via string key:',
+    "    cellEditor: 'dsDateCellEditor',",
+    '  },',
+    '];',
+    '```',
+    '',
+    '---',
+    '',
+    '### `cellEditorParams`',
+    '',
+    'Any additional props to pass to the underlying `DatePicker` can be provided via `cellEditorParams`:',
+    '',
+    '```tsx',
+    'cellEditorParams: {',
+    "  placeholder: 'dd/mm/yyyy',",
+    '  disabled: false,',
+    '},',
+    '```',
+    '',
+    '---',
+    '',
+    '### Value format',
+    '',
+    'The `value` and `onValueChange` use the same date format as the Arbor `DatePicker`.',
+    'Refer to the [DatePicker docs](?path=/docs/components-datepicker--docs) for format details.',
+].join('\n');
+const RELATED_COMPONENTS = [
+    '## Related components',
+    '',
+    '[Table](?path=/docs/components-table--docs) · [DatePicker](?path=/docs/components-datepicker--docs)',
+].join('\n');
+const PROPS_INTRO = 'The preview below shows `DateCellEditor` rendering the Arbor `DatePicker` with a pre-set date value. In a real table this component is mounted by AG Grid when the user begins editing a date cell.';
+// ---------------------------------------------------------------------------
+// Custom DocsPage
+// ---------------------------------------------------------------------------
+function DateCellEditorDocsPage() {
+    return (_jsxs(_Fragment, { children: [_jsx(Title, {}), _jsx(Subtitle, {}), _jsx(Markdown, { children: DESCRIPTION_INTRO }), _jsx(DocHeading, { children: "Interactive example" }), _jsx(Markdown, { children: PROPS_INTRO }), _jsx(DocPrimary, {}), _jsx(Controls, {}), _jsx(DocHeading, { children: "Usage guidance" }), _jsx(Markdown, { children: USAGE_GUIDANCE }), _jsx(DocHeading, { children: "Examples" }), _jsx(Stories, { title: "" }), _jsx(Markdown, { children: RELATED_COMPONENTS })] }));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const makeEditorProps = (value) => ({
+    value,
+    onValueChange: fn(),
+    colDef: { cellEditorParams: {} },
+});
+// ---------------------------------------------------------------------------
+// Meta
+// ---------------------------------------------------------------------------
+const meta = {
+    title: 'Components/Table/CellEditors/DateCellEditor',
+    component: DateCellEditor,
+    tags: ['autodocs'],
+    parameters: {
+        layout: 'padded',
+        docs: { page: DateCellEditorDocsPage },
+    },
+    argTypes: {
+        value: {
+            description: 'The current date value of the cell being edited. Format matches the Arbor `DatePicker` value format.',
+            control: false,
+            table: { type: { summary: 'string' }, defaultValue: { summary: 'undefined' } },
+        },
+        onValueChange: {
+            description: 'Called by AG Grid when the editor value changes. Receives the new date value.',
+            control: false,
+            table: { type: { summary: '(value: string) => void' } },
+        },
+    },
+};
+export default meta;
+const withDescription = (story, description) => ({
+    ...story,
+    parameters: {
+        ...story.parameters,
+        docs: { ...story.parameters?.docs, description: { story: description } },
+    },
+});
+// ---------------------------------------------------------------------------
+// Stories
+// ---------------------------------------------------------------------------
+export const Default = withDescription({
+    render: () => _jsx(DateCellEditor, { ...makeEditorProps(undefined) }),
+}, 'The `DateCellEditor` with no initial value — renders an empty `DatePicker` ready for input.');
+export const WithExistingDate = withDescription({
+    parameters: { controls: { disable: true } },
+    render: () => _jsx(DateCellEditor, { ...makeEditorProps(new Date('2024-09-01')) }),
+}, 'Pre-populated with an existing date value. In a table, AG Grid passes the cell\'s current value as `value` when the editor opens.');
+const DATE_EDITOR_IN_TABLE_DATA = [
+    { name: 'Alice Johnson', dateOfBirth: new Date(1990, 0, 15) },
+    { name: 'Bob Smith', dateOfBirth: new Date(1985, 5, 20) },
+    { name: 'Charlie Brown', dateOfBirth: new Date(1992, 10, 3) },
+    { name: 'Diana Prince', dateOfBirth: new Date(1988, 3, 12) },
+];
+export const InATable = withDescription({
+    parameters: {
+        controls: { disable: true },
+        docs: {
+            source: {
+                language: 'tsx',
+                code: `
+import { Table } from '@arbor-education/design-system.components';
+
+const rowData = [
+  { name: 'Alice Johnson', dateOfBirth: new Date(1990, 0, 15) },
+  { name: 'Bob Smith', dateOfBirth: new Date(1985, 5, 20) },
+  { name: 'Charlie Brown', dateOfBirth: new Date(1992, 10, 3) },
+  { name: 'Diana Prince', dateOfBirth: new Date(1988, 3, 12) },
+];
+
+function DateCellEditorExample() {
+  return (
+    <Table
+      rowData={rowData}
+      columnDefs={[
+        { field: 'name', headerName: 'Name', flex: 2, editable: false },
+        {
+          field: 'dateOfBirth',
+          headerName: 'Date of birth',
+          flex: 1,
+          editable: true,
+          cellEditor: 'dsDateCellEditor',
+          valueFormatter: (params) =>
+            params.value instanceof Date
+              ? params.value.toLocaleDateString('en-GB')
+              : params.value,
+        },
+      ]}
+      defaultColDef={{ flex: 1, minWidth: 120 }}
+      domLayout="autoHeight"
+    />
+  );
+}
+
+export default DateCellEditorExample;
+`.trim(),
+            },
+        },
+    },
+    render: () => (_jsx(Table, { rowData: DATE_EDITOR_IN_TABLE_DATA, columnDefs: [
+            { field: 'name', headerName: 'Name', flex: 2, editable: false },
+            {
+                field: 'dateOfBirth',
+                headerName: 'Date of birth',
+                flex: 1,
+                editable: true,
+                cellEditor: 'dsDateCellEditor',
+                valueFormatter: params => params.value instanceof Date
+                    ? params.value.toLocaleDateString('en-GB')
+                    : params.value,
+            },
+        ], defaultColDef: { flex: 1, minWidth: 120 }, domLayout: "autoHeight" })),
+}, '`dsDateCellEditor` wired up inside a full `Table`. Double-click (or press F2/Enter) on a Date of birth cell to open the `DatePicker` editor — AG Grid mounts the editor component and passes the current cell value as `value`. The `valueFormatter` formats the stored `Date` object as a localised string for display.');
+//# sourceMappingURL=DateCellEditor.stories.js.map