@chenzy-design/svelte 0.1.0

package/dist/input-number/InputNumber.svelte.d.ts

@@ -0,0 +1,79 @@
+import type { Snippet } from 'svelte';
+import { type BoundaryMode } from '@chenzy-design/core';
+type Size = 'small' | 'default' | 'large';
+type Status = 'default' | 'warning' | 'error';
+type ControlsPosition = 'right' | 'sides';
+interface Props {
+    value?: number | null;
+    defaultValue?: number | null;
+    min?: number;
+    max?: number;
+    step?: number;
+    shiftStep?: number;
+    precision?: number;
+    /** 越界处理：clamp 钳制 / strict 拒绝回滚 */
+    boundaryMode?: BoundaryMode;
+    size?: Size;
+    disabled?: boolean;
+    readonly?: boolean;
+    status?: Status;
+    controls?: boolean;
+    /** 步进按钮布局：right 右侧 stacked / sides 两侧 */
+    controlsPosition?: ControlsPosition;
+    /** 步进按钮内嵌悬浮（hover/focus 显形） */
+    innerButtons?: boolean;
+    keyboard?: boolean;
+    /** 聚焦时滚轮步进 */
+    mouseWheel?: boolean;
+    placeholder?: string;
+    /** 输入框前置内容（如货币符号 ¥、单位）；传 Snippet 可自定义渲染 */
+    prefix?: string | Snippet;
+    /** 输入框后置内容（如单位 %、kg）；传 Snippet 可自定义渲染 */
+    suffix?: string | Snippet;
+    name?: string;
+    /** input 元素 id，关联外部 label；不传自动生成 */
+    id?: string;
+    ariaLabel?: string;
+    /** 挂载自动聚焦 */
+    autofocus?: boolean;
+    /** 聚焦时全选文本 */
+    selectOnFocus?: boolean;
+    /** 数字格式化 locale，传给内部 Intl（仅未提供 formatter 时生效） */
+    locale?: string;
+    /** 自定义显示格式化（仅非编辑态） */
+    formatter?: (n: number) => string;
+    /** 自定义解析（与 formatter 对应） */
+    parser?: (s: string) => number;
+    onChange?: (v: number | null) => void;
+    /** 触达/试图越过边界 */
+    onBoundaryHit?: (e: {
+        boundary: 'min' | 'max';
+        value: number;
+    }) => void;
+    /** 任一步进动作完成（按钮 / 键盘 / 滚轮） */
+    onStep?: (e: {
+        value: number;
+        direction: 'up' | 'down';
+        source: 'button' | 'keyboard' | 'wheel';
+    }) => void;
+    /** 聚焦 */
+    onFocus?: (e: FocusEvent) => void;
+    /** 失焦（已完成 commit 归一化） */
+    onBlur?: (e: FocusEvent) => void;
+    /** 透传原生 keydown（便于扩展，如 Enter 提交表单） */
+    onKeydown?: (e: KeyboardEvent) => void;
+    /** 无边框模式 */
+    borderless?: boolean;
+    /** 显示清除按钮（有值时出现 ×） */
+    showClear?: boolean;
+    /** 自定义清除图标 */
+    clearIcon?: Snippet;
+    /** 点击 +/- 按钮后保持输入框聚焦（默认 false） */
+    keepFocus?: boolean;
+    /** 携带 number 类型的变化回调（区别于 onChange 返回 number | null） */
+    onNumberChange?: (value: number | null) => void;
+}
+declare const InputNumber: import("svelte").Component<Props, {}, "value">;
+type InputNumber = ReturnType<typeof InputNumber>;
+export default InputNumber;
+//# sourceMappingURL=InputNumber.svelte.d.ts.map

package/dist/input-number/InputNumber.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputNumber.svelte.d.ts","sourceRoot":"","sources":["../../src/input-number/InputNumber.svelte.ts"],"names":[],"mappings":"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"}

package/dist/input-number/InputNumberKbdFixture.svelte

@@ -0,0 +1,15 @@
+<!--
+  仅供 InputNumber.kbd.test.ts（browser project）使用的键盘 e2e 夹具。
+  InputNumber 焦点落在原生 <input role="spinbutton">：↑ 步进 +step、↓ -step、
+  PageUp/PageDown 大步进，aria-valuenow 真实变化（钳到 min/max）。
+  before 按钮验证 Tab 真实聚焦到 spinbutton。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import InputNumber from './InputNumber.svelte';
+</script>
+
+<LocaleProvider locale="en_US">
+  <button type="button" data-testid="before">before</button>
+  <InputNumber defaultValue={5} min={0} max={100} step={1} ariaLabel="Quantity" />
+</LocaleProvider>

package/dist/input-number/InputNumberKbdFixture.svelte.d.ts

@@ -0,0 +1,19 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const InputNumberKbdFixture: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type InputNumberKbdFixture = InstanceType<typeof InputNumberKbdFixture>;
+export default InputNumberKbdFixture;
+//# sourceMappingURL=InputNumberKbdFixture.svelte.d.ts.map

package/dist/input-number/InputNumberKbdFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputNumberKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/input-number/InputNumberKbdFixture.svelte.ts"],"names":[],"mappings":"AAmBA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,qBAAqB;;kBAA+E,CAAC;AACzF,KAAK,qBAAqB,GAAG,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC1E,eAAe,qBAAqB,CAAC"}

package/dist/input-number/index.d.ts

@@ -0,0 +1,3 @@
+export { default as InputNumber } from './InputNumber.svelte';
+export { meta as inputNumberMeta } from './meta.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/input-number/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/input-number/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/input-number/index.js

@@ -0,0 +1,2 @@
+export { default as InputNumber } from './InputNumber.svelte';
+export { meta as inputNumberMeta } from './meta.js';

package/dist/input-number/meta.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "InputNumber";
+    readonly category: "input";
+    readonly description: "受约束的数值录入框，含步进按钮、键盘步进、精度与范围 clamp，复用 Input 视觉。";
+    readonly props: readonly [{
+        readonly name: "value";
+        readonly type: "number | null";
+        readonly default: "undefined";
+        readonly desc: "受控值；提供则为受控";
+    }, {
+        readonly name: "defaultValue";
+        readonly type: "number | null";
+        readonly default: "null";
+        readonly desc: "非受控初始值";
+    }, {
+        readonly name: "min";
+        readonly type: "number";
+        readonly default: "-Infinity";
+    }, {
+        readonly name: "max";
+        readonly type: "number";
+        readonly default: "Infinity";
+    }, {
+        readonly name: "step";
+        readonly type: "number";
+        readonly default: "1";
+    }, {
+        readonly name: "shiftStep";
+        readonly type: "number";
+        readonly default: "step * 10";
+        readonly desc: "Shift+↑↓ 步长";
+    }, {
+        readonly name: "precision";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "失焦四舍五入保留小数位";
+    }, {
+        readonly name: "boundaryMode";
+        readonly type: "'clamp'|'strict'";
+        readonly default: "clamp";
+        readonly desc: "越界处理：钳制 / 拒绝回滚";
+    }, {
+        readonly name: "formatter";
+        readonly type: "(n: number) => string";
+        readonly default: "undefined";
+        readonly desc: "自定义显示格式化（仅非编辑态）";
+    }, {
+        readonly name: "parser";
+        readonly type: "(s: string) => number";
+        readonly default: "undefined";
+        readonly desc: "自定义解析";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "default";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "readonly";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "status";
+        readonly type: "'default'|'warning'|'error'";
+        readonly default: "default";
+    }, {
+        readonly name: "controls";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示步进按钮";
+    }, {
+        readonly name: "controlsPosition";
+        readonly type: "'right'|'sides'";
+        readonly default: "right";
+        readonly desc: "步进按钮布局：右侧 stacked / 两侧";
+    }, {
+        readonly name: "innerButtons";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "按钮内嵌悬浮（hover/focus 显形）";
+    }, {
+        readonly name: "keyboard";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否启用 ↑↓/PageUp·Down 步进";
+    }, {
+        readonly name: "mouseWheel";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "聚焦时滚轮步进";
+    }, {
+        readonly name: "placeholder";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "prefix";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "输入框前置内容（如货币符号、单位）";
+    }, {
+        readonly name: "suffix";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "输入框后置内容（如单位 %、kg）";
+    }, {
+        readonly name: "name";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "id";
+        readonly type: "string";
+        readonly default: "自动生成";
+        readonly desc: "input 元素 id，关联外部 label";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "autofocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "挂载自动聚焦";
+    }, {
+        readonly name: "selectOnFocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "聚焦时全选文本";
+    }, {
+        readonly name: "locale";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "数字格式化 locale（仅未提供 formatter 时生效）";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(v: number | null) => void";
+        readonly default: "undefined";
+        readonly desc: "归一化后值变化";
+    }, {
+        readonly name: "onBoundaryHit";
+        readonly type: "(e: { boundary: 'min'|'max'; value: number }) => void";
+        readonly default: "undefined";
+        readonly desc: "触达/试图越过边界";
+    }];
+    readonly events: readonly [{
+        readonly name: "change";
+        readonly payload: "{ value: number | null }";
+        readonly desc: "归一化后值变化（受控核心事件）";
+    }, {
+        readonly name: "boundaryHit";
+        readonly payload: "{ boundary: 'min'|'max'; value: number }";
+        readonly desc: "触达/试图越过边界";
+    }, {
+        readonly name: "step";
+        readonly payload: "{ value: number; direction: 'up'|'down'; source: 'button'|'keyboard'|'wheel' }";
+        readonly desc: "任一步进动作完成";
+    }, {
+        readonly name: "focus";
+        readonly payload: "FocusEvent";
+        readonly desc: "聚焦";
+    }, {
+        readonly name: "blur";
+        readonly payload: "FocusEvent";
+        readonly desc: "失焦（已完成 commit 归一化）";
+    }, {
+        readonly name: "keydown";
+        readonly payload: "KeyboardEvent";
+        readonly desc: "透传原生 keydown";
+    }];
+    readonly a11y: {
+        readonly role: "spinbutton";
+        readonly keyboard: readonly ["ArrowUp", "ArrowDown", "Shift+ArrowUp", "Shift+ArrowDown", "PageUp", "PageDown", "Enter"];
+        readonly notes: readonly ["input role=spinbutton + aria-valuenow/valuemin/valuemax", "失焦按 precision 四舍五入并 clamp 到 [min,max]", "到 min/max 时对应步进按钮 disabled", "步进按钮 tabindex=-1，mousedown.preventDefault 不夺焦", "disabled→aria-disabled，readonly→aria-readonly，error→aria-invalid"];
+    };
+    readonly tokens: readonly ["--cd-input-*", "--cd-color-*", "--cd-spacing-*", "--cd-focus-ring", "--cd-motion-*"];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/input-number/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/input-number/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DP,CAAC"}

package/dist/input-number/meta.js

@@ -0,0 +1,65 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export const meta = {
+    name: 'InputNumber',
+    category: 'input',
+    description: '受约束的数值录入框，含步进按钮、键盘步进、精度与范围 clamp，复用 Input 视觉。',
+    props: [
+        { name: 'value', type: 'number | null', default: 'undefined', desc: '受控值；提供则为受控' },
+        { name: 'defaultValue', type: 'number | null', default: 'null', desc: '非受控初始值' },
+        { name: 'min', type: 'number', default: '-Infinity' },
+        { name: 'max', type: 'number', default: 'Infinity' },
+        { name: 'step', type: 'number', default: '1' },
+        { name: 'shiftStep', type: 'number', default: 'step * 10', desc: 'Shift+↑↓ 步长' },
+        { name: 'precision', type: 'number', default: 'undefined', desc: '失焦四舍五入保留小数位' },
+        { name: 'boundaryMode', type: "'clamp'|'strict'", default: 'clamp', desc: '越界处理：钳制 / 拒绝回滚' },
+        { name: 'formatter', type: '(n: number) => string', default: 'undefined', desc: '自定义显示格式化（仅非编辑态）' },
+        { name: 'parser', type: '(s: string) => number', default: 'undefined', desc: '自定义解析' },
+        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
+        { name: 'disabled', type: 'boolean', default: 'false' },
+        { name: 'readonly', type: 'boolean', default: 'false' },
+        { name: 'status', type: "'default'|'warning'|'error'", default: 'default' },
+        { name: 'controls', type: 'boolean', default: 'true', desc: '是否显示步进按钮' },
+        { name: 'controlsPosition', type: "'right'|'sides'", default: 'right', desc: '步进按钮布局：右侧 stacked / 两侧' },
+        { name: 'innerButtons', type: 'boolean', default: 'false', desc: '按钮内嵌悬浮（hover/focus 显形）' },
+        { name: 'keyboard', type: 'boolean', default: 'true', desc: '是否启用 ↑↓/PageUp·Down 步进' },
+        { name: 'mouseWheel', type: 'boolean', default: 'false', desc: '聚焦时滚轮步进' },
+        { name: 'placeholder', type: 'string', default: 'undefined' },
+        { name: 'prefix', type: 'string | Snippet', default: 'undefined', desc: '输入框前置内容（如货币符号、单位）' },
+        { name: 'suffix', type: 'string | Snippet', default: 'undefined', desc: '输入框后置内容（如单位 %、kg）' },
+        { name: 'name', type: 'string', default: 'undefined' },
+        { name: 'id', type: 'string', default: '自动生成', desc: 'input 元素 id，关联外部 label' },
+        { name: 'ariaLabel', type: 'string', default: 'undefined' },
+        { name: 'autofocus', type: 'boolean', default: 'false', desc: '挂载自动聚焦' },
+        { name: 'selectOnFocus', type: 'boolean', default: 'false', desc: '聚焦时全选文本' },
+        { name: 'locale', type: 'string', default: 'undefined', desc: '数字格式化 locale（仅未提供 formatter 时生效）' },
+        { name: 'onChange', type: '(v: number | null) => void', default: 'undefined', desc: '归一化后值变化' },
+        { name: 'onBoundaryHit', type: "(e: { boundary: 'min'|'max'; value: number }) => void", default: 'undefined', desc: '触达/试图越过边界' },
+    ],
+    events: [
+        { name: 'change', payload: '{ value: number | null }', desc: '归一化后值变化（受控核心事件）' },
+        { name: 'boundaryHit', payload: "{ boundary: 'min'|'max'; value: number }", desc: '触达/试图越过边界' },
+        {
+            name: 'step',
+            payload: "{ value: number; direction: 'up'|'down'; source: 'button'|'keyboard'|'wheel' }",
+            desc: '任一步进动作完成',
+        },
+        { name: 'focus', payload: 'FocusEvent', desc: '聚焦' },
+        { name: 'blur', payload: 'FocusEvent', desc: '失焦（已完成 commit 归一化）' },
+        { name: 'keydown', payload: 'KeyboardEvent', desc: '透传原生 keydown' },
+    ],
+    a11y: {
+        role: 'spinbutton',
+        keyboard: ['ArrowUp', 'ArrowDown', 'Shift+ArrowUp', 'Shift+ArrowDown', 'PageUp', 'PageDown', 'Enter'],
+        notes: [
+            'input role=spinbutton + aria-valuenow/valuemin/valuemax',
+            '失焦按 precision 四舍五入并 clamp 到 [min,max]',
+            '到 min/max 时对应步进按钮 disabled',
+            '步进按钮 tabindex=-1，mousedown.preventDefault 不夺焦',
+            'disabled→aria-disabled，readonly→aria-readonly，error→aria-invalid',
+        ],
+    },
+    tokens: ['--cd-input-*', '--cd-color-*', '--cd-spacing-*', '--cd-focus-ring', '--cd-motion-*'],
+};

package/dist/layout/Content.svelte

@@ -0,0 +1,37 @@
+<!--
+  Content — main region within Layout. Grows to fill, token-driven background.
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    /** true→token padding; number→px; string→raw; false→0 */
+    padding?: string | number | boolean;
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { padding = false, class: className = '', children }: Props = $props();
+
+  const paddingCss = $derived.by(() => {
+    if (padding === true) return 'var(--cd-layout-content-padding)';
+    if (padding === false) return '0';
+    return typeof padding === 'number' ? `${padding}px` : padding;
+  });
+
+  const cls = $derived(['cd-layout-content', className].filter(Boolean).join(' '));
+
+  const inlineStyle = $derived(`padding:${paddingCss}`);
+</script>
+
+<main class={cls} style={inlineStyle}>
+  {@render children?.()}
+</main>
+
+<style>
+  .cd-layout-content {
+    flex: 1;
+    min-height: 0;
+    background: var(--cd-layout-content-bg);
+  }
+</style>

package/dist/layout/Content.svelte.d.ts

@@ -0,0 +1,11 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    /** true→token padding; number→px; string→raw; false→0 */
+    padding?: string | number | boolean;
+    class?: string;
+    children?: Snippet;
+}
+declare const Content: import("svelte").Component<Props, {}, "">;
+type Content = ReturnType<typeof Content>;
+export default Content;
+//# sourceMappingURL=Content.svelte.d.ts.map

package/dist/layout/Content.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Content.svelte.d.ts","sourceRoot":"","sources":["../../src/layout/Content.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGpC,UAAU,KAAK;IACb,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA2BH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/layout/Footer.svelte

@@ -0,0 +1,49 @@
+<!--
+  Footer — bottom bar within Layout. Token-driven background/color.
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    sticky?: boolean;
+    /** override height; number→px, string→raw */
+    height?: string | number;
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { sticky = false, height, class: className = '', children }: Props = $props();
+
+  const heightCss = $derived.by(() => {
+    if (height === undefined) return undefined;
+    return typeof height === 'number' ? `${height}px` : height;
+  });
+
+  const cls = $derived(
+    ['cd-layout-footer', sticky && 'cd-layout-footer--sticky', className].filter(Boolean).join(' '),
+  );
+
+  const inlineStyle = $derived(heightCss ? `height:${heightCss}` : undefined);
+</script>
+
+<footer class={cls} style={inlineStyle}>
+  {@render children?.()}
+</footer>
+
+<style>
+  .cd-layout-footer {
+    display: flex;
+    flex: 0 0 auto;
+    align-items: center;
+    justify-content: center;
+    padding-block: var(--cd-spacing-4);
+    padding-inline: var(--cd-spacing-6);
+    background: var(--cd-layout-footer-bg);
+    color: var(--cd-layout-footer-color);
+    text-align: center;
+  }
+  .cd-layout-footer--sticky {
+    position: sticky;
+    inset-block-end: 0;
+  }
+</style>

package/dist/layout/Footer.svelte.d.ts

@@ -0,0 +1,12 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    sticky?: boolean;
+    /** override height; number→px, string→raw */
+    height?: string | number;
+    class?: string;
+    children?: Snippet;
+}
+declare const Footer: import("svelte").Component<Props, {}, "">;
+type Footer = ReturnType<typeof Footer>;
+export default Footer;
+//# sourceMappingURL=Footer.svelte.d.ts.map

package/dist/layout/Footer.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Footer.svelte.d.ts","sourceRoot":"","sources":["../../src/layout/Footer.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGpC,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA4BH,QAAA,MAAM,MAAM,2CAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}

package/dist/layout/Header.svelte

@@ -0,0 +1,46 @@
+<!--
+  Header — top bar within Layout. Token-driven background/height.
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    sticky?: boolean;
+    /** override token height; number→px, string→raw */
+    height?: string | number;
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { sticky = false, height, class: className = '', children }: Props = $props();
+
+  const heightCss = $derived.by(() => {
+    if (height === undefined) return undefined;
+    return typeof height === 'number' ? `${height}px` : height;
+  });
+
+  const cls = $derived(
+    ['cd-layout-header', sticky && 'cd-layout-header--sticky', className].filter(Boolean).join(' '),
+  );
+
+  const inlineStyle = $derived(heightCss ? `height:${heightCss}` : undefined);
+</script>
+
+<header class={cls} style={inlineStyle}>
+  {@render children?.()}
+</header>
+
+<style>
+  .cd-layout-header {
+    display: flex;
+    flex: 0 0 auto;
+    align-items: center;
+    height: var(--cd-layout-header-height);
+    background: var(--cd-layout-header-bg);
+  }
+  .cd-layout-header--sticky {
+    position: sticky;
+    inset-block-start: 0;
+    z-index: var(--cd-layout-header-z);
+  }
+</style>

package/dist/layout/Header.svelte.d.ts

@@ -0,0 +1,12 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    sticky?: boolean;
+    /** override token height; number→px, string→raw */
+    height?: string | number;
+    class?: string;
+    children?: Snippet;
+}
+declare const Header: import("svelte").Component<Props, {}, "">;
+type Header = ReturnType<typeof Header>;
+export default Header;
+//# sourceMappingURL=Header.svelte.d.ts.map

package/dist/layout/Header.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.svelte.d.ts","sourceRoot":"","sources":["../../src/layout/Header.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGpC,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA4BH,QAAA,MAAM,MAAM,2CAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}

package/dist/layout/Layout.a11y.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Layout.a11y.test.d.ts.map

package/dist/layout/Layout.a11y.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layout.a11y.test.d.ts","sourceRoot":"","sources":["../../src/layout/Layout.a11y.test.ts"],"names":[],"mappings":""}

package/dist/layout/Layout.a11y.test.js

@@ -0,0 +1,32 @@
+// Layout a11y：页面级布局骨架（section + header/main/footer/aside 语义元素）。
+// 纯布局，不引入额外 role；Sider collapsible 触发器为原生 button + aria-expanded/aria-controls/aria-label。
+import { describe, it, expect } from 'vitest';
+import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
+import LayoutFixture from './LayoutA11yFixture.svelte';
+describe('Layout a11y', () => {
+    it('默认渲染：语义布局元素齐全，无 axe violations', async () => {
+        const { container } = renderWithLocale(LayoutFixture, {});
+        expect(container.querySelector('section.cd-layout')).not.toBeNull();
+        expect(container.querySelector('header.cd-layout-header')).not.toBeNull();
+        expect(container.querySelector('main.cd-layout-content')).not.toBeNull();
+        expect(container.querySelector('footer.cd-layout-footer')).not.toBeNull();
+        expect(container.querySelector('aside.cd-layout-sider')).not.toBeNull();
+        await expectNoAxeViolations(container);
+    });
+    it('collapsible Sider：触发器 button aria-expanded/aria-controls/aria-label，无 axe violations', async () => {
+        const { container } = renderWithLocale(LayoutFixture, {
+            props: { collapsible: true },
+        });
+        const trigger = container.querySelector('button.cd-layout-sider__trigger');
+        expect(trigger).not.toBeNull();
+        // 展开态 aria-expanded=true。
+        expect(trigger?.getAttribute('aria-expanded')).toBe('true');
+        // aria-controls 指向 Sider id（不悬空）。
+        const controls = trigger?.getAttribute('aria-controls');
+        expect(controls).toBeTruthy();
+        expect(container.ownerDocument.getElementById(controls)).not.toBeNull();
+        // aria-label 来自 i18n（验证 LocaleProvider 管线）。
+        expect(trigger?.getAttribute('aria-label')).toBeTruthy();
+        await expectNoAxeViolations(container);
+    });
+});