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

package/dist/selection.d.ts

@@ -0,0 +1,29 @@
+/** Shared identity and value rules for selection machines. */
+export interface QwSelectionItem {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
+export interface SelectionLimits {
+    min: number;
+    max: number;
+}
+export interface SelectionRestrictions {
+    min?: number;
+    max?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+}
+export type SelectionBlockedReason = "disabled" | "readonly" | "min" | "max";
+export interface SelectionChange {
+    value: string[];
+    blocked: SelectionBlockedReason | null;
+}
+export declare function normalizeSelectionItems(items: readonly QwSelectionItem[]): QwSelectionItem[];
+export declare function normalizeSelectionValue(value?: readonly string[]): string[];
+export declare function resolveSelectionLimits(min?: number, max?: number): SelectionLimits;
+/** Caller values are preserved; limits apply only to a user addition/removal. */
+export declare function toggleSelectionValue(value: readonly string[], item: QwSelectionItem, restrictions?: SelectionRestrictions): SelectionChange;
+/** Injective UTF-16 identity for native item ids, including unmatched surrogates. */
+export declare function selectionItemKey(value: string): string;

package/dist/selector/choice-group.d.ts

@@ -0,0 +1,114 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import { type QwSelectionItem } from "../selection.js";
+import { type IconState } from "../icon/index.js";
+export interface ChoiceGroupItem extends QwSelectionItem {
+    /** Item-level read-only: focusable and submitted, but cannot change. */
+    readOnly?: boolean;
+    /** Supporting trailing text, read after the description. */
+    extra?: string;
+}
+export interface ChoiceGroupValueChangeDetails<I extends ChoiceGroupItem = ChoiceGroupItem> {
+    /** Requested ordered values (independent copy). */
+    value: string[];
+    /** Known items for the requested values, in value order (copies). */
+    items: I[];
+}
+export interface ChoiceGroupProps {
+    id?: string;
+    label: string;
+    hideLabel?: boolean;
+    description?: string;
+    describedBy?: string;
+    items: ChoiceGroupItem[];
+    multiple?: boolean;
+    value?: string[];
+    defaultValue?: string[];
+    required?: boolean;
+    min?: number;
+    max?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    invalid?: boolean;
+    name?: string;
+    form?: string;
+    dir?: string;
+    loop?: boolean;
+    onValueChange?: (details: ChoiceGroupValueChangeDetails) => void;
+}
+export interface ChoiceGroupSchema {
+    props: ChoiceGroupProps & {
+        multiple: boolean;
+        defaultValue: string[];
+        loop: boolean;
+    } & Record<string, unknown>;
+    context: {
+        value: string[];
+        focusedValue: string | null;
+        disabledIds: string[];
+    };
+    state: "ready";
+    action: "setValue" | "toggleValue" | "selectValue" | "setFocus" | "syncInputs" | "normalizeMode";
+    effect: "trackForm";
+    event: {
+        type: "VALUE.SET";
+        value: string[];
+    } | {
+        type: "VALUE.TOGGLE" | "VALUE.SELECT" | "FOCUS";
+        value: string;
+    };
+}
+export type ChoiceGroupMachine = Machine<ChoiceGroupSchema>;
+export type ChoiceGroupService = Service<ChoiceGroupSchema>;
+export interface ChoiceGroupItemState {
+    selected: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+}
+export declare function normalizeChoiceItems<I extends ChoiceGroupItem>(items: readonly I[], family: string): I[];
+export declare function normalizeChoiceValue(value?: readonly string[], multiple?: boolean): string[];
+export declare function createChoiceGroupProps(props: ChoiceGroupProps, family: string): ChoiceGroupSchema["props"];
+/** One machine per family; `family` is the data-scope and id prefix. */
+export declare function createChoiceGroupMachine(family: string): ChoiceGroupMachine;
+export interface ChoiceGroupApi<T extends PropTypes = PropTypes> {
+    value: string[];
+    items: ChoiceGroupItem[];
+    label: string;
+    description: string;
+    setValue(value: string[]): void;
+    toggleValue(value: string): void;
+    clearValue(): void;
+    getRootProps(extra?: Record<string, unknown>): T["element"];
+    getLabelProps(): T["element"];
+    getDescriptionProps(): T["element"];
+    getGroupProps(part: string): T["element"];
+    getItemState(item: {
+        value: string;
+    }): ChoiceGroupItemState;
+    getItemProps(item: {
+        value: string;
+    }, part: string): T["label"];
+    getInputProps(item: {
+        value: string;
+    }): T["input"];
+    getItemPartProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getTextProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getItemDescriptionProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getExtraProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getCheckProps(item: {
+        value: string;
+    }, part: string): T["element"];
+    getCheckIconState(item: {
+        value: string;
+    }): IconState;
+}
+/** SSR-pure getters; client handlers use the Zag DOM scope only inside events. */
+export declare function connectChoiceGroup<T extends PropTypes>(family: string, service: ChoiceGroupService, normalize: NormalizeProps<T>): ChoiceGroupApi<T>;

package/dist/selector/index.d.ts

@@ -0,0 +1,2 @@
+export { SELECTOR_PARTS, SELECTOR_COLUMNS, resolveSelectorColumns, normalizeSelectorOptions, normalizeSelectorValue, createSelectorProps, selectorMachine, connectSelector } from "./selector.js";
+export type { SelectorPart, QwSelectorOption, SelectorValueChangeDetails, QwSelectorProps, QwSelectorSchema, QwSelectorMachine, QwSelectorService, QwSelectorOptionState, QwSelectorOptionProps, QwSelectorApi } from "./selector.js";

package/dist/selector/index.js

@@ -0,0 +1,2 @@
+import { a as normalizeSelectorOptions, c as selectorMachine, i as createSelectorProps, n as SELECTOR_PARTS, o as normalizeSelectorValue, r as connectSelector, s as resolveSelectorColumns, t as SELECTOR_COLUMNS } from "../selector-BU2MMJ4N.js";
+export { SELECTOR_COLUMNS, SELECTOR_PARTS, connectSelector, createSelectorProps, normalizeSelectorOptions, normalizeSelectorValue, resolveSelectorColumns, selectorMachine };

package/dist/selector/selector.d.ts

@@ -0,0 +1,90 @@
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import type { IconState } from "../icon/index.js";
+import { type ChoiceGroupItemState, type ChoiceGroupMachine, type ChoiceGroupSchema, type ChoiceGroupService, type ChoiceGroupValueChangeDetails } from "./choice-group.js";
+/** Stable DOM parts shared by every adapter. */
+export declare const SELECTOR_PARTS: readonly ["root", "label", "description", "options", "option", "input", "content", "text", "option-description", "check"];
+/** Supported fixed column counts; anything else uses the auto-wrapping flow. */
+export declare const SELECTOR_COLUMNS: readonly [1, 2, 3, 4, 5, 6];
+export type SelectorPart = (typeof SELECTOR_PARTS)[number];
+/** One tile. `label` is the accessible option name. */
+export interface QwSelectorOption {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
+export type SelectorValueChangeDetails = ChoiceGroupValueChangeDetails<QwSelectorOption>;
+export interface QwSelectorProps {
+    id?: string;
+    /** Required nonempty group name rendered as the fieldset legend. */
+    label: string;
+    /** Visually hide the legend while it still names the group. */
+    hideLabel?: boolean;
+    description?: string;
+    /** External Field help/error references merged with the own description. */
+    describedBy?: string;
+    /** Ordered tiles with unique nonempty values and labels. */
+    options: QwSelectorOption[];
+    /** Multiple checkboxes instead of single radios. Defaults false. */
+    multiple?: boolean;
+    /** Defined arrays (including []) are controlled; user actions only request changes. */
+    value?: string[];
+    /** Initial value and form reset target. Defaults []. */
+    defaultValue?: string[];
+    /** Native validation; in single mode it also blocks clearing the selected tile. */
+    required?: boolean;
+    /** Multiple-mode limits for user removal/addition. */
+    min?: number;
+    max?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    invalid?: boolean;
+    name?: string;
+    form?: string;
+    dir?: string;
+    /** Arrow-key wrapping; defaults true. */
+    loop?: boolean;
+    /** Equal column count 1–6; otherwise tiles wrap by content. */
+    columns?: number;
+    /** Corner check mark on selected tiles (non-color cue). Defaults true. */
+    showCheckMark?: boolean;
+    onValueChange?: (details: SelectorValueChangeDetails) => void;
+}
+export type QwSelectorSchema = ChoiceGroupSchema;
+export type QwSelectorMachine = ChoiceGroupMachine;
+export type QwSelectorService = ChoiceGroupService;
+export type QwSelectorOptionState = ChoiceGroupItemState;
+export interface QwSelectorOptionProps {
+    value: string;
+}
+/** Resolve columns to a supported integer or undefined (auto flow). */
+export declare function resolveSelectorColumns(columns: unknown): number | undefined;
+export declare function normalizeSelectorOptions(options: readonly QwSelectorOption[]): QwSelectorOption[];
+export declare function normalizeSelectorValue(value?: readonly string[], multiple?: boolean): string[];
+/** Map public props to the shared choice-group machine props. */
+export declare function createSelectorProps(props: QwSelectorProps): QwSelectorSchema["props"];
+export declare const selectorMachine: QwSelectorMachine;
+export interface QwSelectorApi<T extends PropTypes = PropTypes> {
+    value: string[];
+    options: QwSelectorOption[];
+    label: string;
+    description: string;
+    showCheckMark: boolean;
+    setValue(value: string[]): void;
+    toggleValue(value: string): void;
+    clearValue(): void;
+    getRootProps(): T["element"];
+    getLabelProps(): T["element"];
+    getDescriptionProps(): T["element"];
+    getOptionsProps(): T["element"];
+    getOptionState(option: QwSelectorOptionProps): QwSelectorOptionState;
+    getOptionProps(option: QwSelectorOptionProps): T["label"];
+    getInputProps(option: QwSelectorOptionProps): T["input"];
+    getContentProps(option: QwSelectorOptionProps): T["element"];
+    getTextProps(option: QwSelectorOptionProps): T["element"];
+    getOptionDescriptionProps(option: QwSelectorOptionProps): T["element"];
+    getCheckProps(option: QwSelectorOptionProps): T["element"];
+    getCheckIconState(option: QwSelectorOptionProps): IconState;
+}
+/** Mechanical part mapping over the shared kernel. */
+export declare function connectSelector<T extends PropTypes>(service: QwSelectorService, normalize: NormalizeProps<T>): QwSelectorApi<T>;

package/dist/selector-BU2MMJ4N.js

@@ -0,0 +1,93 @@
+import { a as normalizeChoiceValue, i as normalizeChoiceItems, n as createChoiceGroupMachine, r as createChoiceGroupProps, t as connectChoiceGroup } from "./choice-group-C4c9m0qe.js";
+//#region src/selector/selector.ts
+/** Stable DOM parts shared by every adapter. */
+const SELECTOR_PARTS = [
+	"root",
+	"label",
+	"description",
+	"options",
+	"option",
+	"input",
+	"content",
+	"text",
+	"option-description",
+	"check"
+];
+/** Supported fixed column counts; anything else uses the auto-wrapping flow. */
+const SELECTOR_COLUMNS = [
+	1,
+	2,
+	3,
+	4,
+	5,
+	6
+];
+/** Resolve columns to a supported integer or undefined (auto flow). */
+function resolveSelectorColumns(columns) {
+	return typeof columns === "number" && SELECTOR_COLUMNS.includes(columns) ? columns : void 0;
+}
+function normalizeSelectorOptions(options) {
+	return normalizeChoiceItems(options, "Selector");
+}
+function normalizeSelectorValue(value = [], multiple = false) {
+	return normalizeChoiceValue(value, multiple);
+}
+/** Map public props to the shared choice-group machine props. */
+function createSelectorProps(props) {
+	const { options, onValueChange, ...rest } = props;
+	return {
+		...createChoiceGroupProps({
+			...rest,
+			items: options ?? [],
+			onValueChange
+		}, "Selector"),
+		columns: resolveSelectorColumns(props.columns),
+		showCheckMark: props.showCheckMark ?? true
+	};
+}
+const selectorMachine = createChoiceGroupMachine("selector");
+/** Mechanical part mapping over the shared kernel. */
+function connectSelector(service, normalize) {
+	const api = connectChoiceGroup("selector", service, normalize);
+	const columns = resolveSelectorColumns(service.prop("columns")), showCheckMark = service.prop("showCheckMark") !== false;
+	return {
+		value: api.value,
+		options: api.items.map(({ value, label, description, disabled }) => ({
+			value,
+			label,
+			description,
+			disabled
+		})),
+		label: api.label,
+		description: api.description,
+		showCheckMark,
+		setValue: api.setValue,
+		toggleValue: api.toggleValue,
+		clearValue: api.clearValue,
+		getRootProps: () => api.getRootProps({
+			"data-columns": columns,
+			"data-check-mark": showCheckMark ? "" : void 0
+		}),
+		getLabelProps: api.getLabelProps,
+		getDescriptionProps: api.getDescriptionProps,
+		getOptionsProps: () => api.getGroupProps("options"),
+		getOptionState: api.getItemState,
+		getOptionProps: (option) => api.getItemProps(option, "option"),
+		getInputProps: api.getInputProps,
+		getContentProps: (option) => api.getItemPartProps(option, "content"),
+		getTextProps: (option) => api.getTextProps(option, "text"),
+		getOptionDescriptionProps: (option) => api.getItemDescriptionProps(option, "option-description"),
+		getCheckProps: (option) => {
+			const props = api.getCheckProps(option, "check");
+			return showCheckMark ? props : {
+				...props,
+				hidden: true
+			};
+		},
+		getCheckIconState: api.getCheckIconState
+	};
+}
+//#endregion
+export { normalizeSelectorOptions as a, selectorMachine as c, createSelectorProps as i, SELECTOR_PARTS as n, normalizeSelectorValue as o, connectSelector as r, resolveSelectorColumns as s, SELECTOR_COLUMNS as t };
+
+//# sourceMappingURL=selector-BU2MMJ4N.js.map

package/dist/selector-BU2MMJ4N.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-BU2MMJ4N.js","names":[],"sources":["../src/selector/selector.ts"],"sourcesContent":["import type { NormalizeProps, PropTypes } from \"@zag-js/types\";\nimport type { IconState } from \"../icon/index.js\";\nimport { connectChoiceGroup, createChoiceGroupMachine, createChoiceGroupProps, normalizeChoiceItems, normalizeChoiceValue, type ChoiceGroupItemState, type ChoiceGroupMachine, type ChoiceGroupSchema, type ChoiceGroupService, type ChoiceGroupValueChangeDetails } from \"./choice-group.js\";\n\n/** Stable DOM parts shared by every adapter. */\nexport const SELECTOR_PARTS = [\"root\", \"label\", \"description\", \"options\", \"option\", \"input\", \"content\", \"text\", \"option-description\", \"check\"] as const;\n/** Supported fixed column counts; anything else uses the auto-wrapping flow. */\nexport const SELECTOR_COLUMNS = [1, 2, 3, 4, 5, 6] as const;\nexport type SelectorPart = (typeof SELECTOR_PARTS)[number];\n/** One tile. `label` is the accessible option name. */\nexport interface QwSelectorOption { value: string; label: string; description?: string; disabled?: boolean }\nexport type SelectorValueChangeDetails = ChoiceGroupValueChangeDetails<QwSelectorOption>;\nexport interface QwSelectorProps {\n  id?: string;\n  /** Required nonempty group name rendered as the fieldset legend. */\n  label: string;\n  /** Visually hide the legend while it still names the group. */\n  hideLabel?: boolean;\n  description?: string;\n  /** External Field help/error references merged with the own description. */\n  describedBy?: string;\n  /** Ordered tiles with unique nonempty values and labels. */\n  options: QwSelectorOption[];\n  /** Multiple checkboxes instead of single radios. Defaults false. */\n  multiple?: boolean;\n  /** Defined arrays (including []) are controlled; user actions only request changes. */\n  value?: string[];\n  /** Initial value and form reset target. Defaults []. */\n  defaultValue?: string[];\n  /** Native validation; in single mode it also blocks clearing the selected tile. */\n  required?: boolean;\n  /** Multiple-mode limits for user removal/addition. */\n  min?: number;\n  max?: number;\n  disabled?: boolean;\n  readOnly?: boolean;\n  invalid?: boolean;\n  name?: string;\n  form?: string;\n  dir?: string;\n  /** Arrow-key wrapping; defaults true. */\n  loop?: boolean;\n  /** Equal column count 1–6; otherwise tiles wrap by content. */\n  columns?: number;\n  /** Corner check mark on selected tiles (non-color cue). Defaults true. */\n  showCheckMark?: boolean;\n  onValueChange?: (details: SelectorValueChangeDetails) => void;\n}\nexport type QwSelectorSchema = ChoiceGroupSchema;\nexport type QwSelectorMachine = ChoiceGroupMachine;\nexport type QwSelectorService = ChoiceGroupService;\nexport type QwSelectorOptionState = ChoiceGroupItemState;\nexport interface QwSelectorOptionProps { value: string }\n\n/** Resolve columns to a supported integer or undefined (auto flow). */\nexport function resolveSelectorColumns(columns: unknown): number | undefined {\n  return typeof columns === \"number\" && (SELECTOR_COLUMNS as readonly number[]).includes(columns) ? columns : undefined;\n}\nexport function normalizeSelectorOptions(options: readonly QwSelectorOption[]): QwSelectorOption[] { return normalizeChoiceItems(options, \"Selector\"); }\nexport function normalizeSelectorValue(value: readonly string[] = [], multiple = false): string[] { return normalizeChoiceValue(value, multiple); }\n/** Map public props to the shared choice-group machine props. */\nexport function createSelectorProps(props: QwSelectorProps): QwSelectorSchema[\"props\"] {\n  const { options, onValueChange, ...rest } = props;\n  return { ...createChoiceGroupProps({ ...rest, items: options ?? [], onValueChange: onValueChange as QwSelectorSchema[\"props\"][\"onValueChange\"] }, \"Selector\"),\n    columns: resolveSelectorColumns(props.columns), showCheckMark: props.showCheckMark ?? true };\n}\nexport const selectorMachine: QwSelectorMachine = createChoiceGroupMachine(\"selector\");\n\nexport interface QwSelectorApi<T extends PropTypes = PropTypes> {\n  value: string[];\n  options: QwSelectorOption[];\n  label: string;\n  description: string;\n  showCheckMark: boolean;\n  setValue(value: string[]): void;\n  toggleValue(value: string): void;\n  clearValue(): void;\n  getRootProps(): T[\"element\"];\n  getLabelProps(): T[\"element\"];\n  getDescriptionProps(): T[\"element\"];\n  getOptionsProps(): T[\"element\"];\n  getOptionState(option: QwSelectorOptionProps): QwSelectorOptionState;\n  getOptionProps(option: QwSelectorOptionProps): T[\"label\"];\n  getInputProps(option: QwSelectorOptionProps): T[\"input\"];\n  getContentProps(option: QwSelectorOptionProps): T[\"element\"];\n  getTextProps(option: QwSelectorOptionProps): T[\"element\"];\n  getOptionDescriptionProps(option: QwSelectorOptionProps): T[\"element\"];\n  getCheckProps(option: QwSelectorOptionProps): T[\"element\"];\n  getCheckIconState(option: QwSelectorOptionProps): IconState;\n}\n/** Mechanical part mapping over the shared kernel. */\nexport function connectSelector<T extends PropTypes>(service: QwSelectorService, normalize: NormalizeProps<T>): QwSelectorApi<T> {\n  const api = connectChoiceGroup(\"selector\", service, normalize);\n  const columns = resolveSelectorColumns(service.prop(\"columns\")), showCheckMark = service.prop(\"showCheckMark\") !== false;\n  return {\n    value: api.value, options: api.items.map(({ value, label, description, disabled }) => ({ value, label, description, disabled })), label: api.label, description: api.description, showCheckMark,\n    setValue: api.setValue, toggleValue: api.toggleValue, clearValue: api.clearValue,\n    getRootProps: () => api.getRootProps({ \"data-columns\": columns, \"data-check-mark\": showCheckMark ? \"\" : undefined }),\n    getLabelProps: api.getLabelProps, getDescriptionProps: api.getDescriptionProps,\n    getOptionsProps: () => api.getGroupProps(\"options\"),\n    getOptionState: api.getItemState,\n    getOptionProps: (option) => api.getItemProps(option, \"option\"),\n    getInputProps: api.getInputProps,\n    getContentProps: (option) => api.getItemPartProps(option, \"content\"),\n    getTextProps: (option) => api.getTextProps(option, \"text\"),\n    getOptionDescriptionProps: (option) => api.getItemDescriptionProps(option, \"option-description\"),\n    getCheckProps: (option) => { const props = api.getCheckProps(option, \"check\") as Record<string, unknown>; return (showCheckMark ? props : { ...props, hidden: true }) as T[\"element\"]; },\n    getCheckIconState: api.getCheckIconState,\n  };\n}\n"],"mappings":";;;AAKA,MAAa,iBAAiB;CAAC;CAAQ;CAAS;CAAe;CAAW;CAAU;CAAS;CAAW;CAAQ;CAAsB;AAAO;;AAE7I,MAAa,mBAAmB;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;;AAgDjD,SAAgB,uBAAuB,SAAsC;CAC3E,OAAO,OAAO,YAAY,YAAa,iBAAuC,SAAS,OAAO,IAAI,UAAU,KAAA;AAC9G;AACA,SAAgB,yBAAyB,SAA0D;CAAE,OAAO,qBAAqB,SAAS,UAAU;AAAG;AACvJ,SAAgB,uBAAuB,QAA2B,CAAC,GAAG,WAAW,OAAiB;CAAE,OAAO,qBAAqB,OAAO,QAAQ;AAAG;;AAElJ,SAAgB,oBAAoB,OAAmD;CACrF,MAAM,EAAE,SAAS,eAAe,GAAG,SAAS;CAC5C,OAAO;EAAE,GAAG,uBAAuB;GAAE,GAAG;GAAM,OAAO,WAAW,CAAC;GAAkB;EAA4D,GAAG,UAAU;EAC1J,SAAS,uBAAuB,MAAM,OAAO;EAAG,eAAe,MAAM,iBAAiB;CAAK;AAC/F;AACA,MAAa,kBAAqC,yBAAyB,UAAU;;AAyBrF,SAAgB,gBAAqC,SAA4B,WAAgD;CAC/H,MAAM,MAAM,mBAAmB,YAAY,SAAS,SAAS;CAC7D,MAAM,UAAU,uBAAuB,QAAQ,KAAK,SAAS,CAAC,GAAG,gBAAgB,QAAQ,KAAK,eAAe,MAAM;CACnH,OAAO;EACL,OAAO,IAAI;EAAO,SAAS,IAAI,MAAM,KAAK,EAAE,OAAO,OAAO,aAAa,gBAAgB;GAAE;GAAO;GAAO;GAAa;EAAS,EAAE;EAAG,OAAO,IAAI;EAAO,aAAa,IAAI;EAAa;EAClL,UAAU,IAAI;EAAU,aAAa,IAAI;EAAa,YAAY,IAAI;EACtE,oBAAoB,IAAI,aAAa;GAAE,gBAAgB;GAAS,mBAAmB,gBAAgB,KAAK,KAAA;EAAU,CAAC;EACnH,eAAe,IAAI;EAAe,qBAAqB,IAAI;EAC3D,uBAAuB,IAAI,cAAc,SAAS;EAClD,gBAAgB,IAAI;EACpB,iBAAiB,WAAW,IAAI,aAAa,QAAQ,QAAQ;EAC7D,eAAe,IAAI;EACnB,kBAAkB,WAAW,IAAI,iBAAiB,QAAQ,SAAS;EACnE,eAAe,WAAW,IAAI,aAAa,QAAQ,MAAM;EACzD,4BAA4B,WAAW,IAAI,wBAAwB,QAAQ,oBAAoB;EAC/F,gBAAgB,WAAW;GAAE,MAAM,QAAQ,IAAI,cAAc,QAAQ,OAAO;GAA8B,OAAQ,gBAAgB,QAAQ;IAAE,GAAG;IAAO,QAAQ;GAAK;EAAoB;EACvL,mBAAmB,IAAI;CACzB;AACF"}

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

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

package/dist/share-sheet/index.js

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

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

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

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

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

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

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