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

package/dist/ellipsis/index.js

@@ -0,0 +1,320 @@
+import { createMachine } from "@zag-js/core";
+import { dataAttr, visuallyHiddenStyle } from "@zag-js/dom-query";
+//#region src/ellipsis/ellipsis-layout.ts
+/** Inherited typography that determines line breaking. */
+const COPIED_STYLES = [
+	"font-family",
+	"font-size",
+	"font-weight",
+	"font-style",
+	"font-variant",
+	"font-stretch",
+	"font-feature-settings",
+	"letter-spacing",
+	"word-spacing",
+	"line-height",
+	"text-transform",
+	"text-indent",
+	"word-break",
+	"overflow-wrap",
+	"line-break",
+	"hyphens",
+	"tab-size",
+	"direction",
+	"unicode-bidi",
+	"writing-mode"
+];
+const ELLIPSIS_PROBE_ATTRIBUTE = "data-qw-ellipsis-probe";
+/** Code-point safe truncation candidates; `kept` counts content code points that remain visible. */
+function buildEllipsisCandidate(chars, kept, direction, symbol) {
+	const count = Math.max(0, Math.min(chars.length, Math.floor(kept)));
+	if (direction === "start") return symbol + chars.slice(chars.length - count).join("");
+	if (direction === "middle") {
+		const head = Math.ceil(count / 2), tail = count - head;
+		return chars.slice(0, head).join("") + symbol + (tail ? chars.slice(chars.length - tail).join("") : "");
+	}
+	return chars.slice(0, count).join("") + symbol;
+}
+/**
+* Pure search: longest candidate that `fits`. `fits` must be monotonic (fewer kept characters never fit worse).
+* Returns null when the full content fits.
+*/
+function findEllipsisText(content, direction, symbol, fits) {
+	if (fits(content)) return null;
+	const chars = Array.from(content);
+	let low = 0, high = chars.length - 1, best = 0;
+	while (low <= high) {
+		const mid = low + high >> 1;
+		if (fits(buildEllipsisCandidate(chars, mid, direction, symbol))) {
+			best = mid;
+			low = mid + 1;
+		} else high = mid - 1;
+	}
+	return buildEllipsisCandidate(chars, best, direction, symbol);
+}
+function px(value) {
+	const parsed = Number.parseFloat(value);
+	return Number.isFinite(parsed) ? parsed : 0;
+}
+/** Measures with a detached-from-layout probe in the same document; returns null when not laid out (zero width). */
+function measureEllipsisLayout(root, input) {
+	const doc = root.ownerDocument, view = doc.defaultView;
+	if (!view || !doc.body || !root.isConnected) return null;
+	const style = view.getComputedStyle(root);
+	const width = root.getBoundingClientRect().width - px(style.paddingLeft) - px(style.paddingRight) - px(style.borderLeftWidth) - px(style.borderRightWidth);
+	if (!(width > 0)) return null;
+	const probe = doc.createElement("div");
+	probe.setAttribute(ELLIPSIS_PROBE_ATTRIBUTE, "");
+	probe.setAttribute("aria-hidden", "true");
+	for (const name of COPIED_STYLES) probe.style.setProperty(name, style.getPropertyValue(name));
+	for (const [name, value] of [
+		["position", "absolute"],
+		["visibility", "hidden"],
+		["pointer-events", "none"],
+		["inset-block-start", "0"],
+		["inset-inline-start", "0"],
+		["display", "block"],
+		["box-sizing", "content-box"],
+		["padding", "0"],
+		["border", "0"],
+		["margin", "0"],
+		["inline-size", `${width}px`],
+		["block-size", "auto"],
+		["max-block-size", "none"],
+		["overflow", "visible"],
+		["white-space", style.whiteSpace === "nowrap" || style.whiteSpace === "pre" ? "pre-wrap" : style.whiteSpace || "normal"],
+		["-webkit-line-clamp", "none"]
+	]) probe.style.setProperty(name, value);
+	probe.style.setProperty("width", `${width}px`);
+	doc.body.append(probe);
+	try {
+		probe.replaceChildren();
+		for (let line = 0; line < input.rows; line++) {
+			if (line) probe.append(doc.createElement("br"));
+			probe.append(doc.createTextNode("\xA0"));
+		}
+		const limit = probe.getBoundingClientRect().height + .5;
+		const suffix = input.actionText ? `\u00a0${input.actionText}\u00a0` : "";
+		const height = (text) => {
+			probe.textContent = text;
+			return probe.getBoundingClientRect().height;
+		};
+		if (height(input.content) <= limit) return {
+			overflow: false,
+			text: input.content,
+			width
+		};
+		const text = findEllipsisText(input.content, input.direction, input.symbol, (candidate) => height(candidate + suffix) <= limit);
+		return {
+			overflow: text !== null,
+			text: text ?? input.content,
+			width
+		};
+	} finally {
+		probe.remove();
+	}
+}
+/** Calls `onChange` when the observed inline size changes (and once on start). Returns stop. */
+function observeEllipsisLayout(root, onChange) {
+	const view = root.ownerDocument.defaultView;
+	let disposed = false, last = NaN;
+	const notify = () => {
+		if (!disposed) onChange();
+	};
+	let observer;
+	if (view && typeof view.ResizeObserver === "function") {
+		observer = new view.ResizeObserver((entries) => {
+			const width = entries[entries.length - 1]?.contentRect?.width;
+			if (typeof width === "number" && width === last) return;
+			if (typeof width === "number") last = width;
+			notify();
+		});
+		observer.observe(root);
+	} else queueMicrotask(notify);
+	const fonts = root.ownerDocument.fonts;
+	if (fonts?.ready) fonts.ready.then(notify, () => {});
+	return () => {
+		disposed = true;
+		observer?.disconnect();
+	};
+}
+//#endregion
+//#region src/ellipsis/ellipsis.ts
+const ELLIPSIS_DIRECTIONS = [
+	"end",
+	"start",
+	"middle"
+];
+const ELLIPSIS_PARTS = [
+	"root",
+	"content",
+	"text",
+	"full-text",
+	"toggle"
+];
+function normalizeEllipsisRows(rows) {
+	return typeof rows === "number" && Number.isFinite(rows) && rows >= 1 ? Math.min(1e3, Math.floor(rows)) : 1;
+}
+function createEllipsisProps(props) {
+	if (props.id !== void 0 && (typeof props.id !== "string" || !props.id.trim())) throw new TypeError("Ellipsis requires a nonempty instance id when provided");
+	return {
+		...props,
+		content: typeof props.content === "string" ? props.content : String(props.content ?? ""),
+		rows: normalizeEllipsisRows(props.rows),
+		direction: ELLIPSIS_DIRECTIONS.includes(props.direction) ? props.direction : "end",
+		expandText: typeof props.expandText === "string" ? props.expandText : "展开",
+		collapseText: typeof props.collapseText === "string" ? props.collapseText : "收起",
+		symbol: typeof props.symbol === "string" ? props.symbol : "…",
+		defaultExpanded: props.defaultExpanded === true,
+		expanded: typeof props.expanded === "boolean" ? props.expanded : void 0
+	};
+}
+function hex(id) {
+	return id.split("").map((char) => char.charCodeAt(0).toString(16).padStart(4, "0")).join("");
+}
+const rootId = (scope) => {
+	if (!scope.id?.trim()) throw new TypeError("Ellipsis requires a nonempty stable id");
+	return `qw-ellipsis-${hex(scope.id)}`;
+};
+const contentId = (scope) => `${rootId(scope)}-content`;
+/** Measurement identity: a result for other text/options is never shown. */
+const measureKey = (params) => JSON.stringify([
+	params.prop("content"),
+	params.prop("rows"),
+	params.prop("direction"),
+	params.prop("symbol"),
+	params.prop("expandText")
+]);
+function measure(params) {
+	const root = params.scope.getById(rootId(params.scope));
+	if (!root) return;
+	const result = measureEllipsisLayout(root, {
+		content: params.prop("content"),
+		rows: params.prop("rows"),
+		direction: params.prop("direction"),
+		symbol: params.prop("symbol"),
+		actionText: params.prop("expandText")
+	});
+	if (!result) return;
+	const key = measureKey(params), previous = params.context.get("measurement");
+	if (previous && previous.key === key && previous.overflow === result.overflow && previous.text === result.text) return;
+	params.context.set("measurement", {
+		...result,
+		key
+	});
+}
+/** Expanded state + measurement lifecycle. The resize observer is a Core effect: start on mount, stop on unmount. */
+const ellipsisMachine = createMachine({
+	props: ({ props }) => createEllipsisProps({
+		...props,
+		content: props.content ?? ""
+	}),
+	initialState: () => "ready",
+	context({ prop, bindable }) {
+		return {
+			expanded: bindable(() => ({
+				defaultValue: prop("defaultExpanded"),
+				value: prop("expanded"),
+				onChange: (expanded) => prop("onExpandedChange")?.({ expanded })
+			})),
+			measurement: bindable(() => ({ defaultValue: null }))
+		};
+	},
+	watch({ track, prop, send }) {
+		track([
+			() => prop("content"),
+			() => prop("rows"),
+			() => prop("direction"),
+			() => prop("symbol"),
+			() => prop("expandText")
+		], () => send({ type: "MEASURE" }));
+	},
+	effects: ["observeLayout"],
+	on: {
+		TOGGLE: { actions: ["toggle"] },
+		"EXPANDED.SET": { actions: ["setExpanded"] },
+		MEASURE: { actions: ["measure"] }
+	},
+	states: { ready: {} },
+	implementations: {
+		effects: { observeLayout({ scope, send }) {
+			const root = scope.getById(rootId(scope));
+			if (!root) return;
+			return observeEllipsisLayout(root, () => send({ type: "MEASURE" }));
+		} },
+		actions: {
+			toggle({ context, prop }) {
+				if (prop("expandText") || context.get("expanded")) context.set("expanded", !context.get("expanded"));
+			},
+			setExpanded({ context, event }) {
+				if (event.type === "EXPANDED.SET") context.set("expanded", event.value);
+			},
+			measure
+		}
+	}
+});
+function connectEllipsis(service, normalize) {
+	const content = service.prop("content"), expanded = !!service.context.get("expanded");
+	const stored = service.context.get("measurement");
+	const current = stored && stored.key === measureKey(service) ? stored : null;
+	const overflow = !!current?.overflow, truncated = overflow && !expanded;
+	const toggleText = expanded ? service.prop("collapseText") : service.prop("expandText");
+	const showToggle = overflow && toggleText !== "";
+	const part = (name) => ({
+		"data-scope": "ellipsis",
+		"data-part": name
+	});
+	const id = rootId(service.scope);
+	return {
+		content,
+		expanded,
+		measured: current !== null,
+		overflow,
+		truncated,
+		visibleText: truncated ? current.text : content,
+		toggleText,
+		showToggle,
+		setExpanded: (value) => service.send({
+			type: "EXPANDED.SET",
+			value
+		}),
+		remeasure: () => service.send({ type: "MEASURE" }),
+		getRootProps: () => normalize.element({
+			...part("root"),
+			id,
+			"data-direction": service.prop("direction"),
+			"data-expanded": dataAttr(expanded),
+			"data-measured": dataAttr(current !== null),
+			"data-overflow": dataAttr(overflow),
+			"data-truncated": dataAttr(truncated),
+			style: { "--qw-ellipsis-rows": String(service.prop("rows")) }
+		}),
+		getContentProps: () => normalize.element({
+			...part("content"),
+			id: contentId(service.scope)
+		}),
+		getTextProps: () => normalize.element({
+			...part("text"),
+			"aria-hidden": truncated ? "true" : void 0
+		}),
+		getFullTextProps: () => normalize.element({
+			...part("full-text"),
+			hidden: !truncated,
+			style: truncated ? visuallyHiddenStyle : void 0
+		}),
+		getToggleProps: () => normalize.button({
+			...part("toggle"),
+			type: "button",
+			hidden: !showToggle,
+			"aria-expanded": expanded,
+			"aria-controls": contentId(service.scope),
+			onClick() {
+				service.send({ type: "TOGGLE" });
+			}
+		})
+	};
+}
+//#endregion
+export { ELLIPSIS_DIRECTIONS, ELLIPSIS_PARTS, ELLIPSIS_PROBE_ATTRIBUTE, buildEllipsisCandidate, connectEllipsis, createEllipsisProps, ellipsisMachine, findEllipsisText, measureEllipsisLayout, normalizeEllipsisRows, observeEllipsisLayout };
+
+//# sourceMappingURL=index.js.map

package/dist/ellipsis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/ellipsis/ellipsis-layout.ts","../../src/ellipsis/ellipsis.ts"],"sourcesContent":["import type { EllipsisDirection } from \"./ellipsis.js\";\n\n/**\n * Ellipsis platform boundary: DOM measurement and resize observation only.\n * Truncation search and expanded/collapsed decisions stay in ellipsis.ts.\n * Nothing here runs at module top level, so importing it is SSR-safe.\n */\nexport interface EllipsisMeasureInput {\n  content: string;\n  rows: number;\n  direction: EllipsisDirection;\n  symbol: string;\n  /** Visible action label measured on the same line as the truncated text (\"\" = none). */\n  actionText: string;\n}\nexport interface EllipsisMeasurement {\n  /** True when the full content exceeds `rows` lines. */\n  overflow: boolean;\n  /** Collapsed visible text (with symbol) when overflowing; otherwise the full content. */\n  text: string;\n  /** Inline size used for the decision, in CSS pixels. */\n  width: number;\n}\n\n/** Inherited typography that determines line breaking. */\nconst COPIED_STYLES = [\"font-family\", \"font-size\", \"font-weight\", \"font-style\", \"font-variant\", \"font-stretch\", \"font-feature-settings\", \"letter-spacing\", \"word-spacing\", \"line-height\", \"text-transform\", \"text-indent\", \"word-break\", \"overflow-wrap\", \"line-break\", \"hyphens\", \"tab-size\", \"direction\", \"unicode-bidi\", \"writing-mode\"] as const;\nexport const ELLIPSIS_PROBE_ATTRIBUTE = \"data-qw-ellipsis-probe\";\n\n/** Code-point safe truncation candidates; `kept` counts content code points that remain visible. */\nexport function buildEllipsisCandidate(chars: readonly string[], kept: number, direction: EllipsisDirection, symbol: string): string {\n  const count = Math.max(0, Math.min(chars.length, Math.floor(kept)));\n  if (direction === \"start\") return symbol + chars.slice(chars.length - count).join(\"\");\n  if (direction === \"middle\") {\n    const head = Math.ceil(count / 2), tail = count - head;\n    return chars.slice(0, head).join(\"\") + symbol + (tail ? chars.slice(chars.length - tail).join(\"\") : \"\");\n  }\n  return chars.slice(0, count).join(\"\") + symbol;\n}\n\n/**\n * Pure search: longest candidate that `fits`. `fits` must be monotonic (fewer kept characters never fit worse).\n * Returns null when the full content fits.\n */\nexport function findEllipsisText(content: string, direction: EllipsisDirection, symbol: string, fits: (candidate: string) => boolean): string | null {\n  if (fits(content)) return null;\n  const chars = Array.from(content);\n  let low = 0, high = chars.length - 1, best = 0;\n  while (low <= high) {\n    const mid = (low + high) >> 1;\n    if (fits(buildEllipsisCandidate(chars, mid, direction, symbol))) { best = mid; low = mid + 1; } else high = mid - 1;\n  }\n  return buildEllipsisCandidate(chars, best, direction, symbol);\n}\n\nfunction px(value: string): number { const parsed = Number.parseFloat(value); return Number.isFinite(parsed) ? parsed : 0; }\n\n/** Measures with a detached-from-layout probe in the same document; returns null when not laid out (zero width). */\nexport function measureEllipsisLayout(root: HTMLElement, input: EllipsisMeasureInput): EllipsisMeasurement | null {\n  const doc = root.ownerDocument, view = doc.defaultView;\n  if (!view || !doc.body || !root.isConnected) return null;\n  const style = view.getComputedStyle(root);\n  const width = root.getBoundingClientRect().width - px(style.paddingLeft) - px(style.paddingRight) - px(style.borderLeftWidth) - px(style.borderRightWidth);\n  if (!(width > 0)) return null;\n  const probe = doc.createElement(\"div\");\n  probe.setAttribute(ELLIPSIS_PROBE_ATTRIBUTE, \"\");\n  probe.setAttribute(\"aria-hidden\", \"true\");\n  for (const name of COPIED_STYLES) probe.style.setProperty(name, style.getPropertyValue(name));\n  for (const [name, value] of [[\"position\", \"absolute\"], [\"visibility\", \"hidden\"], [\"pointer-events\", \"none\"], [\"inset-block-start\", \"0\"], [\"inset-inline-start\", \"0\"], [\"display\", \"block\"], [\"box-sizing\", \"content-box\"], [\"padding\", \"0\"], [\"border\", \"0\"], [\"margin\", \"0\"], [\"inline-size\", `${width}px`], [\"block-size\", \"auto\"], [\"max-block-size\", \"none\"], [\"overflow\", \"visible\"], [\"white-space\", style.whiteSpace === \"nowrap\" || style.whiteSpace === \"pre\" ? \"pre-wrap\" : style.whiteSpace || \"normal\"], [\"-webkit-line-clamp\", \"none\"]] as const) probe.style.setProperty(name, value);\n  probe.style.setProperty(\"width\", `${width}px`);\n  doc.body.append(probe);\n  try {\n    probe.replaceChildren();\n    for (let line = 0; line < input.rows; line++) { if (line) probe.append(doc.createElement(\"br\")); probe.append(doc.createTextNode(\"\\u00a0\")); }\n    const limit = probe.getBoundingClientRect().height + 0.5;\n    const suffix = input.actionText ? `\\u00a0${input.actionText}\\u00a0` : \"\";\n    const height = (text: string) => { probe.textContent = text; return probe.getBoundingClientRect().height; };\n    if (height(input.content) <= limit) return { overflow: false, text: input.content, width };\n    const text = findEllipsisText(input.content, input.direction, input.symbol, (candidate) => height(candidate + suffix) <= limit);\n    return { overflow: text !== null, text: text ?? input.content, width };\n  } finally {\n    probe.remove();\n  }\n}\n\n/** Calls `onChange` when the observed inline size changes (and once on start). Returns stop. */\nexport function observeEllipsisLayout(root: HTMLElement, onChange: () => void): () => void {\n  const view = root.ownerDocument.defaultView;\n  let disposed = false, last = Number.NaN;\n  const notify = () => { if (!disposed) onChange(); };\n  let observer: ResizeObserver | undefined;\n  if (view && typeof view.ResizeObserver === \"function\") {\n    observer = new view.ResizeObserver((entries) => {\n      const width = entries[entries.length - 1]?.contentRect?.width;\n      if (typeof width === \"number\" && width === last) return;\n      if (typeof width === \"number\") last = width;\n      notify();\n    });\n    observer.observe(root);\n  } else queueMicrotask(notify);\n  const fonts = root.ownerDocument.fonts;\n  if (fonts?.ready) void fonts.ready.then(notify, () => {});\n  return () => { disposed = true; observer?.disconnect(); };\n}\n","import { createMachine, type Machine, type Params, type Service } from \"@zag-js/core\";\nimport { dataAttr, visuallyHiddenStyle } from \"@zag-js/dom-query\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\nimport { measureEllipsisLayout, observeEllipsisLayout, type EllipsisMeasurement } from \"./ellipsis-layout.js\";\n\nexport const ELLIPSIS_DIRECTIONS = [\"end\", \"start\", \"middle\"] as const;\nexport const ELLIPSIS_PARTS = [\"root\", \"content\", \"text\", \"full-text\", \"toggle\"] as const;\nexport type EllipsisDirection = (typeof ELLIPSIS_DIRECTIONS)[number];\nexport type EllipsisPart = (typeof ELLIPSIS_PARTS)[number];\nexport interface EllipsisExpandedChangeDetails { expanded: boolean }\n\nexport interface QwEllipsisProps {\n  /** Stable instance identity for aria-controls; frameworks generate one when omitted. */\n  id?: string;\n  /** Plain text content (measurement requires text). */\n  content: string;\n  /** Visible lines when collapsed; integer ≥ 1, invalid → 1. */\n  rows?: number;\n  /** Where the ellipsis symbol goes. Default end. */\n  direction?: EllipsisDirection;\n  /** Controlled expanded state when defined. */\n  expanded?: boolean;\n  defaultExpanded?: boolean;\n  /** Expand action label; \"\" disables expansion. Default 展开. */\n  expandText?: string;\n  /** Collapse action label; \"\" hides the collapse action. Default 收起. */\n  collapseText?: string;\n  /** Ellipsis symbol. Default …. */\n  symbol?: string;\n  onExpandedChange?: (details: EllipsisExpandedChangeDetails) => void;\n}\n\nexport function normalizeEllipsisRows(rows: unknown): number {\n  return typeof rows === \"number\" && Number.isFinite(rows) && rows >= 1 ? Math.min(1000, Math.floor(rows)) : 1;\n}\ntype NormalizedProps = QwEllipsisProps & { content: string; rows: number; direction: EllipsisDirection; expandText: string; collapseText: string; symbol: string; defaultExpanded: boolean };\nexport function createEllipsisProps(props: QwEllipsisProps): NormalizedProps {\n  if (props.id !== undefined && (typeof props.id !== \"string\" || !props.id.trim())) throw new TypeError(\"Ellipsis requires a nonempty instance id when provided\");\n  return {\n    ...props,\n    content: typeof props.content === \"string\" ? props.content : String(props.content ?? \"\"),\n    rows: normalizeEllipsisRows(props.rows),\n    direction: ELLIPSIS_DIRECTIONS.includes(props.direction!) ? props.direction! : \"end\",\n    expandText: typeof props.expandText === \"string\" ? props.expandText : \"展开\",\n    collapseText: typeof props.collapseText === \"string\" ? props.collapseText : \"收起\",\n    symbol: typeof props.symbol === \"string\" ? props.symbol : \"…\",\n    defaultExpanded: props.defaultExpanded === true,\n    expanded: typeof props.expanded === \"boolean\" ? props.expanded : undefined,\n  };\n}\ninterface KeyedMeasurement extends EllipsisMeasurement { key: string }\nexport interface QwEllipsisSchema {\n  props: NormalizedProps;\n  context: { expanded: boolean; measurement: KeyedMeasurement | null };\n  state: \"ready\";\n  action: \"toggle\" | \"setExpanded\" | \"measure\";\n  effect: \"observeLayout\";\n  event: { type: \"TOGGLE\" } | { type: \"EXPANDED.SET\"; value: boolean } | { type: \"MEASURE\" };\n}\nexport type QwEllipsisMachine = Machine<QwEllipsisSchema>;\nexport type QwEllipsisService = Service<QwEllipsisSchema>;\ntype EllipsisParams = Pick<Params<QwEllipsisSchema>, \"context\" | \"prop\" | \"scope\">;\n\nfunction hex(id: string) { return id.split(\"\").map((char) => char.charCodeAt(0).toString(16).padStart(4, \"0\")).join(\"\"); }\nconst rootId = (scope: QwEllipsisService[\"scope\"]) => { if (!scope.id?.trim()) throw new TypeError(\"Ellipsis requires a nonempty stable id\"); return `qw-ellipsis-${hex(scope.id)}`; };\nconst contentId = (scope: QwEllipsisService[\"scope\"]) => `${rootId(scope)}-content`;\n/** Measurement identity: a result for other text/options is never shown. */\nconst measureKey = (params: Pick<EllipsisParams, \"prop\">) => JSON.stringify([params.prop(\"content\"), params.prop(\"rows\"), params.prop(\"direction\"), params.prop(\"symbol\"), params.prop(\"expandText\")]);\nfunction measure(params: EllipsisParams) {\n  const root = params.scope.getById<HTMLElement>(rootId(params.scope));\n  if (!root) return;\n  const result = measureEllipsisLayout(root, { content: params.prop(\"content\"), rows: params.prop(\"rows\"), direction: params.prop(\"direction\"), symbol: params.prop(\"symbol\"), actionText: params.prop(\"expandText\") });\n  if (!result) return;\n  const key = measureKey(params), previous = params.context.get(\"measurement\");\n  if (previous && previous.key === key && previous.overflow === result.overflow && previous.text === result.text) return;\n  params.context.set(\"measurement\", { ...result, key });\n}\n\n/** Expanded state + measurement lifecycle. The resize observer is a Core effect: start on mount, stop on unmount. */\nexport const ellipsisMachine: QwEllipsisMachine = createMachine<QwEllipsisSchema>({\n  props: ({ props }) => createEllipsisProps({ ...props, content: props.content ?? \"\" }),\n  initialState: () => \"ready\",\n  context({ prop, bindable }) {\n    return {\n      expanded: bindable(() => ({ defaultValue: prop(\"defaultExpanded\"), value: prop(\"expanded\"), onChange: (expanded) => prop(\"onExpandedChange\")?.({ expanded }) })),\n      measurement: bindable<KeyedMeasurement | null>(() => ({ defaultValue: null })),\n    };\n  },\n  watch({ track, prop, send }) {\n    track([() => prop(\"content\"), () => prop(\"rows\"), () => prop(\"direction\"), () => prop(\"symbol\"), () => prop(\"expandText\")], () => send({ type: \"MEASURE\" }));\n  },\n  effects: [\"observeLayout\"],\n  on: { TOGGLE: { actions: [\"toggle\"] }, \"EXPANDED.SET\": { actions: [\"setExpanded\"] }, MEASURE: { actions: [\"measure\"] } },\n  states: { ready: {} },\n  implementations: {\n    effects: {\n      observeLayout({ scope, send }) {\n        const root = scope.getById<HTMLElement>(rootId(scope));\n        if (!root) return;\n        return observeEllipsisLayout(root, () => send({ type: \"MEASURE\" }));\n      },\n    },\n    actions: {\n      toggle({ context, prop }) { if (prop(\"expandText\") || context.get(\"expanded\")) context.set(\"expanded\", !context.get(\"expanded\")); },\n      setExpanded({ context, event }) { if (event.type === \"EXPANDED.SET\") context.set(\"expanded\", event.value); },\n      measure,\n    },\n  },\n});\n\nexport interface QwEllipsisApi<T extends PropTypes = PropTypes> {\n  content: string;\n  expanded: boolean;\n  /** A current measurement exists for these props. */\n  measured: boolean;\n  overflow: boolean;\n  /** Visible text is shortened; full text is provided to assistive technology separately. */\n  truncated: boolean;\n  visibleText: string;\n  toggleText: string;\n  showToggle: boolean;\n  setExpanded(expanded: boolean): void;\n  /** Re-run measurement (for example after a caller-driven style change). */\n  remeasure(): void;\n  getRootProps(): T[\"element\"];\n  getContentProps(): T[\"element\"];\n  getTextProps(): T[\"element\"];\n  getFullTextProps(): T[\"element\"];\n  getToggleProps(): T[\"button\"];\n}\n\nexport function connectEllipsis<T extends PropTypes>(service: QwEllipsisService, normalize: NormalizeProps<T>): QwEllipsisApi<T> {\n  const content = service.prop(\"content\"), expanded = !!service.context.get(\"expanded\");\n  const stored = service.context.get(\"measurement\");\n  const current = stored && stored.key === measureKey(service) ? stored : null;\n  const overflow = !!current?.overflow, truncated = overflow && !expanded;\n  const toggleText = expanded ? service.prop(\"collapseText\") : service.prop(\"expandText\");\n  const showToggle = overflow && toggleText !== \"\";\n  const part = (name: EllipsisPart) => ({ \"data-scope\": \"ellipsis\", \"data-part\": name });\n  const id = rootId(service.scope);\n  return {\n    content, expanded, measured: current !== null, overflow, truncated,\n    visibleText: truncated ? current!.text : content, toggleText, showToggle,\n    setExpanded: (value) => service.send({ type: \"EXPANDED.SET\", value }),\n    remeasure: () => service.send({ type: \"MEASURE\" }),\n    getRootProps: () => normalize.element({ ...part(\"root\"), id, \"data-direction\": service.prop(\"direction\"), \"data-expanded\": dataAttr(expanded), \"data-measured\": dataAttr(current !== null), \"data-overflow\": dataAttr(overflow), \"data-truncated\": dataAttr(truncated), style: { \"--qw-ellipsis-rows\": String(service.prop(\"rows\")) } }),\n    getContentProps: () => normalize.element({ ...part(\"content\"), id: contentId(service.scope) }),\n    getTextProps: () => normalize.element({ ...part(\"text\"), \"aria-hidden\": truncated ? \"true\" : undefined }),\n    getFullTextProps: () => normalize.element({ ...part(\"full-text\"), hidden: !truncated, style: truncated ? visuallyHiddenStyle : undefined }),\n    getToggleProps: () => normalize.button({ ...part(\"toggle\"), type: \"button\", hidden: !showToggle, \"aria-expanded\": expanded, \"aria-controls\": contentId(service.scope),\n      onClick() { service.send({ type: \"TOGGLE\" }); } }),\n  };\n}\n"],"mappings":"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"}

package/dist/empty/empty-illustration.d.ts

@@ -0,0 +1,3 @@
+/** Original 015-empty decorative SVG asset; retained gradient colors are asset data, not component chrome. */
+import type { EmptyVectorNode } from "./empty.js";
+export declare const EMPTY_ILLUSTRATION_ASSET: EmptyVectorNode;

package/dist/empty/empty.d.ts

@@ -1,5 +1,5 @@
 /**
- * Empty 契约 — 原型 A（无状态），core 无 machine 也无共享枚举。
+ * Empty 契约 — 原型 A（无状态），Core 为三栈结构与原有插画的唯一来源。
  * 本目录是 Empty 的"源头锚点"：契约文档与 demo 清单在 ./docs/ 下维护,
  * 双栈实现（React props / Vue props+slots）必须与 docs 清单严格对齐。
  * 渲染契约：`data-scope="empty"`，data-part 为 root / icon / title / description / actions。
@@ -10,3 +10,45 @@
 export declare const EMPTY_PARTS: readonly ["root", "icon", "title", "description", "actions"];
 /** Empty 各渲染部位（data-part 取值）。 */
 export type EmptyPart = (typeof EMPTY_PARTS)[number];
+/** Scalar Empty inputs; framework-rich values use content presence. */
+export interface QwEmptyProps {
+    title?: string | null;
+    description?: string | null;
+    hideIcon?: boolean;
+}
+/** Content presence distinguishes omitted from explicitly empty SSR channels. */
+export interface EmptyContentPresence {
+    readonly icon?: boolean;
+    readonly title?: boolean;
+    readonly description?: boolean;
+    readonly default?: boolean;
+}
+/** Shared passive structure decisions; no generated role or live region. */
+export interface EmptyState {
+    readonly iconMode: "default" | "custom" | "hidden";
+    readonly hasTitle: boolean;
+    readonly hasDescription: boolean;
+    readonly hasActions: boolean;
+    readonly titleFromContent: boolean;
+    readonly descriptionFromContent: boolean;
+}
+/** Resolve structure once, with explicit channel presence overriding scalars. */
+export declare function resolveEmptyState(props?: QwEmptyProps, presence?: EmptyContentPresence): EmptyState;
+/** Plain passive Empty root. */
+export declare function getEmptyRootProps(): {
+    "data-scope": "empty";
+    "data-part": "actions" | "description" | "icon" | "root" | "title";
+};
+/** Shared stable selectors for Empty structure. */
+export declare function getEmptyPartProps(part: EmptyPart): {
+    "data-scope": "empty";
+    "data-part": "actions" | "description" | "icon" | "root" | "title";
+};
+/** Framework-independent retained original vector asset. */
+export interface EmptyVectorNode {
+    readonly tag: string;
+    readonly attrs: Readonly<Record<string, string>>;
+    readonly children: readonly EmptyVectorNode[];
+}
+/** Copy the original illustration with injectively scoped local SVG references. */
+export declare function getEmptyIllustration(identity: string): EmptyVectorNode;

package/dist/empty/index.js

@@ -1,21 +1,2 @@
-//#region src/empty/empty.ts
-/**
-* Empty 契约 — 原型 A（无状态），core 无 machine 也无共享枚举。
-* 本目录是 Empty 的"源头锚点"：契约文档与 demo 清单在 ./docs/ 下维护,
-* 双栈实现（React props / Vue props+slots）必须与 docs 清单严格对齐。
-* 渲染契约：`data-scope="empty"`，data-part 为 root / icon / title / description / actions。
-*
-* data-part 词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。
-*/
-/** Empty 各渲染部位全集（data-part 取值），双栈与 styles-core 共用。 */
-const EMPTY_PARTS = [
-	"root",
-	"icon",
-	"title",
-	"description",
-	"actions"
-];
-//#endregion
-export { EMPTY_PARTS };
-
-//# sourceMappingURL=index.js.map
+import { a as resolveEmptyState, i as getEmptyRootProps, n as getEmptyIllustration, r as getEmptyPartProps, t as EMPTY_PARTS } from "../empty-CAgyvhUI.js";
+export { EMPTY_PARTS, getEmptyIllustration, getEmptyPartProps, getEmptyRootProps, resolveEmptyState };

package/dist/empty-CAgyvhUI.js

@@ -0,0 +1,166 @@
+//#region src/empty/empty-illustration.ts
+const EMPTY_ILLUSTRATION_ASSET = {
+	"tag": "svg",
+	"attrs": {
+		"viewBox": "0 0 120 120",
+		"width": "120",
+		"height": "120",
+		"fill": "none",
+		"xmlns": "http://www.w3.org/2000/svg",
+		"aria-hidden": "true"
+	},
+	"children": [
+		{
+			"tag": "defs",
+			"attrs": {},
+			"children": [{
+				"tag": "linearGradient",
+				"attrs": {
+					"id": "doc",
+					"x1": "19",
+					"y1": "20",
+					"x2": "98.29",
+					"y2": "89.38",
+					"gradientUnits": "userSpaceOnUse"
+				},
+				"children": [{
+					"tag": "stop",
+					"attrs": {
+						"stop-color": "#222222",
+						"stop-opacity": "0.1"
+					},
+					"children": []
+				}, {
+					"tag": "stop",
+					"attrs": {
+						"offset": "1",
+						"stop-color": "#D8D8D8",
+						"stop-opacity": "0.02"
+					},
+					"children": []
+				}]
+			}, {
+				"tag": "linearGradient",
+				"attrs": {
+					"id": "wifi",
+					"x1": "66",
+					"y1": "75",
+					"x2": "101",
+					"y2": "99.58",
+					"gradientUnits": "userSpaceOnUse"
+				},
+				"children": [{
+					"tag": "stop",
+					"attrs": { "stop-color": "#CCCCCC" },
+					"children": []
+				}, {
+					"tag": "stop",
+					"attrs": {
+						"offset": "1",
+						"stop-color": "#EFEFEF"
+					},
+					"children": []
+				}]
+			}]
+		},
+		{
+			"tag": "path",
+			"attrs": {
+				"transform": "translate(19 20)",
+				"fill-rule": "evenodd",
+				"clip-rule": "evenodd",
+				"d": "M0 10C0 4.47715 4.47715 0 10 0H60C65.5229 0 70 4.47715 70 10V70C70 75.5229 65.5229 80 60 80H10C4.47715 80 0 75.5229 0 70V10ZM16 17.5C16 16.1193 17.1193 15 18.5 15H50.5C51.8807 15 53 16.1193 53 17.5C53 18.8807 51.8807 20 50.5 20H18.5C17.1193 20 16 18.8807 16 17.5ZM18.5 32C17.1193 32 16 33.1193 16 34.5C16 35.8807 17.1193 37 18.5 37H50.5C51.8807 37 53 35.8807 53 34.5C53 33.1193 51.8807 32 50.5 32H18.5Z",
+				"fill": "url(#doc)"
+			},
+			"children": []
+		},
+		{
+			"tag": "g",
+			"attrs": {
+				"transform": "translate(66 75)",
+				"fill": "url(#wifi)"
+			},
+			"children": [
+				{
+					"tag": "path",
+					"attrs": { "d": "M17.5156 0C11.2706 0 5.34603 2.33603 0.796994 6.57058L0 7.31249L0.774158 8.07793L3.29835 10.5779L4.02532 11.297L4.77588 10.6095C8.25388 7.41396 12.7717 5.64852 17.5004 5.64852C22.2291 5.64852 26.7545 7.41396 30.2249 10.6095L30.9754 11.297L31.7016 10.5779L34.2266 8.07793L35 7.31249L34.203 6.56984C29.67 2.33676 23.737 0 17.5156 0Z" },
+					"children": []
+				},
+				{
+					"tag": "path",
+					"attrs": { "d": "M28.5598 12.5317C25.5271 9.78909 21.6114 8.28174 17.5313 8.28174H16.8355L16.8279 8.29644C12.9822 8.45306 9.32459 9.94571 6.46393 12.5317L5.64258 13.2736L6.43196 14.0545L8.98813 16.5861L9.6991 17.2891L10.4497 16.6332C12.4273 14.8979 14.9363 13.9376 17.5077 13.9376C20.095 13.9376 22.604 14.8986 24.5809 16.6332L25.3315 17.2891L26.0424 16.5861L28.5986 14.0545L29.388 13.2736L28.5598 12.5317Z" },
+					"children": []
+				},
+				{
+					"tag": "path",
+					"attrs": { "d": "M16.7999 24.2862C17.201 24.682 17.8458 24.6818 18.2466 24.2857L22.4014 20.1797L23.2296 19.3598L22.323 18.6172C21.1195 17.7275 19.7904 17.0547 17.5159 17.0547C15.2497 17.0547 14.0067 17.79 12.7095 18.6172L11.8105 19.3598L12.6388 20.1797L16.7999 24.2862Z" },
+					"children": []
+				}
+			]
+		}
+	]
+};
+//#endregion
+//#region src/empty/empty.ts
+/**
+* Empty 契约 — 原型 A（无状态），Core 为三栈结构与原有插画的唯一来源。
+* 本目录是 Empty 的"源头锚点"：契约文档与 demo 清单在 ./docs/ 下维护,
+* 双栈实现（React props / Vue props+slots）必须与 docs 清单严格对齐。
+* 渲染契约：`data-scope="empty"`，data-part 为 root / icon / title / description / actions。
+*
+* data-part 词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。
+*/
+/** Empty 各渲染部位全集（data-part 取值），双栈与 styles-core 共用。 */
+const EMPTY_PARTS = [
+	"root",
+	"icon",
+	"title",
+	"description",
+	"actions"
+];
+/** Resolve structure once, with explicit channel presence overriding scalars. */
+function resolveEmptyState(props = {}, presence = {}) {
+	return {
+		iconMode: props.hideIcon === true ? "hidden" : presence.icon ? "custom" : "default",
+		hasTitle: presence.title === true || props.title != null,
+		hasDescription: presence.description === true || props.description != null,
+		hasActions: presence.default === true,
+		titleFromContent: presence.title === true,
+		descriptionFromContent: presence.description === true
+	};
+}
+/** Plain passive Empty root. */
+function getEmptyRootProps() {
+	return getEmptyPartProps("root");
+}
+/** Shared stable selectors for Empty structure. */
+function getEmptyPartProps(part) {
+	return {
+		"data-scope": "empty",
+		"data-part": part
+	};
+}
+/** Copy the original illustration with injectively scoped local SVG references. */
+function getEmptyIllustration(identity) {
+	if (!identity.length) throw new Error("Empty illustration requires a nonempty stable identity");
+	let encoded = "";
+	for (let index = 0; index < identity.length; index++) encoded += identity.charCodeAt(index).toString(16).padStart(4, "0");
+	const prefix = `qw-empty-${encoded}-`;
+	const copy = (source) => ({
+		tag: source.tag,
+		attrs: Object.fromEntries(Object.entries(source.attrs).map(([key, value]) => [key, key === "id" ? `${prefix}${value}` : value.replace(/url\(#(doc|wifi)\)/g, (_original, local) => `url(#${prefix}${local})`)])),
+		children: source.children.map(copy)
+	});
+	const vector = copy(EMPTY_ILLUSTRATION_ASSET);
+	return {
+		...vector,
+		attrs: {
+			...vector.attrs,
+			focusable: "false"
+		}
+	};
+}
+//#endregion
+export { resolveEmptyState as a, getEmptyRootProps as i, getEmptyIllustration as n, getEmptyPartProps as r, EMPTY_PARTS as t };
+
+//# sourceMappingURL=empty-CAgyvhUI.js.map

package/dist/empty-CAgyvhUI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-CAgyvhUI.js","names":[],"sources":["../src/empty/empty-illustration.ts","../src/empty/empty.ts"],"sourcesContent":["/** Original 015-empty decorative SVG asset; retained gradient colors are asset data, not component chrome. */\nimport type { EmptyVectorNode } from \"./empty.js\";\n\nexport const EMPTY_ILLUSTRATION_ASSET: EmptyVectorNode = {\n  \"tag\": \"svg\",\n  \"attrs\": {\n    \"viewBox\": \"0 0 120 120\",\n    \"width\": \"120\",\n    \"height\": \"120\",\n    \"fill\": \"none\",\n    \"xmlns\": \"http://www.w3.org/2000/svg\",\n    \"aria-hidden\": \"true\"\n  },\n  \"children\": [\n    {\n      \"tag\": \"defs\",\n      \"attrs\": {},\n      \"children\": [\n        {\n          \"tag\": \"linearGradient\",\n          \"attrs\": {\n            \"id\": \"doc\",\n            \"x1\": \"19\",\n            \"y1\": \"20\",\n            \"x2\": \"98.29\",\n            \"y2\": \"89.38\",\n            \"gradientUnits\": \"userSpaceOnUse\"\n          },\n          \"children\": [\n            {\n              \"tag\": \"stop\",\n              \"attrs\": {\n                \"stop-color\": \"#222222\",\n                \"stop-opacity\": \"0.1\"\n              },\n              \"children\": []\n            },\n            {\n              \"tag\": \"stop\",\n              \"attrs\": {\n                \"offset\": \"1\",\n                \"stop-color\": \"#D8D8D8\",\n                \"stop-opacity\": \"0.02\"\n              },\n              \"children\": []\n            }\n          ]\n        },\n        {\n          \"tag\": \"linearGradient\",\n          \"attrs\": {\n            \"id\": \"wifi\",\n            \"x1\": \"66\",\n            \"y1\": \"75\",\n            \"x2\": \"101\",\n            \"y2\": \"99.58\",\n            \"gradientUnits\": \"userSpaceOnUse\"\n          },\n          \"children\": [\n            {\n              \"tag\": \"stop\",\n              \"attrs\": {\n                \"stop-color\": \"#CCCCCC\"\n              },\n              \"children\": []\n            },\n            {\n              \"tag\": \"stop\",\n              \"attrs\": {\n                \"offset\": \"1\",\n                \"stop-color\": \"#EFEFEF\"\n              },\n              \"children\": []\n            }\n          ]\n        }\n      ]\n    },\n    {\n      \"tag\": \"path\",\n      \"attrs\": {\n        \"transform\": \"translate(19 20)\",\n        \"fill-rule\": \"evenodd\",\n        \"clip-rule\": \"evenodd\",\n        \"d\": \"M0 10C0 4.47715 4.47715 0 10 0H60C65.5229 0 70 4.47715 70 10V70C70 75.5229 65.5229 80 60 80H10C4.47715 80 0 75.5229 0 70V10ZM16 17.5C16 16.1193 17.1193 15 18.5 15H50.5C51.8807 15 53 16.1193 53 17.5C53 18.8807 51.8807 20 50.5 20H18.5C17.1193 20 16 18.8807 16 17.5ZM18.5 32C17.1193 32 16 33.1193 16 34.5C16 35.8807 17.1193 37 18.5 37H50.5C51.8807 37 53 35.8807 53 34.5C53 33.1193 51.8807 32 50.5 32H18.5Z\",\n        \"fill\": \"url(#doc)\"\n      },\n      \"children\": []\n    },\n    {\n      \"tag\": \"g\",\n      \"attrs\": {\n        \"transform\": \"translate(66 75)\",\n        \"fill\": \"url(#wifi)\"\n      },\n      \"children\": [\n        {\n          \"tag\": \"path\",\n          \"attrs\": {\n            \"d\": \"M17.5156 0C11.2706 0 5.34603 2.33603 0.796994 6.57058L0 7.31249L0.774158 8.07793L3.29835 10.5779L4.02532 11.297L4.77588 10.6095C8.25388 7.41396 12.7717 5.64852 17.5004 5.64852C22.2291 5.64852 26.7545 7.41396 30.2249 10.6095L30.9754 11.297L31.7016 10.5779L34.2266 8.07793L35 7.31249L34.203 6.56984C29.67 2.33676 23.737 0 17.5156 0Z\"\n          },\n          \"children\": []\n        },\n        {\n          \"tag\": \"path\",\n          \"attrs\": {\n            \"d\": \"M28.5598 12.5317C25.5271 9.78909 21.6114 8.28174 17.5313 8.28174H16.8355L16.8279 8.29644C12.9822 8.45306 9.32459 9.94571 6.46393 12.5317L5.64258 13.2736L6.43196 14.0545L8.98813 16.5861L9.6991 17.2891L10.4497 16.6332C12.4273 14.8979 14.9363 13.9376 17.5077 13.9376C20.095 13.9376 22.604 14.8986 24.5809 16.6332L25.3315 17.2891L26.0424 16.5861L28.5986 14.0545L29.388 13.2736L28.5598 12.5317Z\"\n          },\n          \"children\": []\n        },\n        {\n          \"tag\": \"path\",\n          \"attrs\": {\n            \"d\": \"M16.7999 24.2862C17.201 24.682 17.8458 24.6818 18.2466 24.2857L22.4014 20.1797L23.2296 19.3598L22.323 18.6172C21.1195 17.7275 19.7904 17.0547 17.5159 17.0547C15.2497 17.0547 14.0067 17.79 12.7095 18.6172L11.8105 19.3598L12.6388 20.1797L16.7999 24.2862Z\"\n          },\n          \"children\": []\n        }\n      ]\n    }\n  ]\n};\n","import { EMPTY_ILLUSTRATION_ASSET } from \"./empty-illustration.js\";\n\n/**\n * Empty 契约 — 原型 A（无状态），Core 为三栈结构与原有插画的唯一来源。\n * 本目录是 Empty 的\"源头锚点\"：契约文档与 demo 清单在 ./docs/ 下维护,\n * 双栈实现（React props / Vue props+slots）必须与 docs 清单严格对齐。\n * 渲染契约：`data-scope=\"empty\"`，data-part 为 root / icon / title / description / actions。\n *\n * data-part 词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。\n */\n\n/** Empty 各渲染部位全集（data-part 取值），双栈与 styles-core 共用。 */\nexport const EMPTY_PARTS = [\"root\", \"icon\", \"title\", \"description\", \"actions\"] as const;\n\n/** Empty 各渲染部位（data-part 取值）。 */\nexport type EmptyPart = (typeof EMPTY_PARTS)[number];\n\n/** Scalar Empty inputs; framework-rich values use content presence. */\nexport interface QwEmptyProps {\n  title?: string | null;\n  description?: string | null;\n  hideIcon?: boolean;\n}\n\n/** Content presence distinguishes omitted from explicitly empty SSR channels. */\nexport interface EmptyContentPresence {\n  readonly icon?: boolean;\n  readonly title?: boolean;\n  readonly description?: boolean;\n  readonly default?: boolean;\n}\n\n/** Shared passive structure decisions; no generated role or live region. */\nexport interface EmptyState {\n  readonly iconMode: \"default\" | \"custom\" | \"hidden\";\n  readonly hasTitle: boolean;\n  readonly hasDescription: boolean;\n  readonly hasActions: boolean;\n  readonly titleFromContent: boolean;\n  readonly descriptionFromContent: boolean;\n}\n\n/** Resolve structure once, with explicit channel presence overriding scalars. */\nexport function resolveEmptyState(props: QwEmptyProps = {}, presence: EmptyContentPresence = {}): EmptyState {\n  return {\n    iconMode: props.hideIcon === true ? \"hidden\" : presence.icon ? \"custom\" : \"default\",\n    hasTitle: presence.title === true || props.title != null,\n    hasDescription: presence.description === true || props.description != null,\n    hasActions: presence.default === true,\n    titleFromContent: presence.title === true,\n    descriptionFromContent: presence.description === true,\n  };\n}\n\n/** Plain passive Empty root. */\nexport function getEmptyRootProps() {\n  return getEmptyPartProps(\"root\");\n}\n\n/** Shared stable selectors for Empty structure. */\nexport function getEmptyPartProps(part: EmptyPart) {\n  return { \"data-scope\": \"empty\" as const, \"data-part\": part };\n}\n\n/** Framework-independent retained original vector asset. */\nexport interface EmptyVectorNode {\n  readonly tag: string;\n  readonly attrs: Readonly<Record<string, string>>;\n  readonly children: readonly EmptyVectorNode[];\n}\n\n/** Copy the original illustration with injectively scoped local SVG references. */\nexport function getEmptyIllustration(identity: string): EmptyVectorNode {\n  if (!identity.length) throw new Error(\"Empty illustration requires a nonempty stable identity\");\n  let encoded = \"\";\n  for (let index = 0; index < identity.length; index++) encoded += identity.charCodeAt(index).toString(16).padStart(4, \"0\");\n  const prefix = `qw-empty-${encoded}-`;\n  const copy = (source: EmptyVectorNode): EmptyVectorNode => ({\n    tag: source.tag,\n    attrs: Object.fromEntries(Object.entries(source.attrs).map(([key, value]) => [key, key === \"id\" ? `${prefix}${value}` : value.replace(/url\\(#(doc|wifi)\\)/g, (_original, local: string) => `url(#${prefix}${local})`)])),\n    children: source.children.map(copy),\n  });\n  const vector = copy(EMPTY_ILLUSTRATION_ASSET);\n  return { ...vector, attrs: { ...vector.attrs, focusable: \"false\" } };\n}\n"],"mappings":";AAGA,MAAa,2BAA4C;CACvD,OAAO;CACP,SAAS;EACP,WAAW;EACX,SAAS;EACT,UAAU;EACV,QAAQ;EACR,SAAS;EACT,eAAe;CACjB;CACA,YAAY;EACV;GACE,OAAO;GACP,SAAS,CAAC;GACV,YAAY,CACV;IACE,OAAO;IACP,SAAS;KACP,MAAM;KACN,MAAM;KACN,MAAM;KACN,MAAM;KACN,MAAM;KACN,iBAAiB;IACnB;IACA,YAAY,CACV;KACE,OAAO;KACP,SAAS;MACP,cAAc;MACd,gBAAgB;KAClB;KACA,YAAY,CAAC;IACf,GACA;KACE,OAAO;KACP,SAAS;MACP,UAAU;MACV,cAAc;MACd,gBAAgB;KAClB;KACA,YAAY,CAAC;IACf,CACF;GACF,GACA;IACE,OAAO;IACP,SAAS;KACP,MAAM;KACN,MAAM;KACN,MAAM;KACN,MAAM;KACN,MAAM;KACN,iBAAiB;IACnB;IACA,YAAY,CACV;KACE,OAAO;KACP,SAAS,EACP,cAAc,UAChB;KACA,YAAY,CAAC;IACf,GACA;KACE,OAAO;KACP,SAAS;MACP,UAAU;MACV,cAAc;KAChB;KACA,YAAY,CAAC;IACf,CACF;GACF,CACF;EACF;EACA;GACE,OAAO;GACP,SAAS;IACP,aAAa;IACb,aAAa;IACb,aAAa;IACb,KAAK;IACL,QAAQ;GACV;GACA,YAAY,CAAC;EACf;EACA;GACE,OAAO;GACP,SAAS;IACP,aAAa;IACb,QAAQ;GACV;GACA,YAAY;IACV;KACE,OAAO;KACP,SAAS,EACP,KAAK,6UACP;KACA,YAAY,CAAC;IACf;IACA;KACE,OAAO;KACP,SAAS,EACP,KAAK,wYACP;KACA,YAAY,CAAC;IACf;IACA;KACE,OAAO;KACP,SAAS,EACP,KAAK,+PACP;KACA,YAAY,CAAC;IACf;GACF;EACF;CACF;AACF;;;;;;;;;;;;AC5GA,MAAa,cAAc;CAAC;CAAQ;CAAQ;CAAS;CAAe;AAAS;;AA+B7E,SAAgB,kBAAkB,QAAsB,CAAC,GAAG,WAAiC,CAAC,GAAe;CAC3G,OAAO;EACL,UAAU,MAAM,aAAa,OAAO,WAAW,SAAS,OAAO,WAAW;EAC1E,UAAU,SAAS,UAAU,QAAQ,MAAM,SAAS;EACpD,gBAAgB,SAAS,gBAAgB,QAAQ,MAAM,eAAe;EACtE,YAAY,SAAS,YAAY;EACjC,kBAAkB,SAAS,UAAU;EACrC,wBAAwB,SAAS,gBAAgB;CACnD;AACF;;AAGA,SAAgB,oBAAoB;CAClC,OAAO,kBAAkB,MAAM;AACjC;;AAGA,SAAgB,kBAAkB,MAAiB;CACjD,OAAO;EAAE,cAAc;EAAkB,aAAa;CAAK;AAC7D;;AAUA,SAAgB,qBAAqB,UAAmC;CACtE,IAAI,CAAC,SAAS,QAAQ,MAAM,IAAI,MAAM,wDAAwD;CAC9F,IAAI,UAAU;CACd,KAAK,IAAI,QAAQ,GAAG,QAAQ,SAAS,QAAQ,SAAS,WAAW,SAAS,WAAW,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG;CACxH,MAAM,SAAS,YAAY,QAAQ;CACnC,MAAM,QAAQ,YAA8C;EAC1D,KAAK,OAAO;EACZ,OAAO,OAAO,YAAY,OAAO,QAAQ,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,QAAQ,OAAO,GAAG,SAAS,UAAU,MAAM,QAAQ,wBAAwB,WAAW,UAAkB,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;EACvN,UAAU,OAAO,SAAS,IAAI,IAAI;CACpC;CACA,MAAM,SAAS,KAAK,wBAAwB;CAC5C,OAAO;EAAE,GAAG;EAAQ,OAAO;GAAE,GAAG,OAAO;GAAO,WAAW;EAAQ;CAAE;AACrE"}