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

package/dist/slider/slider.d.ts

@@ -0,0 +1,174 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+/** Stable DOM parts shared by every adapter. */
+export declare const SLIDER_PARTS: readonly ["root", "label", "control", "track", "range", "thumb", "input"];
+export declare const SLIDER_ORIENTATIONS: readonly ["horizontal", "vertical"];
+export type SliderPart = (typeof SLIDER_PARTS)[number];
+export type SliderOrientation = (typeof SLIDER_ORIENTATIONS)[number];
+/** A single slider reports a number; a range slider reports an ascending `[start, end]` tuple. */
+export type SliderValue = number | readonly [number, number];
+export interface SliderValueChangeDetails {
+    value: SliderValue;
+}
+/** SSR-safe input shared by all adapters (no @zag-js/slider dependency; the machine is qw-ui Core). */
+export interface QwSliderProps {
+    /** Page-unique instance identity; adapters generate one when omitted. */
+    id?: string;
+    /** Required nonempty accessible name; visible unless `hideLabel`. */
+    label: string;
+    /** Keep the name for assistive technology but hide it visually. */
+    hideLabel?: boolean;
+    /** Two thumbs selecting `[start, end]`. */
+    range?: boolean;
+    /** Controlled value. Defined means the owner decides; requests go through onValueChange. */
+    value?: SliderValue;
+    /** Initial Core-owned value and the form-reset value; defaults to min (range: [min, max]). */
+    defaultValue?: SliderValue;
+    /** Finite lower bound, default 0. */
+    min?: number;
+    /** Finite upper bound greater than min, default min + 100. */
+    max?: number;
+    /** Positive finite step, default 1. Values snap to min + k·step; max itself is always reachable. */
+    step?: number;
+    /** PageUp/PageDown step, default max(step, one tenth of the span) snapped to step. */
+    pageStep?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    orientation?: SliderOrientation;
+    /** Standard HTML direction; RTL mirrors horizontal pointer mapping and Arrow keys. */
+    dir?: string;
+    /** Submitted with each thumb's value (range: two entries with the same name). */
+    name?: string;
+    form?: string;
+    /** Range thumb names appended to `label`; default ["最小值", "最大值"]. */
+    thumbLabels?: readonly [string, string];
+    /** aria-valuetext with {value}; default "{value}". */
+    valueTextTemplate?: string;
+    /** Every requested change (pointer move, key, programmatic). */
+    onValueChange?: (details: SliderValueChangeDetails) => void;
+    /** End of an interaction: pointer release or a keyboard step. */
+    onValueCommit?: (details: SliderValueChangeDetails) => void;
+}
+export interface ResolvedSliderState {
+    min: number;
+    max: number;
+    step: number;
+    pageStep: number;
+    range: boolean;
+    orientation: SliderOrientation;
+    dir: string | undefined;
+    disabled: boolean;
+    readOnly: boolean;
+    thumbLabels: [string, string];
+    valueTextTemplate: string;
+}
+export declare function resolveSliderState(props?: Partial<QwSliderProps>): ResolvedSliderState;
+/** Clamp into [lower, upper] and snap to the step grid anchored at min; the bounds themselves stay reachable. */
+export declare function snapSliderValue(state: Pick<ResolvedSliderState, "min" | "max" | "step">, value: number, lower?: number, upper?: number): number;
+/** Any input shape becomes an ascending, snapped array of length 1 (single) or 2 (range). */
+export declare function normalizeSliderValues(state: ResolvedSliderState, value: SliderValue | readonly number[] | undefined): number[];
+/** Public payload shape. */
+export declare function toSliderValue(state: Pick<ResolvedSliderState, "range">, values: readonly number[]): SliderValue;
+/** Bounds a thumb may move within: range thumbs never cross. */
+export declare function getSliderThumbBounds(state: ResolvedSliderState, values: readonly number[], index: number): {
+    lower: number;
+    upper: number;
+};
+export declare function getSliderPercent(state: Pick<ResolvedSliderState, "min" | "max">, value: number): number;
+export interface SliderRect {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+/** Pointer geometry → raw value. Horizontal RTL measures from the right; vertical measures from the bottom. */
+export declare function getSliderPointValue(state: ResolvedSliderState, point: {
+    x: number;
+    y: number;
+}, rect: SliderRect, rtl: boolean): number | null;
+/** Nearest thumb; coincident thumbs choose by the side the pointer is on. */
+export declare function getSliderClosestThumb(values: readonly number[], value: number): number;
+/** Keyboard step result for one thumb (APG slider): Arrow ±step, Page ±pageStep, Home/End to the thumb bounds. */
+export declare function getSliderKeyValue(state: ResolvedSliderState, values: readonly number[], index: number, key: string): number | null;
+export declare function createSliderProps(props: QwSliderProps): QwSliderProps;
+export interface QwSliderSchema {
+    props: QwSliderProps;
+    context: {
+        value: SliderValue;
+        activeIndex: number;
+        focusedIndex: number;
+        pointerId: number | null;
+        requested: number[] | null;
+        inheritedDisabled: boolean;
+    };
+    state: "idle" | "dragging";
+    guard: "canInteract";
+    action: "setThumb" | "setValues" | "startDrag" | "moveDrag" | "endDrag" | "cancelDrag" | "setFocus" | "resetForm" | "setInheritedDisabled";
+    effect: "trackForm" | "capturePointer";
+    event: {
+        type: "THUMB.SET";
+        index: number;
+        value: number;
+        commit?: boolean;
+    } | {
+        type: "VALUES.SET";
+        value: SliderValue;
+    } | {
+        type: "POINTER.DOWN";
+        pointerId: number;
+        value: number;
+    } | {
+        type: "POINTER.MOVE";
+        pointerId: number;
+        value: number;
+    } | {
+        type: "POINTER.UP";
+        pointerId: number;
+    } | {
+        type: "POINTER.CANCEL";
+        pointerId?: number;
+    } | {
+        type: "FOCUS.SET";
+        index: number;
+    } | {
+        type: "FORM.RESET";
+    } | {
+        type: "FIELDSET.DISABLED";
+        disabled: boolean;
+    };
+}
+export type QwSliderMachine = Machine<QwSliderSchema>;
+export type QwSliderService = Service<QwSliderSchema>;
+/** Bindable values own controlled/uncontrolled; a controlled owner rejects a request simply by not updating `value`. */
+export declare const sliderMachine: QwSliderMachine;
+export interface SliderThumb {
+    index: number;
+    key: string;
+    value: number;
+    percent: number;
+    label: string;
+    valueText: string;
+    min: number;
+    max: number;
+    active: boolean;
+    focused: boolean;
+}
+export interface QwSliderApi<T extends PropTypes = PropTypes> {
+    value: SliderValue;
+    values: number[];
+    thumbs: SliderThumb[];
+    label: string;
+    dragging: boolean;
+    disabled: boolean;
+    setValue(value: SliderValue): void;
+    setThumbValue(index: number, value: number): void;
+    getRootProps(): T["element"];
+    getLabelProps(): T["element"];
+    getControlProps(): T["element"];
+    getTrackProps(): T["element"];
+    getRangeProps(): T["element"];
+    getThumbProps(thumb: Pick<SliderThumb, "index">): T["element"];
+    /** One hidden form input per thumb. Always render them: they carry form reset/fieldset tracking and submit only with `name`. */
+    getInputProps(thumb: Pick<SliderThumb, "index">): T["input"];
+}
+export declare function connectSlider<T extends PropTypes>(service: QwSliderService, normalize: NormalizeProps<T>): QwSliderApi<T>;

package/dist/space/index.d.ts

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

package/dist/space/index.js

@@ -0,0 +1,52 @@
+import { i as resolveLayoutGap, n as getLayoutGroupProps, t as LAYOUT_GAP_PRESETS } from "../layout-BRSqi4AQ.js";
+//#region src/space/space.ts
+const SPACE_DIRECTIONS = ["horizontal", "vertical"];
+const SPACE_ALIGNS = [
+	"start",
+	"end",
+	"center",
+	"baseline",
+	"stretch"
+];
+const SPACE_JUSTIFIES = [
+	"start",
+	"end",
+	"center",
+	"between",
+	"around",
+	"evenly"
+];
+function resolveSpaceState(props = {}) {
+	const direction = SPACE_DIRECTIONS.includes(props.direction) ? props.direction : "horizontal";
+	return {
+		direction,
+		align: SPACE_ALIGNS.includes(props.align) ? props.align : direction === "vertical" ? "stretch" : "center",
+		justify: SPACE_JUSTIFIES.includes(props.justify) ? props.justify : "start",
+		wrap: direction === "horizontal" && !!props.wrap,
+		block: !!props.block,
+		gap: resolveLayoutGap(props.gap),
+		label: props.label
+	};
+}
+function getSpaceRootProps(state) {
+	return {
+		"data-scope": "space",
+		"data-part": "root",
+		"data-direction": state.direction,
+		"data-align": state.align,
+		"data-justify": state.justify,
+		...state.wrap ? { "data-wrap": "true" } : {},
+		...state.block ? { "data-block": "true" } : {},
+		...getLayoutGroupProps(state.label)
+	};
+}
+function getSpaceStyle(state) {
+	return {
+		"--qw-space-row-gap": state.gap[0],
+		"--qw-space-column-gap": state.gap[1]
+	};
+}
+//#endregion
+export { LAYOUT_GAP_PRESETS, SPACE_ALIGNS, SPACE_DIRECTIONS, SPACE_JUSTIFIES, getSpaceRootProps, getSpaceStyle, resolveSpaceState };
+
+//# sourceMappingURL=index.js.map

package/dist/space/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/space/space.ts"],"sourcesContent":["import { resolveLayoutGap, getLayoutGroupProps, type LayoutGap, type LayoutStyle, type LayoutGroupProps } from \"../layout.js\";\nexport { LAYOUT_GAP_PRESETS } from \"../layout.js\";\nexport type { LayoutGap, LayoutGapAtom, LayoutStyle, LayoutGroupProps } from \"../layout.js\";\nexport const SPACE_DIRECTIONS = [\"horizontal\", \"vertical\"] as const;\nexport const SPACE_ALIGNS = [\"start\", \"end\", \"center\", \"baseline\", \"stretch\"] as const;\nexport const SPACE_JUSTIFIES = [\"start\", \"end\", \"center\", \"between\", \"around\", \"evenly\"] as const;\nexport type SpaceDirection = (typeof SPACE_DIRECTIONS)[number];\nexport type SpaceAlign = (typeof SPACE_ALIGNS)[number];\nexport type SpaceJustify = (typeof SPACE_JUSTIFIES)[number];\nexport interface QwSpaceProps {\n  /** Main layout direction, default horizontal. */\n  direction?: SpaceDirection;\n  /** Cross-axis alignment; horizontal defaults center, vertical stretch. */\n  align?: SpaceAlign;\n  /** Main-axis distribution, default start. */\n  justify?: SpaceJustify;\n  /** Wrap horizontal items; ignored for vertical layouts. */\n  wrap?: boolean;\n  /** Fill the available inline width. */\n  block?: boolean;\n  /** Preset, numeric pixels, CSS length or CSS-order [row, column]. Default sm. */\n  gap?: LayoutGap;\n  /** Optional accessible group name; empty/omitted keeps a passive div. */\n  label?: string | null;\n}\nexport interface ResolvedSpaceState { direction: SpaceDirection; align: SpaceAlign; justify: SpaceJustify; wrap: boolean; block: boolean; gap: readonly [string,string]; label?: string | null }\nexport function resolveSpaceState(props: QwSpaceProps = {}): ResolvedSpaceState {\n  const direction = SPACE_DIRECTIONS.includes(props.direction!) ? props.direction! : \"horizontal\";\n  return { direction, align: SPACE_ALIGNS.includes(props.align!) ? props.align! : direction === \"vertical\" ? \"stretch\" : \"center\",\n    justify: SPACE_JUSTIFIES.includes(props.justify!) ? props.justify! : \"start\", wrap: direction === \"horizontal\" && !!props.wrap, block: !!props.block,\n    gap: resolveLayoutGap(props.gap), label: props.label };\n}\nexport interface SpaceRootProps extends LayoutGroupProps { \"data-scope\": \"space\"; \"data-part\": \"root\"; \"data-direction\": SpaceDirection; \"data-align\": SpaceAlign; \"data-justify\": SpaceJustify; \"data-wrap\"?: \"true\"; \"data-block\"?: \"true\" }\nexport function getSpaceRootProps(state: ResolvedSpaceState): SpaceRootProps {\n  return { \"data-scope\":\"space\", \"data-part\":\"root\", \"data-direction\":state.direction, \"data-align\":state.align, \"data-justify\":state.justify,\n    ...(state.wrap ? {\"data-wrap\":\"true\" as const}:{}), ...(state.block ? {\"data-block\":\"true\" as const}:{}), ...getLayoutGroupProps(state.label) };\n}\nexport function getSpaceStyle(state: ResolvedSpaceState): LayoutStyle { return { \"--qw-space-row-gap\":state.gap[0], \"--qw-space-column-gap\":state.gap[1] }; }\n"],"mappings":";;AAGA,MAAa,mBAAmB,CAAC,cAAc,UAAU;AACzD,MAAa,eAAe;CAAC;CAAS;CAAO;CAAU;CAAY;AAAS;AAC5E,MAAa,kBAAkB;CAAC;CAAS;CAAO;CAAU;CAAW;CAAU;AAAQ;AAqBvF,SAAgB,kBAAkB,QAAsB,CAAC,GAAuB;CAC9E,MAAM,YAAY,iBAAiB,SAAS,MAAM,SAAU,IAAI,MAAM,YAAa;CACnF,OAAO;EAAE;EAAW,OAAO,aAAa,SAAS,MAAM,KAAM,IAAI,MAAM,QAAS,cAAc,aAAa,YAAY;EACrH,SAAS,gBAAgB,SAAS,MAAM,OAAQ,IAAI,MAAM,UAAW;EAAS,MAAM,cAAc,gBAAgB,CAAC,CAAC,MAAM;EAAM,OAAO,CAAC,CAAC,MAAM;EAC/I,KAAK,iBAAiB,MAAM,GAAG;EAAG,OAAO,MAAM;CAAM;AACzD;AAEA,SAAgB,kBAAkB,OAA2C;CAC3E,OAAO;EAAE,cAAa;EAAS,aAAY;EAAQ,kBAAiB,MAAM;EAAW,cAAa,MAAM;EAAO,gBAAe,MAAM;EAClI,GAAI,MAAM,OAAO,EAAC,aAAY,OAAe,IAAE,CAAC;EAAI,GAAI,MAAM,QAAQ,EAAC,cAAa,OAAe,IAAE,CAAC;EAAI,GAAG,oBAAoB,MAAM,KAAK;CAAE;AAClJ;AACA,SAAgB,cAAc,OAAwC;CAAE,OAAO;EAAE,sBAAqB,MAAM,IAAI;EAAI,yBAAwB,MAAM,IAAI;CAAG;AAAG"}

package/dist/space/space.d.ts

@@ -0,0 +1,46 @@
+import { type LayoutGap, type LayoutStyle, type LayoutGroupProps } from "../layout.js";
+export { LAYOUT_GAP_PRESETS } from "../layout.js";
+export type { LayoutGap, LayoutGapAtom, LayoutStyle, LayoutGroupProps } from "../layout.js";
+export declare const SPACE_DIRECTIONS: readonly ["horizontal", "vertical"];
+export declare const SPACE_ALIGNS: readonly ["start", "end", "center", "baseline", "stretch"];
+export declare const SPACE_JUSTIFIES: readonly ["start", "end", "center", "between", "around", "evenly"];
+export type SpaceDirection = (typeof SPACE_DIRECTIONS)[number];
+export type SpaceAlign = (typeof SPACE_ALIGNS)[number];
+export type SpaceJustify = (typeof SPACE_JUSTIFIES)[number];
+export interface QwSpaceProps {
+    /** Main layout direction, default horizontal. */
+    direction?: SpaceDirection;
+    /** Cross-axis alignment; horizontal defaults center, vertical stretch. */
+    align?: SpaceAlign;
+    /** Main-axis distribution, default start. */
+    justify?: SpaceJustify;
+    /** Wrap horizontal items; ignored for vertical layouts. */
+    wrap?: boolean;
+    /** Fill the available inline width. */
+    block?: boolean;
+    /** Preset, numeric pixels, CSS length or CSS-order [row, column]. Default sm. */
+    gap?: LayoutGap;
+    /** Optional accessible group name; empty/omitted keeps a passive div. */
+    label?: string | null;
+}
+export interface ResolvedSpaceState {
+    direction: SpaceDirection;
+    align: SpaceAlign;
+    justify: SpaceJustify;
+    wrap: boolean;
+    block: boolean;
+    gap: readonly [string, string];
+    label?: string | null;
+}
+export declare function resolveSpaceState(props?: QwSpaceProps): ResolvedSpaceState;
+export interface SpaceRootProps extends LayoutGroupProps {
+    "data-scope": "space";
+    "data-part": "root";
+    "data-direction": SpaceDirection;
+    "data-align": SpaceAlign;
+    "data-justify": SpaceJustify;
+    "data-wrap"?: "true";
+    "data-block"?: "true";
+}
+export declare function getSpaceRootProps(state: ResolvedSpaceState): SpaceRootProps;
+export declare function getSpaceStyle(state: ResolvedSpaceState): LayoutStyle;

package/dist/statistic/index.d.ts

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

package/dist/statistic/index.js

@@ -0,0 +1,152 @@
+import { i as roundDecimal, n as parseDecimal, r as resolveDecimalPrecision, t as groupDecimalInteger } from "../format-BDUY0C_c.js";
+import { visuallyHiddenStyle } from "@zag-js/dom-query";
+//#region src/statistic/statistic.ts
+const STATISTIC_SIZES = [
+	"sm",
+	"md",
+	"lg"
+];
+const STATISTIC_TRENDS = [
+	"up",
+	"down",
+	"flat"
+];
+const STATISTIC_LIVE_MODES = ["off", "polite"];
+/** Stable DOM parts shared by every adapter. */
+const STATISTIC_PARTS = [
+	"root",
+	"title",
+	"content",
+	"prefix",
+	"value",
+	"integer",
+	"decimal",
+	"fraction",
+	"suffix",
+	"trend",
+	"trend-label"
+];
+const STATISTIC_DEFAULT_PLACEHOLDER = "--";
+const STATISTIC_TREND_LABELS = {
+	up: "上升",
+	down: "下降",
+	flat: "持平"
+};
+const TREND_GLYPHS = {
+	up: "▲",
+	down: "▼",
+	flat: "–"
+};
+const pick = (list, value, fallback) => list.includes(value) ? value : fallback;
+/** Format the value synchronously so the readable text is always the final value. */
+function resolveStatisticState(props) {
+	const trend = STATISTIC_TRENDS.includes(props.trend) ? props.trend : void 0;
+	const base = {
+		title: props.title ?? "",
+		prefix: props.prefix ?? "",
+		suffix: props.suffix ?? "",
+		trend,
+		trendGlyph: trend ? TREND_GLYPHS[trend] : "",
+		trendLabel: trend ? props.trendLabel ?? STATISTIC_TREND_LABELS[trend] : "",
+		live: pick(STATISTIC_LIVE_MODES, props.live, "off"),
+		size: pick(STATISTIC_SIZES, props.size, "md")
+	};
+	const parsed = props.value === void 0 || props.value === "" ? null : parseDecimal(props.value);
+	if (!parsed) return {
+		...base,
+		valid: false,
+		negative: false,
+		formatted: false,
+		text: props.placeholder ?? "--",
+		sign: "",
+		integer: "",
+		decimal: "",
+		fraction: ""
+	};
+	const precision = resolveDecimalPrecision(props.precision, void 0);
+	const rounded = precision === void 0 ? parsed : roundDecimal(parsed, precision);
+	const integer = groupDecimalInteger(rounded.integer, props.groupSeparator ?? ",");
+	const decimal = rounded.fraction ? props.decimalSeparator ?? "." : "";
+	const sign = rounded.negative ? "-" : "";
+	const text = `${sign}${integer}${decimal}${rounded.fraction}`;
+	let custom;
+	if (props.formatter) try {
+		custom = props.formatter({
+			value: props.value,
+			negative: rounded.negative,
+			integer,
+			fraction: rounded.fraction,
+			text
+		});
+	} catch {
+		custom = void 0;
+	}
+	const formatted = typeof custom === "string";
+	return {
+		...base,
+		valid: true,
+		negative: rounded.negative,
+		formatted,
+		text: formatted ? custom : text,
+		sign,
+		integer,
+		decimal,
+		fraction: rounded.fraction
+	};
+}
+function getStatisticRootProps(state) {
+	return {
+		"data-scope": "statistic",
+		"data-part": "root",
+		"data-size": state.size,
+		...state.trend ? { "data-trend": state.trend } : {},
+		...state.negative ? { "data-negative": "" } : {},
+		...!state.valid ? { "data-invalid": "" } : {}
+	};
+}
+/** The content row is one atomic polite region only when explicitly requested. */
+function getStatisticContentProps(state) {
+	return {
+		"data-scope": "statistic",
+		"data-part": "content",
+		...state.live === "polite" ? {
+			"aria-live": "polite",
+			"aria-atomic": "true"
+		} : {}
+	};
+}
+/** Empty optional parts carry `hidden`, so adapters render a fixed tree without branches. */
+function getStatisticPartProps(state, part) {
+	const props = {
+		"data-scope": "statistic",
+		"data-part": part,
+		...(part === "title" ? !state.title : part === "prefix" ? !state.prefix : part === "suffix" ? !state.suffix : part === "trend" || part === "trend-label" ? !state.trend : false) ? { hidden: true } : {}
+	};
+	if (part === "trend") props["aria-hidden"] = "true";
+	if (part === "trend-label") props.style = { ...visuallyHiddenStyle };
+	return props;
+}
+function getStatisticSegments(state) {
+	if (!state.valid || state.formatted) return [{
+		part: "integer",
+		text: state.text
+	}];
+	return [
+		{
+			part: "integer",
+			text: `${state.sign}${state.integer}`
+		},
+		{
+			part: "decimal",
+			text: state.decimal
+		},
+		{
+			part: "fraction",
+			text: state.fraction
+		}
+	].filter((segment) => segment.text !== "");
+}
+//#endregion
+export { STATISTIC_DEFAULT_PLACEHOLDER, STATISTIC_LIVE_MODES, STATISTIC_PARTS, STATISTIC_SIZES, STATISTIC_TRENDS, STATISTIC_TREND_LABELS, getStatisticContentProps, getStatisticPartProps, getStatisticRootProps, getStatisticSegments, resolveStatisticState };
+
+//# sourceMappingURL=index.js.map

package/dist/statistic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/statistic/statistic.ts"],"sourcesContent":["import { visuallyHiddenStyle } from \"@zag-js/dom-query\";\nimport { groupDecimalInteger, parseDecimal, resolveDecimalPrecision, roundDecimal } from \"../price/format.js\";\n\nexport const STATISTIC_SIZES = [\"sm\", \"md\", \"lg\"] as const;\nexport const STATISTIC_TRENDS = [\"up\", \"down\", \"flat\"] as const;\nexport const STATISTIC_LIVE_MODES = [\"off\", \"polite\"] as const;\n/** Stable DOM parts shared by every adapter. */\nexport const STATISTIC_PARTS = [\"root\", \"title\", \"content\", \"prefix\", \"value\", \"integer\", \"decimal\", \"fraction\", \"suffix\", \"trend\", \"trend-label\"] as const;\nexport const STATISTIC_DEFAULT_PLACEHOLDER = \"--\";\nexport const STATISTIC_TREND_LABELS = { up: \"上升\", down: \"下降\", flat: \"持平\" } as const;\nconst TREND_GLYPHS = { up: \"▲\", down: \"▼\", flat: \"–\" } as const;\n\nexport type StatisticSize = (typeof STATISTIC_SIZES)[number];\nexport type StatisticTrend = (typeof STATISTIC_TRENDS)[number];\nexport type StatisticLiveMode = (typeof STATISTIC_LIVE_MODES)[number];\nexport type StatisticPart = (typeof STATISTIC_PARTS)[number];\n\n/** Input passed to a custom formatter; digit strings are already rounded and grouped. */\nexport interface StatisticFormatInput {\n  /** Caller value as supplied. */\n  value: number | string;\n  negative: boolean;\n  integer: string;\n  fraction: string;\n  /** Default formatted text, e.g. \"-12,345.60\". */\n  text: string;\n}\nexport type StatisticFormatter = (input: StatisticFormatInput) => string;\n\nexport interface QwStatisticProps {\n  /** Visible title read before the value. */\n  title?: string;\n  value?: number | string;\n  /** Fraction digits 0–10; omitted keeps the supplied fraction digits. */\n  precision?: number;\n  /** Integer group separator; defaults to \",\". Empty disables grouping. */\n  groupSeparator?: string;\n  decimalSeparator?: string;\n  prefix?: string;\n  suffix?: string;\n  /** Pure string formatter; exceptions or non-string results fall back to the default text. */\n  formatter?: StatisticFormatter;\n  /** Text for missing or invalid values; defaults to \"--\". */\n  placeholder?: string;\n  /** Non-color trend expression (glyph plus text). */\n  trend?: StatisticTrend;\n  trendLabel?: string;\n  /** \"polite\" makes the value area a polite live region for refreshed KPIs; defaults \"off\". */\n  live?: StatisticLiveMode;\n  size?: StatisticSize;\n}\n\nexport interface ResolvedStatisticState {\n  title: string;\n  valid: boolean;\n  negative: boolean;\n  /** True when a custom formatter produced the value text. */\n  formatted: boolean;\n  /** Visible value text (without prefix/suffix). */\n  text: string;\n  sign: string;\n  integer: string;\n  decimal: string;\n  fraction: string;\n  prefix: string;\n  suffix: string;\n  trend?: StatisticTrend;\n  trendGlyph: string;\n  trendLabel: string;\n  live: StatisticLiveMode;\n  size: StatisticSize;\n}\n\nconst pick = <T extends string>(list: readonly T[], value: unknown, fallback: T): T => (list as readonly unknown[]).includes(value) ? value as T : fallback;\n\n/** Format the value synchronously so the readable text is always the final value. */\nexport function resolveStatisticState(props: QwStatisticProps): ResolvedStatisticState {\n  const trend = (STATISTIC_TRENDS as readonly unknown[]).includes(props.trend) ? props.trend : undefined;\n  const base = {\n    title: props.title ?? \"\", prefix: props.prefix ?? \"\", suffix: props.suffix ?? \"\", trend,\n    trendGlyph: trend ? TREND_GLYPHS[trend] : \"\", trendLabel: trend ? (props.trendLabel ?? STATISTIC_TREND_LABELS[trend]) : \"\",\n    live: pick(STATISTIC_LIVE_MODES, props.live, \"off\"), size: pick(STATISTIC_SIZES, props.size, \"md\"),\n  };\n  const parsed = props.value === undefined || props.value === \"\" ? null : parseDecimal(props.value);\n  if (!parsed) {\n    return { ...base, valid: false, negative: false, formatted: false, text: props.placeholder ?? STATISTIC_DEFAULT_PLACEHOLDER, sign: \"\", integer: \"\", decimal: \"\", fraction: \"\" };\n  }\n  const precision = resolveDecimalPrecision(props.precision, undefined);\n  const rounded = precision === undefined ? parsed : roundDecimal(parsed, precision);\n  const integer = groupDecimalInteger(rounded.integer, props.groupSeparator ?? \",\");\n  const decimal = rounded.fraction ? (props.decimalSeparator ?? \".\") : \"\";\n  const sign = rounded.negative ? \"-\" : \"\";\n  const text = `${sign}${integer}${decimal}${rounded.fraction}`;\n  let custom: unknown;\n  if (props.formatter) {\n    try { custom = props.formatter({ value: props.value!, negative: rounded.negative, integer, fraction: rounded.fraction, text }); } catch { custom = undefined; }\n  }\n  const formatted = typeof custom === \"string\";\n  return { ...base, valid: true, negative: rounded.negative, formatted, text: formatted ? custom as string : text, sign, integer, decimal, fraction: rounded.fraction };\n}\n\ninterface PartBase { \"data-scope\": \"statistic\"; \"data-part\": StatisticPart }\nexport interface StatisticRootProps extends PartBase {\n  \"data-size\": StatisticSize;\n  \"data-trend\"?: StatisticTrend;\n  \"data-negative\"?: \"\";\n  \"data-invalid\"?: \"\";\n}\nexport function getStatisticRootProps(state: ResolvedStatisticState): StatisticRootProps {\n  return {\n    \"data-scope\": \"statistic\", \"data-part\": \"root\", \"data-size\": state.size,\n    ...(state.trend ? { \"data-trend\": state.trend } : {}),\n    ...(state.negative ? { \"data-negative\": \"\" as const } : {}),\n    ...(!state.valid ? { \"data-invalid\": \"\" as const } : {}),\n  };\n}\nexport interface StatisticContentProps extends PartBase { \"aria-live\"?: \"polite\"; \"aria-atomic\"?: \"true\" }\n/** The content row is one atomic polite region only when explicitly requested. */\nexport function getStatisticContentProps(state: ResolvedStatisticState): StatisticContentProps {\n  return { \"data-scope\": \"statistic\", \"data-part\": \"content\", ...(state.live === \"polite\" ? { \"aria-live\": \"polite\" as const, \"aria-atomic\": \"true\" as const } : {}) };\n}\nexport interface StatisticPartProps extends PartBase { \"aria-hidden\"?: \"true\"; hidden?: true; style?: Record<string, string> }\n/** Empty optional parts carry `hidden`, so adapters render a fixed tree without branches. */\nexport function getStatisticPartProps(state: ResolvedStatisticState, part: Exclude<StatisticPart, \"root\" | \"content\">): StatisticPartProps {\n  const empty = part === \"title\" ? !state.title : part === \"prefix\" ? !state.prefix : part === \"suffix\" ? !state.suffix : part === \"trend\" || part === \"trend-label\" ? !state.trend : false;\n  const props: StatisticPartProps = { \"data-scope\": \"statistic\", \"data-part\": part, ...(empty ? { hidden: true as const } : {}) };\n  if (part === \"trend\") props[\"aria-hidden\"] = \"true\";\n  if (part === \"trend-label\") props.style = { ...visuallyHiddenStyle } as Record<string, string>;\n  return props;\n}\n\n/** Value segments: a formatter or placeholder yields one text segment, otherwise integer/decimal/fraction. */\nexport interface StatisticSegment { part: \"integer\" | \"decimal\" | \"fraction\"; text: string }\nexport function getStatisticSegments(state: ResolvedStatisticState): StatisticSegment[] {\n  if (!state.valid || state.formatted) return [{ part: \"integer\", text: state.text }];\n  return ([\n    { part: \"integer\", text: `${state.sign}${state.integer}` },\n    { part: \"decimal\", text: state.decimal },\n    { part: \"fraction\", text: state.fraction },\n  ] as StatisticSegment[]).filter((segment) => segment.text !== \"\");\n}\n"],"mappings":"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"}

package/dist/statistic/statistic.d.ts

@@ -0,0 +1,101 @@
+export declare const STATISTIC_SIZES: readonly ["sm", "md", "lg"];
+export declare const STATISTIC_TRENDS: readonly ["up", "down", "flat"];
+export declare const STATISTIC_LIVE_MODES: readonly ["off", "polite"];
+/** Stable DOM parts shared by every adapter. */
+export declare const STATISTIC_PARTS: readonly ["root", "title", "content", "prefix", "value", "integer", "decimal", "fraction", "suffix", "trend", "trend-label"];
+export declare const STATISTIC_DEFAULT_PLACEHOLDER = "--";
+export declare const STATISTIC_TREND_LABELS: {
+    readonly up: "上升";
+    readonly down: "下降";
+    readonly flat: "持平";
+};
+export type StatisticSize = (typeof STATISTIC_SIZES)[number];
+export type StatisticTrend = (typeof STATISTIC_TRENDS)[number];
+export type StatisticLiveMode = (typeof STATISTIC_LIVE_MODES)[number];
+export type StatisticPart = (typeof STATISTIC_PARTS)[number];
+/** Input passed to a custom formatter; digit strings are already rounded and grouped. */
+export interface StatisticFormatInput {
+    /** Caller value as supplied. */
+    value: number | string;
+    negative: boolean;
+    integer: string;
+    fraction: string;
+    /** Default formatted text, e.g. "-12,345.60". */
+    text: string;
+}
+export type StatisticFormatter = (input: StatisticFormatInput) => string;
+export interface QwStatisticProps {
+    /** Visible title read before the value. */
+    title?: string;
+    value?: number | string;
+    /** Fraction digits 0–10; omitted keeps the supplied fraction digits. */
+    precision?: number;
+    /** Integer group separator; defaults to ",". Empty disables grouping. */
+    groupSeparator?: string;
+    decimalSeparator?: string;
+    prefix?: string;
+    suffix?: string;
+    /** Pure string formatter; exceptions or non-string results fall back to the default text. */
+    formatter?: StatisticFormatter;
+    /** Text for missing or invalid values; defaults to "--". */
+    placeholder?: string;
+    /** Non-color trend expression (glyph plus text). */
+    trend?: StatisticTrend;
+    trendLabel?: string;
+    /** "polite" makes the value area a polite live region for refreshed KPIs; defaults "off". */
+    live?: StatisticLiveMode;
+    size?: StatisticSize;
+}
+export interface ResolvedStatisticState {
+    title: string;
+    valid: boolean;
+    negative: boolean;
+    /** True when a custom formatter produced the value text. */
+    formatted: boolean;
+    /** Visible value text (without prefix/suffix). */
+    text: string;
+    sign: string;
+    integer: string;
+    decimal: string;
+    fraction: string;
+    prefix: string;
+    suffix: string;
+    trend?: StatisticTrend;
+    trendGlyph: string;
+    trendLabel: string;
+    live: StatisticLiveMode;
+    size: StatisticSize;
+}
+/** Format the value synchronously so the readable text is always the final value. */
+export declare function resolveStatisticState(props: QwStatisticProps): ResolvedStatisticState;
+interface PartBase {
+    "data-scope": "statistic";
+    "data-part": StatisticPart;
+}
+export interface StatisticRootProps extends PartBase {
+    "data-size": StatisticSize;
+    "data-trend"?: StatisticTrend;
+    "data-negative"?: "";
+    "data-invalid"?: "";
+}
+export declare function getStatisticRootProps(state: ResolvedStatisticState): StatisticRootProps;
+export interface StatisticContentProps extends PartBase {
+    "aria-live"?: "polite";
+    "aria-atomic"?: "true";
+}
+/** The content row is one atomic polite region only when explicitly requested. */
+export declare function getStatisticContentProps(state: ResolvedStatisticState): StatisticContentProps;
+export interface StatisticPartProps extends PartBase {
+    "aria-hidden"?: "true";
+    hidden?: true;
+    style?: Record<string, string>;
+}
+/** Empty optional parts carry `hidden`, so adapters render a fixed tree without branches. */
+export declare function getStatisticPartProps(state: ResolvedStatisticState, part: Exclude<StatisticPart, "root" | "content">): StatisticPartProps;
+/** Value segments: a formatter or placeholder yields one text segment, otherwise integer/decimal/fraction. */
+export interface StatisticSegment {
+    part: "integer" | "decimal" | "fraction";
+    text: string;
+}
+export declare function getStatisticSegments(state: ResolvedStatisticState): StatisticSegment[];
+export {};

package/dist/stepper/index.js

@@ -2,8 +2,8 @@
 /**
 * Stepper 加减（数量步进器）的跨框架行为契约。
 *
-* Stepper 是原型 A（无状态 Core 状态机）：交互由原生 `<button>` 承担，
-* core 只负责数值归一化、边界 clamp、按钮可用性计算与 prop-getter 生成。
+* 交互由原生 `<button>` 承担。数值归一化、边界、按钮可用性、非受控模型、
+* 受控判断和取消都在 Core；适配层只运输点击并重绘。
 */
 /** 尺寸全集：s = 15×15px，m = 18×18px。 */
 const STEPPER_SIZES = ["s", "m"];
@@ -107,7 +107,66 @@ function getStepperValueProps() {
 		"aria-atomic": "true"
 	};
 }
+function seedStepperModel(props, snapshot) {
+	if (props.value === void 0 && typeof snapshot?.value === "number") return snapshot.value;
+	if (typeof props.defaultValue === "number") return props.defaultValue;
+	if (typeof props.min === "number") return props.min;
+	return 0;
+}
+/**
+* 步进器的行为源。下一步在提交时按当时的模型计算：同一次任务里连续激活会依次累计，
+* 而不是共用渲染当时预算的同一个 next。取消只看提交时的 defaultPrevented、禁用和 stop。
+*/
+function createStepperModel(props = {}, options = {}) {
+	let current = props;
+	let internal = seedStepperModel(props, options.snapshot);
+	let generation = 0;
+	let stopped = false;
+	const controlledNow = () => current.value !== void 0;
+	const view = () => resolveStepperState({
+		...current,
+		value: controlledNow() ? current.value : internal
+	});
+	const readModel = () => controlledNow() ? current.value ?? internal : internal;
+	return {
+		get state() {
+			return view();
+		},
+		get modelValue() {
+			return readModel();
+		},
+		get controlled() {
+			return controlledNow();
+		},
+		update(next) {
+			current = next;
+		},
+		request(direction, notice) {
+			if (stopped || view().disabled) return;
+			const seen = generation;
+			queueMicrotask(() => {
+				if (stopped || seen !== generation || notice.defaultPrevented) return;
+				const resolved = view();
+				if (resolved.disabled) return;
+				const next = direction === "increment" ? getStepperIncrementValue(resolved) : getStepperDecrementValue(resolved);
+				if (!controlledNow()) internal = next;
+				current.onChange?.(next);
+				options.onCommit?.();
+			});
+		},
+		start() {
+			stopped = false;
+		},
+		stop() {
+			stopped = true;
+			generation += 1;
+		},
+		snapshot() {
+			return { value: readModel() };
+		}
+	};
+}
 //#endregion
-export { STEPPER_PARTS, STEPPER_SIZES, STEPPER_VARIANTS, clampStepperValue, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, resolveStepperState };
+export { STEPPER_PARTS, STEPPER_SIZES, STEPPER_VARIANTS, clampStepperValue, createStepperModel, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, resolveStepperState };
 
 //# sourceMappingURL=index.js.map