@brett_lamy/docstream 1.8.0 → 1.9.1

package/dist/playground/ReactCodePreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactCodePreview.d.ts","sourceRoot":"","sources":["../../src/playground/ReactCodePreview.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAExF,OAAO,EAKL,KAAK,eAAe,EAEpB,KAAK,0BAA0B,EAChC,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,cAAc;IAC7B,uGAAuG;IACvG,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oGAAoG;IACpG,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,CAAA;IAC1B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,8GAA8G;IAC9G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAA;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAA;AAElD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAA;AA0BlE,MAAM,WAAW,uBAAuB;IACtC,mGAAmG;IACnG,KAAK,EAAE,eAAe,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAA;IACX,gBAAgB,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAA;IACtD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,CAAA;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,IAAW,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,uBAAuB,GAAG,qBAAqB,CAiEnJ;AAKD,wBAAgB,SAAS,CAAC,EACxB,KAAgB,EAChB,OAAO,EACP,IAAI,EAAE,QAAQ,EACd,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAuB,EACvB,IAAW,EACX,MAAY,EACZ,QAAQ,EACR,kBAAsB,EACtB,iBAAsB,EACtB,KAA4B,EAC5B,SAAgB,EAChB,OAAoE,EACpE,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,OAAO,GACR,EAAE,cAAc,+BAsEhB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,+BAE5D"}
+{"version":3,"file":"ReactCodePreview.d.ts","sourceRoot":"","sources":["../../src/playground/ReactCodePreview.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAExF,OAAO,EAKL,KAAK,eAAe,EAEpB,KAAK,0BAA0B,EAChC,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,cAAc;IAC7B,uGAAuG;IACvG,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oGAAoG;IACpG,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,CAAA;IAC1B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,8GAA8G;IAC9G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAA;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAA;AAElD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAA;AA0BlE,MAAM,WAAW,uBAAuB;IACtC,mGAAmG;IACnG,KAAK,EAAE,eAAe,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAA;IACX,gBAAgB,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAA;IACtD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,CAAA;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,IAAW,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,uBAAuB,GAAG,qBAAqB,CAyEnJ;AAKD,wBAAgB,SAAS,CAAC,EACxB,KAAgB,EAChB,OAAO,EACP,IAAI,EAAE,QAAQ,EACd,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAuB,EACvB,IAAW,EACX,MAAY,EACZ,QAAQ,EACR,kBAAsB,EACtB,iBAAsB,EACtB,KAA4B,EAC5B,SAAgB,EAChB,OAAoE,EACpE,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,OAAO,GACR,EAAE,cAAc,+BAsEhB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,+BAE5D"}

package/dist/playground/ReactCodePreview.js

@@ -48,6 +48,13 @@ export function useAlmostNodeServer({ files, port = 4173, run, workspaceOptions,
                         workspaceOptions?.onServerReady?.(serverPort, serverUrl);
                     },
                 });
+                // The iframe's virtual URL only works once the host page is controlled. Do not
+                // reload the host when a reader opens its first live example.
+                await workspace.container.serverBridge.ensureServiceWorkerReady({ reloadOnFirstControl: false });
+                if (cancelled) {
+                    workspace.dispose();
+                    return;
+                }
                 const result = await workspace.container.run(`vite --port ${port}`, {
                     env: DETACHED_SERVER_ENV,
                 });

package/dist/playground/ReactCodePreview.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactCodePreview.js","sourceRoot":"","sources":["../../src/playground/ReactCodePreview.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReactCodePreview.js","sourceRoot":"","sources":["../../src/playground/ReactCodePreview.tsx"],"names":[],"mappings":"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"}

package/dist/streamdown.d.ts

@@ -15,5 +15,5 @@ export interface GitbookStreamdownProps extends DocRenderOptions {
     isStreaming?: boolean;
     markdown?: string;
 }
-export declare function GitbookStreamdown({ children, className, isAnimating, isStreaming, markdown, liveRenderer, sourceRenderer, demoResolver, demoRuntime, demoDependencies, demoVFS, pageActions, }: GitbookStreamdownProps): import("react").JSX.Element;
+export declare function GitbookStreamdown({ children, className, isAnimating, isStreaming, markdown, liveRenderer, sourceRenderer, demoResolver, demoRuntime, demoDependencies, demoVFS, pageActions, documentProperties, onTaskStateChange, }: GitbookStreamdownProps): import("react").JSX.Element;
 //# sourceMappingURL=streamdown.d.ts.map

package/dist/streamdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamdown.d.ts","sourceRoot":"","sources":["../src/streamdown.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAKjI,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACnG,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACtG,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAA;AACtH,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAE1G,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,cAAc,CAAC,EAAE,uBAAuB,CAAA;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,WAAW,GACZ,EAAE,sBAAsB,+BA2BxB"}
+{"version":3,"file":"streamdown.d.ts","sourceRoot":"","sources":["../src/streamdown.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAKjI,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACnG,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACtG,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAA;AACtH,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAE1G,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,cAAc,CAAC,EAAE,uBAAuB,CAAA;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,iBAAiB,GAClB,EAAE,sBAAsB,+BA6BxB"}

package/dist/streamdown.js

@@ -7,9 +7,9 @@ import { parseMarkdown, trimPartialInlineToken } from "./gitbook/parse.js";
 export { CitationSources, DocstreamRefContext, InlineReference } from "./docs/reference.js";
 export { DocPageActions } from "./docs/PageActions.js";
 export { DocstreamDemoContext, DocstreamDemoRuntimeContext, DemoFullscreen, DemoViewer } from "./demo/index.js";
-export function GitbookStreamdown({ children, className, isAnimating, isStreaming = false, markdown, liveRenderer, sourceRenderer, demoResolver, demoRuntime, demoDependencies, demoVFS, pageActions, }) {
+export function GitbookStreamdown({ children, className, isAnimating, isStreaming = false, markdown, liveRenderer, sourceRenderer, demoResolver, demoRuntime, demoDependencies, demoVFS, pageActions, documentProperties, onTaskStateChange, }) {
     const content = markdown ?? children ?? "";
     const gitbookDoc = useMemo(() => parseMarkdown(isStreaming ? trimPartialInlineToken(content) : content), [content, isStreaming]);
-    return (_jsx("div", { "aria-busy": isAnimating ?? isStreaming, className: className, "data-docstream": "", "data-streaming": isStreaming ? "" : undefined, children: _jsx(DocsRenderer, { doc: gitbookDoc, markdown: content, liveRenderer: liveRenderer, sourceRenderer: sourceRenderer, demoResolver: demoResolver, demoRuntime: demoRuntime, demoDependencies: demoDependencies, demoVFS: demoVFS, pageActions: isStreaming ? false : pageActions }) }));
+    return (_jsx("div", { "aria-busy": isAnimating ?? isStreaming, className: className, "data-docstream": "", "data-streaming": isStreaming ? "" : undefined, children: _jsx(DocsRenderer, { doc: gitbookDoc, markdown: content, liveRenderer: liveRenderer, sourceRenderer: sourceRenderer, demoResolver: demoResolver, demoRuntime: demoRuntime, demoDependencies: demoDependencies, demoVFS: demoVFS, pageActions: isStreaming ? false : pageActions, documentProperties: documentProperties, onTaskStateChange: onTaskStateChange }) }));
 }
 //# sourceMappingURL=streamdown.js.map

package/dist/streamdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"streamdown.js","sourceRoot":"","sources":["../src/streamdown.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAiF,MAAM,qBAAqB,CAAA;AACjI,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAEvE,uEAAuE;AACvE,yDAAyD;AACzD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AActG,MAAM,UAAU,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,GAAG,KAAK,EACnB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,WAAW,GACY;IACvB,MAAM,OAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,EAAE,CAAA;IAC1C,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAC5E,CAAC,OAAO,EAAE,WAAW,CAAC,CACvB,CAAA;IAED,OAAO,CACL,2BACa,WAAW,IAAI,WAAW,EACrC,SAAS,EAAE,SAAS,oBACL,EAAE,oBACD,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,YAE5C,KAAC,YAAY,IACX,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,gBAAgB,EAClC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAC9C,GACE,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"streamdown.js","sourceRoot":"","sources":["../src/streamdown.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAiF,MAAM,qBAAqB,CAAA;AACjI,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAEvE,uEAAuE;AACvE,yDAAyD;AACzD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AActG,MAAM,UAAU,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,GAAG,KAAK,EACnB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,iBAAiB,GACM;IACvB,MAAM,OAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,EAAE,CAAA;IAC1C,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAC5E,CAAC,OAAO,EAAE,WAAW,CAAC,CACvB,CAAA;IAED,OAAO,CACL,2BACa,WAAW,IAAI,WAAW,EACrC,SAAS,EAAE,SAAS,oBACL,EAAE,oBACD,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,YAE5C,KAAC,YAAY,IACX,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,gBAAgB,EAClC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAC9C,kBAAkB,EAAE,kBAAkB,EACtC,iBAAiB,EAAE,iBAAiB,GACpC,GACE,CACP,CAAA;AACH,CAAC"}

package/dist/styles.css

@@ -1,3 +1,5 @@
+@import "./docs/properties.css";
+@import "./docs/tasks.css";
 
 [data-docstream],
 .docs-article {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brett_lamy/docstream",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "description": "GitBook-aware readonly markdown and AI stream renderer.",
   "publishConfig": {
     "access": "public"
@@ -38,6 +38,20 @@
       "import": "./dist/gitbook/index.js",
       "default": "./dist/gitbook/index.js"
     },
+    "./properties": {
+      "source": "./src/docs/DocumentProperties.tsx",
+      "types": "./dist/docs/DocumentProperties.d.ts",
+      "import": "./dist/docs/DocumentProperties.js",
+      "default": "./dist/docs/DocumentProperties.js"
+    },
+    "./properties/styles.css": "./dist/docs/properties.css",
+    "./tasks": {
+      "source": "./src/docs/TaskCheckbox.tsx",
+      "types": "./dist/docs/TaskCheckbox.d.ts",
+      "import": "./dist/docs/TaskCheckbox.js",
+      "default": "./dist/docs/TaskCheckbox.js"
+    },
+    "./tasks/styles.css": "./dist/docs/tasks.css",
     "./streamdown": {
       "source": "./src/streamdown.tsx",
       "types": "./dist/streamdown.d.ts",

package/src/demo/DemoViewer.tsx

@@ -35,7 +35,7 @@ import { CollapsibleCode } from "../docs/CollapsibleCode"
 import { HighlightedCode } from "../docs/HighlightedCode"
 import { CopyButton } from "../docs/copy"
 import { PillTabs, Segmented, rovingKeyDown } from "../docs/controls"
-import { useDemoResolver, useDemoRuntime } from "./context"
+import { DocstreamDemoContext, useDemoResolver, useDemoRuntime } from "./context"
 import { createDocstreamClipboard, type DemoSourceSnapshot, type DocstreamClipboard } from "./clipboard"
 import { CopyDemoButton } from "./copy-demo"
 import { PathBreadcrumb } from "./PathBreadcrumb"
@@ -1046,7 +1046,9 @@ export function DemoFullscreen({ src, resolver: override, variant, className, st
   if (!resolver) return <DemoError message={`No demo resolver for ${src}`} />
   return (
     <div className={className ? `docs-demo-fullscreen ${className}` : "docs-demo-fullscreen"} style={style} data-demo-src={src}>
-      <DemoCanvas src={src} preview={{ kind: "component", component }} variant={chosen} bleed={metaValue?.bleed} look={metaValue} />
+      <DocstreamDemoContext.Provider value={resolver}>
+        <DemoCanvas src={src} preview={{ kind: "component", component }} variant={chosen} bleed={metaValue?.bleed} look={metaValue} />
+      </DocstreamDemoContext.Provider>
     </div>
   )
 }

package/src/docs/DocsRenderer.tsx

@@ -31,6 +31,10 @@ import { OpenApiOperation } from "../openapi/OpenApiOperation"
 import { Mermaid } from "./Mermaid"
 import { HighlightedCode } from "./HighlightedCode"
 import { CitationSources, InlineReference } from "./reference"
+import { DocumentProperties } from "./DocumentProperties"
+import { TaskCheckbox, TaskStateChangeContext, type TaskStateChangeHandler } from "./TaskCheckbox"
+import { getTaskState } from "../gitbook/tasks"
+import { plainText } from "../gitbook/inline"
 
 type MathRenderer = (formula: string) => string
 let mathRenderer: MathRenderer | null = null
@@ -312,6 +316,7 @@ function Tabs({ block, liveRenderer, sourceRenderer }: { block: Extract<Block, {
 }
 
 function BlockView({ block, liveRenderer, sourceRenderer }: { block: Block } & Renderers) {
+  const onTaskStateChange = useContext(TaskStateChangeContext)
   switch (block.type) {
     case "paragraph":
       return (
@@ -476,8 +481,9 @@ function BlockView({ block, liveRenderer, sourceRenderer }: { block: Block } & R
       return (
         <Tag className={block.task ? "docs-tasklist" : undefined}>
           {block.items.map((item, i) => (
-            <li key={i}>
-              {block.task && <input type="checkbox" checked={!!item.checked} readOnly />}
+            <li key={i} data-task-state={block.task ? getTaskState(item) : undefined}>
+              {block.task && <TaskCheckbox state={getTaskState(item)} label={item.children.filter((b) => b.type === "paragraph").map((b) => b.type === "paragraph" ? plainText(b.children) : "").join(" ") || "Task"}
+                onChange={onTaskStateChange ? (state) => onTaskStateChange(item, state) : undefined} />}
               <Blocks blocks={item.children} inline liveRenderer={liveRenderer} sourceRenderer={sourceRenderer} />
             </li>
           ))}
@@ -582,6 +588,10 @@ function Blocks({ blocks, inline, liveRenderer, sourceRenderer }: { blocks: Bloc
 }
 
 export interface DocRenderOptions {
+  /** Make rendered task checkboxes interactive. Update the supplied item and re-render to persist a choice. */
+  onTaskStateChange?: TaskStateChangeHandler
+  /** Show the document's frontmatter as a property sheet (default true). */
+  documentProperties?: boolean | { defaultOpen?: boolean }
   /** Resolves `{% demo %}` blocks. Provided through context, so nested renderers inherit it. */
   demoResolver?: DemoResolver
   /**
@@ -605,8 +615,9 @@ export interface DocRenderOptions {
   pageActions?: boolean | DocPageActionsOptions
 }
 
-function withDemoContext({ demoResolver, demoRuntime, demoDependencies, demoVFS }: DocRenderOptions, children: ReactNode) {
+function withDemoContext({ demoResolver, demoRuntime, demoDependencies, demoVFS, onTaskStateChange }: DocRenderOptions, children: ReactNode) {
   let out = children
+  if (onTaskStateChange) out = <TaskStateChangeContext.Provider value={onTaskStateChange}>{out}</TaskStateChangeContext.Provider>
   if (demoVFS) out = <DocstreamDemoVFSContext.Provider value={demoVFS}>{out}</DocstreamDemoVFSContext.Provider>
   if (demoRuntime || demoDependencies) {
     out = <DemoRuntimeProvider runtime={demoRuntime} dependencies={demoDependencies}>{out}</DemoRuntimeProvider>
@@ -650,12 +661,15 @@ export function MarkdownContent({
   demoVFS,
   pageActions,
   className,
+  documentProperties = true,
+  onTaskStateChange,
 }: { markdown: string; className?: string } & Renderers & DocRenderOptions) {
   const doc = useMemo(() => parseMarkdown(markdown), [markdown])
   return withDemoContext(
-    { demoResolver, demoRuntime, demoDependencies, demoVFS },
+    { demoResolver, demoRuntime, demoDependencies, demoVFS, onTaskStateChange },
     <div data-docstream="" className={className}>
       <PageActionsBar markdown={markdown} options={pageActions} />
+      {documentProperties && doc.properties ? <DocumentProperties properties={doc.properties} defaultOpen={typeof documentProperties === "object" && documentProperties.defaultOpen} /> : null}
       <Blocks blocks={doc.children} liveRenderer={liveRenderer} sourceRenderer={sourceRenderer} />
       <CitationSources citations={doc.citations} />
     </div>,
@@ -672,11 +686,14 @@ export function DocsRenderer({
   demoVFS,
   pageActions,
   markdown,
+  documentProperties = true,
+  onTaskStateChange,
 }: { doc: DocumentNode; /** Source for page actions; defaults to `serializeMarkdown(doc)`. */ markdown?: string } & Renderers & DocRenderOptions) {
   return withDemoContext(
-    { demoResolver, demoRuntime, demoDependencies, demoVFS },
+    { demoResolver, demoRuntime, demoDependencies, demoVFS, onTaskStateChange },
     <article className="docs-article">
       <PageActionsBar markdown={markdown ?? (() => serializeMarkdown(doc))} options={pageActions} />
+      {documentProperties && doc.properties ? <DocumentProperties properties={doc.properties} defaultOpen={typeof documentProperties === "object" && documentProperties.defaultOpen} /> : null}
       <Blocks blocks={doc.children} liveRenderer={liveRenderer} sourceRenderer={sourceRenderer} />
       <CitationSources citations={doc.citations} />
     </article>,

package/src/docs/DocumentProperties.tsx

@@ -0,0 +1,84 @@
+import { useEffect, useState } from "react"
+import { ChevronRight, Plus, X } from "lucide-react"
+import { parseDocument, stringify } from "yaml"
+import type { DocumentPropertiesNode } from "../gitbook/ast"
+import { readDocumentProperties, removeDocumentProperty, setDocumentProperty, type DocumentPropertyValue } from "../gitbook/properties"
+
+export interface DocumentPropertiesProps {
+  properties: DocumentPropertiesNode
+  /** Omit for read-only properties. Edits retain the YAML document's comments and formatting. */
+  onChange?: (properties: DocumentPropertiesNode) => void
+  defaultOpen?: boolean
+  className?: string
+}
+
+function textValue(value: DocumentPropertyValue): string {
+  return value === null ? "" : typeof value === "object" ? stringify(value).trimEnd() : String(value)
+}
+
+function PropertyField({ name, value, onChange }: { name: string; value: DocumentPropertyValue; onChange: (value: DocumentPropertyValue) => void }) {
+  const rendered = textValue(value)
+  const [draft, setDraft] = useState(rendered)
+  const [error, setError] = useState<string>()
+  useEffect(() => { setDraft(rendered); setError(undefined) }, [rendered])
+  if (typeof value === "boolean") return <input type="checkbox" aria-label={name} checked={value} onChange={(event) => onChange(event.currentTarget.checked)} />
+  const complex = value !== null && typeof value === "object"
+  const multiline = complex || (typeof value === "string" && value.includes("\n"))
+  const change = (text: string) => {
+    setDraft(text)
+    if (!complex && typeof value !== "number") onChange(text)
+    else if (typeof value === "number" && text !== "" && Number.isFinite(Number(text))) onChange(Number(text))
+  }
+  const commit = () => {
+    if (!complex) return
+    try {
+      const yaml = parseDocument(draft)
+      if (yaml.errors.length) throw yaml.errors[0]
+      const next = yaml.toJS({ maxAliasCount: 100 }) as DocumentPropertyValue
+      JSON.stringify(next)
+      setError(undefined)
+      onChange(next)
+    } catch (cause) { setError(cause instanceof Error ? cause.message : String(cause)) }
+  }
+  return <div className="docs-property-field">
+    {multiline ? <textarea aria-label={name} value={draft} rows={Math.min(6, draft.split("\n").length)} aria-invalid={!!error || undefined}
+      onChange={(event) => change(event.currentTarget.value)} onBlur={commit} />
+      : <input type={typeof value === "number" ? "number" : "text"} aria-label={name} value={draft} placeholder="Empty"
+        onChange={(event) => change(event.currentTarget.value)} />}
+    {error ? <span role="alert" className="docs-properties-error">{error}</span> : null}
+  </div>
+}
+
+/** The shared, accessible property sheet used by the renderer and the editor. */
+export function DocumentProperties({ properties, onChange, defaultOpen = false, className }: DocumentPropertiesProps) {
+  const { values, error } = readDocumentProperties(properties)
+  const [adding, setAdding] = useState(false)
+  const [name, setName] = useState("")
+  const keys = Object.keys(values)
+  return <details className={["docs-document-properties", className].filter(Boolean).join(" ")} data-document-properties="" open={defaultOpen || undefined}>
+    <summary><ChevronRight size={13} aria-hidden="true" /><span>Properties</span><span className="docs-properties-count">{keys.length}</span></summary>
+    {error ? <div className="docs-properties-error" role="alert">
+      <p>{error}</p>
+      {onChange ? <textarea aria-label="Document properties YAML" value={properties.yaml} onChange={(event) => onChange({ ...properties, yaml: event.currentTarget.value })} />
+        : <pre>{properties.yaml}</pre>}
+    </div> : <>
+      <dl className="docs-properties-list">
+        {keys.map((key) => <div key={key} className="docs-property-row">
+          <dt>{key}</dt>
+          <dd>{onChange ? <PropertyField name={key} value={values[key]} onChange={(value) => onChange(setDocumentProperty(properties, key, value))} />
+            : <span className="docs-property-value">{values[key] === null ? "Empty" : typeof values[key] === "boolean" ? String(values[key]) : textValue(values[key])}</span>}</dd>
+          {onChange ? <button type="button" className="docs-property-remove" aria-label={`Remove ${key} property`} onClick={() => onChange(removeDocumentProperty(properties, key))}><X size={13} /></button> : null}
+        </div>)}
+      </dl>
+      {onChange ? adding ? <form className="docs-property-add" onSubmit={(event) => {
+        event.preventDefault()
+        const key = name.trim()
+        if (!key || Object.hasOwn(values, key)) return
+        onChange(setDocumentProperty(properties, key, "")); setName(""); setAdding(false)
+      }}><input aria-label="Property name" placeholder="Property name" autoFocus value={name} onChange={(event) => setName(event.currentTarget.value)} />
+        <button type="submit" disabled={!name.trim() || Object.hasOwn(values, name.trim())}>Add</button>
+        <button type="button" onClick={() => { setAdding(false); setName("") }}>Cancel</button></form>
+        : <button type="button" className="docs-property-add" onClick={() => setAdding(true)}><Plus size={13} />Add property</button> : null}
+    </>}
+  </details>
+}

package/src/docs/TaskCheckbox.tsx

@@ -0,0 +1,111 @@
+import { createContext, useEffect, useId, useRef, useState, type CSSProperties } from "react"
+import { createPortal } from "react-dom"
+import { Ban, Check, Circle, CircleCheck, CircleHelp, CircleMinus, CirclePause, CircleX, Clock3 } from "lucide-react"
+import type { ListItemNode, TaskState } from "../gitbook/ast"
+import { TASK_STATES } from "../gitbook/tasks"
+
+/** The icons used by the checkbox, tooltip and state picker. */
+export const TASK_STATE_ICONS = {
+  pending: Circle,
+  "in-progress": Clock3,
+  implemented: CircleHelp,
+  blocked: Ban,
+  parked: CirclePause,
+  refuted: CircleX,
+  verified: CircleCheck,
+  cancelled: CircleMinus,
+} as const
+
+export type TaskStateChangeHandler = (item: ListItemNode, state: TaskState) => void
+export const TaskStateChangeContext = createContext<TaskStateChangeHandler | undefined>(undefined)
+
+export interface TaskCheckboxProps {
+  state: TaskState
+  /** A normal click clears any marked state; clicking pending sets verified. */
+  onChange?: (state: TaskState) => void
+  label?: string
+  className?: string
+}
+
+const TOKENS = ["--foreground", "--muted-foreground", "--popover", "--popover-foreground", "--border", "--primary", "--accent", "--accent-foreground"]
+
+/** An accessible multi-state task checkbox. Right-click or Shift+F10 opens its keyboard-navigable state menu. */
+export function TaskCheckbox({ state, onChange, label = "Task", className }: TaskCheckboxProps) {
+  const input = useRef<HTMLInputElement>(null)
+  const menu = useRef<HTMLDivElement>(null)
+  const tipId = useId()
+  const [popup, setPopup] = useState<{ x: number; y: number; style: CSSProperties }>()
+  const [tip, setTip] = useState<{ x: number; y: number }>()
+  const hoverTimer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined)
+  const meta = TASK_STATES.find((item) => item.id === state) ?? TASK_STATES[0]
+  const StateIcon = TASK_STATE_ICONS[meta.id]
+  const mixed = state !== "pending" && state !== "verified"
+  useEffect(() => { if (input.current) input.current.indeterminate = mixed }, [mixed, state])
+  useEffect(() => () => clearTimeout(hoverTimer.current), [])
+  const hideTip = () => { clearTimeout(hoverTimer.current); setTip(undefined) }
+  const showTip = () => {
+    clearTimeout(hoverTimer.current)
+    hoverTimer.current = setTimeout(() => {
+      const box = input.current?.getBoundingClientRect()
+      if (box) setTip({ x: Math.max(80, Math.min(window.innerWidth - 80, box.x + box.width / 2)), y: box.top > 36 ? box.top - 6 : box.bottom + 30 })
+    }, 400)
+  }
+  const open = (x?: number, y?: number) => {
+    if (!onChange || !input.current) return
+    hideTip()
+    const box = input.current.getBoundingClientRect()
+    const computed = getComputedStyle(input.current)
+    const style = Object.fromEntries(TOKENS.map((token) => [token, computed.getPropertyValue(token)])) as CSSProperties
+    style.fontFamily = computed.fontFamily
+    style.colorScheme = computed.colorScheme
+    setPopup({ x: Math.max(8, Math.min(window.innerWidth - 292, x ?? box.left)), y: Math.max(8, Math.min(window.innerHeight - 330, y ?? box.bottom + 4)), style })
+  }
+  const close = (restoreFocus = false) => { setPopup(undefined); if (restoreFocus) input.current?.focus({ preventScroll: true }) }
+  useEffect(() => {
+    if (!popup) return
+    menu.current?.querySelector<HTMLButtonElement>(`[data-state="${state}"]`)?.focus()
+    const outside = (event: PointerEvent) => { if (event.target instanceof Node && !menu.current?.contains(event.target)) close() }
+    const scroll = (event: Event) => { if (!(event.target instanceof Node && menu.current?.contains(event.target))) close() }
+    document.addEventListener("pointerdown", outside, true)
+    window.addEventListener("resize", scroll)
+    window.addEventListener("scroll", scroll, true)
+    return () => { document.removeEventListener("pointerdown", outside, true); window.removeEventListener("resize", scroll); window.removeEventListener("scroll", scroll, true) }
+  }, [popup])
+  return <span className={["docs-task-control", className].filter(Boolean).join(" ")} data-task-state={state}>
+    <input ref={input} type="checkbox" className="docs-task-checkbox" aria-label={`${label}: ${meta.label}`} aria-describedby={tip ? tipId : undefined}
+      aria-checked={mixed ? "mixed" : state === "verified"} aria-readonly={!onChange || undefined} aria-haspopup={onChange ? "menu" : undefined}
+      aria-expanded={onChange ? !!popup : undefined} checked={state === "verified"} readOnly={!onChange}
+      onClick={(event) => { if (!onChange) event.preventDefault() }}
+      onChange={() => { hideTip(); onChange?.(state === "pending" ? "verified" : "pending") }}
+      onMouseDown={(event) => { if (event.button === 0) event.preventDefault() }}
+      onMouseEnter={showTip} onMouseLeave={hideTip} onFocus={showTip} onBlur={hideTip}
+      onContextMenu={(event) => { if (onChange) { event.preventDefault(); open(event.clientX, event.clientY) } }}
+      onKeyDown={(event) => {
+        if (event.key === "ContextMenu" || (event.shiftKey && event.key === "F10")) { event.preventDefault(); open() }
+      }} />
+    <StateIcon className="docs-task-state-icon" size={20} strokeWidth={1.7} aria-hidden="true" data-state-icon={state} />
+    {tip && !popup ? createPortal(<div role="tooltip" id={tipId} className="docs-task-tooltip" style={{ left: tip.x, top: tip.y }}>{meta.label}</div>, document.body) : null}
+    {popup ? createPortal(<div ref={menu} role="menu" aria-label="Task state" className="docs-task-state-menu" style={{ ...popup.style, left: popup.x, top: popup.y }}
+      onContextMenu={(event) => event.preventDefault()}
+      onKeyDown={(event) => {
+        const items = [...(menu.current?.querySelectorAll<HTMLButtonElement>('[role="menuitemradio"]') ?? [])]
+        const current = items.indexOf(document.activeElement as HTMLButtonElement)
+        let next: number | undefined
+        if (event.key === "ArrowDown") next = (current + 1) % items.length
+        if (event.key === "ArrowUp") next = (current - 1 + items.length) % items.length
+        if (event.key === "Home") next = 0
+        if (event.key === "End") next = items.length - 1
+        if (event.key === "Escape" || event.key === "Tab") { event.preventDefault(); close(true) }
+        if (next !== undefined) { event.preventDefault(); items[next]?.focus() }
+      }}>
+      {TASK_STATES.map((item) => {
+        const Icon = TASK_STATE_ICONS[item.id]
+        return <button type="button" role="menuitemradio" key={item.id} data-state={item.id} aria-checked={item.id === state}
+          onClick={() => { onChange?.(item.id); close(true) }}>
+          <Icon size={19} strokeWidth={1.7} aria-hidden="true" data-state-icon={item.id} />
+          <span>{item.label}</span>{item.id === state ? <Check size={14} aria-hidden="true" /> : <span />}
+        </button>
+      })}
+    </div>, document.body) : null}
+  </span>
+}

package/src/docs/properties.css

@@ -0,0 +1,28 @@
+.docs-document-properties {
+  color: var(--muted-foreground, #787878);
+  font: inherit;
+  font-size: 13px;
+  line-height: 1.5;
+  margin-block: 0 20px;
+}
+.docs-document-properties > summary { display: flex; align-items: center; gap: 6px; width: fit-content; padding-block: 5px; cursor: pointer; list-style: none; user-select: none; }
+.docs-document-properties > summary::-webkit-details-marker { display: none; }
+.docs-document-properties[open] > summary > svg { transform: rotate(90deg); }
+.docs-properties-count { font-variant-numeric: tabular-nums; opacity: .65; margin-left: 2px; }
+.docs-properties-list { margin: 6px 0; }
+.docs-property-row { display: grid; grid-template-columns: minmax(80px, 130px) minmax(0, 1fr) 22px; align-items: start; gap: 10px; padding-block: 6px; border-bottom: 1px solid var(--border, #e8e8e8); }
+.docs-property-row dt { padding-block: 3px; overflow-wrap: anywhere; }
+.docs-property-row dd { margin: 0; min-width: 0; color: var(--foreground, #242424); }
+.docs-property-value { display: block; white-space: pre-wrap; overflow-wrap: anywhere; padding-block: 3px; }
+.docs-document-properties :is(input:not([type="checkbox"]), textarea) { box-sizing: border-box; width: 100%; min-width: 0; padding: 3px 5px; color: var(--foreground, #242424); font: inherit; line-height: inherit; background: transparent; border: 0; border-radius: 4px; }
+.docs-document-properties textarea { resize: vertical; }
+.docs-document-properties input[type="checkbox"] { accent-color: var(--primary, #a87900); margin: 6px 0; }
+.docs-document-properties :is(input, textarea, button, summary):focus-visible { outline: 2px solid var(--primary, #a87900); outline-offset: 2px; }
+.docs-document-properties button { display: inline-flex; align-items: center; justify-content: center; gap: 5px; color: inherit; background: transparent; border: 0; border-radius: 4px; font: inherit; cursor: pointer; }
+.docs-property-remove { padding: 6px 3px; opacity: 0; }
+.docs-property-row:hover .docs-property-remove, .docs-property-remove:focus-visible { opacity: 1; }
+.docs-property-add { display: flex; align-items: center; gap: 8px; margin-block: 8px 0; padding: 3px 0; }
+.docs-property-add input { max-width: 240px; }
+.docs-property-add button { padding: 3px 6px; }
+.docs-properties-error { color: var(--destructive, #bc3030); font-size: 12px; overflow-wrap: anywhere; }
+.docs-properties-error pre { white-space: pre-wrap; }

package/src/docs/tasks.css

@@ -0,0 +1,13 @@
+.docs-task-control { position: relative; display: inline-flex; width: 21px; height: 21px; flex: 0 0 21px; vertical-align: text-bottom; color: var(--muted-foreground, #7a7a7a); }
+.docs-task-control .docs-task-checkbox { position: absolute; inset: 0; box-sizing: border-box; appearance: none; margin: 0; width: 100%; height: 100%; padding: 0; border: 0; border-radius: 50%; background: transparent; cursor: pointer; box-shadow: none; }
+.docs-task-checkbox:focus-visible { outline: 2px solid var(--primary, #a87900); outline-offset: 3px; }
+.docs-task-state-icon { position: absolute; inset: 0; width: 100%; height: 100%; pointer-events: none; }
+.docs-task-control[data-task-state="verified"], .docs-task-control[data-task-state="in-progress"], .docs-task-control[data-task-state="implemented"] { color: var(--primary, #a87900); }
+.docs-task-control[data-task-state="blocked"], .docs-task-control[data-task-state="refuted"] { color: var(--destructive, #bd3d36); }
+.docs-task-state-menu { position: fixed; z-index: 10000; box-sizing: border-box; width: 284px; max-height: calc(100vh - 16px); overflow: auto; padding: 5px; border: 1px solid var(--border, #dedede); border-radius: 10px; background: var(--popover, #fff); color: var(--popover-foreground, #222); box-shadow: 0 8px 32px #0003, 0 1px 3px #0001; font-size: 13px; line-height: 1.4; }
+.docs-task-state-menu > button { display: grid; grid-template-columns: 20px minmax(0, 1fr) 14px; align-items: center; gap: 9px; width: 100%; min-height: 35px; padding: 7px 8px; border: 0; border-radius: 5px; color: inherit; background: transparent; font: inherit; text-align: left; cursor: pointer; outline: none; }
+.docs-task-state-menu > button:hover, .docs-task-state-menu > button:focus { color: var(--accent-foreground, #222); background: var(--accent, #eee); }
+.docs-task-state-menu > button > svg:first-child { color: var(--muted-foreground, #777); }
+.docs-task-state-menu > button[aria-checked="true"] > svg { color: var(--primary, #a87900); }
+.docs-task-tooltip { position: fixed; z-index: 10001; transform: translate(-50%, -100%); border-radius: 5px; padding: 4px 8px; color: #fff; background: #303030; box-shadow: 0 2px 8px #0002; font: 12px/1.4 system-ui, sans-serif; white-space: nowrap; pointer-events: none; }
+.docs-tasklist li > .docs-task-control { margin-top: 2px; }

package/src/gitbook/ast.ts

@@ -433,6 +433,8 @@ export interface ListItemNode extends ContainerSpacing {
   type: "listItem"
   children: Block[]
   checked?: boolean // present only in task lists
+  /** Extended task state. Omitted for ordinary `[ ]` / `[x]` items for backwards compatibility. */
+  state?: TaskState
   /** The item's marker as written (`*`, `3.`), when it isn't the one its list's pattern gives it. */
   marker?: string
   /** Spaces between the marker and the content (default 1). */
@@ -443,6 +445,8 @@ export interface ListItemNode extends ContainerSpacing {
   checkMark?: "X"
 }
 
+export type TaskState = "pending" | "in-progress" | "implemented" | "blocked" | "parked" | "refuted" | "verified" | "cancelled"
+
 export interface ListNode extends BlockSpacing {
   type: "list"
   ordered: boolean
@@ -563,9 +567,21 @@ export type Block =
   | DefinitionNode
   | RawNode
 
+/** YAML frontmatter, kept separately from the document body. Comments, key order and quoting survive edits. */
+export interface DocumentPropertiesNode {
+  /** YAML between the delimiters, using the document's normalized line endings. */
+  yaml: string
+  /** Opening delimiter as written (including an optional BOM). Defaults to `---`. */
+  opening?: string
+  /** Closing delimiter as written (`---` or `...`). Defaults to `---`. */
+  closing?: string
+}
+
 export interface DocumentNode {
   type: "doc"
   children: Block[]
+  /** First-party document properties from YAML frontmatter. */
+  properties?: DocumentPropertiesNode
   /** Footnote citation definitions, in definition order. */
   citations?: CitationDef[]
   /** Blank lines before the trailing footnote definitions (default 1). */

package/src/gitbook/index.ts

@@ -1,6 +1,9 @@
 // Pure GitBook markdown engine (no React, no mermaid/streamdown). Safe to import
 // in non-DOM environments such as a server-side AI agent or a Cloudflare Worker.
 export type * from "./ast"
+export { TASK_STATES, getTaskState, taskMarker, taskStateFromMarker } from "./tasks"
+export { readDocumentProperties, removeDocumentProperty, setDocumentProperty } from "./properties"
+export type { DocumentPropertyValue, ParsedDocumentProperties } from "./properties"
 export { escapeAttr, unescapeAttr } from "./attrs"
 export { closesFence, demoBody, fenceOpener, fenceTracker, parseDemoVariants, parseMarkdown, parseBlocks, trimPartialInlineToken } from "./parse"
 export { fenceFor, serializeBlocks, serializeDemoFile, serializeMarkdown } from "./serialize"

package/src/gitbook/parse.ts

@@ -36,6 +36,7 @@ import type {
 import { TAG_ATTRS, parseAttrs } from "./attrs"
 import { containerTags, defaultDelimiterRow, definitionLine, delimiterAlign, fenceInfo, figureMarkdown, serializeBlocks, type TaggedNode } from "./serialize"
 import { footnoteDefinitions, normalizeLabel, parseInline, plainText, refDefinitions } from "./inline"
+import { taskStateFromMarker } from "./tasks"
 
 // Minimal HTML-inline → markdown-inline bridge for HTML table cells.
 function htmlToInlineMd(html: string): string {
@@ -256,7 +257,15 @@ export function footnoteLine(id: string, url: string, label?: string): string {
 export function parseMarkdown(src: string): DocumentNode {
   // Windows line endings throughout come back as such; mixed ones stay in the lines as written.
   const crlf = src.includes("\r\n") && !/(^|[^\r])\n/.test(src)
-  const lines = src.split(crlf || !src.includes("\r\n") ? /\r?\n/ : "\n")
+  let lines = src.split(crlf || !src.includes("\r\n") ? /\r?\n/ : "\n")
+  let properties: DocumentNode["properties"]
+  if (/^\uFEFF?---[ \t]*$/.test(lines[0])) {
+    const closing = lines.findIndex((line, index) => index > 0 && /^(?:---|\.\.\.)[ \t]*$/.test(line))
+    if (closing > 0) {
+      properties = { yaml: lines.slice(1, closing).join("\n"), opening: lines[0], closing: lines[closing] }
+      lines = lines.slice(closing + 1)
+    }
+  }
   refDefinitions.clear()
   footnoteDefinitions.clear()
   const fences = fenceTracker()
@@ -289,6 +298,7 @@ export function parseMarkdown(src: string): DocumentNode {
   const trailing = group <= last
   const { blocks, end } = parseBody(trailing ? lines.slice(0, group) : lines)
   const doc: DocumentNode = { type: "doc", children: blocks }
+  if (properties) doc.properties = properties
   if (footnoteDefinitions.size) {
     doc.citations = [...footnoteDefinitions.entries()].map(([id, d]) => ({ id, ...d }))
   }
@@ -1117,10 +1127,10 @@ function parseList(lines: string[], start: number): ParsedList {
     let content = m[4]
     let checked: boolean | undefined
     let checkMark: string | undefined
-    const taskMatch = content.match(/^\[([ xX])\]\s+(.*)$/)
+    const taskMatch = content.match(/^\[([ xX~?bd!\-])\]\s+(.*)$/)
     if (taskMatch) {
       list.task = true
-      checked = taskMatch[1] !== " "
+      checked = /[xX]/.test(taskMatch[1])
       checkMark = taskMatch[1]
       content = taskMatch[2]
     }
@@ -1158,6 +1168,8 @@ function parseList(lines: string[], start: number): ParsedList {
     const para: Block = { type: "paragraph", children: parseInline(content) }
     const children: Block[] = body.length ? [para, ...parseBlocks(body)] : [para]
     const item: ListItemNode = checked === undefined ? { type: "listItem", children } : { type: "listItem", children, checked }
+    const state = checkMark === undefined ? undefined : taskStateFromMarker(checkMark)
+    if (state && state !== "pending" && state !== "verified") item.state = state
     const expected = ordered ? `${(list.start ?? 1) + items.length}${list.delimiter ?? "."}` : (list.bullet ?? "-")
     if (m[2] !== expected) item.marker = m[2]
     if (m[3].length !== 1) item.pad = m[3].length