@morlay/dsh-client-ui-primitives 0.0.2-alpha.4 → 0.0.2-alpha.6

package/README.md

@@ -8,13 +8,14 @@
 
 ## 能力
 
-| 导出                      | 用途                                                                                                                                                                         |
-| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `styled('div')(style, …)` | 生成带 `data-css-*` 的组件；多个样式对象深合并（变体叠基样式）                                                                                                               |
-| `styling`                 | `props(style)` 取 `data-css-*` 属性、`keyframes`、`injectGlobals`、`sheets()`                                                                                                |
-| `Token`                   | 变量引用代理（`vars`）、局部变量赋值（`assignVars`）、变体选择器（`variants`）、组合子（`calc` / `min` / `max` / `url` / `colorMix` / `colorScale` / `fallbackVar` / `val`） |
-| `dsw`                     | 官方主题变量引用：`dsw.alias.bg.base` → `var(--dsw-alias-bg-base)`                                                                                                           |
-| `designTokens`            | 生成的 token 树，叶子是官方默认值（可作 fallback 与类型推导来源）                                                                                                            |
+| 导出                                     | 用途                                                                                                                                                                         |
+| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `styled('div')(style, …)`                | 生成带 `data-css-*` 的组件；多个样式对象深合并（变体叠基样式）                                                                                                               |
+| `styling`                                | `props(style)` 取 `data-css-*` 属性、`keyframes`、`injectGlobals`、`sheets()`                                                                                                |
+| `Token`                                  | 变量引用代理（`vars`）、局部变量赋值（`assignVars`）、变体选择器（`variants`）、组合子（`calc` / `min` / `max` / `url` / `colorMix` / `colorScale` / `fallbackVar` / `val`） |
+| `dsw`                                    | 官方主题变量引用：`dsw.alias.bg.base` → `var(--dsw-alias-bg-base)`                                                                                                           |
+| `findReferences` / `parseReferenceToken` | host 面：`@` 引用的统一解析与形态归一（`@path` / `@"path"` / `skill:name` → 结构化引用与 span），`Reference` / `ReferenceSpan` 类型                                          |
+| `designTokens`                           | 生成的 token 树，叶子是官方默认值（可作 fallback 与类型推导来源）                                                                                                            |
 
 样式注入是**惰性立即注入**（某条规则第一次生成时就 append `<style data-css="…">`，
 按 id 去重），不提供 Provider。

package/dist/client.cjs

@@ -323,7 +323,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/theme.generated.ts
 		/**
-		* 官方主题的 `--dsw-*` token 全集（359 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
+		* 官方主题的 `--dsw-*` token 全集（361 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
 		*
 		* 叶子是该变量的**默认值**（官方 light 主题里首次出现的定义）：既是类型推导的来源，也可作 fallback。
 		* `"$"` 键出现在「自身也是 token 的分支」上（命名体系里有 40 个短名同时是长名前缀的 token）。
@@ -458,6 +458,7 @@ window.__ModuleLoader__.load({
 						"primary": "var(--dsw-static-red-600)",
 						"secondary": "var(--dsw-static-red-400)"
 					},
+					"idle": { "primary": "var(--dsw-static-neutral-300)" },
 					"success": {
 						"primary": "var(--dsw-static-green-500)",
 						"secondary": "var(--dsw-static-green-400)",
@@ -803,6 +804,7 @@ window.__ModuleLoader__.load({
 				"think": { "select": "linear-gradient(180deg, #f5f6f7 20.19%, rgba(245, 246, 247, 0) 100%)" }
 			},
 			"mask": { "blur": "blur(2px)" },
+			"menu": { "backdrop": { "filter": "blur(40px) saturate(150%)" } },
 			"shadow": {
 				"lv1": {
 					"$": "0 2px 4px 0 rgba(0, 0, 0, 0.05)",
@@ -818,7 +820,7 @@ window.__ModuleLoader__.load({
 				},
 				"input": { "major": "var(--dsw-static-neutral-bluish-00)" },
 				"login": { "input": "var(--dsw-static-neutral-bluish-50)" },
-				"menu": "var(--dsw-alias-bg-layer-3)",
+				"menu": "rgba(248, 249, 250, 0.58)",
 				"selector": "var(--dsw-static-neutral-bluish-60)",
 				"sidebar": {
 					"fill": "var(--dsw-static-neutral-bluish-50)",
@@ -859,7 +861,7 @@ window.__ModuleLoader__.load({
 					"100": "rgb(228, 237, 253)",
 					"200": "rgb(211, 226, 255)",
 					"300": "rgb(183, 200, 254)",
-					"400": "rgb(103, 158, 254)",
+					"400": "rgb(122, 170, 255)",
 					"450": "rgb(86, 134, 254)",
 					"500": "rgb(65, 118, 230)",
 					"600": "rgb(72, 104, 178)",
@@ -13240,6 +13242,7 @@ window.__ModuleLoader__.load({
 		const LINE_FRAGMENT = /^L(\d+)(?:C(\d+))?(?:-L(\d+))?$/u;
 		const SCHEME = /^([A-Za-z][A-Za-z0-9+.-]*):/u;
 		const BARE_PATH = /^([^:]+):(\d+)(?::(\d+))?$/u;
+		const MENTION_WHITESPACE = /\s/u;
 		const URI_UNSAFE = /[%#()\s<>"`]/gu;
 		const PATH_PUNCTUATION = [
 			codes.slash,
@@ -13296,6 +13299,10 @@ window.__ModuleLoader__.load({
 		function isLocalReference(reference) {
 			return !EXTERNAL_PROTOCOLS.includes(reference.protocol);
 		}
+		function formatReferenceMention(reference) {
+			const path = reference.path ?? "";
+			return MENTION_WHITESPACE.test(path) ? `@"${path}"` : `@${path}`;
+		}
 		function findReferences(text) {
 			const spans = [];
 			if (text === "" || !TRIGGERS.some((trigger) => text.includes(trigger))) return spans;
@@ -13352,8 +13359,29 @@ window.__ModuleLoader__.load({
 				return headStart(code);
 			}
 			function afterAt(code) {
+				if (code === codes.quotationMark) {
+					effects.consume(code);
+					return quotedPath;
+				}
 				return asciiAlpha(code) ? headStart(code) : pathStart(code);
 			}
+			function quotedPath(code) {
+				if (code === null || markdownLineEnding(code)) return nok(code);
+				effects.consume(code);
+				return code === codes.quotationMark ? afterQuotedPath : quotedPath;
+			}
+			function afterQuotedPath(code) {
+				if (code !== codes.numberSign) return finish(code);
+				effects.consume(code);
+				return fragmentInside;
+			}
+			function fragmentInside(code) {
+				if (isPathCode(code) || code === codes.numberSign) {
+					effects.consume(code);
+					return fragmentInside;
+				}
+				return finish(code);
+			}
 			function headStart(code) {
 				if (!asciiAlpha(code)) return nok(code);
 				head = "";
@@ -13552,6 +13580,7 @@ window.__ModuleLoader__.load({
 		function parseBareReference(raw) {
 			const body = raw.startsWith("@") ? raw.slice(1) : raw;
 			if (body === "") return void 0;
+			if (body.startsWith(QUOTED_PATH)) return parseQuotedReference(body);
 			const scheme = SCHEME.exec(body);
 			if (scheme !== null && isKnownScheme(scheme[1])) return parseReference(body);
 			const matched = BARE_PATH.exec(body);
@@ -13568,6 +13597,21 @@ window.__ModuleLoader__.load({
 				...column === void 0 ? {} : { column: Number(column) }
 			};
 		}
+		/** 引号 mention 的起手字符：`@"path with spaces"`。 */
+		const QUOTED_PATH = "\"";
+		function parseQuotedReference(body) {
+			const end = body.indexOf(QUOTED_PATH, 1);
+			if (end === -1) return void 0;
+			const path = body.slice(1, end);
+			if (path === "") return void 0;
+			const fragment = splitLineFragment(body.slice(end + 1));
+			if (fragment.head !== "") return void 0;
+			return {
+				protocol: DEFAULT_PROTOCOL,
+				path,
+				...fragment.lines
+			};
+		}
 		function referenceFromMarkdown() {
 			return {
 				enter: { reference: enterReference },
@@ -13701,6 +13745,7 @@ window.__ModuleLoader__.load({
 		exports.dsw = dsw;
 		exports.findReferences = findReferences;
 		exports.formatReference = formatReference;
+		exports.formatReferenceMention = formatReferenceMention;
 		exports.inject = inject;
 		exports.isLocalReference = isLocalReference;
 		exports.markdownLabels = markdownLabels;

package/dist/client.d.cts

@@ -1,4 +1,4 @@
-import { a as isLocalReference, i as formatReference, n as ReferenceSpan, o as parseReference, r as findReferences, s as parseReferenceToken, t as Reference } from "./reference-Do8Uwujy.cjs";
+import { a as formatReferenceMention, c as parseReferenceToken, i as formatReference, n as ReferenceSpan, o as isLocalReference, r as findReferences, s as parseReference, t as Reference } from "./reference-BX54bj6_.cjs";
 import { Context } from "@deepseek-ai/cordis";
 import { ComponentProps, ComponentPropsWithRef, ElementType, ForwardRefExoticComponent, Ref, RefAttributes } from "react";
 import { MarkdownFileMentions, MarkdownLabels, MarkdownLabels as MarkdownLabels$1, MarkdownPathImages } from "@deepseek-ai/dsh-client-ui-primitives";
@@ -9414,7 +9414,7 @@ declare function styleOf(component: StyledComponent<ElementType>): CSSProps;
 //#endregion
 //#region src/client/theme.generated.d.ts
 /**
- * 官方主题的 `--dsw-*` token 全集（359 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
+ * 官方主题的 `--dsw-*` token 全集（361 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
  *
  * 叶子是该变量的**默认值**（官方 light 主题里首次出现的定义）：既是类型推导的来源，也可作 fallback。
  * `"$"` 键出现在「自身也是 token 的分支」上（命名体系里有 40 个短名同时是长名前缀的 token）。
@@ -9577,6 +9577,9 @@ declare const designTokens: {
         readonly primary: "var(--dsw-static-red-600)";
         readonly secondary: "var(--dsw-static-red-400)";
       };
+      readonly idle: {
+        readonly primary: "var(--dsw-static-neutral-300)";
+      };
       readonly success: {
         readonly primary: "var(--dsw-static-green-500)";
         readonly secondary: "var(--dsw-static-green-400)";
@@ -10010,6 +10013,11 @@ declare const designTokens: {
   readonly mask: {
     readonly blur: "blur(2px)";
   };
+  readonly menu: {
+    readonly backdrop: {
+      readonly filter: "blur(40px) saturate(150%)";
+    };
+  };
   readonly shadow: {
     readonly lv1: {
       readonly $: "0 2px 4px 0 rgba(0, 0, 0, 0.05)";
@@ -10029,7 +10037,7 @@ declare const designTokens: {
     readonly login: {
       readonly input: "var(--dsw-static-neutral-bluish-50)";
     };
-    readonly menu: "var(--dsw-alias-bg-layer-3)";
+    readonly menu: "rgba(248, 249, 250, 0.58)";
     readonly selector: "var(--dsw-static-neutral-bluish-60)";
     readonly sidebar: {
       readonly fill: "var(--dsw-static-neutral-bluish-50)";
@@ -10072,7 +10080,7 @@ declare const designTokens: {
       readonly "100": "rgb(228, 237, 253)";
       readonly "200": "rgb(211, 226, 255)";
       readonly "300": "rgb(183, 200, 254)";
-      readonly "400": "rgb(103, 158, 254)";
+      readonly "400": "rgb(122, 170, 255)";
       readonly "450": "rgb(86, 134, 254)";
       readonly "500": "rgb(65, 118, 230)";
       readonly "600": "rgb(72, 104, 178)";
@@ -10296,6 +10304,9 @@ declare const dsw: TokenVars<{
         readonly primary: "var(--dsw-static-red-600)";
         readonly secondary: "var(--dsw-static-red-400)";
       };
+      readonly idle: {
+        readonly primary: "var(--dsw-static-neutral-300)";
+      };
       readonly success: {
         readonly primary: "var(--dsw-static-green-500)";
         readonly secondary: "var(--dsw-static-green-400)";
@@ -10729,6 +10740,11 @@ declare const dsw: TokenVars<{
   readonly mask: {
     readonly blur: "blur(2px)";
   };
+  readonly menu: {
+    readonly backdrop: {
+      readonly filter: "blur(40px) saturate(150%)";
+    };
+  };
   readonly shadow: {
     readonly lv1: {
       readonly $: "0 2px 4px 0 rgba(0, 0, 0, 0.05)";
@@ -10748,7 +10764,7 @@ declare const dsw: TokenVars<{
     readonly login: {
       readonly input: "var(--dsw-static-neutral-bluish-50)";
     };
-    readonly menu: "var(--dsw-alias-bg-layer-3)";
+    readonly menu: "rgba(248, 249, 250, 0.58)";
     readonly selector: "var(--dsw-static-neutral-bluish-60)";
     readonly sidebar: {
       readonly fill: "var(--dsw-static-neutral-bluish-50)";
@@ -10791,7 +10807,7 @@ declare const dsw: TokenVars<{
       readonly "100": "rgb(228, 237, 253)";
       readonly "200": "rgb(211, 226, 255)";
       readonly "300": "rgb(183, 200, 254)";
-      readonly "400": "rgb(103, 158, 254)";
+      readonly "400": "rgb(122, 170, 255)";
       readonly "450": "rgb(86, 134, 254)";
       readonly "500": "rgb(65, 118, 230)";
       readonly "600": "rgb(72, 104, 178)";
@@ -10880,4 +10896,4 @@ declare const ReferenceMarkdown: import("react").MemoExoticComponent<({ text, la
 declare const inject: readonly string[];
 declare function apply(_ctx: Context): void;
 //#endregion
-export { type CSSObject, type CSSProps, type CSSSelector, type CSSValue, type CSSVar, type CSSVarRef, MarkdownCopySeat, type Reference, type ReferenceActions, ReferenceMarkdown, type ReferenceMarkdownProps, type ReferenceSpan, type StyledComponent, Styling, Token, type TokenVars, type Tokens, apply, designTokens, dsw, findReferences, formatReference, inject, isLocalReference, markdownLabels, parseReference, parseReferenceToken, referenceMentions, styleOf, styled, styling };
+export { type CSSObject, type CSSProps, type CSSSelector, type CSSValue, type CSSVar, type CSSVarRef, MarkdownCopySeat, type Reference, type ReferenceActions, ReferenceMarkdown, type ReferenceMarkdownProps, type ReferenceSpan, type StyledComponent, Styling, Token, type TokenVars, type Tokens, apply, designTokens, dsw, findReferences, formatReference, formatReferenceMention, inject, isLocalReference, markdownLabels, parseReference, parseReferenceToken, referenceMentions, styleOf, styled, styling };

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { a as isLocalReference, i as formatReference, n as ReferenceSpan, o as parseReference, r as findReferences, s as parseReferenceToken, t as Reference } from "./reference-Do8Uwujy.mjs";
+import { a as formatReferenceMention, c as parseReferenceToken, i as formatReference, n as ReferenceSpan, o as isLocalReference, r as findReferences, s as parseReference, t as Reference } from "./reference-BX54bj6_.mjs";
 import { ComponentProps, ComponentPropsWithRef, ElementType, ForwardRefExoticComponent, Ref, RefAttributes } from "react";
 import { MarkdownFileMentions, MarkdownLabels, MarkdownLabels as MarkdownLabels$1, MarkdownPathImages } from "@deepseek-ai/dsh-client-ui-primitives";
 import { Context } from "@deepseek-ai/cordis";
@@ -9414,7 +9414,7 @@ declare function styleOf(component: StyledComponent<ElementType>): CSSProps;
 //#endregion
 //#region src/client/theme.generated.d.ts
 /**
- * 官方主题的 `--dsw-*` token 全集（359 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
+ * 官方主题的 `--dsw-*` token 全集（361 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
  *
  * 叶子是该变量的**默认值**（官方 light 主题里首次出现的定义）：既是类型推导的来源，也可作 fallback。
  * `"$"` 键出现在「自身也是 token 的分支」上（命名体系里有 40 个短名同时是长名前缀的 token）。
@@ -9577,6 +9577,9 @@ declare const designTokens: {
         readonly primary: "var(--dsw-static-red-600)";
         readonly secondary: "var(--dsw-static-red-400)";
       };
+      readonly idle: {
+        readonly primary: "var(--dsw-static-neutral-300)";
+      };
       readonly success: {
         readonly primary: "var(--dsw-static-green-500)";
         readonly secondary: "var(--dsw-static-green-400)";
@@ -10010,6 +10013,11 @@ declare const designTokens: {
   readonly mask: {
     readonly blur: "blur(2px)";
   };
+  readonly menu: {
+    readonly backdrop: {
+      readonly filter: "blur(40px) saturate(150%)";
+    };
+  };
   readonly shadow: {
     readonly lv1: {
       readonly $: "0 2px 4px 0 rgba(0, 0, 0, 0.05)";
@@ -10029,7 +10037,7 @@ declare const designTokens: {
     readonly login: {
       readonly input: "var(--dsw-static-neutral-bluish-50)";
     };
-    readonly menu: "var(--dsw-alias-bg-layer-3)";
+    readonly menu: "rgba(248, 249, 250, 0.58)";
     readonly selector: "var(--dsw-static-neutral-bluish-60)";
     readonly sidebar: {
       readonly fill: "var(--dsw-static-neutral-bluish-50)";
@@ -10072,7 +10080,7 @@ declare const designTokens: {
       readonly "100": "rgb(228, 237, 253)";
       readonly "200": "rgb(211, 226, 255)";
       readonly "300": "rgb(183, 200, 254)";
-      readonly "400": "rgb(103, 158, 254)";
+      readonly "400": "rgb(122, 170, 255)";
       readonly "450": "rgb(86, 134, 254)";
       readonly "500": "rgb(65, 118, 230)";
       readonly "600": "rgb(72, 104, 178)";
@@ -10296,6 +10304,9 @@ declare const dsw: TokenVars<{
         readonly primary: "var(--dsw-static-red-600)";
         readonly secondary: "var(--dsw-static-red-400)";
       };
+      readonly idle: {
+        readonly primary: "var(--dsw-static-neutral-300)";
+      };
       readonly success: {
         readonly primary: "var(--dsw-static-green-500)";
         readonly secondary: "var(--dsw-static-green-400)";
@@ -10729,6 +10740,11 @@ declare const dsw: TokenVars<{
   readonly mask: {
     readonly blur: "blur(2px)";
   };
+  readonly menu: {
+    readonly backdrop: {
+      readonly filter: "blur(40px) saturate(150%)";
+    };
+  };
   readonly shadow: {
     readonly lv1: {
       readonly $: "0 2px 4px 0 rgba(0, 0, 0, 0.05)";
@@ -10748,7 +10764,7 @@ declare const dsw: TokenVars<{
     readonly login: {
       readonly input: "var(--dsw-static-neutral-bluish-50)";
     };
-    readonly menu: "var(--dsw-alias-bg-layer-3)";
+    readonly menu: "rgba(248, 249, 250, 0.58)";
     readonly selector: "var(--dsw-static-neutral-bluish-60)";
     readonly sidebar: {
       readonly fill: "var(--dsw-static-neutral-bluish-50)";
@@ -10791,7 +10807,7 @@ declare const dsw: TokenVars<{
       readonly "100": "rgb(228, 237, 253)";
       readonly "200": "rgb(211, 226, 255)";
       readonly "300": "rgb(183, 200, 254)";
-      readonly "400": "rgb(103, 158, 254)";
+      readonly "400": "rgb(122, 170, 255)";
       readonly "450": "rgb(86, 134, 254)";
       readonly "500": "rgb(65, 118, 230)";
       readonly "600": "rgb(72, 104, 178)";
@@ -10880,4 +10896,4 @@ declare const ReferenceMarkdown: import("react").MemoExoticComponent<({ text, la
 declare const inject: readonly string[];
 declare function apply(_ctx: Context): void;
 //#endregion
-export { type CSSObject, type CSSProps, type CSSSelector, type CSSValue, type CSSVar, type CSSVarRef, MarkdownCopySeat, type Reference, type ReferenceActions, ReferenceMarkdown, type ReferenceMarkdownProps, type ReferenceSpan, type StyledComponent, Styling, Token, type TokenVars, type Tokens, apply, designTokens, dsw, findReferences, formatReference, inject, isLocalReference, markdownLabels, parseReference, parseReferenceToken, referenceMentions, styleOf, styled, styling };
+export { type CSSObject, type CSSProps, type CSSSelector, type CSSValue, type CSSVar, type CSSVarRef, MarkdownCopySeat, type Reference, type ReferenceActions, ReferenceMarkdown, type ReferenceMarkdownProps, type ReferenceSpan, type StyledComponent, Styling, Token, type TokenVars, type Tokens, apply, designTokens, dsw, findReferences, formatReference, formatReferenceMention, inject, isLocalReference, markdownLabels, parseReference, parseReferenceToken, referenceMentions, styleOf, styled, styling };

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { n as ReferenceSpan, r as findReferences, s as parseReferenceToken, t as Reference } from "./reference-Do8Uwujy.cjs";
+import { c as parseReferenceToken, n as ReferenceSpan, r as findReferences, t as Reference } from "./reference-BX54bj6_.cjs";
 //#region src/index.d.ts
 declare function apply(): void;
 //#endregion

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { n as ReferenceSpan, r as findReferences, s as parseReferenceToken, t as Reference } from "./reference-Do8Uwujy.mjs";
+import { c as parseReferenceToken, n as ReferenceSpan, r as findReferences, t as Reference } from "./reference-BX54bj6_.mjs";
 //#region src/index.d.ts
 declare function apply(): void;
 //#endregion

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as parseReferenceToken, t as findReferences } from "./reference-BLcMVsqa.mjs";
+import { o as parseReferenceToken, t as findReferences } from "./reference-Dxy9uQYz.mjs";
 //#region src/index.ts
 function apply() {}
 //#endregion

package/dist/{reference-Do8Uwujy.d.cts → reference-BX54bj6_.d.cts}

@@ -24,6 +24,7 @@ declare function parseReference(value: string, title?: string): Reference | unde
 declare function parseReferenceToken(value: string): Reference | undefined;
 declare function formatReference(reference: Reference): string;
 declare function isLocalReference(reference: Reference): boolean;
+declare function formatReferenceMention(reference: Reference): string;
 declare function findReferences(text: string): readonly ReferenceSpan[];
 //#endregion
-export { isLocalReference as a, formatReference as i, ReferenceSpan as n, parseReference as o, findReferences as r, parseReferenceToken as s, Reference as t };
+export { formatReferenceMention as a, parseReferenceToken as c, formatReference as i, ReferenceSpan as n, isLocalReference as o, findReferences as r, parseReference as s, Reference as t };

package/dist/{reference-Do8Uwujy.d.mts → reference-BX54bj6_.d.mts}

@@ -24,6 +24,7 @@ declare function parseReference(value: string, title?: string): Reference | unde
 declare function parseReferenceToken(value: string): Reference | undefined;
 declare function formatReference(reference: Reference): string;
 declare function isLocalReference(reference: Reference): boolean;
+declare function formatReferenceMention(reference: Reference): string;
 declare function findReferences(text: string): readonly ReferenceSpan[];
 //#endregion
-export { isLocalReference as a, formatReference as i, ReferenceSpan as n, parseReference as o, findReferences as r, parseReferenceToken as s, Reference as t };
+export { formatReferenceMention as a, parseReferenceToken as c, formatReference as i, ReferenceSpan as n, isLocalReference as o, findReferences as r, parseReference as s, Reference as t };

package/dist/{reference-BLcMVsqa.mjs → reference-Dxy9uQYz.mjs}

@@ -1,6 +1,6 @@
 import { fromMarkdown } from "mdast-util-from-markdown";
 import { gfmFromMarkdown } from "mdast-util-gfm";
-import { asciiAlpha, asciiAlphanumeric, asciiDigit, markdownLineEndingOrSpace, unicodePunctuation, unicodeWhitespace } from "micromark-util-character";
+import { asciiAlpha, asciiAlphanumeric, asciiDigit, markdownLineEnding, markdownLineEndingOrSpace, unicodePunctuation, unicodeWhitespace } from "micromark-util-character";
 import { gfm } from "micromark-extension-gfm";
 import { codes, types } from "micromark-util-symbol";
 //#region src/reference.ts
@@ -13,6 +13,7 @@ const EXTERNAL_PROTOCOLS = [
 const LINE_FRAGMENT = /^L(\d+)(?:C(\d+))?(?:-L(\d+))?$/u;
 const SCHEME = /^([A-Za-z][A-Za-z0-9+.-]*):/u;
 const BARE_PATH = /^([^:]+):(\d+)(?::(\d+))?$/u;
+const MENTION_WHITESPACE = /\s/u;
 const URI_UNSAFE = /[%#()\s<>"`]/gu;
 const PATH_PUNCTUATION = [
 	codes.slash,
@@ -69,6 +70,10 @@ function formatReference(reference) {
 function isLocalReference(reference) {
 	return !EXTERNAL_PROTOCOLS.includes(reference.protocol);
 }
+function formatReferenceMention(reference) {
+	const path = reference.path ?? "";
+	return MENTION_WHITESPACE.test(path) ? `@"${path}"` : `@${path}`;
+}
 function findReferences(text) {
 	const spans = [];
 	if (text === "" || !TRIGGERS.some((trigger) => text.includes(trigger))) return spans;
@@ -125,8 +130,29 @@ const tokenizeReference = function(effects, ok, nok) {
 		return headStart(code);
 	}
 	function afterAt(code) {
+		if (code === codes.quotationMark) {
+			effects.consume(code);
+			return quotedPath;
+		}
 		return asciiAlpha(code) ? headStart(code) : pathStart(code);
 	}
+	function quotedPath(code) {
+		if (code === null || markdownLineEnding(code)) return nok(code);
+		effects.consume(code);
+		return code === codes.quotationMark ? afterQuotedPath : quotedPath;
+	}
+	function afterQuotedPath(code) {
+		if (code !== codes.numberSign) return finish(code);
+		effects.consume(code);
+		return fragmentInside;
+	}
+	function fragmentInside(code) {
+		if (isPathCode(code) || code === codes.numberSign) {
+			effects.consume(code);
+			return fragmentInside;
+		}
+		return finish(code);
+	}
 	function headStart(code) {
 		if (!asciiAlpha(code)) return nok(code);
 		head = "";
@@ -325,6 +351,7 @@ function textOf(node) {
 function parseBareReference(raw) {
 	const body = raw.startsWith("@") ? raw.slice(1) : raw;
 	if (body === "") return void 0;
+	if (body.startsWith(QUOTED_PATH)) return parseQuotedReference(body);
 	const scheme = SCHEME.exec(body);
 	if (scheme !== null && isKnownScheme(scheme[1])) return parseReference(body);
 	const matched = BARE_PATH.exec(body);
@@ -341,6 +368,21 @@ function parseBareReference(raw) {
 		...column === void 0 ? {} : { column: Number(column) }
 	};
 }
+/** 引号 mention 的起手字符：`@"path with spaces"`。 */
+const QUOTED_PATH = "\"";
+function parseQuotedReference(body) {
+	const end = body.indexOf(QUOTED_PATH, 1);
+	if (end === -1) return void 0;
+	const path = body.slice(1, end);
+	if (path === "") return void 0;
+	const fragment = splitLineFragment(body.slice(end + 1));
+	if (fragment.head !== "") return void 0;
+	return {
+		protocol: DEFAULT_PROTOCOL,
+		path,
+		...fragment.lines
+	};
+}
 function referenceFromMarkdown() {
 	return {
 		enter: { reference: enterReference },
@@ -403,4 +445,4 @@ function decodeUri(value) {
 	}
 }
 //#endregion
-export { parseReferenceToken as a, parseReference as i, formatReference as n, isLocalReference as r, findReferences as t };
+export { parseReference as a, isLocalReference as i, formatReference as n, parseReferenceToken as o, formatReferenceMention as r, findReferences as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-client-ui-primitives",
-  "version": "0.0.2-alpha.4",
+  "version": "0.0.2-alpha.6",
   "description": "css-in-js styling kit (styled / Token / Styling) for the forked conversation UI: consumes the official --dsw-* design tokens, so no CSS Modules precompile step is needed.",
   "keywords": [
     "client",
@@ -40,7 +40,7 @@
     "micromark-util-types": "^2.0.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.1",
     "@types/mdast": "^4.0.4",
     "@types/react": "~18.3.1",
     "csstype": "^3.1.3",
@@ -48,7 +48,7 @@
     "react-dom": "^18.2.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "4.0.2"
+    "@deepseek-ai/cordis": "4.0.3"
   },
   "dsh": {
     "client": {

package/src/client/index.ts

@@ -7,6 +7,7 @@ export * from "./markdown-labels.ts";
 export {
   findReferences,
   formatReference,
+  formatReferenceMention,
   isLocalReference,
   parseReference,
   parseReferenceToken,

package/src/client/theme.generated.ts

@@ -1,5 +1,5 @@
 /**
- * 官方主题的 `--dsw-*` token 全集（359 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
+ * 官方主题的 `--dsw-*` token 全集（361 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
  *
  * 叶子是该变量的**默认值**（官方 light 主题里首次出现的定义）：既是类型推导的来源，也可作 fallback。
  * `"$"` 键出现在「自身也是 token 的分支」上（命名体系里有 40 个短名同时是长名前缀的 token）。
@@ -162,6 +162,9 @@ export const designTokens = {
               "primary": "var(--dsw-static-red-600)",
               "secondary": "var(--dsw-static-red-400)",
           },
+          "idle": {
+              "primary": "var(--dsw-static-neutral-300)",
+          },
           "success": {
               "primary": "var(--dsw-static-green-500)",
               "secondary": "var(--dsw-static-green-400)",
@@ -595,6 +598,11 @@ export const designTokens = {
   "mask": {
       "blur": "blur(2px)",
   },
+  "menu": {
+      "backdrop": {
+          "filter": "blur(40px) saturate(150%)",
+      },
+  },
   "shadow": {
       "lv1": {
           "$": "0 2px 4px 0 rgba(0, 0, 0, 0.05)",
@@ -614,7 +622,7 @@ export const designTokens = {
       "login": {
           "input": "var(--dsw-static-neutral-bluish-50)",
       },
-      "menu": "var(--dsw-alias-bg-layer-3)",
+      "menu": "rgba(248, 249, 250, 0.58)",
       "selector": "var(--dsw-static-neutral-bluish-60)",
       "sidebar": {
           "fill": "var(--dsw-static-neutral-bluish-50)",
@@ -657,7 +665,7 @@ export const designTokens = {
           "100": "rgb(228, 237, 253)",
           "200": "rgb(211, 226, 255)",
           "300": "rgb(183, 200, 254)",
-          "400": "rgb(103, 158, 254)",
+          "400": "rgb(122, 170, 255)",
           "450": "rgb(86, 134, 254)",
           "500": "rgb(65, 118, 230)",
           "600": "rgb(72, 104, 178)",

package/src/reference.ts

@@ -10,6 +10,7 @@ import {
   asciiAlpha,
   asciiAlphanumeric,
   asciiDigit,
+  markdownLineEnding,
   markdownLineEndingOrSpace,
   unicodePunctuation,
   unicodeWhitespace,
@@ -62,6 +63,8 @@ const SCHEME = /^([A-Za-z][A-Za-z0-9+.-]*):/u;
 
 const BARE_PATH = /^([^:]+):(\d+)(?::(\d+))?$/u;
 
+const MENTION_WHITESPACE = /\s/u;
+
 const URI_UNSAFE = /[%#()\s<>"`]/gu;
 
 const PATH_PUNCTUATION: readonly Code[] = [
@@ -127,6 +130,13 @@ export function isLocalReference(reference: Reference): boolean {
   return !EXTERNAL_PROTOCOLS.includes(reference.protocol);
 }
 
+// 引用在提示文本里的 mention 形态：`@` 接路径，路径含空白时用引号包住。
+// 谁产出的都走这一个函数归一——消息里是这一形态与「产生方是谁」无关。
+export function formatReferenceMention(reference: Reference): string {
+  const path = reference.path ?? "";
+  return MENTION_WHITESPACE.test(path) ? `@"${path}"` : `@${path}`;
+}
+
 export function findReferences(text: string): readonly ReferenceSpan[] {
   const spans: ReferenceSpan[] = [];
   if (text === "" || !TRIGGERS.some((trigger) => text.includes(trigger))) return spans;
@@ -210,9 +220,34 @@ const tokenizeReference: Tokenizer = function (effects, ok, nok) {
   }
 
   function afterAt(code: Code): State | undefined {
+    if (code === codes.quotationMark) {
+      effects.consume(code);
+      return quotedPath;
+    }
     return asciiAlpha(code) ? headStart(code) : pathStart(code);
   }
 
+  // `@"path with spaces"`：引号内的空格是路径的一部分，换行与未闭合都让整个形态退回普通文本。
+  function quotedPath(code: Code): State | undefined {
+    if (code === null || markdownLineEnding(code)) return nok(code);
+    effects.consume(code);
+    return code === codes.quotationMark ? afterQuotedPath : quotedPath;
+  }
+
+  function afterQuotedPath(code: Code): State | undefined {
+    if (code !== codes.numberSign) return finish(code);
+    effects.consume(code);
+    return fragmentInside;
+  }
+
+  function fragmentInside(code: Code): State | undefined {
+    if (isPathCode(code) || code === codes.numberSign) {
+      effects.consume(code);
+      return fragmentInside;
+    }
+    return finish(code);
+  }
+
   function headStart(code: Code): State | undefined {
     if (!asciiAlpha(code)) return nok(code);
     head = "";
@@ -469,6 +504,7 @@ function textOf(node: MarkdownNode): string {
 function parseBareReference(raw: string): Reference | undefined {
   const body = raw.startsWith("@") ? raw.slice(1) : raw;
   if (body === "") return undefined;
+  if (body.startsWith(QUOTED_PATH)) return parseQuotedReference(body);
   const scheme = SCHEME.exec(body);
   if (scheme !== null && isKnownScheme(scheme[1] as string)) return parseReference(body);
   const matched = BARE_PATH.exec(body);
@@ -486,6 +522,20 @@ function parseBareReference(raw: string): Reference | undefined {
   };
 }
 
+/** 引号 mention 的起手字符：`@"path with spaces"`。 */
+const QUOTED_PATH = '"';
+
+function parseQuotedReference(body: string): Reference | undefined {
+  const end = body.indexOf(QUOTED_PATH, 1);
+  if (end === -1) return undefined;
+  const path = body.slice(1, end);
+  if (path === "") return undefined;
+  // 闭合引号之后只允许行号 fragment（`@"a b.ts"#L12-L40`）；其它尾巴说明这不是一个引号引用。
+  const fragment = splitLineFragment(body.slice(end + 1));
+  if (fragment.head !== "") return undefined;
+  return { protocol: DEFAULT_PROTOCOL, path, ...fragment.lines };
+}
+
 export function referenceFromMarkdown(): MdastExtension {
   return {
     enter: { reference: enterReference },