@astryx-vue/core 0.3.0 → 0.4.0

package/dist/isApplePlatform-B1ju6F5B.js

@@ -0,0 +1,27 @@
+//#region src/utils/isApplePlatform.ts
+/**
+* 只读 User-Agent Client Hints。
+*
+* 空字符串（改写过客户端标识的浏览器会给这个）和规范自己的哨兵值 `Unknown`
+* 都算「没回答」，不能当成「不是苹果」。
+*/
+function readClientHintsPlatform(userAgentData) {
+	const raw = userAgentData?.platform;
+	const named = typeof raw === "string" ? raw.trim() : "";
+	if (named === "" || named.toLowerCase() === "unknown") return "unknown";
+	return /mac/i.test(named) ? "apple" : "other";
+}
+/**
+* 当前是不是 Apple 平台。
+*
+* 先看 Client Hints；它说不出来时，退回 `navigator.platform`（已废弃但到处都有）。
+* 服务端没有 navigator，答 false。
+*/
+function isApplePlatform() {
+	if (typeof navigator === "undefined") return false;
+	const hinted = readClientHintsPlatform(navigator.userAgentData);
+	if (hinted !== "unknown") return hinted === "apple";
+	return /Mac|iPhone|iPad|iPod/.test(navigator.platform ?? "");
+}
+//#endregion
+export { isApplePlatform as t };

package/dist/isRenderable-BnKHIqfd.js

@@ -0,0 +1,21 @@
+import { Comment, Fragment, Text } from "vue";
+//#region src/Indicator/isRenderable.ts
+/**
+* Whether a slot or vnode should replace an indicator's own mark.
+*
+* Null, undefined, booleans, and the empty string do not count. An element
+* does, even when that element later renders nothing. A host writes
+* `v-if="busy"` around a spinner, and `false` must not delete the mark.
+*/
+function isRenderable(value) {
+	if (value == null || typeof value === "boolean" || value === "") return false;
+	if (Array.isArray(value)) return value.some((item) => isRenderable(item));
+	if (typeof value !== "object") return true;
+	const node = value;
+	if (node.type === Comment) return false;
+	if (node.type === Text) return String(node.children ?? "").trim() !== "";
+	if (node.type === Fragment) return isRenderable(node.children);
+	return true;
+}
+//#endregion
+export { isRenderable as t };

package/dist/layerDepth-CNDh-IHb.js

@@ -0,0 +1,181 @@
+import { inject, provide } from "vue";
+//#region src/utils/ime.ts
+/**
+* 输入法（IME）正在拼字时的按键判断，全库只用这一个。
+*
+* 中文、日文、韩文用户拼字时，按 Enter 是把候选词上屏，按 Escape 是取消拼字，
+* 方向键是在候选框里挑词。浏览器会先发这个 keydown，随后才发 `compositionend`，
+* 不判断的话，菜单、对话框、快捷键会把它当成命令：提交、关闭、跳转。
+*
+* 三个信号任一成立就算拼字中：
+* - `isComposing === true`：标准信号，现在的浏览器都可靠；
+* - `keyCode === 229`：浏览器表示「这个键交给输入法处理了」的老信号，部分输入法和老版 Safari
+*   发拼字的 keydown 时还没把 `isComposing` 设上，只有这个；
+* - `key === 'Process'`：同一件事在 `key` 上的写法。
+*/
+const IME_PROCESSING_KEY_CODE = 229;
+/** 这个按键属于输入法正在进行的拼字，不能当命令处理。 */
+function isImeKeyEvent(event) {
+	return event.isComposing === true || event.keyCode === IME_PROCESSING_KEY_CODE || event.key === "Process";
+}
+//#endregion
+//#region src/layer/dismissStack.ts
+const entries = [];
+let seqByToken = /* @__PURE__ */ new WeakMap();
+let nextSeq = 0;
+let isListening = false;
+/**
+* 按压编号。每收到一次 pointerdown 加一。
+* 在一次按压里才登记进来的层（触发器按下就打开的那种）不能被这次按压自己关掉，
+* 记下编号就能认出来。
+*/
+let pressSerial = 0;
+function seqFor(token) {
+	const existing = seqByToken.get(token);
+	if (existing !== void 0) return existing;
+	const seq = nextSeq++;
+	seqByToken.set(token, seq);
+	return seq;
+}
+function isPresent(entry) {
+	return entry.isPresent?.() ?? true;
+}
+/**
+* 比较两层谁在上面：正数表示 `a` 在上面，负数表示在下面。
+*
+* 先比嵌套深度，再比 DOM 包含，最后比排位号。这是一个偏序，只能两两比较求最大值，
+* 不能排序：容器包含关系只在有包含关系的那一对之间有定义。
+*/
+function compareEntries(a, b) {
+	if (a.depth !== b.depth) return a.depth - b.depth;
+	const aEl = a.getContainer?.() ?? null;
+	const bEl = b.getContainer?.() ?? null;
+	if (aEl != null && bEl != null && aEl !== bEl) {
+		if (bEl.contains(aEl)) return 1;
+		if (aEl.contains(bEl)) return -1;
+	}
+	return a.seq - b.seq;
+}
+/** 屏幕上现存的层，最上面那层在前。 */
+function presentEntriesTopFirst() {
+	const present = entries.filter(isPresent);
+	const ordered = [];
+	for (const entry of present) {
+		let insertAt = ordered.length;
+		for (let i = 0; i < ordered.length; i++) if (compareEntries(entry, ordered[i]) > 0) {
+			insertAt = i;
+			break;
+		}
+		ordered.splice(insertAt, 0, entry);
+	}
+	return ordered;
+}
+function topPresentEntry() {
+	return presentEntriesTopFirst()[0] ?? null;
+}
+/** `token` 是不是此刻最上面那一层。 */
+function isTopLayer(token) {
+	return topPresentEntry()?.token === token;
+}
+/**
+* 关掉一次按压该关掉的层。
+*
+* 从最上面往下找，点在某一层里面就只关它上面的层；点在所有层外面就只关最上面那一层。
+* 点在栈顶自己的触发器上时什么都不关，那一下是触发器的开关动作。
+*/
+function handlePointerDown(event) {
+	pressSerial += 1;
+	const serial = pressSerial;
+	const target = event.target;
+	if (!(target instanceof Node)) return;
+	const ordered = presentEntriesTopFirst().filter((entry) => entry.bornPress !== serial);
+	const top = ordered[0];
+	if (top == null) return;
+	const topTrigger = top.getTrigger?.() ?? null;
+	if (topTrigger != null && topTrigger.contains(target)) return;
+	for (let i = 0; i < ordered.length; i++) {
+		const container = ordered[i].getContainer?.() ?? null;
+		if (container == null || !container.contains(target)) continue;
+		for (let j = 0; j < i; j++) {
+			const above = ordered[j];
+			if (above.dismissOnPointerOutside) above.onDismiss();
+		}
+		return;
+	}
+	if (top.dismissOnPointerOutside) top.onDismiss();
+}
+/**
+* 把一次 Escape 按键交给栈。
+*
+* 输入法拼字中的 Escape 是取消拼字，不是关层：什么都不关，但仍然吃掉这次按键。
+* 不吃掉的话浏览器会自己发起一次关闭请求，同一按键照样把层关掉。
+*/
+function handleKeyDown(event) {
+	if (event.key !== "Escape") return;
+	const top = topPresentEntry();
+	if (top == null) return;
+	if (isImeKeyEvent(event)) {
+		event.preventDefault();
+		return;
+	}
+	if (event.defaultPrevented) return;
+	if (top.dismissOnEscape === "ignore") return;
+	event.preventDefault();
+	if (top.dismissOnEscape === "block") return;
+	if (top.onEscape != null) top.onEscape();
+	else top.onDismiss();
+}
+function startListening() {
+	if (isListening || typeof document === "undefined") return;
+	isListening = true;
+	document.addEventListener("pointerdown", handlePointerDown, true);
+	document.addEventListener("keydown", handleKeyDown);
+}
+function stopListening() {
+	if (!isListening || typeof document === "undefined") return;
+	isListening = false;
+	document.removeEventListener("pointerdown", handlePointerDown, true);
+	document.removeEventListener("keydown", handleKeyDown);
+}
+/**
+* 把一层登记进栈，返回「把这一层摘下来」的函数。
+* 调用方负责在关闭或卸载时调用它。
+*/
+function pushLayer(entry) {
+	const full = {
+		...entry,
+		depth: entry.depth ?? 0,
+		seq: seqFor(entry.token),
+		bornPress: pressSerial
+	};
+	entries.push(full);
+	startListening();
+	return () => {
+		const index = entries.indexOf(full);
+		if (index !== -1) entries.splice(index, 1);
+		if (entries.length === 0) stopListening();
+	};
+}
+//#endregion
+//#region src/layer/layerDepth.ts
+/**
+* 浮层嵌套深度。
+*
+* 关层时要比谁在上面。气泡经常被 Teleport 到 body，DOM 上的包含关系就断了。
+* provide/inject 跟着组件树走，Teleport 切不断，所以深度从这里往下传。
+* 根上是 0。每一层浮层只给自己的内容加 1，里面再开的层读到的就是更深的数字。
+*/
+const layerDepthKey = Symbol("astryx-layer-depth");
+/** 读当前子树的嵌套深度。没有外层浮层时是 0。必须在 setup 里调用。 */
+function useLayerDepth() {
+	return inject(layerDepthKey, 0);
+}
+/**
+* 给这一层的内容再加深一层。
+* 在内容边界的 setup 里调用，不要包住触发器：触发器还在外面那一层。
+*/
+function provideLayerDepth() {
+	provide(layerDepthKey, useLayerDepth() + 1);
+}
+//#endregion
+export { isImeKeyEvent as a, pushLayer as i, useLayerDepth as n, isTopLayer as r, provideLayerDepth as t };

package/dist/link-DuuA2eCL.js

@@ -0,0 +1,30 @@
+import { n as isSafeUrl } from "./safeUrl-CsvfcZ9m.js";
+import { toRaw } from "vue";
+//#region src/NavItem/link.ts
+/**
+* 有可用地址、而且协议允许当页面打开时，才是链接。
+* 禁用，或 `javascript:`、`vbscript:`、`data:text/html`，都不是。
+*/
+function isNavigableHref(href, isDisabled = false) {
+	return href != null && href !== "" && !isDisabled && isSafeUrl(href);
+}
+/** 能导航时原样返回地址，否则不把这个字符串写进 `href`。 */
+function safeNavHref(href) {
+	return isNavigableHref(href) ? href : void 0;
+}
+/**
+* 有可用地址时用链接组件，否则用按钮。禁用的地址也不走链接。
+* `fallback` 是外层的默认链接组件，例如 `LinkProvider` 给的那个；`as` 写了就以 `as` 为准。
+*/
+function resolveNavRoot(href, isDisabled, as, fallback) {
+	if (isNavigableHref(href, isDisabled)) {
+		const root = as ?? fallback;
+		return root == null ? "a" : toRaw(root);
+	}
+	return "button";
+}
+function isExternalNavTarget(target) {
+	return target === "_blank";
+}
+//#endregion
+export { safeNavHref as i, isNavigableHref as n, resolveNavRoot as r, isExternalNavTarget as t };