@qw-ui/core 0.3.0-next.17 → 0.3.0-next.18

package/dist/badge/badge.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Badge 契约 — 原型 A（无状态），core 无 machine，
+ * 承载双栈共享的类型契约与纯函数状态解析（SSR-safe，无 DOM 依赖）。
+ * 渲染契约：`data-scope="badge"`，`data-part="root"`；
+ * `data-variant` / `data-kind` 摊平枚举。
+ *
+ * 变体 / 形态 / 部位词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。
+ */
+/** 视觉变体全集：solid 强提示（默认）/ subtle 弱提示。 */
+export declare const BADGE_VARIANTS: readonly ["solid", "subtle"];
+/** 形态全集：number 数字（默认）/ dot 纯红点。 */
+export declare const BADGE_KINDS: readonly ["number", "dot"];
+/** Badge 各渲染部位全集（data-part 取值）。 */
+export declare const BADGE_PARTS: readonly ["root"];
+/** 默认溢出阈值：数值超过时收敛为「99+」。 */
+export declare const DEFAULT_BADGE_MAX_COUNT = 99;
+export type BadgeVariant = (typeof BADGE_VARIANTS)[number];
+export type BadgeKind = (typeof BADGE_KINDS)[number];
+export type BadgePart = (typeof BADGE_PARTS)[number];
+/**
+ * QwBadgeProps — 双栈共享的行为契约（全字段可选）。
+ * 视觉完全由语义令牌驱动，组件不开放自定义色值入口。
+ */
+export interface QwBadgeProps {
+    /** 视觉变体，默认 solid；dot 形态强制 solid。 */
+    variant?: BadgeVariant;
+    /** 纯红点形态，默认 false；为 true 时优先于 count。 */
+    dot?: boolean;
+    /** 未读数量；≤0 / 非有限数值不渲染。 */
+    count?: number;
+    /** 溢出阈值，默认 99；非法值（≤0 或非整数）回退默认。 */
+    maxCount?: number;
+    /** 自定义无障碍播报文案，全量覆盖默认文案。 */
+    ariaLabel?: string;
+}
+/** 适配层从 locale 传入的默认播报文案。 */
+export interface BadgeAriaTexts {
+    /** 数字形态播报模板，含 {count} 占位符。 */
+    unreadAriaTemplate: string;
+    /** 纯红点形态播报文案。 */
+    dotAria: string;
+}
+/** resolveBadgeState 的解析结果，适配层据此摊平渲染。 */
+export interface ResolvedBadgeState {
+    /** 是否渲染徽标本体；false 时双栈一致返回空渲染。 */
+    visible: boolean;
+    /** 形态。 */
+    kind: BadgeKind;
+    /** 解析后的视觉变体（dot + subtle 已降级为 solid）。 */
+    variant: BadgeVariant;
+    /** 可见文本（溢出为「<阈值>+」；dot / 不可见为空串）。 */
+    label: string;
+    /** 数值是否超过阈值。 */
+    overflow: boolean;
+    /** 解析后的生效阈值。 */
+    maxCount: number;
+    /** 生效的无障碍播报文案。 */
+    ariaLabel: string;
+}
+/**
+ * 纯函数：props + 文案 → 解析结果。
+ * 规则：dot 优先于 count；dot 强制 solid；数值四舍五入；
+ * ≤0 / NaN / Infinity 不渲染；溢出渲染「<阈值>+」。
+ */
+export declare function resolveBadgeState(props: QwBadgeProps, texts: BadgeAriaTexts): ResolvedBadgeState;
+/** 根元素 prop-getter 返回的 DOM 属性集。 */
+export interface BadgeRootProps {
+    "data-scope": "badge";
+    "data-part": "root";
+    "data-variant": BadgeVariant;
+    "data-kind": BadgeKind;
+    role: "status";
+    "aria-label": string;
+}
+/** 根元素 prop-getter：摊平 data 状态属性 + role="status" + 播报文案。 */
+export declare function getBadgeRootProps(state: ResolvedBadgeState): BadgeRootProps;

package/dist/badge/index.d.ts

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

package/dist/badge/index.js

@@ -0,0 +1,75 @@
+//#region src/badge/badge.ts
+/**
+* Badge 契约 — 原型 A（无状态），core 无 machine，
+* 承载双栈共享的类型契约与纯函数状态解析（SSR-safe，无 DOM 依赖）。
+* 渲染契约：`data-scope="badge"`，`data-part="root"`；
+* `data-variant` / `data-kind` 摊平枚举。
+*
+* 变体 / 形态 / 部位词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。
+*/
+/** 视觉变体全集：solid 强提示（默认）/ subtle 弱提示。 */
+const BADGE_VARIANTS = ["solid", "subtle"];
+/** 形态全集：number 数字（默认）/ dot 纯红点。 */
+const BADGE_KINDS = ["number", "dot"];
+/** Badge 各渲染部位全集（data-part 取值）。 */
+const BADGE_PARTS = ["root"];
+/** 默认溢出阈值：数值超过时收敛为「99+」。 */
+const DEFAULT_BADGE_MAX_COUNT = 99;
+/** 非法阈值（≤0 或非整数）一律回退默认值，避免非法配置导致空渲染。 */
+function resolveMaxCount(maxCount) {
+	return typeof maxCount === "number" && Number.isInteger(maxCount) && maxCount > 0 ? maxCount : 99;
+}
+/**
+* 纯函数：props + 文案 → 解析结果。
+* 规则：dot 优先于 count；dot 强制 solid；数值四舍五入；
+* ≤0 / NaN / Infinity 不渲染；溢出渲染「<阈值>+」。
+*/
+function resolveBadgeState(props, texts) {
+	const { variant = "solid", dot = false, count, maxCount, ariaLabel } = props;
+	const safeMax = resolveMaxCount(maxCount);
+	if (dot) return {
+		visible: true,
+		kind: "dot",
+		variant: "solid",
+		label: "",
+		overflow: false,
+		maxCount: safeMax,
+		ariaLabel: ariaLabel ?? texts.dotAria
+	};
+	const normalized = typeof count === "number" && Number.isFinite(count) && count > 0 ? Math.round(count) : 0;
+	if (normalized === 0) return {
+		visible: false,
+		kind: "number",
+		variant,
+		label: "",
+		overflow: false,
+		maxCount: safeMax,
+		ariaLabel: ""
+	};
+	const overflow = normalized > safeMax;
+	const label = overflow ? `${safeMax}+` : `${normalized}`;
+	return {
+		visible: true,
+		kind: "number",
+		variant,
+		label,
+		overflow,
+		maxCount: safeMax,
+		ariaLabel: ariaLabel ?? texts.unreadAriaTemplate.replaceAll("{count}", label)
+	};
+}
+/** 根元素 prop-getter：摊平 data 状态属性 + role="status" + 播报文案。 */
+function getBadgeRootProps(state) {
+	return {
+		"data-scope": "badge",
+		"data-part": "root",
+		"data-variant": state.variant,
+		"data-kind": state.kind,
+		role: "status",
+		"aria-label": state.ariaLabel
+	};
+}
+//#endregion
+export { BADGE_KINDS, BADGE_PARTS, BADGE_VARIANTS, DEFAULT_BADGE_MAX_COUNT, getBadgeRootProps, resolveBadgeState };
+
+//# sourceMappingURL=index.js.map

package/dist/badge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/badge/badge.ts"],"sourcesContent":["/**\n * Badge 契约 — 原型 A（无状态），core 无 machine，\n * 承载双栈共享的类型契约与纯函数状态解析（SSR-safe，无 DOM 依赖）。\n * 渲染契约：`data-scope=\"badge\"`，`data-part=\"root\"`；\n * `data-variant` / `data-kind` 摊平枚举。\n *\n * 变体 / 形态 / 部位词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。\n */\n\n/** 视觉变体全集：solid 强提示（默认）/ subtle 弱提示。 */\nexport const BADGE_VARIANTS = [\"solid\", \"subtle\"] as const;\n\n/** 形态全集：number 数字（默认）/ dot 纯红点。 */\nexport const BADGE_KINDS = [\"number\", \"dot\"] as const;\n\n/** Badge 各渲染部位全集（data-part 取值）。 */\nexport const BADGE_PARTS = [\"root\"] as const;\n\n/** 默认溢出阈值：数值超过时收敛为「99+」。 */\nexport const DEFAULT_BADGE_MAX_COUNT = 99;\n\nexport type BadgeVariant = (typeof BADGE_VARIANTS)[number];\nexport type BadgeKind = (typeof BADGE_KINDS)[number];\nexport type BadgePart = (typeof BADGE_PARTS)[number];\n\n/**\n * QwBadgeProps — 双栈共享的行为契约（全字段可选）。\n * 视觉完全由语义令牌驱动，组件不开放自定义色值入口。\n */\nexport interface QwBadgeProps {\n  /** 视觉变体，默认 solid；dot 形态强制 solid。 */\n  variant?: BadgeVariant;\n  /** 纯红点形态，默认 false；为 true 时优先于 count。 */\n  dot?: boolean;\n  /** 未读数量；≤0 / 非有限数值不渲染。 */\n  count?: number;\n  /** 溢出阈值，默认 99；非法值（≤0 或非整数）回退默认。 */\n  maxCount?: number;\n  /** 自定义无障碍播报文案，全量覆盖默认文案。 */\n  ariaLabel?: string;\n}\n\n/** 适配层从 locale 传入的默认播报文案。 */\nexport interface BadgeAriaTexts {\n  /** 数字形态播报模板，含 {count} 占位符。 */\n  unreadAriaTemplate: string;\n  /** 纯红点形态播报文案。 */\n  dotAria: string;\n}\n\n/** resolveBadgeState 的解析结果，适配层据此摊平渲染。 */\nexport interface ResolvedBadgeState {\n  /** 是否渲染徽标本体；false 时双栈一致返回空渲染。 */\n  visible: boolean;\n  /** 形态。 */\n  kind: BadgeKind;\n  /** 解析后的视觉变体（dot + subtle 已降级为 solid）。 */\n  variant: BadgeVariant;\n  /** 可见文本（溢出为「<阈值>+」；dot / 不可见为空串）。 */\n  label: string;\n  /** 数值是否超过阈值。 */\n  overflow: boolean;\n  /** 解析后的生效阈值。 */\n  maxCount: number;\n  /** 生效的无障碍播报文案。 */\n  ariaLabel: string;\n}\n\n/** 非法阈值（≤0 或非整数）一律回退默认值，避免非法配置导致空渲染。 */\nfunction resolveMaxCount(maxCount: number | undefined): number {\n  return typeof maxCount === \"number\" && Number.isInteger(maxCount) && maxCount > 0\n    ? maxCount\n    : DEFAULT_BADGE_MAX_COUNT;\n}\n\n/**\n * 纯函数：props + 文案 → 解析结果。\n * 规则：dot 优先于 count；dot 强制 solid；数值四舍五入；\n * ≤0 / NaN / Infinity 不渲染；溢出渲染「<阈值>+」。\n */\nexport function resolveBadgeState(\n  props: QwBadgeProps,\n  texts: BadgeAriaTexts,\n): ResolvedBadgeState {\n  const { variant = \"solid\", dot = false, count, maxCount, ariaLabel } = props;\n  const safeMax = resolveMaxCount(maxCount);\n\n  if (dot) {\n    return {\n      visible: true,\n      kind: \"dot\",\n      variant: \"solid\",\n      label: \"\",\n      overflow: false,\n      maxCount: safeMax,\n      ariaLabel: ariaLabel ?? texts.dotAria,\n    };\n  }\n\n  const normalized =\n    typeof count === \"number\" && Number.isFinite(count) && count > 0\n      ? Math.round(count)\n      : 0;\n\n  if (normalized === 0) {\n    return {\n      visible: false,\n      kind: \"number\",\n      variant,\n      label: \"\",\n      overflow: false,\n      maxCount: safeMax,\n      ariaLabel: \"\",\n    };\n  }\n\n  const overflow = normalized > safeMax;\n  const label = overflow ? `${safeMax}+` : `${normalized}`;\n  return {\n    visible: true,\n    kind: \"number\",\n    variant,\n    label,\n    overflow,\n    maxCount: safeMax,\n    ariaLabel: ariaLabel ?? texts.unreadAriaTemplate.replaceAll(\"{count}\", label),\n  };\n}\n\n/** 根元素 prop-getter 返回的 DOM 属性集。 */\nexport interface BadgeRootProps {\n  \"data-scope\": \"badge\";\n  \"data-part\": \"root\";\n  \"data-variant\": BadgeVariant;\n  \"data-kind\": BadgeKind;\n  role: \"status\";\n  \"aria-label\": string;\n}\n\n/** 根元素 prop-getter：摊平 data 状态属性 + role=\"status\" + 播报文案。 */\nexport function getBadgeRootProps(state: ResolvedBadgeState): BadgeRootProps {\n  return {\n    \"data-scope\": \"badge\",\n    \"data-part\": \"root\",\n    \"data-variant\": state.variant,\n    \"data-kind\": state.kind,\n    role: \"status\",\n    \"aria-label\": state.ariaLabel,\n  };\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,iBAAiB,CAAC,SAAS,QAAQ;;AAGhD,MAAa,cAAc,CAAC,UAAU,KAAK;;AAG3C,MAAa,cAAc,CAAC,MAAM;;AAGlC,MAAa,0BAA0B;;AAkDvC,SAAS,gBAAgB,UAAsC;CAC7D,OAAO,OAAO,aAAa,YAAY,OAAO,UAAU,QAAQ,KAAK,WAAW,IAC5E,WAAA;AAEN;;;;;;AAOA,SAAgB,kBACd,OACA,OACoB;CACpB,MAAM,EAAE,UAAU,SAAS,MAAM,OAAO,OAAO,UAAU,cAAc;CACvE,MAAM,UAAU,gBAAgB,QAAQ;CAExC,IAAI,KACF,OAAO;EACL,SAAS;EACT,MAAM;EACN,SAAS;EACT,OAAO;EACP,UAAU;EACV,UAAU;EACV,WAAW,aAAa,MAAM;CAChC;CAGF,MAAM,aACJ,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,QAAQ,IAC3D,KAAK,MAAM,KAAK,IAChB;CAEN,IAAI,eAAe,GACjB,OAAO;EACL,SAAS;EACT,MAAM;EACN;EACA,OAAO;EACP,UAAU;EACV,UAAU;EACV,WAAW;CACb;CAGF,MAAM,WAAW,aAAa;CAC9B,MAAM,QAAQ,WAAW,GAAG,QAAQ,KAAK,GAAG;CAC5C,OAAO;EACL,SAAS;EACT,MAAM;EACN;EACA;EACA;EACA,UAAU;EACV,WAAW,aAAa,MAAM,mBAAmB,WAAW,WAAW,KAAK;CAC9E;AACF;;AAaA,SAAgB,kBAAkB,OAA2C;CAC3E,OAAO;EACL,cAAc;EACd,aAAa;EACb,gBAAgB,MAAM;EACtB,aAAa,MAAM;EACnB,MAAM;EACN,cAAc,MAAM;CACtB;AACF"}

package/dist/index.d.ts

@@ -32,3 +32,5 @@ export { SWITCH_PARTS, getSwitchRootProps, getSwitchThumbProps, resolveSwitchSta
 export type { SwitchPart, QwSwitchProps, ResolvedSwitchState, SwitchRootProps, SwitchThumbProps } from "./switch/index.js";
 export { STEPPER_SIZES, STEPPER_PARTS, clampStepperValue, getStepperRootProps, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperValueProps, resolveStepperState, } from "./stepper/index.js";
 export type { StepperPart, StepperSize, QwStepperProps, ResolvedStepperState, StepperRootProps, StepperDecrementProps, StepperIncrementProps, StepperValueProps, } from "./stepper/index.js";
+export { BADGE_KINDS, BADGE_PARTS, BADGE_VARIANTS, DEFAULT_BADGE_MAX_COUNT, getBadgeRootProps, resolveBadgeState, } from "./badge/index.js";
+export type { BadgeAriaTexts, BadgeKind, BadgePart, BadgeRootProps, BadgeVariant, QwBadgeProps, ResolvedBadgeState, } from "./badge/index.js";

package/dist/index.js

@@ -15,4 +15,5 @@ import { TAG_PARTS, TAG_SIZES, TAG_VARIANTS } from "./tag/index.js";
 import { createInputProps } from "./input/index.js";
 import { SWITCH_PARTS, getSwitchRootProps, getSwitchThumbProps, resolveSwitchState } from "./switch/index.js";
 import { STEPPER_PARTS, STEPPER_SIZES, clampStepperValue, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, resolveStepperState } from "./stepper/index.js";
-export { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AVATAR_SIZES, BADGE_COUNT_MAX, BUTTON_ICON_POSITIONS, BUTTON_PARTS, BUTTON_SHAPES, BUTTON_SIZES, BUTTON_TONES, BUTTON_VARIANTS, DEFAULT_OVERLAY_PANEL_HEADER_HEIGHT, DEFAULT_TOAST_DURATION, DEFAULT_TOAST_POSITION, DIVIDER_ORIENTATIONS, DIVIDER_PARTS, DIVIDER_WEIGHTS, EMPTY_PARTS, ICON_FALLBACK_NAME, ICON_PARTS, LOADING_SIZES, OVERLAY_PANEL_PARTS, SKELETON_ANIMATIONS, SKELETON_PARTS, SKELETON_RADII, SKELETON_VARIANTS, STEPPER_PARTS, STEPPER_SIZES, SWITCH_PARTS, TAG_PARTS, TAG_SIZES, TAG_VARIANTS, TOAST_ICON_TYPES, TOAST_PARTS, TOAST_POSITIONS, TOPBAR_VARIANTS, clampStepperValue, connect, createDialogProps, createInputProps, createTabsProps, createTextAreaProps, createTopBarProps, dialogMachine, extractInitials, getAvatarBadgeProps, getAvatarFallbackProps, getAvatarImageElementProps, getAvatarImageProps, getAvatarRootProps, getButtonRootProps, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, getSwitchRootProps, getSwitchThumbProps, isToastIconType, resolveAvatarState, resolveButtonState, resolveIconName, resolveOverlayPanelHeight, resolveStepperState, resolveSwitchState, resolveToastDuration, tabsMachine, connect$1 as textAreaConnect, machine as textAreaMachine };
+import { BADGE_KINDS, BADGE_PARTS, BADGE_VARIANTS, DEFAULT_BADGE_MAX_COUNT, getBadgeRootProps, resolveBadgeState } from "./badge/index.js";
+export { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AVATAR_SIZES, BADGE_COUNT_MAX, BADGE_KINDS, BADGE_PARTS, BADGE_VARIANTS, BUTTON_ICON_POSITIONS, BUTTON_PARTS, BUTTON_SHAPES, BUTTON_SIZES, BUTTON_TONES, BUTTON_VARIANTS, DEFAULT_BADGE_MAX_COUNT, DEFAULT_OVERLAY_PANEL_HEADER_HEIGHT, DEFAULT_TOAST_DURATION, DEFAULT_TOAST_POSITION, DIVIDER_ORIENTATIONS, DIVIDER_PARTS, DIVIDER_WEIGHTS, EMPTY_PARTS, ICON_FALLBACK_NAME, ICON_PARTS, LOADING_SIZES, OVERLAY_PANEL_PARTS, SKELETON_ANIMATIONS, SKELETON_PARTS, SKELETON_RADII, SKELETON_VARIANTS, STEPPER_PARTS, STEPPER_SIZES, SWITCH_PARTS, TAG_PARTS, TAG_SIZES, TAG_VARIANTS, TOAST_ICON_TYPES, TOAST_PARTS, TOAST_POSITIONS, TOPBAR_VARIANTS, clampStepperValue, connect, createDialogProps, createInputProps, createTabsProps, createTextAreaProps, createTopBarProps, dialogMachine, extractInitials, getAvatarBadgeProps, getAvatarFallbackProps, getAvatarImageElementProps, getAvatarImageProps, getAvatarRootProps, getBadgeRootProps, getButtonRootProps, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, getSwitchRootProps, getSwitchThumbProps, isToastIconType, resolveAvatarState, resolveBadgeState, resolveButtonState, resolveIconName, resolveOverlayPanelHeight, resolveStepperState, resolveSwitchState, resolveToastDuration, tabsMachine, connect$1 as textAreaConnect, machine as textAreaMachine };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qw-ui/core",
-  "version": "0.3.0-next.17",
+  "version": "0.3.0-next.18",
   "description": "L2 · Headless Core — zag.js machine 薄包装，纯 TS / SSR-safe，零样式。",
   "license": "MIT",
   "author": "qw-ui contributors",
@@ -103,6 +103,10 @@
     "./stepper": {
       "types": "./dist/stepper/index.d.ts",
       "import": "./dist/stepper/index.js"
+    },
+    "./badge": {
+      "types": "./dist/badge/index.d.ts",
+      "import": "./dist/badge/index.js"
     }
   },
   "sideEffects": false,
@@ -111,7 +115,7 @@
     "@zag-js/dialog": "^1.42.0",
     "@zag-js/tabs": "^1.42.0",
     "@zag-js/utils": "1.42.0",
-    "@qw-ui/icons": "^0.3.0-next.17"
+    "@qw-ui/icons": "^0.3.0-next.18"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.58.9",
@@ -125,8 +129,8 @@
     "typescript": "^6.0.3",
     "unrun": "^0.3.1",
     "vitest": "^4.1.9",
-    "@qw-ui/tsconfig": "0.0.1",
-    "@qw-ui/eslint-config": "0.0.1"
+    "@qw-ui/eslint-config": "0.0.1",
+    "@qw-ui/tsconfig": "0.0.1"
   },
   "size-limit": [
     {