@deepseek-ai/dsh-client-ui-sidebar-documentpreview 0.2.0-rc.1 → 0.2.1-alpha.1

package/lib/client.js

@@ -1506,6 +1506,23 @@ window.__ModuleLoader__.load({
 		*/
 		const documentTabInfoFactory = (_standard, useTabInfo) => useTabInfo;
 		//#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. */
 		/**
@@ -1533,7 +1550,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/markdown/MarkdownBody.module.css.mjs
-		const css$7 = "._0RKuNG_document{min-width:0;font-family:var(--dsw-font,inherit);white-space:normal;padding:10px 12px}";
+		const css$7 = "._0RKuNG_document{min-width:0;font-family:var(--dsw-font,inherit);white-space:normal;padding:10px 12px}._0RKuNG_frontmatter{border:.5px solid var(--dsw-alias-border-l2);border-radius:var(--dsw-radius-md);background:var(--dsw-alias-bg-layer-1);font:var(--dsw-font-markdown-small);color:var(--dsw-alias-label-primary);white-space:pre-wrap;overflow-wrap:anywhere;margin:0 0 16px;padding:10px 12px}._0RKuNG_frontmatter:empty{display:none}._0RKuNG_frontmatterSource{font-family:var(--ds-font-family-code);white-space:inherit;margin:0}";
 		const tagId$7 = "@deepseek-ai/dsh-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");
@@ -1542,12 +1559,23 @@ window.__ModuleLoader__.load({
 			tag.textContent = css$7;
 			document.head.appendChild(tag);
 		}
-		var MarkdownBody_module_css_default = { "document": "_0RKuNG_document" };
+		var MarkdownBody_module_css_default = {
+			"document": "_0RKuNG_document",
+			"frontmatter": "_0RKuNG_frontmatter",
+			"frontmatterSource": "_0RKuNG_frontmatterSource"
+		};
 		//#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.
 		*/
@@ -1579,15 +1607,39 @@ window.__ModuleLoader__.load({
 				wrapLabel,
 				unwrapLabel
 			]);
+			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)(_deepseek_ai_dsh_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)(_deepseek_ai_dsh_client_ui_primitives.MarkdownText, {
+					text: split?.body ?? text,
 					streaming: !content.eof,
 					labels,
 					pathImages
+				})]
+			});
+		}
+		/**
+		* 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": "@deepseek-ai/dsh-client-ui-sidebar-documentpreview",
   "description": "Extensible Sidebar previews for Office documents, spreadsheets, Markdown, code, images, PDF, HTML, and plain text",
-  "version": "0.2.0-rc.1",
+  "version": "0.2.1-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -42,7 +42,7 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
   },
   "devDependencies": {
     "@fortune-sheet/core": "1.0.4",
@@ -61,26 +61,27 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-gateway": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-api-workspace-files": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-resources": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-test-runtime": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-dockkit": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-office-to-pdf": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-util-workspace-path": "0.2.0-rc.1"
+    "yaml": "^2.9.0",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-api-gateway": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-api-workspace-files": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-resources": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-dockkit": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-office-to-pdf": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.1"
   },
   "files": [
     "lib/index.js",
@@ -89,7 +90,7 @@
     "lib/types/**/*.d.ts"
   ],
   "dependencies": {
-    "@deepseek-ai/schemastery": "~3.18.4"
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   },
   "scripts": {
     "bundle": "tsdown",