@qw-ui/core 0.3.0-next.8 → 0.3.0

package/dist/tree-select/tree-select.d.ts

@@ -0,0 +1,215 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import { type QwSelectionItem } from "../selection.js";
+/** Stable DOM parts shared by every adapter. */
+export declare const TREE_SELECT_PARTS: readonly ["root", "tree", "item", "row", "indicator", "check", "text", "group", "empty"];
+export type TreeSelectPart = (typeof TREE_SELECT_PARTS)[number];
+/** Single mode: which nodes can be selected. `leaf` (default): only nodes without children; `any`: every node. */
+export declare const TREE_SELECT_SELECTABLE: readonly ["leaf", "any"];
+export type TreeSelectSelectable = (typeof TREE_SELECT_SELECTABLE)[number];
+/** Default texts. */
+export declare const TREE_SELECT_DEFAULT_TEXTS: {
+    readonly label: "树形选择";
+    readonly emptyText: "暂无数据";
+};
+export type TreeSelectTexts = {
+    -readonly [K in keyof typeof TREE_SELECT_DEFAULT_TEXTS]: string;
+};
+/** One caller-owned node. `value` is unique across the whole tree; an empty or missing `children` array makes a leaf. */
+export interface TreeSelectOption extends Pick<QwSelectionItem, "value" | "label" | "disabled"> {
+    children?: readonly TreeSelectOption[];
+}
+/** Indexed node. `disabled` is inherited: a disabled node disables its whole subtree (expansion stays available). */
+export interface TreeSelectNode {
+    value: string;
+    label: string;
+    option: TreeSelectOption;
+    /** 1-based depth, position among siblings and sibling count (aria-level / aria-posinset / aria-setsize). */
+    level: number;
+    posinset: number;
+    setsize: number;
+    parent: string | null;
+    path: string[];
+    children: string[];
+    /** Leaf descendants in tree order (the node itself for a leaf). */
+    leaves: string[];
+    leaf: boolean;
+    disabled: boolean;
+}
+export interface TreeSelectIndex {
+    roots: string[];
+    order: string[];
+    nodes: Map<string, TreeSelectNode>;
+}
+export interface TreeSelectMode {
+    multiple: boolean;
+    selectable: TreeSelectSelectable;
+    checkStrictly: boolean;
+}
+export type TreeSelectCheckedState = boolean | "mixed";
+/** Selection proposal: the complete next value (tree order), its labels, the activated node and whether it is now selected/checked. */
+export interface TreeSelectValueChangeDetails {
+    value: string[];
+    labels: string[];
+    target: string;
+    selected: boolean;
+}
+/** Expansion proposal: the complete next expanded parent values (tree order), the toggled node and its next state. */
+export interface TreeSelectExpandedChangeDetails {
+    value: string[];
+    target: string;
+    expanded: boolean;
+}
+/** Rendered node; `children` holds the visible children only (empty while collapsed). */
+export interface TreeSelectItem {
+    value: string;
+    label: string;
+    option: TreeSelectOption;
+    level: number;
+    posinset: number;
+    setsize: number;
+    leaf: boolean;
+    expanded: boolean;
+    disabled: boolean;
+    /** Activating this node changes the value (false for disabled nodes, a disabled tree and parents in single `leaf` mode). */
+    selectable: boolean;
+    selected: boolean;
+    checked: TreeSelectCheckedState;
+    focusable: boolean;
+    children: TreeSelectItem[];
+}
+export interface QwTreeSelectProps extends Partial<TreeSelectTexts> {
+    /** Page-unique instance identity; adapters generate one when omitted. */
+    id?: string;
+    /** Caller-owned hierarchical data; never mutated. Replace it to update; the value and labels are re-resolved against it. */
+    options?: readonly TreeSelectOption[];
+    /** Checkbox semantics (`aria-checked`) instead of single selection (`aria-selected`). */
+    multiple?: boolean;
+    /** Single mode only: `leaf` (default) or `any`. */
+    selectable?: TreeSelectSelectable;
+    /** Multiple mode only: check nodes independently, without parent/child cascade. */
+    checkStrictly?: boolean;
+    /** Controlled value. It only changes when the owner updates it; not updating rejects a proposal. */
+    value?: readonly string[];
+    defaultValue?: readonly string[];
+    /** Controlled expanded parent values; same owner contract as `value`. */
+    expandedValue?: readonly string[];
+    /** Initial expanded parent values; omitted expands the ancestors of the initial value. */
+    defaultExpandedValue?: readonly string[];
+    /** Block every selection change; browsing (focus, expand/collapse) stays available. */
+    disabled?: boolean;
+    onValueChange?: (details: TreeSelectValueChangeDetails) => void;
+    onExpandedChange?: (details: TreeSelectExpandedChangeDetails) => void;
+}
+/** Index the tree. Empty values/labels and values repeated anywhere in the tree throw a `TypeError`. */
+export declare function createTreeSelectIndex(options?: readonly TreeSelectOption[]): TreeSelectIndex;
+export declare function resolveTreeSelectMode(props?: Pick<QwTreeSelectProps, "multiple" | "selectable" | "checkStrictly">): TreeSelectMode;
+/**
+ * Effective value in tree order. Unknown (stale) values are ignored. Single mode keeps the first known value the mode
+ * allows. Cascade mode stores leaves: a parent value stands for all its leaf descendants.
+ */
+export declare function resolveTreeSelectValue(index: TreeSelectIndex, raw: readonly unknown[] | null | undefined, mode: TreeSelectMode): string[];
+/** Raw values that no longer match a node (for example after the options were replaced). */
+export declare function getTreeSelectStaleValue(index: TreeSelectIndex, raw: readonly unknown[] | null | undefined): string[];
+/** Known parent values in tree order; leaves and unknown values are ignored. */
+export declare function resolveTreeSelectExpanded(index: TreeSelectIndex, raw: readonly unknown[] | null | undefined): string[];
+/** Ancestors of the given values, in tree order. */
+export declare function getTreeSelectAncestors(index: TreeSelectIndex, values: readonly string[]): string[];
+/**
+ * Checked state. Cascade parents derive from their enabled leaves: all checked → true, none (and no disabled leaf
+ * checked) → false, otherwise "mixed". A parent whose leaves are all disabled derives from all of them.
+ */
+export declare function getTreeSelectCheckedState(index: TreeSelectIndex, value: ReadonlySet<string>, target: string, mode: TreeSelectMode): TreeSelectCheckedState;
+/**
+ * Next value after activating `target`, or null when nothing changes (disabled node, non-selectable parent, reselecting
+ * the single value). Cascade: a parent that is not fully checked checks all its enabled leaves, a checked parent
+ * unchecks them; disabled leaves keep their state.
+ */
+export declare function toggleTreeSelectValue(index: TreeSelectIndex, value: readonly string[], target: string, mode: TreeSelectMode): string[] | null;
+/** Next expanded value after opening/closing (`open` omitted: toggle) a parent, or null when nothing changes. */
+export declare function toggleTreeSelectExpanded(index: TreeSelectIndex, expanded: readonly string[], target: string, open?: boolean): string[] | null;
+/** Visible values in tree order: roots plus the children of expanded parents whose ancestors are expanded. */
+export declare function getTreeSelectVisible(index: TreeSelectIndex, expanded: ReadonlySet<string>): string[];
+export declare function getTreeSelectLabels(index: TreeSelectIndex, value: readonly string[]): string[];
+/** Trigger summary: in cascade mode a parent whose leaves are all checked is shown once instead of its leaves. */
+export declare function getTreeSelectSummary(index: TreeSelectIndex, value: readonly string[], mode: TreeSelectMode): string[];
+export type TreeSelectKeyAction = {
+    type: "focus";
+    value: string;
+} | {
+    type: "expand";
+    value: string;
+    expanded: boolean;
+} | {
+    type: "activate";
+    value: string;
+} | {
+    type: "none";
+};
+/**
+ * WAI-ARIA tree keys from the focused node: ArrowUp/Down, Home/End, ArrowRight opens/moves to the first child,
+ * ArrowLeft closes/moves to the parent (mirrored when `rtl`), Enter/Space activate, a printable character moves to the
+ * next visible node whose label starts with it. `none`: a handled key with no effect; null: not a tree key.
+ */
+export declare function getTreeSelectKeyAction(index: TreeSelectIndex, visible: readonly string[], expanded: ReadonlySet<string>, current: string, key: string, rtl?: boolean): TreeSelectKeyAction | null;
+export declare function createTreeSelectProps(props?: QwTreeSelectProps): QwTreeSelectProps;
+export interface QwTreeSelectSchema {
+    props: QwTreeSelectProps;
+    context: {
+        value: string[];
+        expandedValue: string[];
+        focusedValue: string | null;
+    };
+    state: "ready";
+    action: "activate" | "expand" | "focus";
+    event: {
+        type: "NODE.ACTIVATE";
+        value: string;
+    } | {
+        type: "NODE.EXPAND";
+        value: string;
+        expanded?: boolean;
+    } | {
+        type: "NODE.FOCUS";
+        value: string;
+        move?: boolean;
+    };
+}
+export type QwTreeSelectMachine = Machine<QwTreeSelectSchema>;
+export type QwTreeSelectService = Service<QwTreeSelectSchema>;
+/** Core owns the selection rules (single/cascade/strict), expansion, roving focus and the keyboard map; adapters only render. */
+export declare const treeSelectMachine: QwTreeSelectMachine;
+export interface QwTreeSelectApi<T extends PropTypes = PropTypes> {
+    /** Effective value in tree order (cascade mode: checked leaves). */
+    value: string[];
+    /** Labels of `value`, in the same order. */
+    labels: string[];
+    /** Trigger summary labels: fully checked cascade parents collapse into their own label. */
+    summary: string[];
+    /** Raw values that match no node of the current options; they are dropped by the next selection change. */
+    staleValue: string[];
+    expandedValue: string[];
+    /** Visible node values in tree order. */
+    visibleValue: string[];
+    focusedValue: string | null;
+    multiple: boolean;
+    disabled: boolean;
+    empty: boolean;
+    label: string;
+    emptyText: string;
+    /** Root nodes; each item carries its visible children. */
+    items: TreeSelectItem[];
+    activate(value: string): void;
+    setExpanded(value: string, expanded: boolean): void;
+    focus(value: string): void;
+    getRootProps(): T["element"];
+    getTreeProps(): T["element"];
+    getItemProps(item: TreeSelectItem): T["element"];
+    getRowProps(item: TreeSelectItem): T["element"];
+    getIndicatorProps(item: TreeSelectItem): T["element"];
+    getCheckProps(item: TreeSelectItem): T["element"];
+    getTextProps(item: TreeSelectItem): T["element"];
+    getGroupProps(item: TreeSelectItem): T["element"];
+    getEmptyProps(): T["element"];
+}
+export declare function connectTreeSelect<T extends PropTypes>(service: QwTreeSelectService, normalize: NormalizeProps<T>): QwTreeSelectApi<T>;

package/dist/typography/index.d.ts

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

package/dist/typography/index.js

@@ -0,0 +1,82 @@
+//#region src/typography/typography.ts
+const TYPOGRAPHY_VARIANTS = [
+	"body",
+	"body-strong",
+	"body-lg",
+	"heading-sm",
+	"heading-md",
+	"heading-lg",
+	"caption",
+	"label-sm",
+	"code"
+];
+const TYPOGRAPHY_TAGS = [
+	"span",
+	"p",
+	"div",
+	"h1",
+	"h2",
+	"h3",
+	"h4",
+	"h5",
+	"h6"
+];
+const TYPOGRAPHY_FONT_FAMILIES = [
+	"text",
+	"number",
+	"code"
+];
+const TYPOGRAPHY_TONES = [
+	"primary",
+	"secondary",
+	"tertiary",
+	"placeholder",
+	"intro",
+	"disabled",
+	"link",
+	"inverse",
+	"on-solid",
+	"on-warning-subtle"
+];
+const TYPOGRAPHY_ALIGNS = [
+	"start",
+	"end",
+	"center",
+	"justify"
+];
+const TYPOGRAPHY_PARTS = ["root"];
+function choose(values, value, fallback) {
+	return values.includes(value) ? value : fallback;
+}
+/** Pure display contract; no content measurement, language detection or focus behavior. */
+function resolveTypographyState(props = {}) {
+	return {
+		tag: choose(TYPOGRAPHY_TAGS, props.as, "span"),
+		variant: choose(TYPOGRAPHY_VARIANTS, props.variant, "body"),
+		fontFamily: TYPOGRAPHY_FONT_FAMILIES.includes(props.fontFamily) ? props.fontFamily : void 0,
+		tone: choose(TYPOGRAPHY_TONES, props.tone, "primary"),
+		align: choose(TYPOGRAPHY_ALIGNS, props.align, "start"),
+		wrap: props.wrap !== false,
+		lang: props.lang,
+		dir: props.dir,
+		hidden: props.hidden === true ? true : void 0
+	};
+}
+function getTypographyRootProps(state) {
+	return {
+		"data-scope": "typography",
+		"data-part": "root",
+		"data-variant": state.variant,
+		"data-font-family": state.fontFamily,
+		"data-tone": state.tone,
+		"data-align": state.align,
+		"data-wrap": state.wrap ? "true" : "false",
+		lang: state.lang,
+		dir: state.dir,
+		hidden: state.hidden
+	};
+}
+//#endregion
+export { TYPOGRAPHY_ALIGNS, TYPOGRAPHY_FONT_FAMILIES, TYPOGRAPHY_PARTS, TYPOGRAPHY_TAGS, TYPOGRAPHY_TONES, TYPOGRAPHY_VARIANTS, getTypographyRootProps, resolveTypographyState };
+
+//# sourceMappingURL=index.js.map

package/dist/typography/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/typography/typography.ts"],"sourcesContent":["export const TYPOGRAPHY_VARIANTS = [\"body\", \"body-strong\", \"body-lg\", \"heading-sm\", \"heading-md\", \"heading-lg\", \"caption\", \"label-sm\", \"code\"] as const;\nexport const TYPOGRAPHY_TAGS = [\"span\", \"p\", \"div\", \"h1\", \"h2\", \"h3\", \"h4\", \"h5\", \"h6\"] as const;\nexport const TYPOGRAPHY_FONT_FAMILIES = [\"text\", \"number\", \"code\"] as const;\nexport const TYPOGRAPHY_TONES = [\"primary\", \"secondary\", \"tertiary\", \"placeholder\", \"intro\", \"disabled\", \"link\", \"inverse\", \"on-solid\", \"on-warning-subtle\"] as const;\nexport const TYPOGRAPHY_ALIGNS = [\"start\", \"end\", \"center\", \"justify\"] as const;\nexport const TYPOGRAPHY_PARTS = [\"root\"] as const;\nexport type TypographyVariant = (typeof TYPOGRAPHY_VARIANTS)[number];\nexport type TypographyTag = (typeof TYPOGRAPHY_TAGS)[number];\nexport type TypographyFontFamily = (typeof TYPOGRAPHY_FONT_FAMILIES)[number];\nexport type TypographyTone = (typeof TYPOGRAPHY_TONES)[number];\nexport type TypographyAlign = (typeof TYPOGRAPHY_ALIGNS)[number];\n\nexport interface QwTypographyProps {\n  /** Existing semantic type role; default body. Does not choose a heading level. */\n  variant?: TypographyVariant;\n  /** Independent native HTML semantics; default span. */\n  as?: TypographyTag;\n  /** Optional existing family override; omission keeps the role's family. */\n  fontFamily?: TypographyFontFamily;\n  /** Existing content color; context-specific tones require the matching background. */\n  tone?: TypographyTone;\n  /** Logical text alignment; use a block root to align its text container. */\n  align?: TypographyAlign;\n  /** Normal wrapping and long-word handling by default; false keeps all text on one line. */\n  wrap?: boolean;\n  lang?: string;\n  dir?: string;\n  hidden?: boolean;\n}\nexport interface ResolvedTypographyState {\n  tag: TypographyTag;\n  variant: TypographyVariant;\n  fontFamily?: TypographyFontFamily;\n  tone: TypographyTone;\n  align: TypographyAlign;\n  wrap: boolean;\n  lang?: string;\n  dir?: string;\n  hidden?: boolean;\n}\nfunction choose<T extends string>(values: readonly T[], value: unknown, fallback: T): T {\n  return values.includes(value as T) ? value as T : fallback;\n}\n/** Pure display contract; no content measurement, language detection or focus behavior. */\nexport function resolveTypographyState(props: QwTypographyProps = {}): ResolvedTypographyState {\n  return {\n    tag: choose(TYPOGRAPHY_TAGS, props.as, \"span\"),\n    variant: choose(TYPOGRAPHY_VARIANTS, props.variant, \"body\"),\n    fontFamily: TYPOGRAPHY_FONT_FAMILIES.includes(props.fontFamily!) ? props.fontFamily : undefined,\n    tone: choose(TYPOGRAPHY_TONES, props.tone, \"primary\"),\n    align: choose(TYPOGRAPHY_ALIGNS, props.align, \"start\"),\n    wrap: props.wrap !== false,\n    lang: props.lang, dir: props.dir, hidden: props.hidden === true ? true : undefined,\n  };\n}\nexport interface TypographyRootProps {\n  \"data-scope\": \"typography\";\n  \"data-part\": \"root\";\n  \"data-variant\": TypographyVariant;\n  \"data-font-family\"?: TypographyFontFamily;\n  \"data-tone\": TypographyTone;\n  \"data-align\": TypographyAlign;\n  \"data-wrap\": \"true\" | \"false\";\n  lang?: string;\n  dir?: string;\n  hidden?: boolean;\n}\nexport function getTypographyRootProps(state: ResolvedTypographyState): TypographyRootProps {\n  return { \"data-scope\": \"typography\", \"data-part\": \"root\", \"data-variant\": state.variant,\n    \"data-font-family\": state.fontFamily, \"data-tone\": state.tone, \"data-align\": state.align,\n    \"data-wrap\": state.wrap ? \"true\" : \"false\", lang: state.lang, dir: state.dir, hidden: state.hidden };\n}\n"],"mappings":";AAAA,MAAa,sBAAsB;CAAC;CAAQ;CAAe;CAAW;CAAc;CAAc;CAAc;CAAW;CAAY;AAAM;AAC7I,MAAa,kBAAkB;CAAC;CAAQ;CAAK;CAAO;CAAM;CAAM;CAAM;CAAM;CAAM;AAAI;AACtF,MAAa,2BAA2B;CAAC;CAAQ;CAAU;AAAM;AACjE,MAAa,mBAAmB;CAAC;CAAW;CAAa;CAAY;CAAe;CAAS;CAAY;CAAQ;CAAW;CAAY;AAAmB;AAC3J,MAAa,oBAAoB;CAAC;CAAS;CAAO;CAAU;AAAS;AACrE,MAAa,mBAAmB,CAAC,MAAM;AAmCvC,SAAS,OAAyB,QAAsB,OAAgB,UAAgB;CACtF,OAAO,OAAO,SAAS,KAAU,IAAI,QAAa;AACpD;;AAEA,SAAgB,uBAAuB,QAA2B,CAAC,GAA4B;CAC7F,OAAO;EACL,KAAK,OAAO,iBAAiB,MAAM,IAAI,MAAM;EAC7C,SAAS,OAAO,qBAAqB,MAAM,SAAS,MAAM;EAC1D,YAAY,yBAAyB,SAAS,MAAM,UAAW,IAAI,MAAM,aAAa,KAAA;EACtF,MAAM,OAAO,kBAAkB,MAAM,MAAM,SAAS;EACpD,OAAO,OAAO,mBAAmB,MAAM,OAAO,OAAO;EACrD,MAAM,MAAM,SAAS;EACrB,MAAM,MAAM;EAAM,KAAK,MAAM;EAAK,QAAQ,MAAM,WAAW,OAAO,OAAO,KAAA;CAC3E;AACF;AAaA,SAAgB,uBAAuB,OAAqD;CAC1F,OAAO;EAAE,cAAc;EAAc,aAAa;EAAQ,gBAAgB,MAAM;EAC9E,oBAAoB,MAAM;EAAY,aAAa,MAAM;EAAM,cAAc,MAAM;EACnF,aAAa,MAAM,OAAO,SAAS;EAAS,MAAM,MAAM;EAAM,KAAK,MAAM;EAAK,QAAQ,MAAM;CAAO;AACvG"}

package/dist/typography/typography.d.ts

@@ -0,0 +1,54 @@
+export declare const TYPOGRAPHY_VARIANTS: readonly ["body", "body-strong", "body-lg", "heading-sm", "heading-md", "heading-lg", "caption", "label-sm", "code"];
+export declare const TYPOGRAPHY_TAGS: readonly ["span", "p", "div", "h1", "h2", "h3", "h4", "h5", "h6"];
+export declare const TYPOGRAPHY_FONT_FAMILIES: readonly ["text", "number", "code"];
+export declare const TYPOGRAPHY_TONES: readonly ["primary", "secondary", "tertiary", "placeholder", "intro", "disabled", "link", "inverse", "on-solid", "on-warning-subtle"];
+export declare const TYPOGRAPHY_ALIGNS: readonly ["start", "end", "center", "justify"];
+export declare const TYPOGRAPHY_PARTS: readonly ["root"];
+export type TypographyVariant = (typeof TYPOGRAPHY_VARIANTS)[number];
+export type TypographyTag = (typeof TYPOGRAPHY_TAGS)[number];
+export type TypographyFontFamily = (typeof TYPOGRAPHY_FONT_FAMILIES)[number];
+export type TypographyTone = (typeof TYPOGRAPHY_TONES)[number];
+export type TypographyAlign = (typeof TYPOGRAPHY_ALIGNS)[number];
+export interface QwTypographyProps {
+    /** Existing semantic type role; default body. Does not choose a heading level. */
+    variant?: TypographyVariant;
+    /** Independent native HTML semantics; default span. */
+    as?: TypographyTag;
+    /** Optional existing family override; omission keeps the role's family. */
+    fontFamily?: TypographyFontFamily;
+    /** Existing content color; context-specific tones require the matching background. */
+    tone?: TypographyTone;
+    /** Logical text alignment; use a block root to align its text container. */
+    align?: TypographyAlign;
+    /** Normal wrapping and long-word handling by default; false keeps all text on one line. */
+    wrap?: boolean;
+    lang?: string;
+    dir?: string;
+    hidden?: boolean;
+}
+export interface ResolvedTypographyState {
+    tag: TypographyTag;
+    variant: TypographyVariant;
+    fontFamily?: TypographyFontFamily;
+    tone: TypographyTone;
+    align: TypographyAlign;
+    wrap: boolean;
+    lang?: string;
+    dir?: string;
+    hidden?: boolean;
+}
+/** Pure display contract; no content measurement, language detection or focus behavior. */
+export declare function resolveTypographyState(props?: QwTypographyProps): ResolvedTypographyState;
+export interface TypographyRootProps {
+    "data-scope": "typography";
+    "data-part": "root";
+    "data-variant": TypographyVariant;
+    "data-font-family"?: TypographyFontFamily;
+    "data-tone": TypographyTone;
+    "data-align": TypographyAlign;
+    "data-wrap": "true" | "false";
+    lang?: string;
+    dir?: string;
+    hidden?: boolean;
+}
+export declare function getTypographyRootProps(state: ResolvedTypographyState): TypographyRootProps;

package/dist/upload/index.d.ts

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