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

package/dist/side-nav/index.js

@@ -0,0 +1,99 @@
+//#region src/side-nav/side-nav.ts
+/**
+* SideNav 的跨框架行为契约。
+*
+* SideNav 是受控单选的 Prototype A 侧导航列：纵向堆叠的导航项（可选分组
+* 标题），多用于 H5 浮层分类切换。选中项白底加粗，组内直接相邻项获得
+* 16px 邻接圆角。这里仅归一化公开 props、推导选中/邻接视觉态并收口
+* data/aria 属性，React/Vue 适配器不得复制归一化、可见性或推导规则。
+*/
+const SIDENAV_PARTS = [
+	"root",
+	"group-label",
+	"item"
+];
+function resolveItem(item, selectedValue) {
+	return {
+		value: item.value,
+		label: item.label,
+		disabled: item.disabled ?? false,
+		selected: selectedValue !== void 0 && item.value === selectedValue
+	};
+}
+/** 组内邻接推导：仅与选中项索引差 1 的项获得 adjacent；分组标题为边界。 */
+function attachAdjacency(items) {
+	const selectedIndex = items.findIndex((item) => item.selected);
+	if (selectedIndex < 0) return;
+	for (const item of items) item.adjacent = null;
+	if (selectedIndex > 0) {
+		const prev = items[selectedIndex - 1];
+		if (prev) prev.adjacent = "prev";
+	}
+	if (selectedIndex < items.length - 1) {
+		const next = items[selectedIndex + 1];
+		if (next) next.adjacent = "next";
+	}
+}
+/**
+* 将公开输入归一化为唯一的跨框架状态。
+* items 非空时作为最前的无标题隐式组；空组（无项）不产生渲染；
+* 全部为空 → visible=false。
+*/
+function resolveSideNavState(props = {}) {
+	const selectedValue = props.value;
+	const rawGroups = [];
+	if ((props.items ?? []).length > 0) rawGroups.push({ items: props.items ?? [] });
+	for (const group of props.groups ?? []) rawGroups.push(group);
+	const groups = [];
+	let count = 0;
+	for (const raw of rawGroups) {
+		if (raw.items.length === 0) continue;
+		const items = raw.items.map((item) => ({
+			...resolveItem(item, selectedValue),
+			adjacent: null
+		}));
+		attachAdjacency(items);
+		groups.push({
+			...raw.title !== void 0 ? { title: raw.title } : {},
+			items
+		});
+		count += items.length;
+	}
+	return {
+		visible: count > 0,
+		count,
+		...selectedValue !== void 0 ? { selectedValue } : {},
+		groups
+	};
+}
+/** 将归一化结果转成 root 属性。 */
+function getSideNavRootProps(state) {
+	return {
+		"data-scope": "side-nav",
+		"data-part": "root",
+		"data-count": String(state.count)
+	};
+}
+/** 分组标题元素属性（无状态入参，纯收口）。 */
+function getSideNavGroupLabelProps() {
+	return {
+		"data-scope": "side-nav",
+		"data-part": "group-label"
+	};
+}
+/** 将单个归一化导航项转成 button 属性（选中/邻接/禁用收口，适配器不得覆盖）。 */
+function getSideNavItemProps(item) {
+	return {
+		type: "button",
+		"data-scope": "side-nav",
+		"data-part": "item",
+		"data-state": item.selected ? "selected" : "default",
+		...item.selected ? { "aria-current": "true" } : {},
+		...item.adjacent !== null ? { "data-adjacent": item.adjacent } : {},
+		disabled: item.disabled
+	};
+}
+//#endregion
+export { SIDENAV_PARTS, getSideNavGroupLabelProps, getSideNavItemProps, getSideNavRootProps, resolveSideNavState };
+
+//# sourceMappingURL=index.js.map

package/dist/side-nav/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/side-nav/side-nav.ts"],"sourcesContent":["/**\n * SideNav 的跨框架行为契约。\n *\n * SideNav 是受控单选的 Prototype A 侧导航列：纵向堆叠的导航项（可选分组\n * 标题），多用于 H5 浮层分类切换。选中项白底加粗，组内直接相邻项获得\n * 16px 邻接圆角。这里仅归一化公开 props、推导选中/邻接视觉态并收口\n * data/aria 属性，React/Vue 适配器不得复制归一化、可见性或推导规则。\n */\n\nexport const SIDENAV_PARTS = [\"root\", \"group-label\", \"item\"] as const;\n\nexport type SideNavPart = (typeof SIDENAV_PARTS)[number];\n\n/** 与选中项直接相邻的方位：prev=上邻项（右下角圆角）、next=下邻项（右上角圆角）。 */\nexport type SideNavItemAdjacent = \"prev\" | \"next\";\n\n/** 单个导航项声明；双栈共享，框架特有的事件通道不进入 Core。 */\nexport interface QwSideNavItemProps {\n  /** 唯一标识；受控选中值与 onChange 回传值均用它比对。 */\n  value: string;\n  /** 纯文本标签，同时作为按钮可访问名。 */\n  label: string;\n  /** 禁用标记：保留灰底、文字降为 placeholder 语义色，不可激活。 */\n  disabled?: boolean;\n}\n\n/** 分组声明；分组标题仅作视觉区隔，不参与选中语义。 */\nexport interface QwSideNavGroupProps {\n  /** 分组标题；缺省时该组无标题行。 */\n  title?: string;\n  /** 该组导航项。 */\n  items: readonly QwSideNavItemProps[];\n}\n\n/** 双栈共享的标量 props。 */\nexport interface QwSideNavProps {\n  /** 扁平声明；归一化为最前的无标题隐式组。 */\n  items?: readonly QwSideNavItemProps[];\n  /** 分组声明；追加在隐式组之后。 */\n  groups?: readonly QwSideNavGroupProps[];\n  /** 受控选中项 value；缺省时全部为默认态。 */\n  value?: string;\n  /** 项被激活（点击/回车/空格）时回传该项 value；点击已选中项同样触发。 */\n  onChange?: (value: string) => void;\n}\n\n/** 逐项归一化结果。 */\nexport interface ResolvedSideNavItemState {\n  value: string;\n  label: string;\n  disabled: boolean;\n  /** value 与受控选中值全等。 */\n  selected: boolean;\n  /** 组内与选中项直接相邻：prev=上邻、next=下邻；否则 null。 */\n  adjacent: SideNavItemAdjacent | null;\n}\n\n/** 归一化分组结果。 */\nexport interface ResolvedSideNavGroupState {\n  title?: string;\n  items: ResolvedSideNavItemState[];\n}\n\n/** 适配器唯一可消费的归一化结果。 */\nexport interface ResolvedSideNavState {\n  visible: boolean;\n  count: number;\n  selectedValue?: string;\n  groups: ResolvedSideNavGroupState[];\n}\n\n/** Core 生成、由适配器摊到根元素（原生 nav）的属性。 */\nexport interface SideNavRootProps {\n  \"data-scope\": \"side-nav\";\n  \"data-part\": \"root\";\n  \"data-count\": string;\n}\n\n/** Core 生成、由适配器摊到分组标题元素的属性。 */\nexport interface SideNavGroupLabelProps {\n  \"data-scope\": \"side-nav\";\n  \"data-part\": \"group-label\";\n}\n\n/** Core 生成、由适配器摊到导航项（原生 button）的属性。 */\nexport interface SideNavItemProps {\n  type: \"button\";\n  \"data-scope\": \"side-nav\";\n  \"data-part\": \"item\";\n  \"data-state\": \"selected\" | \"default\";\n  \"aria-current\"?: \"true\";\n  \"data-adjacent\"?: SideNavItemAdjacent;\n  disabled: boolean;\n}\n\nfunction resolveItem(\n  item: QwSideNavItemProps,\n  selectedValue: string | undefined,\n): Omit<ResolvedSideNavItemState, \"adjacent\"> {\n  return {\n    value: item.value,\n    label: item.label,\n    disabled: item.disabled ?? false,\n    selected: selectedValue !== undefined && item.value === selectedValue,\n  };\n}\n\n/** 组内邻接推导：仅与选中项索引差 1 的项获得 adjacent；分组标题为边界。 */\nfunction attachAdjacency(items: ResolvedSideNavItemState[]): void {\n  const selectedIndex = items.findIndex((item) => item.selected);\n  if (selectedIndex < 0) return;\n  for (const item of items) item.adjacent = null;\n  if (selectedIndex > 0) {\n    const prev = items[selectedIndex - 1];\n    if (prev) prev.adjacent = \"prev\";\n  }\n  if (selectedIndex < items.length - 1) {\n    const next = items[selectedIndex + 1];\n    if (next) next.adjacent = \"next\";\n  }\n}\n\n/**\n * 将公开输入归一化为唯一的跨框架状态。\n * items 非空时作为最前的无标题隐式组；空组（无项）不产生渲染；\n * 全部为空 → visible=false。\n */\nexport function resolveSideNavState(props: QwSideNavProps = {}): ResolvedSideNavState {\n  const selectedValue = props.value;\n  const rawGroups: QwSideNavGroupProps[] = [];\n  if ((props.items ?? []).length > 0) rawGroups.push({ items: props.items ?? [] });\n  for (const group of props.groups ?? []) rawGroups.push(group);\n\n  const groups: ResolvedSideNavGroupState[] = [];\n  let count = 0;\n  for (const raw of rawGroups) {\n    if (raw.items.length === 0) continue;\n    const items = raw.items.map((item) => ({\n      ...resolveItem(item, selectedValue),\n      adjacent: null as SideNavItemAdjacent | null,\n    }));\n    attachAdjacency(items);\n    groups.push({ ...(raw.title !== undefined ? { title: raw.title } : {}), items });\n    count += items.length;\n  }\n\n  return {\n    visible: count > 0,\n    count,\n    ...(selectedValue !== undefined ? { selectedValue } : {}),\n    groups,\n  };\n}\n\n/** 将归一化结果转成 root 属性。 */\nexport function getSideNavRootProps(state: ResolvedSideNavState): SideNavRootProps {\n  return {\n    \"data-scope\": \"side-nav\",\n    \"data-part\": \"root\",\n    \"data-count\": String(state.count),\n  };\n}\n\n/** 分组标题元素属性（无状态入参，纯收口）。 */\nexport function getSideNavGroupLabelProps(): SideNavGroupLabelProps {\n  return {\n    \"data-scope\": \"side-nav\",\n    \"data-part\": \"group-label\",\n  };\n}\n\n/** 将单个归一化导航项转成 button 属性（选中/邻接/禁用收口，适配器不得覆盖）。 */\nexport function getSideNavItemProps(item: ResolvedSideNavItemState): SideNavItemProps {\n  return {\n    type: \"button\",\n    \"data-scope\": \"side-nav\",\n    \"data-part\": \"item\",\n    \"data-state\": item.selected ? \"selected\" : \"default\",\n    ...(item.selected ? { \"aria-current\": \"true\" as const } : {}),\n    ...(item.adjacent !== null ? { \"data-adjacent\": item.adjacent } : {}),\n    disabled: item.disabled,\n  };\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,gBAAgB;CAAC;CAAQ;CAAe;AAAM;AAsF3D,SAAS,YACP,MACA,eAC4C;CAC5C,OAAO;EACL,OAAO,KAAK;EACZ,OAAO,KAAK;EACZ,UAAU,KAAK,YAAY;EAC3B,UAAU,kBAAkB,KAAA,KAAa,KAAK,UAAU;CAC1D;AACF;;AAGA,SAAS,gBAAgB,OAAyC;CAChE,MAAM,gBAAgB,MAAM,WAAW,SAAS,KAAK,QAAQ;CAC7D,IAAI,gBAAgB,GAAG;CACvB,KAAK,MAAM,QAAQ,OAAO,KAAK,WAAW;CAC1C,IAAI,gBAAgB,GAAG;EACrB,MAAM,OAAO,MAAM,gBAAgB;EACnC,IAAI,MAAM,KAAK,WAAW;CAC5B;CACA,IAAI,gBAAgB,MAAM,SAAS,GAAG;EACpC,MAAM,OAAO,MAAM,gBAAgB;EACnC,IAAI,MAAM,KAAK,WAAW;CAC5B;AACF;;;;;;AAOA,SAAgB,oBAAoB,QAAwB,CAAC,GAAyB;CACpF,MAAM,gBAAgB,MAAM;CAC5B,MAAM,YAAmC,CAAC;CAC1C,KAAK,MAAM,SAAS,CAAC,EAAA,CAAG,SAAS,GAAG,UAAU,KAAK,EAAE,OAAO,MAAM,SAAS,CAAC,EAAE,CAAC;CAC/E,KAAK,MAAM,SAAS,MAAM,UAAU,CAAC,GAAG,UAAU,KAAK,KAAK;CAE5D,MAAM,SAAsC,CAAC;CAC7C,IAAI,QAAQ;CACZ,KAAK,MAAM,OAAO,WAAW;EAC3B,IAAI,IAAI,MAAM,WAAW,GAAG;EAC5B,MAAM,QAAQ,IAAI,MAAM,KAAK,UAAU;GACrC,GAAG,YAAY,MAAM,aAAa;GAClC,UAAU;EACZ,EAAE;EACF,gBAAgB,KAAK;EACrB,OAAO,KAAK;GAAE,GAAI,IAAI,UAAU,KAAA,IAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;GAAI;EAAM,CAAC;EAC/E,SAAS,MAAM;CACjB;CAEA,OAAO;EACL,SAAS,QAAQ;EACjB;EACA,GAAI,kBAAkB,KAAA,IAAY,EAAE,cAAc,IAAI,CAAC;EACvD;CACF;AACF;;AAGA,SAAgB,oBAAoB,OAA+C;CACjF,OAAO;EACL,cAAc;EACd,aAAa;EACb,cAAc,OAAO,MAAM,KAAK;CAClC;AACF;;AAGA,SAAgB,4BAAoD;CAClE,OAAO;EACL,cAAc;EACd,aAAa;CACf;AACF;;AAGA,SAAgB,oBAAoB,MAAkD;CACpF,OAAO;EACL,MAAM;EACN,cAAc;EACd,aAAa;EACb,cAAc,KAAK,WAAW,aAAa;EAC3C,GAAI,KAAK,WAAW,EAAE,gBAAgB,OAAgB,IAAI,CAAC;EAC3D,GAAI,KAAK,aAAa,OAAO,EAAE,iBAAiB,KAAK,SAAS,IAAI,CAAC;EACnE,UAAU,KAAK;CACjB;AACF"}

package/dist/side-nav/side-nav.d.ts

@@ -0,0 +1,94 @@
+/**
+ * SideNav 的跨框架行为契约。
+ *
+ * SideNav 是受控单选的 Prototype A 侧导航列：纵向堆叠的导航项（可选分组
+ * 标题），多用于 H5 浮层分类切换。选中项白底加粗，组内直接相邻项获得
+ * 16px 邻接圆角。这里仅归一化公开 props、推导选中/邻接视觉态并收口
+ * data/aria 属性，React/Vue 适配器不得复制归一化、可见性或推导规则。
+ */
+export declare const SIDENAV_PARTS: readonly ["root", "group-label", "item"];
+export type SideNavPart = (typeof SIDENAV_PARTS)[number];
+/** 与选中项直接相邻的方位：prev=上邻项（右下角圆角）、next=下邻项（右上角圆角）。 */
+export type SideNavItemAdjacent = "prev" | "next";
+/** 单个导航项声明；双栈共享，框架特有的事件通道不进入 Core。 */
+export interface QwSideNavItemProps {
+    /** 唯一标识；受控选中值与 onChange 回传值均用它比对。 */
+    value: string;
+    /** 纯文本标签，同时作为按钮可访问名。 */
+    label: string;
+    /** 禁用标记：保留灰底、文字降为 placeholder 语义色，不可激活。 */
+    disabled?: boolean;
+}
+/** 分组声明；分组标题仅作视觉区隔，不参与选中语义。 */
+export interface QwSideNavGroupProps {
+    /** 分组标题；缺省时该组无标题行。 */
+    title?: string;
+    /** 该组导航项。 */
+    items: readonly QwSideNavItemProps[];
+}
+/** 双栈共享的标量 props。 */
+export interface QwSideNavProps {
+    /** 扁平声明；归一化为最前的无标题隐式组。 */
+    items?: readonly QwSideNavItemProps[];
+    /** 分组声明；追加在隐式组之后。 */
+    groups?: readonly QwSideNavGroupProps[];
+    /** 受控选中项 value；缺省时全部为默认态。 */
+    value?: string;
+    /** 项被激活（点击/回车/空格）时回传该项 value；点击已选中项同样触发。 */
+    onChange?: (value: string) => void;
+}
+/** 逐项归一化结果。 */
+export interface ResolvedSideNavItemState {
+    value: string;
+    label: string;
+    disabled: boolean;
+    /** value 与受控选中值全等。 */
+    selected: boolean;
+    /** 组内与选中项直接相邻：prev=上邻、next=下邻；否则 null。 */
+    adjacent: SideNavItemAdjacent | null;
+}
+/** 归一化分组结果。 */
+export interface ResolvedSideNavGroupState {
+    title?: string;
+    items: ResolvedSideNavItemState[];
+}
+/** 适配器唯一可消费的归一化结果。 */
+export interface ResolvedSideNavState {
+    visible: boolean;
+    count: number;
+    selectedValue?: string;
+    groups: ResolvedSideNavGroupState[];
+}
+/** Core 生成、由适配器摊到根元素（原生 nav）的属性。 */
+export interface SideNavRootProps {
+    "data-scope": "side-nav";
+    "data-part": "root";
+    "data-count": string;
+}
+/** Core 生成、由适配器摊到分组标题元素的属性。 */
+export interface SideNavGroupLabelProps {
+    "data-scope": "side-nav";
+    "data-part": "group-label";
+}
+/** Core 生成、由适配器摊到导航项（原生 button）的属性。 */
+export interface SideNavItemProps {
+    type: "button";
+    "data-scope": "side-nav";
+    "data-part": "item";
+    "data-state": "selected" | "default";
+    "aria-current"?: "true";
+    "data-adjacent"?: SideNavItemAdjacent;
+    disabled: boolean;
+}
+/**
+ * 将公开输入归一化为唯一的跨框架状态。
+ * items 非空时作为最前的无标题隐式组；空组（无项）不产生渲染；
+ * 全部为空 → visible=false。
+ */
+export declare function resolveSideNavState(props?: QwSideNavProps): ResolvedSideNavState;
+/** 将归一化结果转成 root 属性。 */
+export declare function getSideNavRootProps(state: ResolvedSideNavState): SideNavRootProps;
+/** 分组标题元素属性（无状态入参，纯收口）。 */
+export declare function getSideNavGroupLabelProps(): SideNavGroupLabelProps;
+/** 将单个归一化导航项转成 button 属性（选中/邻接/禁用收口，适配器不得覆盖）。 */
+export declare function getSideNavItemProps(item: ResolvedSideNavItemState): SideNavItemProps;

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";