dou-ui 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/types/utils/safe-url.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns `url` when it is safe to use as a link (`href`), otherwise `undefined`.
+ * http(s), mailto, tel, relative addresses and anchors pass; anything else,
+ * such as `javascript:` or `data:`, is dropped. Only for links: it also drops
+ * `data:` and `blob:`, which are fine in an image `src`.
+ */
+export declare function safeUrl(url: string | undefined): string | undefined;
+/** Whether a link should open in a new tab: not for `mailto:` and `tel:`, which hand off to an app. */
+export declare function opensNewTab(url: string): boolean;
+/**
+ * {@link safeUrl}, warning once while developing when an address is dropped.
+ * `component` names the component in the warning, e.g. `DouChatSources`.
+ */
+export declare function checkedUrl(component: string, url: string | undefined): string | undefined;

package/dist/types/utils/status-check.d.ts

@@ -0,0 +1,8 @@
+/** Warn once per page with this message. Call only while developing. */
+export declare function devWarn(message: string): void;
+/**
+ * While developing, warn once about a `status` the component doesn't know,
+ * e.g. an old name in JSON from a server, where types can't catch it.
+ * `renamed` maps old names to the new ones to suggest.
+ */
+export declare function useStatusCheck(component: string, statuses: () => readonly (string | undefined)[], known: readonly string[], renamed?: Record<string, string>): void;

package/dist/utils/app-context.js

@@ -0,0 +1,22 @@
+// src/utils/app-context.ts
+var installed = null;
+/**
+* Remembers the app whose locale and config what is rendered outside any
+* component should take. `app.use(DouUI)`, installing `DouDialog` or
+* `DouToastViewport`, and `provideGlobalConfig(config, app)` call it; the
+* last one wins. Call it yourself to pick one of several apps.
+*/
+function setInstalledAppContext(appContext) {
+	installed = appContext;
+}
+/**
+* The context of the app DouUI was set up in (see `setInstalledAppContext`),
+* for things rendered outside any component, e.g. by `dialog()`, `toast()`
+* or `renderFlowSVG`, to take its locale and config; `null` before.
+*/
+function installedAppContext() {
+	return installed;
+}
+export { installedAppContext, setInstalledAppContext };
+
+//# sourceMappingURL=app-context.js.map

package/dist/utils/app-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-context.js","names":[],"sources":["../../src/utils/app-context.ts"],"sourcesContent":["import type { AppContext } from 'vue'\n\nlet installed: AppContext | null = null\n\n/**\n * Remembers the app whose locale and config what is rendered outside any\n * component should take. `app.use(DouUI)`, installing `DouDialog` or\n * `DouToastViewport`, and `provideGlobalConfig(config, app)` call it; the\n * last one wins. Call it yourself to pick one of several apps.\n */\nexport function setInstalledAppContext(appContext: AppContext | null) {\n  installed = appContext\n}\n\n/**\n * The context of the app DouUI was set up in (see `setInstalledAppContext`),\n * for things rendered outside any component, e.g. by `dialog()`, `toast()`\n * or `renderFlowSVG`, to take its locale and config; `null` before.\n */\nexport function installedAppContext() {\n  return installed\n}\n"],"mappings":";AAEA,IAAI,YAA+B;;;;;;;AAQnC,SAAgB,uBAAuB,YAA+B;CACpE,YAAY;AACd;;;;;;AAOA,SAAgB,sBAAsB;CACpC,OAAO;AACT"}

package/dist/utils/install.js

@@ -17,6 +17,11 @@ function withInstall(component) {
 * given. Each prop's default becomes a factory that looks up the
 * configured value first; Vue runs default factories inside the
 * component, so `inject` sees the nearest provider.
+*
+* 这一步发生在包装组件的模块里，按需引入时打包器只留下用到的模块。所以组件内部渲染
+* 别的组件时，要引入包装过的那个（`import { DouSpinner } from '../spinner'`），
+* 不要直接引入 `.vue`，否则单独用外层组件时里面那个读不到默认值。
+* `utils/__tests__/nested-defaults.test.ts` 检查整个仓库都这样做。
 */
 function readConfiguredDefaults(component) {
 	const { name, props } = component;

package/dist/utils/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","names":[],"sources":["../../src/utils/install.ts"],"sourcesContent":["import { hasInjectionContext, inject } from 'vue'\nimport type { App, ButtonHTMLAttributes, Component, HTMLAttributes, Plugin } from 'vue'\nimport { configProviderKey } from '../components/config-provider/config-provider'\n\ntype InstanceProps<I> = I extends { $props: infer P } ? P : {}\n\n/** 类型标记：记下组件原本的类型，`ComponentDefaults` 从这里取 props。只存在于类型里。 */\nexport declare const ownComponent: unique symbol\n\n/**\n * 组件在模板里可以写的属性：自己的 props 之外，再加上它转交给元素的原生属性和事件 `A`。\n * 与 props、事件同名的项以组件自己的为准。\n *\n * 只影响类型（例如开启 checkUnknownProps 时 `<DouInput placeholder=\"…\">` 不报错）。\n * 给模板看的构造签名放在前面，所以 `InstanceType` 的 `$props` 也带着这些属性；\n * 要只看组件自己的 props，用各组件导出的 `XxxInstance`，`ComponentDefaults` 则经由 `ownComponent` 取原本的类型。\n */\nexport type WithAttributes<T, A> = T extends abstract new (...args: any) => infer I\n  ? { new (...args: any[]): I & { $props: Omit<A, keyof InstanceProps<I>> } } & T & {\n        readonly [ownComponent]?: T\n      }\n  : T\n\n/**\n * 渲染成按钮的组件转交的属性。不含 `type`：组件自己定好了按钮的类型（DouButton 用 `nativeType`），\n * 原生 `type` 会覆盖它，写成 `submit` 还会提交表单。\n */\nexport type ButtonAttributes = Omit<ButtonHTMLAttributes, 'type'>\n\n/**\n * 泛型组件的类型不能在导出时改写，改在 `defineProps` 里用交叉类型并上它，\n * 并在它前面加 `@vue-ignore` 注释让编译器跳过：这些属性在运行时仍是透传属性。\n * `Own` 是组件自己的 props，`Events` 是它自己的事件名，与它们同名的原生属性和事件以组件的为准。\n */\nexport type ForwardedAttributes<A, Own, Events extends string = never> = Omit<\n  A,\n  keyof Own | `on${Capitalize<Events>}`\n>\n\n/**\n * `A` 是组件转交的原生属性，默认是通用的 HTML 属性；\n * 把属性交给 `<input>` 的组件写 `InputHTMLAttributes`，不渲染元素的组件写 `{}`。\n */\nexport type WithInstall<T, A = HTMLAttributes> = WithAttributes<T, A> & Plugin\n\n/** Attach an `install` method so a component can be used with `app.use()`. */\nexport function withInstall<T extends Component, A = HTMLAttributes>(\n  component: T,\n): WithInstall<T, A> {\n  const target = component as unknown as WithInstall<T, A>\n  target.install = (app: App) => {\n    const { name } = component as { name?: string }\n    if (!name) throw new Error('[dou-ui] component registered with app.use() must have a name')\n    app.component(name, component)\n  }\n  readConfiguredDefaults(component)\n  return target\n}\n\ntype PropOption = {\n  type?: unknown\n  default?: unknown\n  skipFactory?: boolean\n}\n\n/**\n * Let `ConfigProvider`'s `defaults` fill in props the component wasn't\n * given. Each prop's default becomes a factory that looks up the\n * configured value first; Vue runs default factories inside the\n * component, so `inject` sees the nearest provider.\n */\nfunction readConfiguredDefaults(component: Component) {\n  const { name, props } = component as { name?: string; props?: Record<string, PropOption | null> }\n  if (!name || !props || Array.isArray(props)) return\n  for (const [key, option] of Object.entries(props)) {\n    const own: PropOption = option && typeof option === 'object' ? option : {}\n    // a function-typed prop takes its default as the value itself, never as a factory\n    if (own.type === Function || own.skipFactory) continue\n    const hasDefault = 'default' in own\n    const fallback = own.default\n    const types = Array.isArray(own.type) ? own.type : [own.type]\n    props[key] = {\n      ...own,\n      default(raw: Record<string, unknown>) {\n        const config = hasInjectionContext() ? inject(configProviderKey, undefined) : undefined\n        const configured = (config?.value.defaults as Record<string, Record<string, unknown>>)?.[\n          name\n        ]?.[key]\n        if (configured !== undefined) return configured\n        if (!hasDefault) return types.includes(Boolean) ? false : undefined\n        return typeof fallback === 'function' ? fallback(raw) : fallback\n      },\n    }\n  }\n}\n"],"mappings":";;;;AA8CA,SAAgB,YACd,WACmB;CACnB,MAAM,SAAS;CACf,OAAO,WAAW,QAAa;EAC7B,MAAM,EAAE,SAAS;EACjB,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,+DAA+D;EAC1F,IAAI,UAAU,MAAM,SAAS;CAC/B;CACA,uBAAuB,SAAS;CAChC,OAAO;AACT;;;;;;;AAcA,SAAS,uBAAuB,WAAsB;CACpD,MAAM,EAAE,MAAM,UAAU;CACxB,IAAI,CAAC,QAAQ,CAAC,SAAS,MAAM,QAAQ,KAAK,GAAG;CAC7C,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,KAAK,GAAG;EACjD,MAAM,MAAkB,UAAU,OAAO,WAAW,WAAW,SAAS,CAAC;EAEzE,IAAI,IAAI,SAAS,YAAY,IAAI,aAAa;EAC9C,MAAM,aAAa,aAAa;EAChC,MAAM,WAAW,IAAI;EACrB,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI;EAC5D,MAAM,OAAO;GACX,GAAG;GACH,QAAQ,KAA8B;IAEpC,MAAM,eADS,oBAAoB,IAAI,OAAO,mBAAmB,KAAA,CAAS,IAAI,KAAA,EAAA,EAClD,MAAM,SAAA,GAChC,KACD,GAAG;IACJ,IAAI,eAAe,KAAA,GAAW,OAAO;IACrC,IAAI,CAAC,YAAY,OAAO,MAAM,SAAS,OAAO,IAAI,QAAQ,KAAA;IAC1D,OAAO,OAAO,aAAa,aAAa,SAAS,GAAG,IAAI;GAC1D;EACF;CACF;AACF"}
+{"version":3,"file":"install.js","names":[],"sources":["../../src/utils/install.ts"],"sourcesContent":["import { hasInjectionContext, inject } from 'vue'\nimport type { App, ButtonHTMLAttributes, Component, HTMLAttributes, Plugin } from 'vue'\nimport { configProviderKey } from '../components/config-provider/config-provider'\n\ntype InstanceProps<I> = I extends { $props: infer P } ? P : {}\n\n/** 类型标记：记下组件原本的类型，`ComponentDefaults` 从这里取 props。只存在于类型里。 */\nexport declare const ownComponent: unique symbol\n\n/**\n * 组件在模板里可以写的属性：自己的 props 之外，再加上它转交给元素的原生属性和事件 `A`。\n * 与 props、事件同名的项以组件自己的为准。\n *\n * 只影响类型（例如开启 checkUnknownProps 时 `<DouInput placeholder=\"…\">` 不报错）。\n * 给模板看的构造签名放在前面，所以 `InstanceType` 的 `$props` 也带着这些属性；\n * 要只看组件自己的 props，用各组件导出的 `XxxInstance`，`ComponentDefaults` 则经由 `ownComponent` 取原本的类型。\n */\nexport type WithAttributes<T, A> = T extends abstract new (...args: any) => infer I\n  ? { new (...args: any[]): I & { $props: Omit<A, keyof InstanceProps<I>> } } & T & {\n        readonly [ownComponent]?: T\n      }\n  : T\n\n/**\n * 渲染成按钮的组件转交的属性。不含 `type`：组件自己定好了按钮的类型（DouButton 用 `nativeType`），\n * 原生 `type` 会覆盖它，写成 `submit` 还会提交表单。\n */\nexport type ButtonAttributes = Omit<ButtonHTMLAttributes, 'type'>\n\n/**\n * 泛型组件的类型不能在导出时改写，改在 `defineProps` 里用交叉类型并上它，\n * 并在它前面加 `@vue-ignore` 注释让编译器跳过：这些属性在运行时仍是透传属性。\n * `Own` 是组件自己的 props，`Events` 是它自己的事件名，与它们同名的原生属性和事件以组件的为准。\n */\nexport type ForwardedAttributes<A, Own, Events extends string = never> = Omit<\n  A,\n  keyof Own | `on${Capitalize<Events>}`\n>\n\n/**\n * `A` 是组件转交的原生属性，默认是通用的 HTML 属性；\n * 把属性交给 `<input>` 的组件写 `InputHTMLAttributes`，不渲染元素的组件写 `{}`。\n */\nexport type WithInstall<T, A = HTMLAttributes> = WithAttributes<T, A> & Plugin\n\n/** Attach an `install` method so a component can be used with `app.use()`. */\nexport function withInstall<T extends Component, A = HTMLAttributes>(\n  component: T,\n): WithInstall<T, A> {\n  const target = component as unknown as WithInstall<T, A>\n  target.install = (app: App) => {\n    const { name } = component as { name?: string }\n    if (!name) throw new Error('[dou-ui] component registered with app.use() must have a name')\n    app.component(name, component)\n  }\n  readConfiguredDefaults(component)\n  return target\n}\n\ntype PropOption = {\n  type?: unknown\n  default?: unknown\n  skipFactory?: boolean\n}\n\n/**\n * Let `ConfigProvider`'s `defaults` fill in props the component wasn't\n * given. Each prop's default becomes a factory that looks up the\n * configured value first; Vue runs default factories inside the\n * component, so `inject` sees the nearest provider.\n *\n * 这一步发生在包装组件的模块里，按需引入时打包器只留下用到的模块。所以组件内部渲染\n * 别的组件时，要引入包装过的那个（`import { DouSpinner } from '../spinner'`），\n * 不要直接引入 `.vue`，否则单独用外层组件时里面那个读不到默认值。\n * `utils/__tests__/nested-defaults.test.ts` 检查整个仓库都这样做。\n */\nfunction readConfiguredDefaults(component: Component) {\n  const { name, props } = component as { name?: string; props?: Record<string, PropOption | null> }\n  if (!name || !props || Array.isArray(props)) return\n  for (const [key, option] of Object.entries(props)) {\n    const own: PropOption = option && typeof option === 'object' ? option : {}\n    // a function-typed prop takes its default as the value itself, never as a factory\n    if (own.type === Function || own.skipFactory) continue\n    const hasDefault = 'default' in own\n    const fallback = own.default\n    const types = Array.isArray(own.type) ? own.type : [own.type]\n    props[key] = {\n      ...own,\n      default(raw: Record<string, unknown>) {\n        const config = hasInjectionContext() ? inject(configProviderKey, undefined) : undefined\n        const configured = (config?.value.defaults as Record<string, Record<string, unknown>>)?.[\n          name\n        ]?.[key]\n        if (configured !== undefined) return configured\n        if (!hasDefault) return types.includes(Boolean) ? false : undefined\n        return typeof fallback === 'function' ? fallback(raw) : fallback\n      },\n    }\n  }\n}\n"],"mappings":";;;;AA8CA,SAAgB,YACd,WACmB;CACnB,MAAM,SAAS;CACf,OAAO,WAAW,QAAa;EAC7B,MAAM,EAAE,SAAS;EACjB,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,+DAA+D;EAC1F,IAAI,UAAU,MAAM,SAAS;CAC/B;CACA,uBAAuB,SAAS;CAChC,OAAO;AACT;;;;;;;;;;;;AAmBA,SAAS,uBAAuB,WAAsB;CACpD,MAAM,EAAE,MAAM,UAAU;CACxB,IAAI,CAAC,QAAQ,CAAC,SAAS,MAAM,QAAQ,KAAK,GAAG;CAC7C,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,KAAK,GAAG;EACjD,MAAM,MAAkB,UAAU,OAAO,WAAW,WAAW,SAAS,CAAC;EAEzE,IAAI,IAAI,SAAS,YAAY,IAAI,aAAa;EAC9C,MAAM,aAAa,aAAa;EAChC,MAAM,WAAW,IAAI;EACrB,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI;EAC5D,MAAM,OAAO;GACX,GAAG;GACH,QAAQ,KAA8B;IAEpC,MAAM,eADS,oBAAoB,IAAI,OAAO,mBAAmB,KAAA,CAAS,IAAI,KAAA,EAAA,EAClD,MAAM,SAAA,GAChC,KACD,GAAG;IACJ,IAAI,eAAe,KAAA,GAAW,OAAO;IACrC,IAAI,CAAC,YAAY,OAAO,MAAM,SAAS,OAAO,IAAI,QAAQ,KAAA;IAC1D,OAAO,OAAO,aAAa,aAAa,SAAS,GAAG,IAAI;GAC1D;EACF;CACF;AACF"}

package/dist/utils/only-child.js

@@ -1,4 +1,5 @@
-import { Comment, Fragment, Text, cloneVNode, defineComponent, h } from "vue";
+import { devWarn } from "./status-check.js";
+import { Comment, Fragment, Text, cloneVNode, defineComponent, getCurrentInstance, h, mergeProps, onMounted } from "vue";
 // src/utils/only-child.ts
 function firstElement(nodes) {
 	for (const node of nodes) {
@@ -16,28 +17,78 @@ function firstElement(nodes) {
 	}
 	return null;
 }
-/** 属性和事件都转交给插槽里的元素，所以模板里可以写任何原生属性。 */
-var OnlyChild = defineComponent({
+var triggerHosts = /* @__PURE__ */ new WeakSet();
+/** Marks a component whose default slot is its trigger, rendered through `OnlyChild`. */
+function forwardsTrigger(component) {
+	triggerHosts.add(component);
+	return component;
+}
+var DYNAMIC_SLOTS = 1024;
+function passToTrigger(host, attrs) {
+	const slots = host.children;
+	const inner = slots?.default;
+	if (typeof inner !== "function") return host;
+	const { _: _compiled, $stable: _stable, ...rest } = slots;
+	const passed = cloneVNode(host);
+	passed.children = {
+		...rest,
+		default: (...args) => [h(OnlyChildComponent, attrs, { default: () => inner(...args) })]
+	};
+	if (passed.patchFlag >= 0) passed.patchFlag |= DYNAMIC_SLOTS;
+	return passed;
+}
+/**
+* Render the first element of the default slot, with the attributes and
+* listeners given to this component merged onto it. Lets a floating
+* component wire up its trigger without wrapping it in an extra element.
+*/
+var OnlyChildComponent = defineComponent({
 	name: "DouOnlyChild",
 	inheritAttrs: false,
 	setup(_, { slots, attrs }) {
+		const probe = useProbe(attrs);
 		return () => {
 			const child = firstElement(slots.default?.() ?? []);
 			if (!child) return null;
+			const given = probe ? mergeProps(attrs, { onDouProbe: probe }) : attrs;
+			if (triggerHosts.has(child.type)) return passToTrigger(child, { ...given });
 			const describedBy = [child.props?.["aria-describedby"], attrs["aria-describedby"]].filter(Boolean).join(" ") || void 0;
 			return cloneVNode(child, {
-				...attrs,
+				...given,
 				"aria-describedby": describedBy
 			}, true);
 		};
 	}
 });
+function useProbe(attrs) {
+	if (process.env.NODE_ENV === "production") return void 0;
+	const instance = getCurrentInstance();
+	let reached = false;
+	onMounted(() => {
+		if (!Object.keys(attrs).some((key) => /^on[A-Z]/.test(key) && key !== "onDouProbe")) return;
+		const root = onlyChildElement(instance?.proxy);
+		if (!root) return;
+		const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+		let node = root;
+		for (let n = 0; node && n < 500; n++) {
+			node.dispatchEvent(new Event("dou-probe"));
+			if (reached) return;
+			node = walker.nextNode();
+		}
+		if (node) return;
+		const owner = (instance?.parent?.type)?.name ?? "DouOnlyChild";
+		devWarn(`[dou-ui] ${owner}: its trigger got none of its listeners. The component in the default slot keeps its attributes for something else, e.g. your own component whose root is a DouPopover or DouDropdown. Put ${owner} inside that component, right around the overlay, or wrap the slot in an element.`);
+	});
+	return () => reached = true;
+}
+/** 属性和事件都转交给插槽里的元素，所以模板里可以写任何原生属性。 */
+var OnlyChild = OnlyChildComponent;
 /** The DOM element rendered by an `OnlyChild`, from its template ref. */
 function onlyChildElement(instance) {
 	let node = instance?.$el;
 	while (node && !(node instanceof Element)) node = node.nextSibling;
 	return node ?? null;
 }
-export { OnlyChild, onlyChildElement };
+export { OnlyChild, forwardsTrigger, onlyChildElement };
 
 //# sourceMappingURL=only-child.js.map

package/dist/utils/only-child.js.map

@@ -1 +1 @@
-{"version":3,"file":"only-child.js","names":[],"sources":["../../src/utils/only-child.ts"],"sourcesContent":["import { Comment, Fragment, Text, cloneVNode, defineComponent, h } from 'vue'\nimport type { ComponentPublicInstance, HTMLAttributes, VNode } from 'vue'\nimport type { WithAttributes } from './install'\n\nfunction firstElement(nodes: VNode[]): VNode | null {\n  for (const node of nodes) {\n    if (node.type === Comment) continue\n    if (node.type === Fragment) {\n      const found = firstElement((node.children as VNode[]) ?? [])\n      if (found) return found\n      continue\n    }\n    if (node.type === Text) {\n      if (!String(node.children).trim()) continue\n      return h('span', null, node.children as string)\n    }\n    return node\n  }\n  return null\n}\n\n/**\n * Render the first element of the default slot, with the attributes and\n * listeners given to this component merged onto it. Lets a floating\n * component wire up its trigger without wrapping it in an extra element.\n */\nconst OnlyChildComponent = defineComponent({\n  name: 'DouOnlyChild',\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    return () => {\n      const child = firstElement(slots.default?.() ?? [])\n      if (!child) return null\n      // ids that describe the element are a list: the element's own stay with the ones given\n      const own = child.props?.['aria-describedby'] as string | undefined\n      const given = attrs['aria-describedby'] as string | undefined\n      const describedBy = [own, given].filter(Boolean).join(' ') || undefined\n      return cloneVNode(child, { ...attrs, 'aria-describedby': describedBy }, true)\n    }\n  },\n})\n\n/** 属性和事件都转交给插槽里的元素，所以模板里可以写任何原生属性。 */\nexport const OnlyChild = OnlyChildComponent as WithAttributes<\n  typeof OnlyChildComponent,\n  HTMLAttributes\n>\n\n/** The DOM element rendered by an `OnlyChild`, from its template ref. */\nexport function onlyChildElement(instance: ComponentPublicInstance | null | undefined) {\n  let node = instance?.$el as Node | null | undefined\n  while (node && !(node instanceof Element)) node = node.nextSibling\n  return node ?? null\n}\n"],"mappings":";;AAIA,SAAS,aAAa,OAA8B;CAClD,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,SAAS,SAAS;EAC3B,IAAI,KAAK,SAAS,UAAU;GAC1B,MAAM,QAAQ,aAAc,KAAK,YAAwB,CAAC,CAAC;GAC3D,IAAI,OAAO,OAAO;GAClB;EACF;EACA,IAAI,KAAK,SAAS,MAAM;GACtB,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,KAAK,GAAG;GACnC,OAAO,EAAE,QAAQ,MAAM,KAAK,QAAkB;EAChD;EACA,OAAO;CACT;CACA,OAAO;AACT;;AAwBA,IAAa,YAjBc,gBAAgB;CACzC,MAAM;CACN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,aAAa;GACX,MAAM,QAAQ,aAAa,MAAM,UAAU,KAAK,CAAC,CAAC;GAClD,IAAI,CAAC,OAAO,OAAO;GAInB,MAAM,cAAc,CAFR,MAAM,QAAQ,qBACZ,MAAM,mBACW,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG,KAAK,KAAA;GAC9D,OAAO,WAAW,OAAO;IAAE,GAAG;IAAO,oBAAoB;GAAY,GAAG,IAAI;EAC9E;CACF;AACF,CAGyB;;AAMzB,SAAgB,iBAAiB,UAAsD;CACrF,IAAI,OAAO,UAAU;CACrB,OAAO,QAAQ,EAAE,gBAAgB,UAAU,OAAO,KAAK;CACvD,OAAO,QAAQ;AACjB"}
+{"version":3,"file":"only-child.js","names":[],"sources":["../../src/utils/only-child.ts"],"sourcesContent":["import {\n  Comment,\n  Fragment,\n  Text,\n  cloneVNode,\n  defineComponent,\n  getCurrentInstance,\n  h,\n  mergeProps,\n  onMounted,\n} from 'vue'\nimport type { Component, ComponentPublicInstance, HTMLAttributes, VNode } from 'vue'\nimport type { WithAttributes } from './install'\nimport { devWarn } from './status-check'\n\nfunction firstElement(nodes: VNode[]): VNode | null {\n  for (const node of nodes) {\n    if (node.type === Comment) continue\n    if (node.type === Fragment) {\n      const found = firstElement((node.children as VNode[]) ?? [])\n      if (found) return found\n      continue\n    }\n    if (node.type === Text) {\n      if (!String(node.children).trim()) continue\n      return h('span', null, node.children as string)\n    }\n    return node\n  }\n  return null\n}\n\n/*\n * Components whose default slot is their trigger (a tooltip, a popover, a\n * menu). Nested inside one another, each would hand its listeners to the\n * outer component, which keeps them for its own panel. So when the child\n * is one of these, the attributes go on to its slot instead and reach the\n * element both of them anchor to.\n */\nconst triggerHosts = new WeakSet<object>()\n\n/** Marks a component whose default slot is its trigger, rendered through `OnlyChild`. */\nexport function forwardsTrigger<T extends Component>(component: T): T {\n  triggerHosts.add(component)\n  return component\n}\n\n// PatchFlags.DYNAMIC_SLOTS: the replaced slot differs on every render\nconst DYNAMIC_SLOTS = 1 << 10\n\nfunction passToTrigger(host: VNode, attrs: Record<string, unknown>): VNode {\n  const slots = host.children as Record<string, unknown> | null\n  const inner = slots?.default\n  if (typeof inner !== 'function') return host\n  // without `_` and `$stable` the slots are taken as new on every render\n  const { _: _compiled, $stable: _stable, ...rest } = slots!\n  const passed = cloneVNode(host)\n  passed.children = {\n    ...rest,\n    default: (...args: unknown[]) => [\n      h(OnlyChildComponent, attrs, {\n        default: () => (inner as (...a: unknown[]) => VNode[])(...args),\n      }),\n    ],\n  }\n  if (passed.patchFlag >= 0) passed.patchFlag |= DYNAMIC_SLOTS\n  return passed\n}\n\n/**\n * Render the first element of the default slot, with the attributes and\n * listeners given to this component merged onto it. Lets a floating\n * component wire up its trigger without wrapping it in an extra element.\n */\nconst OnlyChildComponent = defineComponent({\n  name: 'DouOnlyChild',\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const probe = useProbe(attrs)\n    return () => {\n      const child = firstElement(slots.default?.() ?? [])\n      if (!child) return null\n      // probes of the components around are kept: each checks its own listeners\n      const given = probe ? mergeProps(attrs, { onDouProbe: probe }) : attrs\n      if (triggerHosts.has(child.type as object)) return passToTrigger(child, { ...given })\n      // ids that describe the element are a list: the element's own stay with the ones given\n      const own = child.props?.['aria-describedby'] as string | undefined\n      const theirs = attrs['aria-describedby'] as string | undefined\n      const describedBy = [own, theirs].filter(Boolean).join(' ') || undefined\n      return cloneVNode(child, { ...given, 'aria-describedby': describedBy }, true)\n    }\n  },\n})\n\n/*\n * While developing: check once that the listeners reached an element. A\n * component in the slot that keeps its attributes for something else\n * (say a wrapper whose root is a DouDropdown, which puts them on its\n * panel) leaves the trigger without them, and nothing else would say so.\n */\nfunction useProbe(attrs: Record<string, unknown>) {\n  if (process.env.NODE_ENV === 'production') return undefined\n  const instance = getCurrentInstance()\n  let reached = false\n  onMounted(() => {\n    if (!Object.keys(attrs).some((key) => /^on[A-Z]/.test(key) && key !== 'onDouProbe')) return\n    const root = onlyChildElement(instance?.proxy)\n    if (!root) return\n    // the listeners may sit on an element inside the root, not on the root itself\n    const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT)\n    let node: Node | null = root\n    for (let n = 0; node && n < 500; n++) {\n      node.dispatchEvent(new Event('dou-probe'))\n      if (reached) return\n      node = walker.nextNode()\n    }\n    // a trigger too large to look through is given the benefit of the doubt\n    if (node) return\n    const owner = (instance?.parent?.type as { name?: string } | undefined)?.name ?? 'DouOnlyChild'\n    devWarn(\n      `[dou-ui] ${owner}: its trigger got none of its listeners. The component in the default slot keeps its attributes for something else, e.g. your own component whose root is a DouPopover or DouDropdown. Put ${owner} inside that component, right around the overlay, or wrap the slot in an element.`,\n    )\n  })\n  return () => (reached = true)\n}\n\n/** 属性和事件都转交给插槽里的元素，所以模板里可以写任何原生属性。 */\nexport const OnlyChild = OnlyChildComponent as WithAttributes<\n  typeof OnlyChildComponent,\n  HTMLAttributes\n>\n\n/** The DOM element rendered by an `OnlyChild`, from its template ref. */\nexport function onlyChildElement(instance: ComponentPublicInstance | null | undefined) {\n  let node = instance?.$el as Node | null | undefined\n  while (node && !(node instanceof Element)) node = node.nextSibling\n  return node ?? null\n}\n"],"mappings":";;;AAeA,SAAS,aAAa,OAA8B;CAClD,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,SAAS,SAAS;EAC3B,IAAI,KAAK,SAAS,UAAU;GAC1B,MAAM,QAAQ,aAAc,KAAK,YAAwB,CAAC,CAAC;GAC3D,IAAI,OAAO,OAAO;GAClB;EACF;EACA,IAAI,KAAK,SAAS,MAAM;GACtB,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,KAAK,GAAG;GACnC,OAAO,EAAE,QAAQ,MAAM,KAAK,QAAkB;EAChD;EACA,OAAO;CACT;CACA,OAAO;AACT;AASA,IAAM,+BAAe,IAAI,QAAgB;;AAGzC,SAAgB,gBAAqC,WAAiB;CACpE,aAAa,IAAI,SAAS;CAC1B,OAAO;AACT;AAGA,IAAM,gBAAgB;AAEtB,SAAS,cAAc,MAAa,OAAuC;CACzE,MAAM,QAAQ,KAAK;CACnB,MAAM,QAAQ,OAAO;CACrB,IAAI,OAAO,UAAU,YAAY,OAAO;CAExC,MAAM,EAAE,GAAG,WAAW,SAAS,SAAS,GAAG,SAAS;CACpD,MAAM,SAAS,WAAW,IAAI;CAC9B,OAAO,WAAW;EAChB,GAAG;EACH,UAAU,GAAG,SAAoB,CAC/B,EAAE,oBAAoB,OAAO,EAC3B,eAAgB,MAAuC,GAAG,IAAI,EAChE,CAAC,CACH;CACF;CACA,IAAI,OAAO,aAAa,GAAG,OAAO,aAAa;CAC/C,OAAO;AACT;;;;;;AAOA,IAAM,qBAAqB,gBAAgB;CACzC,MAAM;CACN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,QAAQ,SAAS,KAAK;EAC5B,aAAa;GACX,MAAM,QAAQ,aAAa,MAAM,UAAU,KAAK,CAAC,CAAC;GAClD,IAAI,CAAC,OAAO,OAAO;GAEnB,MAAM,QAAQ,QAAQ,WAAW,OAAO,EAAE,YAAY,MAAM,CAAC,IAAI;GACjE,IAAI,aAAa,IAAI,MAAM,IAAc,GAAG,OAAO,cAAc,OAAO,EAAE,GAAG,MAAM,CAAC;GAIpF,MAAM,cAAc,CAFR,MAAM,QAAQ,qBACX,MAAM,mBACW,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG,KAAK,KAAA;GAC/D,OAAO,WAAW,OAAO;IAAE,GAAG;IAAO,oBAAoB;GAAY,GAAG,IAAI;EAC9E;CACF;AACF,CAAC;AAQD,SAAS,SAAS,OAAgC;CAChD,IAAA,QAAA,IAAA,aAA6B,cAAc,OAAO,KAAA;CAClD,MAAM,WAAW,mBAAmB;CACpC,IAAI,UAAU;CACd,gBAAgB;EACd,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,MAAM,QAAQ,WAAW,KAAK,GAAG,KAAK,QAAQ,YAAY,GAAG;EACrF,MAAM,OAAO,iBAAiB,UAAU,KAAK;EAC7C,IAAI,CAAC,MAAM;EAEX,MAAM,SAAS,SAAS,iBAAiB,MAAM,WAAW,YAAY;EACtE,IAAI,OAAoB;EACxB,KAAK,IAAI,IAAI,GAAG,QAAQ,IAAI,KAAK,KAAK;GACpC,KAAK,cAAc,IAAI,MAAM,WAAW,CAAC;GACzC,IAAI,SAAS;GACb,OAAO,OAAO,SAAS;EACzB;EAEA,IAAI,MAAM;EACV,MAAM,SAAS,UAAU,QAAQ,KAAA,EAAwC,QAAQ;EACjF,QACE,YAAY,MAAM,6LAA6L,MAAM,kFACvN;CACF,CAAC;CACD,aAAc,UAAU;AAC1B;;AAGA,IAAa,YAAY;;AAMzB,SAAgB,iBAAiB,UAAsD;CACrF,IAAI,OAAO,UAAU;CACrB,OAAO,QAAQ,EAAE,gBAAgB,UAAU,OAAO,KAAK;CACvD,OAAO,QAAQ;AACjB"}

package/dist/utils/pointer.js

@@ -1,5 +1,10 @@
 // src/utils/pointer.ts
 /**
+* Whether a pointer of this type can hover. Fingers and pens touch down
+* where they act, and the enter and leave they send come with the press.
+*/
+var hasHover = (pointerType) => pointerType !== "touch" && pointerType !== "pen";
+/**
 * Keeps a touch on the drag it started, also when the element under the
 * finger is removed while it moves (the item moved to another list, a
 * virtual row scrolled out of view).
@@ -81,6 +86,6 @@ function holdPointer(event, root, onLost) {
 		release
 	};
 }
-export { holdPointer };
+export { hasHover, holdPointer };
 
 //# sourceMappingURL=pointer.js.map

package/dist/utils/pointer.js.map

@@ -1 +1 @@
-{"version":3,"file":"pointer.js","names":[],"sources":["../../src/utils/pointer.ts"],"sourcesContent":["/** A press that may turn into a drag; see `holdPointer`. */\nexport interface PointerHold {\n  /** The drag has started: the touch stops scrolling and `root` captures the pointer. */\n  grab(): void\n  /** The press or the drag is over. */\n  release(): void\n}\n\n/**\n * Keeps a touch on the drag it started, also when the element under the\n * finger is removed while it moves (the item moved to another list, a\n * virtual row scrolled out of view).\n *\n * Touch events keep going to the element the finger went down on, and a\n * removed element no longer passes them up to the page: nothing stops the\n * touch from scrolling, and the browser cancels the pointer to scroll\n * instead. So the element gets its own `touchmove` listener, next to one on\n * the window. Call this in `pointerdown`: it comes before `touchstart`, and\n * a touch can only be kept from scrolling when a listener on the window was\n * there as it started (one on the element alone is not seen in time). Call\n * `grab()` once the drag starts and `release()` when it ends.\n *\n * `root` is an element that stays in the page for the whole drag; it\n * captures the pointer, so its events go on without the element. Leave it\n * out when the element itself captures the pointer and is never removed.\n *\n * The hold also lets go by itself once the last finger is lifted, whether\n * or not the `pointerup` reached the code that would call `release()`\n * (Safari on iOS sends it to a removed element, where nothing hears it):\n * a hold that outlived its touch would keep the whole page from scrolling.\n * The drag is then cancelled the usual way: a `pointercancel` for the same\n * pointer goes out from the pressed element (or `root`, or the window, when\n * it is gone), so code that ends a drag on `pointercancel` ends it here too.\n * `onLost` is called after it.\n */\nexport function holdPointer(\n  event: PointerEvent,\n  root?: Element | null,\n  onLost?: () => void,\n): PointerHold {\n  // A mouse never scrolls the page by dragging.\n  if (event.pointerType === 'mouse') return { grab() {}, release() {} }\n  const target = event.target instanceof Element ? event.target : null\n  let grabbed = false\n  let held = true\n  const block = (e: Event) => {\n    if (grabbed && e.cancelable) e.preventDefault()\n  }\n  // After the pointer's own events, so a `pointerup` that did arrive ends the drag first.\n  const end = (e: Event) => {\n    if ((e as TouchEvent).touches?.length) return\n    setTimeout(() => {\n      if (!held) return\n      release()\n      const at = target?.isConnected ? target : root?.isConnected ? root : window\n      at.dispatchEvent(\n        new PointerEvent('pointercancel', {\n          pointerId: event.pointerId,\n          pointerType: event.pointerType,\n          bubbles: true,\n        }),\n      )\n      onLost?.()\n    })\n  }\n  window.addEventListener('touchmove', block, { passive: false })\n  target?.addEventListener('touchmove', block, { passive: false })\n  for (const type of ['touchend', 'touchcancel']) {\n    window.addEventListener(type, end, { passive: true })\n    target?.addEventListener(type, end, { passive: true })\n  }\n  function release() {\n    if (held) {\n      held = false\n      window.removeEventListener('touchmove', block)\n      target?.removeEventListener('touchmove', block)\n      for (const type of ['touchend', 'touchcancel']) {\n        window.removeEventListener(type, end)\n        target?.removeEventListener(type, end)\n      }\n    }\n    if (!grabbed) return\n    grabbed = false\n    if (root?.isConnected && root.hasPointerCapture?.(event.pointerId))\n      root.releasePointerCapture(event.pointerId)\n  }\n  return {\n    grab() {\n      if (grabbed || !held) return\n      grabbed = true\n      try {\n        if (root?.isConnected) root.setPointerCapture?.(event.pointerId)\n      } catch {\n        // the pointer is already gone\n      }\n    },\n    release,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,YACd,OACA,MACA,QACa;CAEb,IAAI,MAAM,gBAAgB,SAAS,OAAO;EAAE,OAAO,CAAC;EAAG,UAAU,CAAC;CAAE;CACpE,MAAM,SAAS,MAAM,kBAAkB,UAAU,MAAM,SAAS;CAChE,IAAI,UAAU;CACd,IAAI,OAAO;CACX,MAAM,SAAS,MAAa;EAC1B,IAAI,WAAW,EAAE,YAAY,EAAE,eAAe;CAChD;CAEA,MAAM,OAAO,MAAa;EACxB,IAAK,EAAiB,SAAS,QAAQ;EACvC,iBAAiB;GACf,IAAI,CAAC,MAAM;GACX,QAAQ;GAER,CADW,QAAQ,cAAc,SAAS,MAAM,cAAc,OAAO,OAAA,CAClE,cACD,IAAI,aAAa,iBAAiB;IAChC,WAAW,MAAM;IACjB,aAAa,MAAM;IACnB,SAAS;GACX,CAAC,CACH;GACA,SAAS;EACX,CAAC;CACH;CACA,OAAO,iBAAiB,aAAa,OAAO,EAAE,SAAS,MAAM,CAAC;CAC9D,QAAQ,iBAAiB,aAAa,OAAO,EAAE,SAAS,MAAM,CAAC;CAC/D,KAAK,MAAM,QAAQ,CAAC,YAAY,aAAa,GAAG;EAC9C,OAAO,iBAAiB,MAAM,KAAK,EAAE,SAAS,KAAK,CAAC;EACpD,QAAQ,iBAAiB,MAAM,KAAK,EAAE,SAAS,KAAK,CAAC;CACvD;CACA,SAAS,UAAU;EACjB,IAAI,MAAM;GACR,OAAO;GACP,OAAO,oBAAoB,aAAa,KAAK;GAC7C,QAAQ,oBAAoB,aAAa,KAAK;GAC9C,KAAK,MAAM,QAAQ,CAAC,YAAY,aAAa,GAAG;IAC9C,OAAO,oBAAoB,MAAM,GAAG;IACpC,QAAQ,oBAAoB,MAAM,GAAG;GACvC;EACF;EACA,IAAI,CAAC,SAAS;EACd,UAAU;EACV,IAAI,MAAM,eAAe,KAAK,oBAAoB,MAAM,SAAS,GAC/D,KAAK,sBAAsB,MAAM,SAAS;CAC9C;CACA,OAAO;EACL,OAAO;GACL,IAAI,WAAW,CAAC,MAAM;GACtB,UAAU;GACV,IAAI;IACF,IAAI,MAAM,aAAa,KAAK,oBAAoB,MAAM,SAAS;GACjE,QAAQ,CAER;EACF;EACA;CACF;AACF"}
+{"version":3,"file":"pointer.js","names":[],"sources":["../../src/utils/pointer.ts"],"sourcesContent":["/**\n * Whether a pointer of this type can hover. Fingers and pens touch down\n * where they act, and the enter and leave they send come with the press.\n */\nexport const hasHover = (pointerType: string) => pointerType !== 'touch' && pointerType !== 'pen'\n\n/** A press that may turn into a drag; see `holdPointer`. */\nexport interface PointerHold {\n  /** The drag has started: the touch stops scrolling and `root` captures the pointer. */\n  grab(): void\n  /** The press or the drag is over. */\n  release(): void\n}\n\n/**\n * Keeps a touch on the drag it started, also when the element under the\n * finger is removed while it moves (the item moved to another list, a\n * virtual row scrolled out of view).\n *\n * Touch events keep going to the element the finger went down on, and a\n * removed element no longer passes them up to the page: nothing stops the\n * touch from scrolling, and the browser cancels the pointer to scroll\n * instead. So the element gets its own `touchmove` listener, next to one on\n * the window. Call this in `pointerdown`: it comes before `touchstart`, and\n * a touch can only be kept from scrolling when a listener on the window was\n * there as it started (one on the element alone is not seen in time). Call\n * `grab()` once the drag starts and `release()` when it ends.\n *\n * `root` is an element that stays in the page for the whole drag; it\n * captures the pointer, so its events go on without the element. Leave it\n * out when the element itself captures the pointer and is never removed.\n *\n * The hold also lets go by itself once the last finger is lifted, whether\n * or not the `pointerup` reached the code that would call `release()`\n * (Safari on iOS sends it to a removed element, where nothing hears it):\n * a hold that outlived its touch would keep the whole page from scrolling.\n * The drag is then cancelled the usual way: a `pointercancel` for the same\n * pointer goes out from the pressed element (or `root`, or the window, when\n * it is gone), so code that ends a drag on `pointercancel` ends it here too.\n * `onLost` is called after it.\n */\nexport function holdPointer(\n  event: PointerEvent,\n  root?: Element | null,\n  onLost?: () => void,\n): PointerHold {\n  // A mouse never scrolls the page by dragging.\n  if (event.pointerType === 'mouse') return { grab() {}, release() {} }\n  const target = event.target instanceof Element ? event.target : null\n  let grabbed = false\n  let held = true\n  const block = (e: Event) => {\n    if (grabbed && e.cancelable) e.preventDefault()\n  }\n  // After the pointer's own events, so a `pointerup` that did arrive ends the drag first.\n  const end = (e: Event) => {\n    if ((e as TouchEvent).touches?.length) return\n    setTimeout(() => {\n      if (!held) return\n      release()\n      const at = target?.isConnected ? target : root?.isConnected ? root : window\n      at.dispatchEvent(\n        new PointerEvent('pointercancel', {\n          pointerId: event.pointerId,\n          pointerType: event.pointerType,\n          bubbles: true,\n        }),\n      )\n      onLost?.()\n    })\n  }\n  window.addEventListener('touchmove', block, { passive: false })\n  target?.addEventListener('touchmove', block, { passive: false })\n  for (const type of ['touchend', 'touchcancel']) {\n    window.addEventListener(type, end, { passive: true })\n    target?.addEventListener(type, end, { passive: true })\n  }\n  function release() {\n    if (held) {\n      held = false\n      window.removeEventListener('touchmove', block)\n      target?.removeEventListener('touchmove', block)\n      for (const type of ['touchend', 'touchcancel']) {\n        window.removeEventListener(type, end)\n        target?.removeEventListener(type, end)\n      }\n    }\n    if (!grabbed) return\n    grabbed = false\n    if (root?.isConnected && root.hasPointerCapture?.(event.pointerId))\n      root.releasePointerCapture(event.pointerId)\n  }\n  return {\n    grab() {\n      if (grabbed || !held) return\n      grabbed = true\n      try {\n        if (root?.isConnected) root.setPointerCapture?.(event.pointerId)\n      } catch {\n        // the pointer is already gone\n      }\n    },\n    release,\n  }\n}\n"],"mappings":";;;;;AAIA,IAAa,YAAY,gBAAwB,gBAAgB,WAAW,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqC5F,SAAgB,YACd,OACA,MACA,QACa;CAEb,IAAI,MAAM,gBAAgB,SAAS,OAAO;EAAE,OAAO,CAAC;EAAG,UAAU,CAAC;CAAE;CACpE,MAAM,SAAS,MAAM,kBAAkB,UAAU,MAAM,SAAS;CAChE,IAAI,UAAU;CACd,IAAI,OAAO;CACX,MAAM,SAAS,MAAa;EAC1B,IAAI,WAAW,EAAE,YAAY,EAAE,eAAe;CAChD;CAEA,MAAM,OAAO,MAAa;EACxB,IAAK,EAAiB,SAAS,QAAQ;EACvC,iBAAiB;GACf,IAAI,CAAC,MAAM;GACX,QAAQ;GAER,CADW,QAAQ,cAAc,SAAS,MAAM,cAAc,OAAO,OAAA,CAClE,cACD,IAAI,aAAa,iBAAiB;IAChC,WAAW,MAAM;IACjB,aAAa,MAAM;IACnB,SAAS;GACX,CAAC,CACH;GACA,SAAS;EACX,CAAC;CACH;CACA,OAAO,iBAAiB,aAAa,OAAO,EAAE,SAAS,MAAM,CAAC;CAC9D,QAAQ,iBAAiB,aAAa,OAAO,EAAE,SAAS,MAAM,CAAC;CAC/D,KAAK,MAAM,QAAQ,CAAC,YAAY,aAAa,GAAG;EAC9C,OAAO,iBAAiB,MAAM,KAAK,EAAE,SAAS,KAAK,CAAC;EACpD,QAAQ,iBAAiB,MAAM,KAAK,EAAE,SAAS,KAAK,CAAC;CACvD;CACA,SAAS,UAAU;EACjB,IAAI,MAAM;GACR,OAAO;GACP,OAAO,oBAAoB,aAAa,KAAK;GAC7C,QAAQ,oBAAoB,aAAa,KAAK;GAC9C,KAAK,MAAM,QAAQ,CAAC,YAAY,aAAa,GAAG;IAC9C,OAAO,oBAAoB,MAAM,GAAG;IACpC,QAAQ,oBAAoB,MAAM,GAAG;GACvC;EACF;EACA,IAAI,CAAC,SAAS;EACd,UAAU;EACV,IAAI,MAAM,eAAe,KAAK,oBAAoB,MAAM,SAAS,GAC/D,KAAK,sBAAsB,MAAM,SAAS;CAC9C;CACA,OAAO;EACL,OAAO;GACL,IAAI,WAAW,CAAC,MAAM;GACtB,UAAU;GACV,IAAI;IACF,IAAI,MAAM,aAAa,KAAK,oBAAoB,MAAM,SAAS;GACjE,QAAQ,CAER;EACF;EACA;CACF;AACF"}

package/dist/utils/safe-url.js

@@ -0,0 +1,57 @@
+import { devWarn } from "./status-check.js";
+// src/utils/safe-url.ts
+var SAFE_SCHEMES = [
+	"http",
+	"https",
+	"mailto",
+	"tel"
+];
+/**
+* The scheme of `url` in lower case, such as `https`, or an empty string for a
+* relative address or anchor. Control characters and whitespace are ignored,
+* as browsers do, so `java\tscript:` reads as `javascript`.
+*/
+function urlScheme(url) {
+	let compact = "";
+	for (const ch of url) {
+		const code = ch.charCodeAt(0);
+		if (code > 32 && (code < 127 || code > 159)) compact += ch;
+	}
+	const colon = compact.indexOf(":");
+	if (colon < 0) return "";
+	const cut = compact.search(/[/?#]/);
+	if (cut >= 0 && cut < colon) return "";
+	const scheme = compact.slice(0, colon);
+	return /^[a-z][a-z0-9+.-]*$/i.test(scheme) ? scheme.toLowerCase() : "";
+}
+/**
+* Returns `url` when it is safe to use as a link (`href`), otherwise `undefined`.
+* http(s), mailto, tel, relative addresses and anchors pass; anything else,
+* such as `javascript:` or `data:`, is dropped. Only for links: it also drops
+* `data:` and `blob:`, which are fine in an image `src`.
+*/
+function safeUrl(url) {
+	if (!url) return void 0;
+	const scheme = urlScheme(url);
+	return scheme === "" || SAFE_SCHEMES.includes(scheme) ? url : void 0;
+}
+/** Whether a link should open in a new tab: not for `mailto:` and `tel:`, which hand off to an app. */
+function opensNewTab(url) {
+	const scheme = urlScheme(url);
+	return scheme !== "mailto" && scheme !== "tel";
+}
+/**
+* {@link safeUrl}, warning once while developing when an address is dropped.
+* `component` names the component in the warning, e.g. `DouChatSources`.
+*/
+function checkedUrl(component, url) {
+	const safe = safeUrl(url);
+	if (url && safe === void 0 && process.env.NODE_ENV !== "production") {
+		const shown = url.length > 60 ? `${url.slice(0, 60)}…` : url;
+		devWarn(`[dou-ui] ${component}: \`${shown}\` is not a safe url and is shown without a link. Use http(s), mailto, tel or a relative address.`);
+	}
+	return safe;
+}
+export { checkedUrl, opensNewTab, safeUrl };
+
+//# sourceMappingURL=safe-url.js.map

package/dist/utils/safe-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-url.js","names":[],"sources":["../../src/utils/safe-url.ts"],"sourcesContent":["import { devWarn } from './status-check'\n\nconst SAFE_SCHEMES = ['http', 'https', 'mailto', 'tel']\n\n/**\n * The scheme of `url` in lower case, such as `https`, or an empty string for a\n * relative address or anchor. Control characters and whitespace are ignored,\n * as browsers do, so `java\\tscript:` reads as `javascript`.\n */\nfunction urlScheme(url: string): string {\n  let compact = ''\n  for (const ch of url) {\n    const code = ch.charCodeAt(0)\n    if (code > 0x20 && (code < 0x7f || code > 0x9f)) compact += ch\n  }\n  const colon = compact.indexOf(':')\n  if (colon < 0) return ''\n  // a colon after a slash, `?` or `#` belongs to a relative path, not a scheme\n  const cut = compact.search(/[/?#]/)\n  if (cut >= 0 && cut < colon) return ''\n  const scheme = compact.slice(0, colon)\n  // not a scheme name, e.g. `2024:年报.html`: browsers read it as a relative path.\n  // `compact` drops more characters than browsers do, so a bad character here is\n  // in the original too.\n  return /^[a-z][a-z0-9+.-]*$/i.test(scheme) ? scheme.toLowerCase() : ''\n}\n\n/**\n * Returns `url` when it is safe to use as a link (`href`), otherwise `undefined`.\n * http(s), mailto, tel, relative addresses and anchors pass; anything else,\n * such as `javascript:` or `data:`, is dropped. Only for links: it also drops\n * `data:` and `blob:`, which are fine in an image `src`.\n */\nexport function safeUrl(url: string | undefined): string | undefined {\n  if (!url) return undefined\n  const scheme = urlScheme(url)\n  return scheme === '' || SAFE_SCHEMES.includes(scheme) ? url : undefined\n}\n\n/** Whether a link should open in a new tab: not for `mailto:` and `tel:`, which hand off to an app. */\nexport function opensNewTab(url: string): boolean {\n  const scheme = urlScheme(url)\n  return scheme !== 'mailto' && scheme !== 'tel'\n}\n\n/**\n * {@link safeUrl}, warning once while developing when an address is dropped.\n * `component` names the component in the warning, e.g. `DouChatSources`.\n */\nexport function checkedUrl(component: string, url: string | undefined): string | undefined {\n  const safe = safeUrl(url)\n  if (url && safe === undefined && process.env.NODE_ENV !== 'production') {\n    const shown = url.length > 60 ? `${url.slice(0, 60)}…` : url\n    devWarn(\n      `[dou-ui] ${component}: \\`${shown}\\` is not a safe url and is shown without a link. Use http(s), mailto, tel or a relative address.`,\n    )\n  }\n  return safe\n}\n"],"mappings":";;AAEA,IAAM,eAAe;CAAC;CAAQ;CAAS;CAAU;AAAK;;;;;;AAOtD,SAAS,UAAU,KAAqB;CACtC,IAAI,UAAU;CACd,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,OAAO,GAAG,WAAW,CAAC;EAC5B,IAAI,OAAO,OAAS,OAAO,OAAQ,OAAO,MAAO,WAAW;CAC9D;CACA,MAAM,QAAQ,QAAQ,QAAQ,GAAG;CACjC,IAAI,QAAQ,GAAG,OAAO;CAEtB,MAAM,MAAM,QAAQ,OAAO,OAAO;CAClC,IAAI,OAAO,KAAK,MAAM,OAAO,OAAO;CACpC,MAAM,SAAS,QAAQ,MAAM,GAAG,KAAK;CAIrC,OAAO,uBAAuB,KAAK,MAAM,IAAI,OAAO,YAAY,IAAI;AACtE;;;;;;;AAQA,SAAgB,QAAQ,KAA6C;CACnE,IAAI,CAAC,KAAK,OAAO,KAAA;CACjB,MAAM,SAAS,UAAU,GAAG;CAC5B,OAAO,WAAW,MAAM,aAAa,SAAS,MAAM,IAAI,MAAM,KAAA;AAChE;;AAGA,SAAgB,YAAY,KAAsB;CAChD,MAAM,SAAS,UAAU,GAAG;CAC5B,OAAO,WAAW,YAAY,WAAW;AAC3C;;;;;AAMA,SAAgB,WAAW,WAAmB,KAA6C;CACzF,MAAM,OAAO,QAAQ,GAAG;CACxB,IAAI,OAAO,SAAS,KAAA,KAAA,QAAA,IAAA,aAAsC,cAAc;EACtE,MAAM,QAAQ,IAAI,SAAS,KAAK,GAAG,IAAI,MAAM,GAAG,EAAE,EAAE,KAAK;EACzD,QACE,YAAY,UAAU,MAAM,MAAM,kGACpC;CACF;CACA,OAAO;AACT"}

package/dist/utils/status-check.js

@@ -0,0 +1,27 @@
+import { watchEffect } from "vue";
+// src/utils/status-check.ts
+var warned = /* @__PURE__ */ new Set();
+/** Warn once per page with this message. Call only while developing. */
+function devWarn(message) {
+	if (warned.has(message)) return;
+	warned.add(message);
+	console.warn(message);
+}
+/**
+* While developing, warn once about a `status` the component doesn't know,
+* e.g. an old name in JSON from a server, where types can't catch it.
+* `renamed` maps old names to the new ones to suggest.
+*/
+function useStatusCheck(component, statuses, known, renamed = {}) {
+	if (process.env.NODE_ENV === "production") return;
+	watchEffect(() => {
+		for (const status of statuses()) {
+			if (status === void 0 || known.includes(status)) continue;
+			const hint = renamed[status] ? ` Use \`${renamed[status]}\`.` : "";
+			devWarn(`[dou-ui] ${component}: unknown status \`${status}\`, expected one of ${known.map((k) => `\`${k}\``).join(", ")}.${hint}`);
+		}
+	});
+}
+export { devWarn, useStatusCheck };
+
+//# sourceMappingURL=status-check.js.map

package/dist/utils/status-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-check.js","names":[],"sources":["../../src/utils/status-check.ts"],"sourcesContent":["import { watchEffect } from 'vue'\n\n// one warning per component and value for the whole page, so a long list doesn't flood the console\nconst warned = new Set<string>()\n\n/** Warn once per page with this message. Call only while developing. */\nexport function devWarn(message: string) {\n  if (warned.has(message)) return\n  warned.add(message)\n  console.warn(message)\n}\n\n/**\n * While developing, warn once about a `status` the component doesn't know,\n * e.g. an old name in JSON from a server, where types can't catch it.\n * `renamed` maps old names to the new ones to suggest.\n */\nexport function useStatusCheck(\n  component: string,\n  statuses: () => readonly (string | undefined)[],\n  known: readonly string[],\n  renamed: Record<string, string> = {},\n) {\n  // The app's bundler replaces this, as for Vue's own warnings.\n  if (process.env.NODE_ENV === 'production') return\n  watchEffect(() => {\n    for (const status of statuses()) {\n      if (status === undefined || known.includes(status)) continue\n      const hint = renamed[status] ? ` Use \\`${renamed[status]}\\`.` : ''\n      devWarn(\n        `[dou-ui] ${component}: unknown status \\`${status}\\`, expected one of ${known.map((k) => `\\`${k}\\``).join(', ')}.${hint}`,\n      )\n    }\n  })\n}\n"],"mappings":";;AAGA,IAAM,yBAAS,IAAI,IAAY;;AAG/B,SAAgB,QAAQ,SAAiB;CACvC,IAAI,OAAO,IAAI,OAAO,GAAG;CACzB,OAAO,IAAI,OAAO;CAClB,QAAQ,KAAK,OAAO;AACtB;;;;;;AAOA,SAAgB,eACd,WACA,UACA,OACA,UAAkC,CAAC,GACnC;CAEA,IAAA,QAAA,IAAA,aAA6B,cAAc;CAC3C,kBAAkB;EAChB,KAAK,MAAM,UAAU,SAAS,GAAG;GAC/B,IAAI,WAAW,KAAA,KAAa,MAAM,SAAS,MAAM,GAAG;GACpD,MAAM,OAAO,QAAQ,UAAU,UAAU,QAAQ,QAAQ,OAAO;GAChE,QACE,YAAY,UAAU,qBAAqB,OAAO,sBAAsB,MAAM,KAAK,MAAM,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,GAAG,MACrH;EACF;CACF,CAAC;AACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dou-ui",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.4",
   "description": "为自己打造的 Vue 3 组件库：简洁克制，样式与组件分离，内置无障碍支持",
   "keywords": [
     "vue",
@@ -49,8 +49,8 @@
     "vue": "^3.5.0"
   },
   "dependencies": {
-    "@dou-ui/icons": "0.1.0-alpha.2",
-    "@dou-ui/theme": "0.1.0-alpha.2"
+    "@dou-ui/icons": "0.1.0-alpha.4",
+    "@dou-ui/theme": "0.1.0-alpha.4"
   },
   "publishConfig": {
     "access": "public"