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

package/dist/field/field.d.ts

@@ -0,0 +1,95 @@
+import { type QwNamePath } from "../form/model.js";
+export declare const FIELD_LABEL_MODES: readonly ["label", "control", "custom"];
+export declare const FIELD_LAYOUTS: readonly ["stacked", "inline"];
+export declare const FIELD_PARTS: readonly ["root", "label", "required", "control", "description", "error", "status"];
+export type FieldLabelMode = (typeof FIELD_LABEL_MODES)[number];
+export type FieldLayout = (typeof FIELD_LAYOUTS)[number];
+/** Pure association/feedback container; Form owns value and validation. */
+export interface QwFieldProps {
+    /** Adapters supply an SSR-safe identity when omitted. */
+    id?: string;
+    name?: QwNamePath;
+    label?: string;
+    description?: string;
+    errors?: string[];
+    controlId?: string;
+    /** label links an actual labelable input; control avoids duplicate own names. */
+    labelMode?: FieldLabelMode;
+    required?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    validating?: boolean;
+    layout?: FieldLayout;
+    validatingLabel?: string;
+}
+export interface ResolvedFieldState {
+    id: string;
+    key?: string;
+    label: string;
+    description: string;
+    errors: string[];
+    controlId?: string;
+    labelMode: FieldLabelMode;
+    labelTag: "label" | "span";
+    layout: FieldLayout;
+    required: boolean;
+    disabled: boolean;
+    invalid: boolean;
+    validating: boolean;
+    validatingLabel: string;
+    labelId: string;
+    descriptionId: string;
+    errorId: string;
+    statusId: string;
+    describedBy?: string;
+}
+export declare function resolveFieldState(props: QwFieldProps): ResolvedFieldState;
+export declare function getFieldRootProps(state: ResolvedFieldState): {
+    "data-scope": "field";
+    "data-part": string;
+    id: string;
+    "data-field-key": string | undefined;
+    "data-label-mode": "control" | "custom" | "label";
+    "data-layout": "inline" | "stacked";
+    "data-required": string | undefined;
+    "data-disabled": string | undefined;
+    "data-invalid": string | undefined;
+    "aria-busy": true | undefined;
+};
+export declare function getFieldLabelProps(state: ResolvedFieldState): {
+    "data-scope": "field";
+    "data-part": string;
+    id: string;
+    htmlFor: string | undefined;
+    hidden: boolean;
+};
+export declare function getFieldRequiredProps(state: ResolvedFieldState): {
+    "data-scope": "field";
+    "data-part": string;
+    hidden: boolean;
+    "aria-hidden": boolean;
+};
+export declare function getFieldControlProps(_state: ResolvedFieldState): {
+    "data-scope": "field";
+    "data-part": string;
+};
+export declare function getFieldDescriptionProps(state: ResolvedFieldState): {
+    "data-scope": "field";
+    "data-part": string;
+    id: string;
+    hidden: boolean;
+};
+export declare function getFieldErrorProps(state: ResolvedFieldState): {
+    "data-scope": "field";
+    "data-part": string;
+    id: string;
+    role: "alert";
+    hidden: boolean;
+};
+export declare function getFieldStatusProps(state: ResolvedFieldState): {
+    "data-scope": "field";
+    "data-part": string;
+    id: string;
+    role: "status";
+    hidden: boolean;
+};

package/dist/field/index.d.ts

@@ -0,0 +1,2 @@
+export { FIELD_LABEL_MODES, FIELD_LAYOUTS, FIELD_PARTS, resolveFieldState, getFieldRootProps, getFieldLabelProps, getFieldRequiredProps, getFieldControlProps, getFieldDescriptionProps, getFieldErrorProps, getFieldStatusProps } from "./field.js";
+export type { FieldLabelMode, FieldLayout, QwFieldProps, ResolvedFieldState } from "./field.js";

package/dist/field/index.js

@@ -0,0 +1,2 @@
+import { a as getFieldDescriptionProps, c as getFieldRequiredProps, d as resolveFieldState, i as getFieldControlProps, l as getFieldRootProps, n as FIELD_LAYOUTS, o as getFieldErrorProps, r as FIELD_PARTS, s as getFieldLabelProps, t as FIELD_LABEL_MODES, u as getFieldStatusProps } from "../field-DMHGIMZF.js";
+export { FIELD_LABEL_MODES, FIELD_LAYOUTS, FIELD_PARTS, getFieldControlProps, getFieldDescriptionProps, getFieldErrorProps, getFieldLabelProps, getFieldRequiredProps, getFieldRootProps, getFieldStatusProps, resolveFieldState };

package/dist/field-DMHGIMZF.js

@@ -0,0 +1,241 @@
+//#region src/form/model.ts
+const forbidden = /* @__PURE__ */ new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
+const plain = (value) => !!value && typeof value === "object" && !Array.isArray(value) && [Object.prototype, null].includes(Object.getPrototypeOf(value));
+/** Strings are literal single segments, never implicit dot/bracket parsing. */
+function normalizeFormNamePath(name) {
+	const path = typeof name === "string" ? [name] : Array.isArray(name) ? [...name] : [];
+	if (!path.length || path.length > 64 || path.some((segment) => typeof segment === "string" ? !segment.length || forbidden.has(segment) : typeof segment !== "number" || !Number.isSafeInteger(segment) || segment < 0)) throw new TypeError("Form name paths require nonempty safe string/integer segments without prototype names");
+	return path;
+}
+function formFieldKey(name) {
+	return JSON.stringify(normalizeFormNamePath(name));
+}
+function formFieldNativeName(name) {
+	return normalizeFormNamePath(name).map((segment, index) => index ? `[${segment}]` : String(segment)).join("");
+}
+function copy(value, ancestors, depth) {
+	if (depth > 64) throw new TypeError("Form values exceed maximum depth");
+	if (value === null || typeof value === "string" || typeof value === "boolean") return value;
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (!Array.isArray(value) && !plain(value)) throw new TypeError("Form values must be finite plain JSON without undefined, classes or functions");
+	if (ancestors.has(value)) throw new TypeError("Cyclic Form values");
+	ancestors.add(value);
+	let result;
+	if (Array.isArray(value)) {
+		const entries = [];
+		for (let index = 0; index < value.length; index++) {
+			if (!Object.hasOwn(value, index)) throw new TypeError("Form JSON arrays must be dense");
+			entries.push(copy(value[index], ancestors, depth + 1));
+		}
+		result = entries;
+	} else result = Object.fromEntries(Object.entries(value).map(([key, child]) => [key, copy(child, ancestors, depth + 1)]));
+	ancestors.delete(value);
+	return result;
+}
+function cloneFormValue(value) {
+	return copy(value, /* @__PURE__ */ new Set(), 0);
+}
+function cloneFormValues(values = {}) {
+	if (!plain(values)) throw new TypeError("Form values root must be a plain record");
+	return cloneFormValue(values);
+}
+/** Fresh recursively frozen validator snapshot; never freeze caller storage. */
+function freezeFormValues(values) {
+	const freeze = (value) => {
+		if (value && typeof value === "object") {
+			Object.values(value).forEach(freeze);
+			Object.freeze(value);
+		}
+	};
+	const cloned = cloneFormValues(values);
+	freeze(cloned);
+	return cloned;
+}
+/** Canonical comparison keeps object key order from manufacturing dirty changes. */
+function formValueFingerprint(value) {
+	const canonical = (node) => Array.isArray(node) ? node.map(canonical) : plain(node) ? Object.fromEntries(Object.keys(node).sort().map((key) => [key, canonical(node[key])])) : node;
+	return value === void 0 ? "undefined" : JSON.stringify(canonical(value));
+}
+function formValuesEqual(a, b) {
+	return !!b && formValueFingerprint(a) === formValueFingerprint(b);
+}
+function getFormValue(values, name) {
+	let current = values;
+	for (const segment of normalizeFormNamePath(name)) {
+		if (!current || typeof current !== "object" || Array.isArray(current) && typeof segment !== "number" || !Object.hasOwn(current, segment)) return void 0;
+		current = current[segment];
+	}
+	return current === void 0 ? void 0 : cloneFormValue(current);
+}
+function hasFormValue(values, name) {
+	return getFormValue(values, name) !== void 0;
+}
+/** Immutable path update. Dense arrays retain explicit JSON semantics. */
+function setFormValue(values, name, value) {
+	const path = normalizeFormNamePath(name), result = cloneFormValues(values), nextValue = value === void 0 ? void 0 : cloneFormValue(value);
+	let current = result;
+	for (let index = 0; index < path.length; index++) {
+		const segment = path[index], last = index === path.length - 1;
+		if (Array.isArray(current)) {
+			if (typeof segment !== "number" || segment > 4294967293) throw new TypeError("Form array paths require valid numeric indexes");
+			if (segment - current.length > 1e4) throw new RangeError("Form sparse array expansion exceeds 10000 missing positions");
+			if (last && nextValue === void 0) {
+				if (segment < current.length) current.splice(segment, 1);
+				break;
+			}
+			while (current.length <= segment) current.push(null);
+		}
+		const record = current;
+		if (last) {
+			if (nextValue === void 0) delete record[segment];
+			else Object.defineProperty(record, segment, {
+				value: nextValue,
+				enumerable: true,
+				configurable: true,
+				writable: true
+			});
+			break;
+		}
+		const existing = record[segment];
+		if (!(Array.isArray(existing) || plain(existing))) {
+			const child = typeof path[index + 1] === "number" ? [] : {};
+			Object.defineProperty(record, segment, {
+				value: child,
+				enumerable: true,
+				configurable: true,
+				writable: true
+			});
+		}
+		current = record[segment];
+	}
+	return result;
+}
+/** Object recursion, array replacement; all inputs and outputs are independent. */
+function mergeFormValues(values, patch) {
+	const result = cloneFormValues(values), safePatch = cloneFormValues(patch);
+	const merge = (target, source) => {
+		for (const [key, value] of Object.entries(source)) if (plain(value) && plain(target[key])) merge(target[key], value);
+		else Object.defineProperty(target, key, {
+			value,
+			enumerable: true,
+			configurable: true,
+			writable: true
+		});
+	};
+	merge(result, safePatch);
+	return result;
+}
+//#endregion
+//#region src/field/field.ts
+const FIELD_LABEL_MODES = [
+	"label",
+	"control",
+	"custom"
+];
+const FIELD_LAYOUTS = ["stacked", "inline"];
+const FIELD_PARTS = [
+	"root",
+	"label",
+	"required",
+	"control",
+	"description",
+	"error",
+	"status"
+];
+const part = (name) => ({
+	"data-scope": "field",
+	"data-part": name
+});
+function resolveFieldState(props) {
+	if (typeof props.id !== "string" || !props.id.trim()) throw new TypeError("Field requires a nonempty stable identity");
+	const labelMode = FIELD_LABEL_MODES.includes(props.labelMode) ? props.labelMode : "label";
+	const label = props.label ?? "";
+	if (labelMode !== "control" && !label.trim()) throw new TypeError("Field requires a nonempty label unless the control names itself");
+	if (labelMode === "label" && !props.controlId?.trim()) throw new TypeError("Field label mode requires an actual labelable control id");
+	if (props.errors !== void 0 && (!Array.isArray(props.errors) || props.errors.some((error) => typeof error !== "string"))) throw new TypeError("Field errors must be strings");
+	const errors = [...new Set((props.errors ?? []).filter((error) => !!error.trim()))], id = `field:${props.id}`;
+	const description = props.description ?? "", descriptionId = `${id}:description`, errorId = `${id}:error`;
+	return {
+		id,
+		key: props.name === void 0 ? void 0 : formFieldKey(props.name),
+		label,
+		description,
+		errors,
+		controlId: props.controlId,
+		labelMode,
+		labelTag: labelMode === "label" ? "label" : "span",
+		layout: props.layout === "inline" ? "inline" : "stacked",
+		required: !!props.required,
+		disabled: !!props.disabled,
+		invalid: !!props.invalid || !!errors.length,
+		validating: !!props.validating,
+		validatingLabel: props.validatingLabel ?? "正在校验",
+		labelId: `${id}:label`,
+		descriptionId,
+		errorId,
+		statusId: `${id}:status`,
+		describedBy: [description ? descriptionId : "", errors.length ? errorId : ""].filter(Boolean).join(" ") || void 0
+	};
+}
+function getFieldRootProps(state) {
+	return {
+		...part("root"),
+		id: state.id,
+		"data-field-key": state.key,
+		"data-label-mode": state.labelMode,
+		"data-layout": state.layout,
+		"data-required": state.required ? "" : void 0,
+		"data-disabled": state.disabled ? "" : void 0,
+		"data-invalid": state.invalid ? "" : void 0,
+		"aria-busy": state.validating || void 0
+	};
+}
+function getFieldLabelProps(state) {
+	return {
+		...part("label"),
+		id: state.labelId,
+		htmlFor: state.labelMode === "label" ? state.controlId : void 0,
+		hidden: state.labelMode === "control"
+	};
+}
+function getFieldRequiredProps(state) {
+	return {
+		...part("required"),
+		hidden: !state.required || state.labelMode === "control",
+		"aria-hidden": true
+	};
+}
+function getFieldControlProps(_state) {
+	return part("control");
+}
+function getFieldDescriptionProps(state) {
+	return {
+		...part("description"),
+		id: state.descriptionId,
+		hidden: !state.description
+	};
+}
+function getFieldErrorProps(state) {
+	return {
+		...part("error"),
+		id: state.errorId,
+		role: "alert",
+		hidden: !state.errors.length
+	};
+}
+function getFieldStatusProps(state) {
+	return {
+		...part("status"),
+		id: state.statusId,
+		role: "status",
+		hidden: !state.validating
+	};
+}
+//#endregion
+export { setFormValue as C, normalizeFormNamePath as S, formValuesEqual as _, getFieldDescriptionProps as a, hasFormValue as b, getFieldRequiredProps as c, resolveFieldState as d, cloneFormValue as f, formValueFingerprint as g, formFieldNativeName as h, getFieldControlProps as i, getFieldRootProps as l, formFieldKey as m, FIELD_LAYOUTS as n, getFieldErrorProps as o, cloneFormValues as p, FIELD_PARTS as r, getFieldLabelProps as s, FIELD_LABEL_MODES as t, getFieldStatusProps as u, freezeFormValues as v, mergeFormValues as x, getFormValue as y };
+
+//# sourceMappingURL=field-DMHGIMZF.js.map

package/dist/field-DMHGIMZF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-DMHGIMZF.js","names":[],"sources":["../src/form/model.ts","../src/field/field.ts"],"sourcesContent":["/** Finite JSON values form the public value/SSR boundary. */\nexport type QwFormValue = string | number | boolean | null | QwFormValue[] | { [key: string]: QwFormValue };\nexport type QwFormValues = Record<string, QwFormValue>;\nexport type QwNamePath = string | readonly (string | number)[];\nexport type FormNamePath = (string | number)[];\nconst forbidden = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\nconst plain = (value: unknown): value is Record<string, QwFormValue> => !!value && typeof value === \"object\" && !Array.isArray(value) && [Object.prototype, null].includes(Object.getPrototypeOf(value));\n\n/** Strings are literal single segments, never implicit dot/bracket parsing. */\nexport function normalizeFormNamePath(name: unknown): FormNamePath {\n  const path = typeof name === \"string\" ? [name] : Array.isArray(name) ? [...name] : [];\n  if (!path.length || path.length > 64 || path.some((segment) => typeof segment === \"string\" ? !segment.length || forbidden.has(segment) : typeof segment !== \"number\" || !Number.isSafeInteger(segment) || segment < 0)) throw new TypeError(\"Form name paths require nonempty safe string/integer segments without prototype names\");\n  return path as FormNamePath;\n}\nexport function formFieldKey(name: QwNamePath): string { return JSON.stringify(normalizeFormNamePath(name)); }\nexport function formFieldNativeName(name: QwNamePath): string { return normalizeFormNamePath(name).map((segment, index) => index ? `[${segment}]` : String(segment)).join(\"\"); }\n\nfunction copy(value: unknown, ancestors: Set<object>, depth: number): QwFormValue {\n  if (depth > 64) throw new TypeError(\"Form values exceed maximum depth\");\n  if (value === null || typeof value === \"string\" || typeof value === \"boolean\") return value;\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (!Array.isArray(value) && !plain(value)) throw new TypeError(\"Form values must be finite plain JSON without undefined, classes or functions\");\n  if (ancestors.has(value)) throw new TypeError(\"Cyclic Form values\");\n  ancestors.add(value);\n  let result: QwFormValue;\n  if (Array.isArray(value)) {\n    const entries: QwFormValue[] = [];\n    for (let index = 0; index < value.length; index++) {\n      if (!Object.hasOwn(value, index)) throw new TypeError(\"Form JSON arrays must be dense\");\n      entries.push(copy(value[index], ancestors, depth + 1));\n    }\n    result = entries;\n  } else result = Object.fromEntries(Object.entries(value).map(([key, child]) => [key, copy(child, ancestors, depth + 1)]));\n  ancestors.delete(value);\n  return result;\n}\nexport function cloneFormValue(value: unknown): QwFormValue { return copy(value, new Set(), 0); }\nexport function cloneFormValues(values: unknown = {}): QwFormValues {\n  if (!plain(values)) throw new TypeError(\"Form values root must be a plain record\");\n  return cloneFormValue(values) as QwFormValues;\n}\n/** Fresh recursively frozen validator snapshot; never freeze caller storage. */\nexport function freezeFormValues(values: QwFormValues): Readonly<QwFormValues> {\n  const freeze = (value: QwFormValue): void => { if (value && typeof value === \"object\") { Object.values(value).forEach(freeze); Object.freeze(value); } };\n  const cloned = cloneFormValues(values); freeze(cloned); return cloned;\n}\n/** Canonical comparison keeps object key order from manufacturing dirty changes. */\nexport function formValueFingerprint(value: QwFormValue | undefined): string {\n  const canonical = (node: QwFormValue): QwFormValue => Array.isArray(node) ? node.map(canonical) : plain(node) ? Object.fromEntries(Object.keys(node).sort().map((key) => [key, canonical(node[key]!)])) : node;\n  return value === undefined ? \"undefined\" : JSON.stringify(canonical(value));\n}\nexport function formValuesEqual(a: QwFormValues, b: QwFormValues | undefined): boolean { return !!b && formValueFingerprint(a) === formValueFingerprint(b); }\nexport function getFormValue(values: QwFormValues, name: QwNamePath): QwFormValue | undefined {\n  let current: QwFormValue | undefined = values;\n  for (const segment of normalizeFormNamePath(name)) {\n    if (!current || typeof current !== \"object\" || (Array.isArray(current) && typeof segment !== \"number\") || !Object.hasOwn(current, segment)) return undefined;\n    current = (current as Record<string | number, QwFormValue>)[segment];\n  }\n  return current === undefined ? undefined : cloneFormValue(current);\n}\nexport function hasFormValue(values: QwFormValues, name: QwNamePath): boolean { return getFormValue(values, name) !== undefined; }\n\n/** Immutable path update. Dense arrays retain explicit JSON semantics. */\nexport function setFormValue(values: QwFormValues, name: QwNamePath, value: QwFormValue | undefined): QwFormValues {\n  const path = normalizeFormNamePath(name), result = cloneFormValues(values), nextValue = value === undefined ? undefined : cloneFormValue(value);\n  let current: Record<string, QwFormValue> | QwFormValue[] = result;\n  for (let index = 0; index < path.length; index++) {\n    const segment = path[index]!, last = index === path.length - 1;\n    if (Array.isArray(current)) {\n      if (typeof segment !== \"number\" || segment > 0xffffffff - 2) throw new TypeError(\"Form array paths require valid numeric indexes\");\n      if (segment - current.length > 10_000) throw new RangeError(\"Form sparse array expansion exceeds 10000 missing positions\");\n      if (last && nextValue === undefined) { if (segment < current.length) current.splice(segment, 1); break; }\n      while (current.length <= segment) current.push(null);\n    }\n    const record = current as Record<string | number, QwFormValue>;\n    if (last) { if (nextValue === undefined) delete record[segment]; else Object.defineProperty(record, segment, { value: nextValue, enumerable: true, configurable: true, writable: true }); break; }\n    const existing = record[segment], container = Array.isArray(existing) || plain(existing);\n    if (!container) {\n      const child = typeof path[index + 1] === \"number\" ? [] : {};\n      Object.defineProperty(record, segment, { value: child, enumerable: true, configurable: true, writable: true });\n    }\n    current = record[segment] as Record<string, QwFormValue> | QwFormValue[];\n  }\n  return result;\n}\n/** Object recursion, array replacement; all inputs and outputs are independent. */\nexport function mergeFormValues(values: QwFormValues, patch: QwFormValues): QwFormValues {\n  const result = cloneFormValues(values), safePatch = cloneFormValues(patch);\n  const merge = (target: Record<string, QwFormValue>, source: Record<string, QwFormValue>) => {\n    for (const [key, value] of Object.entries(source)) {\n      if (plain(value) && plain(target[key])) merge(target[key] as Record<string, QwFormValue>, value);\n      else Object.defineProperty(target, key, { value, enumerable: true, configurable: true, writable: true });\n    }\n  };\n  merge(result, safePatch); return result;\n}\n","import { formFieldKey, type QwNamePath } from \"../form/model.js\";\nexport const FIELD_LABEL_MODES = [\"label\", \"control\", \"custom\"] as const;\nexport const FIELD_LAYOUTS = [\"stacked\", \"inline\"] as const;\nexport const FIELD_PARTS = [\"root\", \"label\", \"required\", \"control\", \"description\", \"error\", \"status\"] as const;\nexport type FieldLabelMode = (typeof FIELD_LABEL_MODES)[number];\nexport type FieldLayout = (typeof FIELD_LAYOUTS)[number];\n/** Pure association/feedback container; Form owns value and validation. */\nexport interface QwFieldProps {\n  /** Adapters supply an SSR-safe identity when omitted. */\n  id?: string;\n  name?: QwNamePath;\n  label?: string;\n  description?: string;\n  errors?: string[];\n  controlId?: string;\n  /** label links an actual labelable input; control avoids duplicate own names. */\n  labelMode?: FieldLabelMode;\n  required?: boolean;\n  disabled?: boolean;\n  invalid?: boolean;\n  validating?: boolean;\n  layout?: FieldLayout;\n  validatingLabel?: string;\n}\nexport interface ResolvedFieldState {\n  id: string; key?: string; label: string; description: string; errors: string[]; controlId?: string;\n  labelMode: FieldLabelMode; labelTag: \"label\" | \"span\"; layout: FieldLayout;\n  required: boolean; disabled: boolean; invalid: boolean; validating: boolean; validatingLabel: string;\n  labelId: string; descriptionId: string; errorId: string; statusId: string; describedBy?: string;\n}\nconst part = (name: string) => ({ \"data-scope\": \"field\" as const, \"data-part\": name });\nexport function resolveFieldState(props: QwFieldProps): ResolvedFieldState {\n  if (typeof props.id !== \"string\" || !props.id.trim()) throw new TypeError(\"Field requires a nonempty stable identity\");\n  const labelMode = FIELD_LABEL_MODES.includes(props.labelMode!) ? props.labelMode! : \"label\";\n  const label = props.label ?? \"\";\n  if (labelMode !== \"control\" && !label.trim()) throw new TypeError(\"Field requires a nonempty label unless the control names itself\");\n  if (labelMode === \"label\" && !props.controlId?.trim()) throw new TypeError(\"Field label mode requires an actual labelable control id\");\n  if (props.errors !== undefined && (!Array.isArray(props.errors) || props.errors.some((error) => typeof error !== \"string\"))) throw new TypeError(\"Field errors must be strings\");\n  const errors = [...new Set((props.errors ?? []).filter((error) => !!error.trim()))], id = `field:${props.id}`;\n  const description = props.description ?? \"\", descriptionId = `${id}:description`, errorId = `${id}:error`;\n  return { id, key: props.name === undefined ? undefined : formFieldKey(props.name), label, description, errors, controlId: props.controlId,\n    labelMode, labelTag: labelMode === \"label\" ? \"label\" : \"span\", layout: props.layout === \"inline\" ? \"inline\" : \"stacked\",\n    required: !!props.required, disabled: !!props.disabled, invalid: !!props.invalid || !!errors.length, validating: !!props.validating,\n    validatingLabel: props.validatingLabel ?? \"正在校验\", labelId: `${id}:label`, descriptionId, errorId, statusId: `${id}:status`,\n    describedBy: [description ? descriptionId : \"\", errors.length ? errorId : \"\"].filter(Boolean).join(\" \") || undefined };\n}\nexport function getFieldRootProps(state: ResolvedFieldState) { return { ...part(\"root\"), id: state.id, \"data-field-key\": state.key, \"data-label-mode\": state.labelMode, \"data-layout\": state.layout, \"data-required\": state.required ? \"\" : undefined, \"data-disabled\": state.disabled ? \"\" : undefined, \"data-invalid\": state.invalid ? \"\" : undefined, \"aria-busy\": state.validating || undefined }; }\nexport function getFieldLabelProps(state: ResolvedFieldState) { return { ...part(\"label\"), id: state.labelId, htmlFor: state.labelMode === \"label\" ? state.controlId : undefined, hidden: state.labelMode === \"control\" }; }\nexport function getFieldRequiredProps(state: ResolvedFieldState) { return { ...part(\"required\"), hidden: !state.required || state.labelMode === \"control\", \"aria-hidden\": true }; }\nexport function getFieldControlProps(_state: ResolvedFieldState) { return part(\"control\"); }\nexport function getFieldDescriptionProps(state: ResolvedFieldState) { return { ...part(\"description\"), id: state.descriptionId, hidden: !state.description }; }\nexport function getFieldErrorProps(state: ResolvedFieldState) { return { ...part(\"error\"), id: state.errorId, role: \"alert\" as const, hidden: !state.errors.length }; }\nexport function getFieldStatusProps(state: ResolvedFieldState) { return { ...part(\"status\"), id: state.statusId, role: \"status\" as const, hidden: !state.validating }; }\n"],"mappings":"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"}

package/dist/floating-bubble/floating-bubble.d.ts

@@ -0,0 +1,116 @@
+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 FLOATING_BUBBLE_PARTS: readonly ["root"];
+export declare const FLOATING_BUBBLE_AXES: readonly ["xy", "x", "y", "lock"];
+export declare const FLOATING_BUBBLE_MAGNETS: readonly ["x", "y", "none"];
+export declare const FLOATING_BUBBLE_BOUNDARIES: readonly ["viewport", "parent"];
+export type FloatingBubbleAxis = (typeof FLOATING_BUBBLE_AXES)[number];
+export type FloatingBubbleMagnet = (typeof FLOATING_BUBBLE_MAGNETS)[number];
+export type FloatingBubbleBoundary = (typeof FLOATING_BUBBLE_BOUNDARIES)[number];
+export declare const FLOATING_BUBBLE_DEFAULT_STEP = 16;
+/** Physical CSS px of the bubble's top-left corner relative to the containing block (viewport or offsetParent padding box). */
+export interface FloatingBubbleOffset {
+    x: number;
+    y: number;
+}
+export type FloatingBubbleOffsetReason = "drag" | "keyboard" | "resize";
+export interface FloatingBubbleOffsetChangeDetails {
+    offset: FloatingBubbleOffset;
+    reason: FloatingBubbleOffsetReason;
+}
+/** Allowed resting range after subtracting the CSS-provided insets (gap + safe area) and the bubble size. */
+export interface FloatingBubbleBounds {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+}
+export interface QwFloatingBubbleProps {
+    id?: string;
+    /** Required accessible name of the button. */
+    label?: string;
+    /** Controlled position; undefined lets Core own it (seeded by defaultOffset, else inline-end bottom after measuring). */
+    offset?: FloatingBubbleOffset;
+    defaultOffset?: FloatingBubbleOffset;
+    /** Called once per drag release, keyboard move or resize correction; controlled owners accept by updating offset. */
+    onOffsetChange?: (details: FloatingBubbleOffsetChangeDetails) => void;
+    /** Drag axes; lock disables dragging. Default xy. */
+    axis?: FloatingBubbleAxis;
+    /** Snap to the nearest horizontal (x) or vertical (y) edge after moving; default x. */
+    magnet?: FloatingBubbleMagnet;
+    /** viewport (position: fixed, default) or parent (position: absolute in the offsetParent). */
+    boundary?: FloatingBubbleBoundary;
+    /** Arrow-key step in px; 0 disables keyboard moving. Default 16. */
+    keyboardStep?: number;
+    disabled?: boolean;
+}
+export interface ResolvedFloatingBubbleState {
+    label: string;
+    axis: FloatingBubbleAxis;
+    magnet: FloatingBubbleMagnet;
+    boundary: FloatingBubbleBoundary;
+    keyboardStep: number;
+    disabled: boolean;
+}
+export declare function resolveFloatingBubbleState(props?: QwFloatingBubbleProps): ResolvedFloatingBubbleState;
+export declare function createFloatingBubbleProps(props?: QwFloatingBubbleProps): QwFloatingBubbleProps;
+export declare function clampFloatingBubbleOffset(offset: FloatingBubbleOffset, bounds: FloatingBubbleBounds): FloatingBubbleOffset;
+/** Clamp, then move to the nearest edge on the magnet axis (ties go to the larger edge). */
+export declare function snapFloatingBubbleOffset(offset: FloatingBubbleOffset, bounds: FloatingBubbleBounds, magnet: FloatingBubbleMagnet): FloatingBubbleOffset;
+export interface QwFloatingBubbleSchema {
+    props: QwFloatingBubbleProps;
+    context: {
+        offset: FloatingBubbleOffset | null;
+        drag: FloatingBubbleOffset | null;
+        bounds: FloatingBubbleBounds | null;
+        animate: boolean;
+    };
+    refs: {
+        rtl: boolean;
+        suppressClick: boolean;
+    };
+    state: "ready";
+    action: "measure" | "drag" | "release" | "key";
+    effect: "track";
+    event: {
+        type: "MEASURE";
+        bounds: FloatingBubbleBounds;
+        rtl: boolean;
+    } | {
+        type: "DRAG";
+        position: FloatingBubbleOffset;
+    } | {
+        type: "RELEASE";
+    } | {
+        type: "KEY";
+        key: string;
+    };
+}
+export type QwFloatingBubbleMachine = Machine<QwFloatingBubbleSchema>;
+export type QwFloatingBubbleService = Service<QwFloatingBubbleSchema>;
+/** Core owns click/drag discrimination, clamping, magnet snapping, measurement, keyboard moving and listener cleanup. */
+export declare const floatingBubbleMachine: QwFloatingBubbleMachine;
+/** Minimal event surface shared by React, Vue and native events. */
+export interface FloatingBubbleDomEvent {
+    readonly defaultPrevented: boolean;
+    readonly key?: string;
+    preventDefault?(): void;
+    stopPropagation?(): void;
+}
+export type FloatingBubbleEventHandler = (event: FloatingBubbleDomEvent) => void;
+type Handlers = FloatingBubbleEventHandler | readonly FloatingBubbleEventHandler[] | undefined;
+/** Caller onClick/onKeyDown run first (except the click swallowed after a drag); preventDefault() skips Core. */
+export interface FloatingBubbleConnectOptions {
+    onClick?: Handlers;
+    onKeyDown?: Handlers;
+}
+export interface QwFloatingBubbleApi<T extends PropTypes = PropTypes> {
+    label: string;
+    dragging: boolean;
+    /** Rendered position, or null before the first measurement (CSS logical fallback). */
+    position: FloatingBubbleOffset | null;
+    getRootProps(): T["button"];
+}
+export declare function connectFloatingBubble<T extends PropTypes>(service: QwFloatingBubbleService, normalize: NormalizeProps<T>, options?: FloatingBubbleConnectOptions): QwFloatingBubbleApi<T>;
+export {};

package/dist/floating-bubble/index.d.ts

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