@qw-ui/core 0.3.0-next.40 → 0.3.0-next.42

package/dist/share-sheet/index.js

@@ -0,0 +1,138 @@
+import { o as resolveIconState } from "../icon-Cgdbnk1u.js";
+import { createMachine } from "@zag-js/core";
+//#region src/share-sheet/share-sheet.ts
+function createShareSheetProps(props = {}) {
+	return {
+		...props,
+		groups: props.groups ?? [],
+		ariaLabel: props.ariaLabel?.trim() || "分享面板"
+	};
+}
+function resolveShareSheetGroups(groups = []) {
+	const seen = /* @__PURE__ */ new Set();
+	return groups.map((group, groupIndex) => ({
+		label: group.label,
+		groupIndex,
+		actions: group.actions.map((source, index) => {
+			const duplicate = seen.has(source.value);
+			seen.add(source.value);
+			return {
+				...source,
+				source,
+				index,
+				groupIndex,
+				disabled: !!source.disabled || duplicate || !source.value.trim() || !source.label.trim(),
+				duplicate
+			};
+		})
+	}));
+}
+const shareSheetMachine = createMachine({
+	props: ({ props }) => createShareSheetProps(props),
+	initialState: () => "ready",
+	states: { ready: {} },
+	context: ({ bindable, prop }) => ({ open: bindable(() => ({
+		defaultValue: prop("defaultOpen") ?? false,
+		value: prop("open"),
+		onChange: (open) => prop("onOpenChange")?.(open)
+	})) }),
+	on: {
+		OPEN: { actions: ["open"] },
+		ACTIVATE: { actions: ["activate"] },
+		CANCEL: { actions: ["cancel"] }
+	},
+	implementations: { actions: {
+		open({ context, event }) {
+			if (event.type === "OPEN") context.set("open", event.open);
+		},
+		activate({ prop, context, event }) {
+			if (event.type !== "ACTIVATE" || !context.get("open")) return;
+			const latest = resolveShareSheetGroups(prop("groups"))[event.groupIndex]?.actions[event.index];
+			if (!latest || latest.source !== event.source || latest.disabled) return;
+			prop("onAction")?.({
+				value: latest.value,
+				groupIndex: event.groupIndex,
+				index: event.index
+			});
+			if (prop("closeOnAction") !== false) context.set("open", false);
+		},
+		cancel({ prop, context }) {
+			if (!context.get("open")) return;
+			prop("onCancel")?.();
+			context.set("open", false);
+		}
+	} }
+});
+function connectShareSheet(service, normalize) {
+	const groups = resolveShareSheetGroups(service.prop("groups")), open = service.context.get("open");
+	const part = (name) => ({
+		"data-scope": "share-sheet",
+		"data-part": name
+	});
+	return {
+		open,
+		groups,
+		popupProps: {
+			id: `${service.scope.id}-popup`,
+			open,
+			title: service.prop("title"),
+			ariaLabel: service.prop("ariaLabel"),
+			closeLabel: service.prop("closeLabel"),
+			placement: "bottom",
+			closeOnMaskClick: service.prop("closeOnMaskClick"),
+			disableBodyScroll: service.prop("disableBodyScroll"),
+			safeArea: service.prop("safeArea"),
+			returnFocus: service.prop("returnFocus"),
+			onOpenChange: (value) => service.send({
+				type: "OPEN",
+				open: value
+			})
+		},
+		cancelText: service.prop("cancelText")?.trim() || "取消",
+		setOpen: (value) => service.send({
+			type: "OPEN",
+			open: value
+		}),
+		getRootProps: () => normalize.element({
+			...part("root"),
+			lang: service.prop("lang"),
+			dir: service.prop("dir"),
+			"data-visual-target": "share-sheet-root"
+		}),
+		getGroupProps: (group) => normalize.element({
+			...part("group"),
+			role: "group",
+			"aria-label": group.label
+		}),
+		getActionProps: (action) => normalize.button({
+			...part("action"),
+			type: "button",
+			disabled: action.disabled,
+			"aria-label": action.label,
+			"data-value": action.value,
+			"data-visual-target": "share-sheet-action",
+			onClick: () => service.send({
+				type: "ACTIVATE",
+				source: action.source,
+				groupIndex: action.groupIndex,
+				index: action.index
+			})
+		}),
+		getIconState: (action) => resolveIconState({
+			id: `${service.scope.id}:share:${action.groupIndex}:${action.index}`,
+			name: action.icon
+		}),
+		getLabelProps: () => normalize.element(part("label")),
+		getDescriptionProps: () => normalize.element(part("description")),
+		getCancelProps: () => normalize.button({
+			...part("cancel"),
+			type: "button",
+			"data-visual-target": "share-sheet-cancel",
+			onClick: () => service.send({ type: "CANCEL" })
+		})
+	};
+}
+//#endregion
+export { connectShareSheet, createShareSheetProps, resolveShareSheetGroups, shareSheetMachine };
+
+//# sourceMappingURL=index.js.map

package/dist/share-sheet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/share-sheet/share-sheet.ts"],"sourcesContent":["import { createMachine, type Machine, type Service } from \"@zag-js/core\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\nimport type { QwPopupProps } from \"../popup/popup.js\";\nimport { resolveIconState, type IconNameInput } from \"../icon/icon.js\";\n\nexport interface ShareSheetAction { value: string; label: string; icon: IconNameInput; description?: string; disabled?: boolean }\nexport interface ShareSheetGroup { label: string; actions: readonly ShareSheetAction[] }\nexport interface ShareSheetActionDetails { value: string; groupIndex: number; index: number }\nexport interface QwShareSheetProps extends Omit<QwPopupProps, \"placement\"> {\n  /** Locale on the immediate Popup host; arbitrary outer ancestors are not copied into its portal. */\n  lang?: string;\n  dir?: string;\n  groups?: readonly ShareSheetGroup[];\n  /** Enabled actions request closing by default; no system share or network side effect. */\n  closeOnAction?: boolean;\n  cancelText?: string;\n  onAction?: (details: ShareSheetActionDetails) => void;\n  onCancel?: () => void;\n}\nexport interface QwShareSheetSchema {\n  props: QwShareSheetProps;\n  context: { open: boolean };\n  state: \"ready\";\n  action: \"open\" | \"activate\" | \"cancel\";\n  event: { type: \"OPEN\"; open: boolean } | { type: \"ACTIVATE\"; source: ShareSheetAction; groupIndex: number; index: number } | { type: \"CANCEL\" };\n}\nexport type QwShareSheetService = Service<QwShareSheetSchema>;\nexport function createShareSheetProps(props: QwShareSheetProps = {}): QwShareSheetProps { return { ...props, groups: props.groups ?? [], ariaLabel: props.ariaLabel?.trim() || \"分享面板\" }; }\nexport function resolveShareSheetGroups(groups: readonly ShareSheetGroup[] = []) {\n  const seen = new Set<string>();\n  return groups.map((group, groupIndex) => ({ label: group.label, groupIndex, actions: group.actions.map((source, index) => {\n    const duplicate = seen.has(source.value); seen.add(source.value);\n    return { ...source, source, index, groupIndex, disabled: !!source.disabled || duplicate || !source.value.trim() || !source.label.trim(), duplicate };\n  }) }));\n}\nexport const shareSheetMachine: Machine<QwShareSheetSchema> = createMachine<QwShareSheetSchema>({\n  props: ({ props }) => createShareSheetProps(props), initialState: () => \"ready\", states: { ready: {} },\n  context: ({ bindable, prop }) => ({ open: bindable(() => ({ defaultValue: prop(\"defaultOpen\") ?? false, value: prop(\"open\"), onChange: (open) => prop(\"onOpenChange\")?.(open) })) }),\n  on: { OPEN: { actions: [\"open\"] }, ACTIVATE: { actions: [\"activate\"] }, CANCEL: { actions: [\"cancel\"] } },\n  implementations: { actions: {\n    open({ context, event }) { if (event.type === \"OPEN\") context.set(\"open\", event.open); },\n    activate({ prop, context, event }) {\n      if (event.type !== \"ACTIVATE\" || !context.get(\"open\")) return;\n      const latest = resolveShareSheetGroups(prop(\"groups\"))[event.groupIndex]?.actions[event.index];\n      if (!latest || latest.source !== event.source || latest.disabled) return;\n      prop(\"onAction\")?.({ value: latest.value, groupIndex: event.groupIndex, index: event.index });\n      if (prop(\"closeOnAction\") !== false) context.set(\"open\", false);\n    },\n    cancel({ prop, context }) { if (!context.get(\"open\")) return; prop(\"onCancel\")?.(); context.set(\"open\", false); },\n  } },\n});\nexport function connectShareSheet<T extends PropTypes>(service: QwShareSheetService, normalize: NormalizeProps<T>) {\n  const groups = resolveShareSheetGroups(service.prop(\"groups\")), open = service.context.get(\"open\");\n  const part = (name: string) => ({ \"data-scope\": \"share-sheet\", \"data-part\": name });\n  const popupProps: QwPopupProps = { id: `${service.scope.id}-popup`, open, title: service.prop(\"title\"), ariaLabel: service.prop(\"ariaLabel\"), closeLabel: service.prop(\"closeLabel\"), placement: \"bottom\", closeOnMaskClick: service.prop(\"closeOnMaskClick\"), disableBodyScroll: service.prop(\"disableBodyScroll\"), safeArea: service.prop(\"safeArea\"), returnFocus: service.prop(\"returnFocus\"), onOpenChange: (value) => service.send({ type: \"OPEN\", open: value }) };\n  return { open, groups, popupProps, cancelText: service.prop(\"cancelText\")?.trim() || \"取消\",\n    setOpen: (value: boolean) => service.send({ type: \"OPEN\", open: value }),\n    getRootProps: () => normalize.element({ ...part(\"root\"), lang: service.prop(\"lang\"), dir: service.prop(\"dir\"), \"data-visual-target\": \"share-sheet-root\" }),\n    getGroupProps: (group: (typeof groups)[number]) => normalize.element({ ...part(\"group\"), role: \"group\", \"aria-label\": group.label }),\n    getActionProps: (action: (typeof groups)[number][\"actions\"][number]) => normalize.button({ ...part(\"action\"), type: \"button\", disabled: action.disabled, \"aria-label\": action.label, \"data-value\": action.value, \"data-visual-target\": \"share-sheet-action\", onClick: () => service.send({ type: \"ACTIVATE\", source: action.source, groupIndex: action.groupIndex, index: action.index }) }),\n    getIconState: (action: (typeof groups)[number][\"actions\"][number]) => resolveIconState({ id: `${service.scope.id}:share:${action.groupIndex}:${action.index}`, name: action.icon }),\n    getLabelProps: () => normalize.element(part(\"label\")), getDescriptionProps: () => normalize.element(part(\"description\")),\n    getCancelProps: () => normalize.button({ ...part(\"cancel\"), type: \"button\", \"data-visual-target\": \"share-sheet-cancel\", onClick: () => service.send({ type: \"CANCEL\" }) }),\n  };\n}\nexport type QwShareSheetApi<T extends PropTypes = PropTypes> = ReturnType<typeof connectShareSheet<T>>;\n"],"mappings":"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"}

package/dist/share-sheet/share-sheet.d.ts

@@ -0,0 +1,139 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import type { QwPopupProps } from "../popup/popup.js";
+import { type IconNameInput } from "../icon/icon.js";
+export interface ShareSheetAction {
+    value: string;
+    label: string;
+    icon: IconNameInput;
+    description?: string;
+    disabled?: boolean;
+}
+export interface ShareSheetGroup {
+    label: string;
+    actions: readonly ShareSheetAction[];
+}
+export interface ShareSheetActionDetails {
+    value: string;
+    groupIndex: number;
+    index: number;
+}
+export interface QwShareSheetProps extends Omit<QwPopupProps, "placement"> {
+    /** Locale on the immediate Popup host; arbitrary outer ancestors are not copied into its portal. */
+    lang?: string;
+    dir?: string;
+    groups?: readonly ShareSheetGroup[];
+    /** Enabled actions request closing by default; no system share or network side effect. */
+    closeOnAction?: boolean;
+    cancelText?: string;
+    onAction?: (details: ShareSheetActionDetails) => void;
+    onCancel?: () => void;
+}
+export interface QwShareSheetSchema {
+    props: QwShareSheetProps;
+    context: {
+        open: boolean;
+    };
+    state: "ready";
+    action: "open" | "activate" | "cancel";
+    event: {
+        type: "OPEN";
+        open: boolean;
+    } | {
+        type: "ACTIVATE";
+        source: ShareSheetAction;
+        groupIndex: number;
+        index: number;
+    } | {
+        type: "CANCEL";
+    };
+}
+export type QwShareSheetService = Service<QwShareSheetSchema>;
+export declare function createShareSheetProps(props?: QwShareSheetProps): QwShareSheetProps;
+export declare function resolveShareSheetGroups(groups?: readonly ShareSheetGroup[]): {
+    label: string;
+    groupIndex: number;
+    actions: {
+        value: string;
+        label: string;
+        icon: IconNameInput;
+        description?: string;
+        source: ShareSheetAction;
+        index: number;
+        groupIndex: number;
+        disabled: boolean;
+        duplicate: boolean;
+    }[];
+}[];
+export declare const shareSheetMachine: Machine<QwShareSheetSchema>;
+export declare function connectShareSheet<T extends PropTypes>(service: QwShareSheetService, normalize: NormalizeProps<T>): {
+    open: boolean;
+    groups: {
+        label: string;
+        groupIndex: number;
+        actions: {
+            value: string;
+            label: string;
+            icon: IconNameInput;
+            description?: string;
+            source: ShareSheetAction;
+            index: number;
+            groupIndex: number;
+            disabled: boolean;
+            duplicate: boolean;
+        }[];
+    }[];
+    popupProps: QwPopupProps;
+    cancelText: string;
+    setOpen: (value: boolean) => void;
+    getRootProps: () => T["element"];
+    getGroupProps: (group: ({
+        label: string;
+        groupIndex: number;
+        actions: {
+            value: string;
+            label: string;
+            icon: IconNameInput;
+            description?: string;
+            source: ShareSheetAction;
+            index: number;
+            groupIndex: number;
+            disabled: boolean;
+            duplicate: boolean;
+        }[];
+    }[])[number]) => T["element"];
+    getActionProps: (action: ({
+        label: string;
+        groupIndex: number;
+        actions: {
+            value: string;
+            label: string;
+            icon: IconNameInput;
+            description?: string;
+            source: ShareSheetAction;
+            index: number;
+            groupIndex: number;
+            disabled: boolean;
+            duplicate: boolean;
+        }[];
+    }[])[number]["actions"][number]) => T["button"];
+    getIconState: (action: ({
+        label: string;
+        groupIndex: number;
+        actions: {
+            value: string;
+            label: string;
+            icon: IconNameInput;
+            description?: string;
+            source: ShareSheetAction;
+            index: number;
+            groupIndex: number;
+            disabled: boolean;
+            duplicate: boolean;
+        }[];
+    }[])[number]["actions"][number]) => import("../index.js").IconState;
+    getLabelProps: () => T["element"];
+    getDescriptionProps: () => T["element"];
+    getCancelProps: () => T["button"];
+};
+export type QwShareSheetApi<T extends PropTypes = PropTypes> = ReturnType<typeof connectShareSheet<T>>;

package/dist/skeleton/index.js

@@ -1,6 +1,6 @@
 //#region src/skeleton/skeleton.ts
 /**
-* Skeleton 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。
+* Skeleton 契约 — 原型 A（无状态），Core 无 machine，承载三栈共享的类型与渲染契约。
 * 渲染契约：`data-scope="skeleton"`，`aria-hidden="true"`；
 * data-part 为 root / line；流光动效纯 CSS，尊重 `prefers-reduced-motion`。
 *
@@ -22,7 +22,56 @@ const SKELETON_RADII = [
 ];
 /** Skeleton 各渲染部位全集（data-part 取值）。 */
 const SKELETON_PARTS = ["root", "line"];
+const radiusVariables = {
+	control: "var(--qw-sem-size-radius-control)",
+	card: "var(--qw-sem-size-radius-card)",
+	full: "var(--qw-sem-size-radius-full)"
+};
+const length = (value) => typeof value === "number" ? `${value}px` : value;
+/** Rendering, dimensions and invalid-input handling are shared by all adapters. */
+function resolveSkeletonState(props = {}) {
+	const variant = SKELETON_VARIANTS.includes(props.variant) ? props.variant : "text";
+	const animation = SKELETON_ANIMATIONS.includes(props.animation) ? props.animation : "wave";
+	const radius = variant !== "circle" && SKELETON_RADII.includes(props.radius) ? props.radius : void 0;
+	const lines = Number.isInteger(props.lines) && props.lines > 0 && props.lines <= 4294967295 ? props.lines : 1;
+	const style = {};
+	if (props.width != null) style["--qw-skeleton-w"] = length(props.width);
+	if (props.height != null) style["--qw-skeleton-h"] = length(props.height);
+	if (radius) style["--qw-skeleton-r"] = radiusVariables[radius];
+	return {
+		variant,
+		animation,
+		radius,
+		lines,
+		style,
+		lineItems: variant === "text" && lines > 1 ? Array.from({ length: lines }, (_, index) => ({
+			index,
+			last: index === lines - 1
+		})) : []
+	};
+}
+function getSkeletonRootProps(state) {
+	return {
+		"data-scope": "skeleton",
+		"data-part": "root",
+		"data-variant": state.variant,
+		"data-animation": state.animation,
+		"data-radius": state.radius,
+		"data-lines": state.lineItems.length ? state.lines : void 0,
+		"aria-hidden": "true"
+	};
+}
+function getSkeletonStyle(state) {
+	return state.style;
+}
+function getSkeletonLineProps(line) {
+	return {
+		"data-scope": "skeleton",
+		"data-part": "line",
+		"data-last": line.last ? "true" : void 0
+	};
+}
 //#endregion
-export { SKELETON_ANIMATIONS, SKELETON_PARTS, SKELETON_RADII, SKELETON_VARIANTS };
+export { SKELETON_ANIMATIONS, SKELETON_PARTS, SKELETON_RADII, SKELETON_VARIANTS, getSkeletonLineProps, getSkeletonRootProps, getSkeletonStyle, resolveSkeletonState };
 
 //# sourceMappingURL=index.js.map

package/dist/skeleton/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/skeleton/skeleton.ts"],"sourcesContent":["/**\n * Skeleton 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。\n * 渲染契约：`data-scope=\"skeleton\"`，`aria-hidden=\"true\"`；\n * data-part 为 root / line；流光动效纯 CSS，尊重 `prefers-reduced-motion`。\n *\n * 形状 / 动效 / 圆角词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。\n */\n\n/** 形状全集：text 文本条 / circle 头像 / rect 图片卡片块。 */\nexport const SKELETON_VARIANTS = [\"text\", \"circle\", \"rect\"] as const;\n\n/** 动效全集：wave 流光（默认）/ none 静态。 */\nexport const SKELETON_ANIMATIONS = [\"wave\", \"none\"] as const;\n\n/** 圆角档位全集。 */\nexport const SKELETON_RADII = [\"control\", \"card\", \"full\"] as const;\n\n/** Skeleton 各渲染部位全集（data-part 取值）。 */\nexport const SKELETON_PARTS = [\"root\", \"line\"] as const;\n\nexport type SkeletonVariant = (typeof SKELETON_VARIANTS)[number];\nexport type SkeletonAnimation = (typeof SKELETON_ANIMATIONS)[number];\nexport type SkeletonRadius = (typeof SKELETON_RADII)[number];\nexport type SkeletonPart = (typeof SKELETON_PARTS)[number];\n\n/**\n * QwSkeletonProps — 双栈共享的行为契约。\n * 几何 width/height 的 number|string 形式是框架无关的；\n * 富内容不涉及（骨架不承载文本）。\n */\nexport interface QwSkeletonProps {\n  /** 形状，默认 text。 */\n  variant?: SkeletonVariant;\n  /** 动效，默认 wave。 */\n  animation?: SkeletonAnimation;\n  /** 宽度，数值按 px 处理。 */\n  width?: number | string;\n  /** 高度，数值按 px 处理。 */\n  height?: number | string;\n  /** 圆角档位（circle 恒为正圆，忽略此项）。 */\n  radius?: SkeletonRadius;\n  /** 仅 text：一次渲染多行文本条，末行更短。默认 1。 */\n  lines?: number;\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,oBAAoB;CAAC;CAAQ;CAAU;AAAM;;AAG1D,MAAa,sBAAsB,CAAC,QAAQ,MAAM;;AAGlD,MAAa,iBAAiB;CAAC;CAAW;CAAQ;AAAM;;AAGxD,MAAa,iBAAiB,CAAC,QAAQ,MAAM"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/skeleton/skeleton.ts"],"sourcesContent":["/**\n * Skeleton 契约 — 原型 A（无状态），Core 无 machine，承载三栈共享的类型与渲染契约。\n * 渲染契约：`data-scope=\"skeleton\"`，`aria-hidden=\"true\"`；\n * data-part 为 root / line；流光动效纯 CSS，尊重 `prefers-reduced-motion`。\n *\n * 形状 / 动效 / 圆角词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。\n */\n\n/** 形状全集：text 文本条 / circle 头像 / rect 图片卡片块。 */\nexport const SKELETON_VARIANTS = [\"text\", \"circle\", \"rect\"] as const;\n\n/** 动效全集：wave 流光（默认）/ none 静态。 */\nexport const SKELETON_ANIMATIONS = [\"wave\", \"none\"] as const;\n\n/** 圆角档位全集。 */\nexport const SKELETON_RADII = [\"control\", \"card\", \"full\"] as const;\n\n/** Skeleton 各渲染部位全集（data-part 取值）。 */\nexport const SKELETON_PARTS = [\"root\", \"line\"] as const;\n\nexport type SkeletonVariant = (typeof SKELETON_VARIANTS)[number];\nexport type SkeletonAnimation = (typeof SKELETON_ANIMATIONS)[number];\nexport type SkeletonRadius = (typeof SKELETON_RADII)[number];\nexport type SkeletonPart = (typeof SKELETON_PARTS)[number];\n\n/**\n * QwSkeletonProps — 三栈共享的行为与渲染契约。\n * 几何 width/height 的 number|string 形式是框架无关的；\n * 富内容不涉及（骨架不承载文本）。\n */\nexport interface QwSkeletonProps {\n  /** 形状，默认 text。 */\n  variant?: SkeletonVariant;\n  /** 动效，默认 wave。 */\n  animation?: SkeletonAnimation;\n  /** 宽度，数值按 px 处理。 */\n  width?: number | string;\n  /** 高度，数值按 px 处理。 */\n  height?: number | string;\n  /** 圆角档位（circle 使用 full 圆角，忽略此项；显式宽高可独立设置）。 */\n  radius?: SkeletonRadius;\n  /** 仅 text：一次渲染多行文本条，末行更短。默认 1。 */\n  lines?: number;\n}\n\n\nexport interface SkeletonLine { readonly index: number; readonly last: boolean }\nexport interface ResolvedSkeletonState {\n  variant: SkeletonVariant; animation: SkeletonAnimation; radius?: SkeletonRadius; lines: number;\n  style: Readonly<Record<string, string>>; lineItems: readonly SkeletonLine[];\n}\nconst radiusVariables: Record<SkeletonRadius, string> = {\n  control: \"var(--qw-sem-size-radius-control)\", card: \"var(--qw-sem-size-radius-card)\", full: \"var(--qw-sem-size-radius-full)\",\n};\nconst length = (value: number | string): string => typeof value === \"number\" ? `${value}px` : value;\n/** Rendering, dimensions and invalid-input handling are shared by all adapters. */\nexport function resolveSkeletonState(props: QwSkeletonProps = {}): ResolvedSkeletonState {\n  const variant = SKELETON_VARIANTS.includes(props.variant!) ? props.variant! : \"text\";\n  const animation = SKELETON_ANIMATIONS.includes(props.animation!) ? props.animation! : \"wave\";\n  const radius = variant !== \"circle\" && SKELETON_RADII.includes(props.radius!) ? props.radius : undefined;\n  const lines = Number.isInteger(props.lines) && props.lines! > 0 && props.lines! <= 0xffff_ffff ? props.lines! : 1;\n  const style: Record<string, string> = {};\n  if (props.width != null) style[\"--qw-skeleton-w\"] = length(props.width);\n  if (props.height != null) style[\"--qw-skeleton-h\"] = length(props.height);\n  if (radius) style[\"--qw-skeleton-r\"] = radiusVariables[radius];\n  return { variant, animation, radius, lines, style, lineItems: variant === \"text\" && lines > 1 ? Array.from({ length: lines }, (_, index) => ({ index, last: index === lines - 1 })) : [] };\n}\nexport interface SkeletonRootProps {\n  \"data-scope\": \"skeleton\"; \"data-part\": \"root\"; \"data-variant\": SkeletonVariant; \"data-animation\": SkeletonAnimation;\n  \"data-radius\"?: SkeletonRadius; \"data-lines\"?: number; \"aria-hidden\": \"true\";\n}\nexport function getSkeletonRootProps(state: ResolvedSkeletonState): SkeletonRootProps {\n  return { \"data-scope\": \"skeleton\", \"data-part\": \"root\", \"data-variant\": state.variant, \"data-animation\": state.animation,\n    \"data-radius\": state.radius, \"data-lines\": state.lineItems.length ? state.lines : undefined, \"aria-hidden\": \"true\" };\n}\nexport function getSkeletonStyle(state: ResolvedSkeletonState): Readonly<Record<string, string>> { return state.style; }\nexport interface SkeletonLineProps { \"data-scope\": \"skeleton\"; \"data-part\": \"line\"; \"data-last\"?: \"true\" }\nexport function getSkeletonLineProps(line: SkeletonLine): SkeletonLineProps {\n  return { \"data-scope\": \"skeleton\", \"data-part\": \"line\", \"data-last\": line.last ? \"true\" : undefined };\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,oBAAoB;CAAC;CAAQ;CAAU;AAAM;;AAG1D,MAAa,sBAAsB,CAAC,QAAQ,MAAM;;AAGlD,MAAa,iBAAiB;CAAC;CAAW;CAAQ;AAAM;;AAGxD,MAAa,iBAAiB,CAAC,QAAQ,MAAM;AAiC7C,MAAM,kBAAkD;CACtD,SAAS;CAAqC,MAAM;CAAkC,MAAM;AAC9F;AACA,MAAM,UAAU,UAAmC,OAAO,UAAU,WAAW,GAAG,MAAM,MAAM;;AAE9F,SAAgB,qBAAqB,QAAyB,CAAC,GAA0B;CACvF,MAAM,UAAU,kBAAkB,SAAS,MAAM,OAAQ,IAAI,MAAM,UAAW;CAC9E,MAAM,YAAY,oBAAoB,SAAS,MAAM,SAAU,IAAI,MAAM,YAAa;CACtF,MAAM,SAAS,YAAY,YAAY,eAAe,SAAS,MAAM,MAAO,IAAI,MAAM,SAAS,KAAA;CAC/F,MAAM,QAAQ,OAAO,UAAU,MAAM,KAAK,KAAK,MAAM,QAAS,KAAK,MAAM,SAAU,aAAc,MAAM,QAAS;CAChH,MAAM,QAAgC,CAAC;CACvC,IAAI,MAAM,SAAS,MAAM,MAAM,qBAAqB,OAAO,MAAM,KAAK;CACtE,IAAI,MAAM,UAAU,MAAM,MAAM,qBAAqB,OAAO,MAAM,MAAM;CACxE,IAAI,QAAQ,MAAM,qBAAqB,gBAAgB;CACvD,OAAO;EAAE;EAAS;EAAW;EAAQ;EAAO;EAAO,WAAW,YAAY,UAAU,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,MAAM,IAAI,GAAG,WAAW;GAAE;GAAO,MAAM,UAAU,QAAQ;EAAE,EAAE,IAAI,CAAC;CAAE;AAC3L;AAKA,SAAgB,qBAAqB,OAAiD;CACpF,OAAO;EAAE,cAAc;EAAY,aAAa;EAAQ,gBAAgB,MAAM;EAAS,kBAAkB,MAAM;EAC7G,eAAe,MAAM;EAAQ,cAAc,MAAM,UAAU,SAAS,MAAM,QAAQ,KAAA;EAAW,eAAe;CAAO;AACvH;AACA,SAAgB,iBAAiB,OAAgE;CAAE,OAAO,MAAM;AAAO;AAEvH,SAAgB,qBAAqB,MAAuC;CAC1E,OAAO;EAAE,cAAc;EAAY,aAAa;EAAQ,aAAa,KAAK,OAAO,SAAS,KAAA;CAAU;AACtG"}

package/dist/skeleton/skeleton.d.ts

@@ -1,5 +1,5 @@
 /**
- * Skeleton 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。
+ * Skeleton 契约 — 原型 A（无状态），Core 无 machine，承载三栈共享的类型与渲染契约。
  * 渲染契约：`data-scope="skeleton"`，`aria-hidden="true"`；
  * data-part 为 root / line；流光动效纯 CSS，尊重 `prefers-reduced-motion`。
  *
@@ -18,7 +18,7 @@ export type SkeletonAnimation = (typeof SKELETON_ANIMATIONS)[number];
 export type SkeletonRadius = (typeof SKELETON_RADII)[number];
 export type SkeletonPart = (typeof SKELETON_PARTS)[number];
 /**
- * QwSkeletonProps — 双栈共享的行为契约。
+ * QwSkeletonProps — 三栈共享的行为与渲染契约。
  * 几何 width/height 的 number|string 形式是框架无关的；
  * 富内容不涉及（骨架不承载文本）。
  */
@@ -31,8 +31,39 @@ export interface QwSkeletonProps {
     width?: number | string;
     /** 高度，数值按 px 处理。 */
     height?: number | string;
-    /** 圆角档位（circle 恒为正圆，忽略此项）。 */
+    /** 圆角档位（circle 使用 full 圆角，忽略此项；显式宽高可独立设置）。 */
     radius?: SkeletonRadius;
     /** 仅 text：一次渲染多行文本条，末行更短。默认 1。 */
     lines?: number;
 }
+export interface SkeletonLine {
+    readonly index: number;
+    readonly last: boolean;
+}
+export interface ResolvedSkeletonState {
+    variant: SkeletonVariant;
+    animation: SkeletonAnimation;
+    radius?: SkeletonRadius;
+    lines: number;
+    style: Readonly<Record<string, string>>;
+    lineItems: readonly SkeletonLine[];
+}
+/** Rendering, dimensions and invalid-input handling are shared by all adapters. */
+export declare function resolveSkeletonState(props?: QwSkeletonProps): ResolvedSkeletonState;
+export interface SkeletonRootProps {
+    "data-scope": "skeleton";
+    "data-part": "root";
+    "data-variant": SkeletonVariant;
+    "data-animation": SkeletonAnimation;
+    "data-radius"?: SkeletonRadius;
+    "data-lines"?: number;
+    "aria-hidden": "true";
+}
+export declare function getSkeletonRootProps(state: ResolvedSkeletonState): SkeletonRootProps;
+export declare function getSkeletonStyle(state: ResolvedSkeletonState): Readonly<Record<string, string>>;
+export interface SkeletonLineProps {
+    "data-scope": "skeleton";
+    "data-part": "line";
+    "data-last"?: "true";
+}
+export declare function getSkeletonLineProps(line: SkeletonLine): SkeletonLineProps;

package/dist/slider/index.d.ts

@@ -0,0 +1 @@
+export * from "./slider.js";