@qilin-agent/client-ui-sidebar-documentpreview 3.1.5 → 3.1.6

package/lib/client.js

@@ -2098,6 +2098,23 @@ window.__ModuleLoader__.load({
 			}, VideoBody)));
 		}
 		//#endregion
+		//#region lib/types/client/markdown/frontmatter.js
+		/** Leading YAML frontmatter split from a Markdown document before Markdown parsing. */
+		const FRONTMATTER = /^\uFEFF?---[ \t]*\r?\n(?:([\s\S]*?)\r?\n)??(?:---|\.\.\.)[ \t]*(?:\r?\n|$)/u;
+		/**
+		* Split a leading YAML frontmatter block from Markdown text without parsing its YAML.
+		* @param text - Markdown source; an unterminated block is not frontmatter.
+		* @returns frontmatter source and the remaining body, or `undefined` when the text has none.
+		*/
+		function splitFrontmatter(text) {
+			const match = FRONTMATTER.exec(text);
+			if (match === null) return void 0;
+			return {
+				source: match[1] ?? "",
+				body: text.slice(match[0].length)
+			};
+		}
+		//#endregion
 		//#region lib/types/client/markdown/path-images.js
 		/** Local Markdown image destinations served by the authenticated file route. */
 		/**
@@ -4381,7 +4398,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-sidebar-documentpreview/src/client/markdown/MarkdownBody.module.css.mjs
-		const css$7 = ".zbylqG_document{min-width:0;font-family:var(--qilin-font,inherit);white-space:normal;padding:10px 12px}.zbylqG_htmlBlock{min-width:0;font-family:inherit;overflow-x:auto}";
+		const css$7 = ".zbylqG_document{min-width:0;font-family:var(--qilin-font,inherit);white-space:normal;padding:10px 12px}.zbylqG_htmlBlock{min-width:0;font-family:inherit;overflow-x:auto}.zbylqG_frontmatter{border:.5px solid var(--qilin-alias-border-l2);border-radius:var(--qilin-radius-md);background:var(--qilin-alias-bg-layer-1);font:var(--qilin-font-markdown-small);color:var(--qilin-alias-label-primary);white-space:pre-wrap;overflow-wrap:anywhere;margin:0 0 16px;padding:10px 12px}.zbylqG_frontmatter:empty{display:none}.zbylqG_frontmatterSource{font-family:var(--ds-font-family-code);white-space:inherit;margin:0}";
 		const tagId$7 = "@qilin-agent/client-ui-sidebar-documentpreview/MarkdownBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$7) + "]") === null) {
 			const tag = document.createElement("style");
@@ -4392,13 +4409,22 @@ window.__ModuleLoader__.load({
 		}
 		var MarkdownBody_module_css_default = {
 			"document": "zbylqG_document",
+			"frontmatter": "zbylqG_frontmatter",
+			"frontmatterSource": "zbylqG_frontmatterSource",
 			"htmlBlock": "zbylqG_htmlBlock"
 		};
 		//#endregion
 		//#region lib/types/client/markdown/MarkdownBody.js
 		/** One retained Markdown renderer over the document owner's accumulated text. */
+		/** Show the verbatim frontmatter when the field-list chunk cannot load. */
+		function FrontmatterFallback({ fallback }) {
+			return fallback;
+		}
+		const FrontmatterFields = (0, react.lazy)(() => require.async("./client.frontmatter-fields.js").then((module) => ({ default: module.FrontmatterFields }), () => ({ default: FrontmatterFallback })));
 		/**
 		* Render one accumulated document; EOF completes the primitive's full parse.
+		* A leading YAML frontmatter block renders as a field list instead of Markdown; its
+		* verbatim source stands in while the field-list chunk loads or when it fails.
 		* @param props - owner-loaded contents and localized primitive labels.
 		* @returns Markdown content, or nothing for a non-text delivery.
 		*/
@@ -4436,16 +4462,40 @@ window.__ModuleLoader__.load({
 					dangerouslySetInnerHTML: { __html: markup }
 				});
 			}, [absolutePath]);
+			const text = content.kind === "text" ? content.text : "";
+			const split = (0, react.useMemo)(() => splitFrontmatter(text), [text]);
 			if (content.kind !== "text") return null;
-			return (0, react_jsx_runtime.jsx)("div", {
+			return (0, react_jsx_runtime.jsxs)("div", {
 				className: MarkdownBody_module_css_default.document,
 				"data-document-markdown": true,
-				children: (0, react_jsx_runtime.jsx)(_qilin_agent_client_ui_primitives.MarkdownText, {
-					text: content.text,
+				children: [split === void 0 ? null : (0, react_jsx_runtime.jsx)(FrontmatterBox, { source: split.source }), (0, react_jsx_runtime.jsx)(_qilin_agent_client_ui_primitives.MarkdownText, {
+					text: split?.body ?? text,
 					streaming: !content.eof,
 					labels,
 					pathImages,
 					html
+				})]
+			});
+		}
+		/**
+		* Frame one frontmatter block and choose its field list or verbatim source.
+		* @param props - YAML between the frontmatter delimiters.
+		* @returns the metadata box; it collapses when the document has no content.
+		*/
+		function FrontmatterBox({ source }) {
+			const verbatim = (0, react_jsx_runtime.jsx)("pre", {
+				className: MarkdownBody_module_css_default.frontmatterSource,
+				children: source
+			});
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: MarkdownBody_module_css_default.frontmatter,
+				"data-document-frontmatter": true,
+				children: (0, react_jsx_runtime.jsx)(react.Suspense, {
+					fallback: verbatim,
+					children: (0, react_jsx_runtime.jsx)(FrontmatterFields, {
+						source,
+						fallback: verbatim
+					})
 				})
 			});
 		}

package/lib/types/client/markdown/MarkdownBody.d.ts

@@ -5,6 +5,8 @@ import type { DocumentPreviewProps } from '../document/contract.ts';
 export type MarkdownBodyProps = DocumentPreviewProps & PropsLocale<'documentMarkdown'>;
 /**
  * Render one accumulated document; EOF completes the primitive's full parse.
+ * A leading YAML frontmatter block renders as a field list instead of Markdown; its
+ * verbatim source stands in while the field-list chunk loads or when it fails.
  * @param props - owner-loaded contents and localized primitive labels.
  * @returns Markdown content, or nothing for a non-text delivery.
  */

package/lib/types/client/markdown/frontmatter-fields.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Field list for a Markdown document's leading YAML frontmatter. The Markdown
+ * body loads this module lazily so the YAML parser stays out of the startup
+ * chunk.
+ */
+import { type ReactNode } from 'react';
+/** Owner inputs for the lazily loaded field list. */
+export interface FrontmatterFieldsProps {
+    /** YAML between the frontmatter delimiters. */
+    source: string;
+    /** Verbatim block shown for invalid YAML and non-mapping documents. */
+    fallback: ReactNode;
+}
+/**
+ * Render frontmatter fields, or the owner's verbatim block when the YAML is not a mapping.
+ * @param props - frontmatter source and its verbatim fallback.
+ * @returns the field list, the fallback, or nothing for a document without content.
+ */
+export declare function FrontmatterFields({ source, fallback }: FrontmatterFieldsProps): ReactNode;
+//# sourceMappingURL=frontmatter-fields.d.ts.map

package/lib/types/client/markdown/frontmatter.d.ts

@@ -0,0 +1,13 @@
+/** Leading YAML frontmatter split from a Markdown document before Markdown parsing. */
+/** Frontmatter source between its delimiters and the Markdown body after the closing delimiter. */
+export interface FrontmatterSplit {
+    source: string;
+    body: string;
+}
+/**
+ * Split a leading YAML frontmatter block from Markdown text without parsing its YAML.
+ * @param text - Markdown source; an unterminated block is not frontmatter.
+ * @returns frontmatter source and the remaining body, or `undefined` when the text has none.
+ */
+export declare function splitFrontmatter(text: string): FrontmatterSplit | undefined;
+//# sourceMappingURL=frontmatter.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-sidebar-documentpreview",
   "description": "Extensible document previews for Sidebar files: Office, Markdown, highlighted code, images, PDF, HTML, and plain text",
-  "version": "3.1.5",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -46,7 +46,7 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
     "@fortune-sheet/core": "1.0.4",
@@ -65,27 +65,28 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
-    "@qilin-agent/api-gateway": "3.1.5",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/api-remotes": "3.1.5",
-    "@qilin-agent/client-connection": "3.1.5",
-    "@qilin-agent/api-workspace-files": "3.1.5",
-    "@qilin-agent/client-locale": "3.1.5",
-    "@qilin-agent/client-resources": "3.1.5",
-    "@qilin-agent/client-store": "3.1.5",
-    "@qilin-agent/client-ui-conversation": "3.1.5",
-    "@qilin-agent/client-ui-primitives": "3.1.5",
-    "@qilin-agent/client-ui-dockkit": "3.1.5",
-    "@qilin-agent/client-test-runtime": "3.1.5",
-    "@qilin-agent/client-ui-renderer": "3.1.5",
-    "@qilin-agent/client-ui-session": "3.1.5",
-    "@qilin-agent/client-ui-settings": "3.1.5",
-    "@qilin-agent/client-ui-sidebar-right": "3.1.5",
-    "@qilin-agent/client-ui-slots": "3.1.5",
-    "@qilin-agent/host-webserver": "3.1.5",
-    "@qilin-agent/session": "3.1.5",
-    "@qilin-agent/util-workspace-path": "3.1.5",
-    "@qilin-agent/office-to-pdf": "3.1.5"
+    "yaml": "^2.9.0",
+    "@qilin-agent/api-gateway": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/api-workspace-files": "3.1.6",
+    "@qilin-agent/client-connection": "3.1.6",
+    "@qilin-agent/api-remotes": "3.1.6",
+    "@qilin-agent/client-locale": "3.1.6",
+    "@qilin-agent/client-store": "3.1.6",
+    "@qilin-agent/client-resources": "3.1.6",
+    "@qilin-agent/client-test-runtime": "3.1.6",
+    "@qilin-agent/client-ui-dockkit": "3.1.6",
+    "@qilin-agent/client-ui-conversation": "3.1.6",
+    "@qilin-agent/client-ui-primitives": "3.1.6",
+    "@qilin-agent/client-ui-renderer": "3.1.6",
+    "@qilin-agent/client-ui-settings": "3.1.6",
+    "@qilin-agent/client-ui-sidebar-right": "3.1.6",
+    "@qilin-agent/session": "3.1.6",
+    "@qilin-agent/host-webserver": "3.1.6",
+    "@qilin-agent/util-workspace-path": "3.1.6",
+    "@qilin-agent/client-ui-session": "3.1.6",
+    "@qilin-agent/office-to-pdf": "3.1.6",
+    "@qilin-agent/client-ui-slots": "3.1.6"
   },
   "files": [
     "lib/index.js",
@@ -94,7 +95,7 @@
     "lib/types/**/*.d.ts"
   ],
   "dependencies": {
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.5"
   },
   "scripts": {
     "bundle": "tsdown",