@clderystd/m3-ui 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# @clderystd/m3-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+云术工作室的 Material Design 3 组件库。18 个 M3 组件 + 结构令牌 + useModal / v-ripple / v-reveal，
+不依赖任何第三方 UI 组件库。
+
+## 关键约定
+
+**配色由使用方注入。** 本包只带结构令牌（形状 / 字阶 / 海拔 / 动效 / 状态层），
+全部颜色走 `--md-sys-color-*` 这类语义变量。每个站点用自己的种子色生成配色表：
+
+```css
+/* 使用方自己的 m3-color-tokens.css */
+:root { --md-sys-color-primary: #0061a4; /* ... */ }
+.dark { --md-sys-color-primary: #9ecaff; /* ... */ }
+```
+
+这样官方站的蓝色、scforge 的橙色可以共存，而组件代码只有一份。
+
+**图标不绑定图标库。** `IconComponent` 就是 Vue 的 `Component`，
+unplugin-icons 生成的、手写 SFC、其他图标库的都能传。包里只内联了三个自己要用的小图标
+（check / close / expand-more）。
+
+## 使用
+
+```bash
+pnpm add @clderystd/m3-ui --registry=https://npm.pkg.github.com
+```
+
+```ts
+import { M3Button, M3Card, M3Dialog } from '@clderystd/m3-ui'
+import '@clderystd/m3-ui/style.css'   // 结构令牌 + 组件样式（不含配色）
+```
+
+`style.css` 要在**站点自己的配色之前**引入，方便站点覆盖。
+
+## 组件
+
+M3Avatar、M3Button、M3Card、M3Chip、M3Dialog、M3Divider、M3Fab、M3Icon、M3IconButton、
+M3List、M3ListItem、M3Menu、M3MenuItem、M3SegmentedButton、M3Sheet、M3Switch、M3Tooltip、M3TopAppBar。
+
+另导出 `vRipple`、`vReveal`、`useModal`、`IconCheck`、`IconClose`、`IconExpandMore`。
+
+## 本地联调
+
+站点用 `file:../m3-ui` 引用本包。**注意 pnpm 的 `file:` 是复制语义，不是软链**：
+改了组件源码后必须
+
+```bash
+pnpm build                          # 在 m3-ui 里重新构建
+cd ../identity-ui && pnpm install   # 让站点拿到新副本
+```
+
+只跑 `pnpm build` 而不 `pnpm install`，站点侧仍指向旧的 `dist` 副本
+（实测两份 `m3-ui.css` 时间戳会差几分钟，改了也不生效）。
+
+正式接入时应改用发布后的版本号（`@clderystd/m3-ui@^0.1.0`），
+那时升级用 `pnpm update`，行为符合预期。
+
+## 开发
+
+```bash
+pnpm build       # 产出 dist/index.js + dist/m3-ui.css + dist/*.d.ts
+pnpm typecheck
+```
+
+构建细节：
+
+- `vue` 是 peerDependency，不打进产物；
+- 类型由 `vite-plugin-dts` 生成后用 `scripts/flatten-dts.mjs` 摊平到 `dist/` 根
+  （**不要**开 `rollupTypes`，它会把 `.vue` 的类型全丢掉，产出空的 `index.d.ts`）；
+- CSS 独立成 `dist/m3-ui.css`，不在 JS 里自动注入。
+
+## 发布
+
+发布到 npm 公共 registry（registry.npmjs.org），包作用域是 `@cloudery`。
+
+1. 准备一个带 `read:packages` + `write:packages` 权限的 GitHub token（classic PAT 即可）；
+2. 写进 `~/.npmrc`（**不要**提交到仓库）：
+
+   ```
+   @cloudery:registry=https://npm.pkg.github.com
+   //npm.pkg.github.com/:_authToken=${NPM_TOKEN}
+   ```
+
+3. 设置环境变量后发布：
+
+   ```bash
+   $env:NPM_TOKEN = 'npm_xxx'      # PowerShell
+   pnpm publish                       # 会先跑 prepublishOnly -> build
+   ```
+
+`publishConfig.registry` 已固定到 GitHub Packages，`access: restricted`。
+改版本号用 `pnpm version patch|minor|major`（会自动打 tag）。

package/dist/components/M3Avatar.vue.d.ts

@@ -0,0 +1,20 @@
+type __VLS_Props = {
+    src?: string;
+    /** Accessible name; also used to derive fallback initials. */
+    name?: string;
+    alt?: string;
+    /** Diameter in px or any CSS length. */
+    size?: number | string;
+    /** Adds an outline ring, used for emphasis in member grids. */
+    ring?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    src: string;
+    name: string;
+    alt: string;
+    size: number | string;
+    ring: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    imageEl: HTMLImageElement;
+}, HTMLSpanElement>;
+export default _default;

package/dist/components/M3Button.vue.d.ts

@@ -0,0 +1,57 @@
+import { IconComponent } from '../icons';
+type ButtonVariant = 'filled' | 'tonal' | 'elevated' | 'outlined' | 'text';
+type ButtonSize = 'sm' | 'md' | 'lg';
+type __VLS_Props = {
+    /** MD3 button emphasis level. */
+    variant?: ButtonVariant;
+    /** MD3 button height: 32dp / 40dp / 56dp (extra large). */
+    size?: ButtonSize;
+    /** Optional leading icon. */
+    icon?: IconComponent | null;
+    /** Optional trailing icon. */
+    trailingIcon?: IconComponent | null;
+    disabled?: boolean;
+    /**
+     * Busy state: disables interaction and swaps the leading slot for a spinner while the
+     * label keeps its width, so the button never resizes mid-request.
+     * (Extension over the upstream copy — the identity flows submit over the network.)
+     */
+    loading?: boolean;
+    /** Renders an anchor instead of a button. */
+    href?: string;
+    target?: string;
+    rel?: string;
+    /** Native button type; ignored when href is set. */
+    type?: 'button' | 'submit' | 'reset';
+    /** Stretch to the container width. */
+    block?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: ButtonSize;
+    type: "button" | "submit" | "reset";
+    loading: boolean;
+    icon: IconComponent | null;
+    variant: ButtonVariant;
+    trailingIcon: IconComponent | null;
+    disabled: boolean;
+    href: string;
+    target: string;
+    rel: string;
+    block: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3Card.vue.d.ts

@@ -0,0 +1,37 @@
+type __VLS_Props = {
+    /** MD3 card emphasis: elevated, filled or outlined. */
+    variant?: 'elevated' | 'filled' | 'outlined';
+    /** Adds hover/press elevation and pointer affordance. */
+    interactive?: boolean;
+    /** Corner radius override; 'large' matches the M3 card default of 12dp. */
+    shape?: 'medium' | 'large' | 'extra-large';
+    href?: string;
+    target?: string;
+    rel?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        media?(_: {}): any;
+        default?(_: {}): any;
+        actions?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: "elevated" | "filled" | "outlined";
+    href: string;
+    target: string;
+    rel: string;
+    interactive: boolean;
+    shape: "medium" | "large" | "extra-large";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3Chip.vue.d.ts

@@ -0,0 +1,25 @@
+import { IconComponent } from '../icons';
+type __VLS_Props = {
+    /** Chip text. */
+    label: string;
+    /** MD3 chip type. */
+    variant?: 'assist' | 'filter' | 'input';
+    /** Filter chips toggle; selected chips get the checkmark and a tonal container. */
+    selected?: boolean;
+    icon?: IconComponent | null;
+    disabled?: boolean;
+    /** Render as a pressed toggle button (filter/input chips). */
+    toggle?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    remove: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRemove?: (() => any) | undefined;
+}>, {
+    toggle: boolean;
+    icon: IconComponent | null;
+    variant: "assist" | "filter" | "input";
+    disabled: boolean;
+    selected: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLButtonElement>;
+export default _default;

package/dist/components/M3Dialog.vue.d.ts

@@ -0,0 +1,41 @@
+import { IconComponent } from '../icons';
+type __VLS_Props = {
+    modelValue: boolean;
+    title?: string;
+    /** Optional hero icon above the headline (MD3 "icon" dialog). */
+    icon?: IconComponent | null;
+    /** Allow dismissal by scrim click or Escape. */
+    dismissible?: boolean;
+    ariaLabel?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+        actions?(_: {}): any;
+    };
+    refs: {
+        panelRef: HTMLDivElement;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {
+    title: string;
+    icon: IconComponent | null;
+    dismissible: boolean;
+    ariaLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    panelRef: HTMLDivElement;
+}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3Divider.vue.d.ts

@@ -0,0 +1,10 @@
+type __VLS_Props = {
+    /** MD3 divider inset: full-bleed, 16dp start inset, or 16dp both sides. */
+    inset?: 'none' | 'inset' | 'middle';
+    vertical?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    inset: "none" | "inset" | "middle";
+    vertical: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLHRElement>;
+export default _default;

package/dist/components/M3Fab.vue.d.ts

@@ -0,0 +1,31 @@
+import { IconComponent } from '../icons';
+type FabVariant = 'surface' | 'primary' | 'secondary' | 'tertiary' | 'primary-container' | 'secondary-container' | 'tertiary-container';
+type __VLS_Props = {
+    icon: IconComponent;
+    /** MD3 FAB size: 40dp small / 56dp regular / 96dp large. */
+    size?: 'sm' | 'md' | 'lg';
+    variant?: FabVariant;
+    /** Extended FAB: icon plus a text label. */
+    label?: string;
+    /** Pin to the bottom-end corner of the viewport. */
+    fixed?: boolean;
+    colored?: boolean;
+    href?: string;
+    target?: string;
+    rel?: string;
+    type?: 'button' | 'submit' | 'reset';
+    ariaLabel?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: "sm" | "md" | "lg";
+    fixed: boolean;
+    type: "button" | "submit" | "reset";
+    label: string;
+    variant: FabVariant;
+    href: string;
+    target: string;
+    rel: string;
+    ariaLabel: string;
+    colored: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/M3Icon.vue.d.ts

@@ -0,0 +1,30 @@
+import { IconComponent } from '../icons';
+type __VLS_Props = {
+    /** 任何渲染成 <svg> 的 Vue 组件；不限定图标库。 */
+    icon?: IconComponent | null;
+    /** Rendered size in px (or any CSS length). MD3 default glyph size is 24dp. */
+    size?: number | string;
+    /** Accessible name. When omitted the icon is decorative and hidden from AT. */
+    label?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLSpanElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: number | string;
+    label: string;
+    icon: IconComponent | null;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLSpanElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3IconButton.vue.d.ts

@@ -0,0 +1,33 @@
+import { IconComponent } from '../icons';
+type IconButtonVariant = 'standard' | 'filled' | 'tonal' | 'outlined';
+type IconButtonSize = 'sm' | 'md' | 'lg';
+type __VLS_Props = {
+    icon: IconComponent;
+    /** Variant to use when the button is toggled on. Defaults to a filled emphasis. */
+    selectedIcon?: IconComponent | null;
+    variant?: IconButtonVariant;
+    size?: IconButtonSize;
+    /** Accessible name — required, since the button has no visible label. */
+    label: string;
+    selected?: boolean;
+    disabled?: boolean;
+    href?: string;
+    target?: string;
+    rel?: string;
+    type?: 'button' | 'submit' | 'reset';
+    /** Circular hit area is the default; 'square' is used for dense app bars. */
+    shape?: 'full' | 'small' | 'medium';
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: IconButtonSize;
+    type: "button" | "submit" | "reset";
+    variant: IconButtonVariant;
+    disabled: boolean;
+    href: string;
+    target: string;
+    rel: string;
+    shape: "full" | "small" | "medium";
+    selected: boolean;
+    selectedIcon: IconComponent | null;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/M3List.vue.d.ts

@@ -0,0 +1,22 @@
+type __VLS_Props = {
+    dense?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLUListElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    dense: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLUListElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3ListItem.vue.d.ts

@@ -0,0 +1,52 @@
+import { IconComponent } from '../icons';
+type __VLS_Props = {
+    /** Primary text. Can also come from the default slot. */
+    headline?: string;
+    /** Secondary text under the headline. */
+    supporting?: string;
+    leadingIcon?: IconComponent | null;
+    /** Renders an anchor; the item becomes navigable. */
+    href?: string;
+    target?: string;
+    rel?: string;
+    /** Renders a button; the item becomes actionable. */
+    clickable?: boolean;
+    selected?: boolean;
+    disabled?: boolean;
+    /** MD3 list item height: one-line 56dp, two-line 72dp, three-line 88dp. */
+    lines?: 1 | 2 | 3;
+    /** Extra leading/trailing padding, used inside sheets. */
+    padded?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        leading?(_: {}): any;
+        default?(_: {}): any;
+        supporting?(_: {}): any;
+        trailing?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    disabled: boolean;
+    href: string;
+    target: string;
+    rel: string;
+    selected: boolean;
+    headline: string;
+    supporting: string;
+    leadingIcon: IconComponent | null;
+    clickable: boolean;
+    lines: 1 | 2 | 3;
+    padded: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3Menu.vue.d.ts

@@ -0,0 +1,61 @@
+type __VLS_Props = {
+    /** Which edge of the trigger the panel aligns to. */
+    placement?: 'bottom-start' | 'bottom-end' | 'bottom';
+    /** Distance between trigger and panel. */
+    gap?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    /** Stretch the panel to the trigger width (used by navigation panels). */
+    matchTriggerWidth?: boolean;
+    /** MD3 menus carry 8dp vertical padding; large navigation panels turn it off. */
+    padded?: boolean;
+    /** Close after activating an item inside the panel. */
+    closeOnSelect?: boolean;
+    /** Close on page scroll instead of tracking the trigger. */
+    closeOnScroll?: boolean;
+};
+declare function close(): void;
+declare function toggle(): void;
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        trigger?(_: {
+            open: boolean;
+            toggle: typeof toggle;
+            close: typeof close;
+        }): any;
+        default?(_: {
+            close: typeof close;
+        }): any;
+    };
+    refs: {
+        anchorRef: HTMLSpanElement;
+        panelRef: HTMLDivElement;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
+    open: import('vue').Ref<boolean, boolean>;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    padded: boolean;
+    placement: "bottom-start" | "bottom-end" | "bottom";
+    gap: number;
+    minWidth: number;
+    maxWidth: number;
+    matchTriggerWidth: boolean;
+    closeOnSelect: boolean;
+    closeOnScroll: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    anchorRef: HTMLSpanElement;
+    panelRef: HTMLDivElement;
+}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3MenuItem.vue.d.ts

@@ -0,0 +1,39 @@
+import { IconComponent } from '../icons';
+type __VLS_Props = {
+    label?: string;
+    supporting?: string;
+    icon?: IconComponent | null;
+    trailingText?: string;
+    href?: string;
+    target?: string;
+    rel?: string;
+    disabled?: boolean;
+    selected?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    label: string;
+    icon: IconComponent | null;
+    disabled: boolean;
+    href: string;
+    target: string;
+    rel: string;
+    selected: boolean;
+    supporting: string;
+    trailingText: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3SegmentedButton.vue.d.ts

@@ -0,0 +1,23 @@
+import { IconComponent } from '../icons';
+export interface SegmentedOption {
+    value: string;
+    label: string;
+    icon?: IconComponent;
+}
+type __VLS_Props = {
+    options: SegmentedOption[];
+    /** Selected value (single-select). */
+    modelValue: string;
+    /** Full-width segments instead of content-width. */
+    block?: boolean;
+    ariaLabel?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    block: boolean;
+    ariaLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/components/M3Sheet.vue.d.ts

@@ -0,0 +1,44 @@
+type __VLS_Props = {
+    modelValue: boolean;
+    /** Edge the sheet is anchored to. */
+    side?: 'start' | 'end' | 'bottom';
+    /** Width (side sheets) or height (bottom sheet) as a CSS length. */
+    size?: string;
+    title?: string;
+    /** Skip the built-in header and render the whole panel through the default slot. */
+    bare?: boolean;
+    /** Hide the close button in the header. */
+    hideClose?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+        footer?(_: {}): any;
+    };
+    refs: {
+        panelRef: HTMLDivElement;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: string;
+    title: string;
+    side: "start" | "end" | "bottom";
+    bare: boolean;
+    hideClose: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    panelRef: HTMLDivElement;
+}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/M3Switch.vue.d.ts

@@ -0,0 +1,30 @@
+type __VLS_Props = {
+    modelValue: boolean;
+    /** Accessible name — the visible label usually lives next to the switch. */
+    label?: string;
+    disabled?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        'on-icon'?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLButtonElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {
+    label: string;
+    disabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLButtonElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};