basalt-ui 1.27.0 → 1.29.0

package/dist/content/callout.js

@@ -1,4 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
+import { cx } from "../common/props.js";
 import classes from "./callout.module.css";
 const KIND_CLASS = {
   info: classes.info,
@@ -45,14 +46,20 @@ const DEFAULT_ICON = {
   bad: /* @__PURE__ */ jsx(BadGlyph, {})
 };
 function Callout({ kind = "info", title, icon, children, className, style }) {
-  const rootClass = [classes.root, KIND_CLASS[kind], className].filter(Boolean).join(" ");
-  return /* @__PURE__ */ jsxs("div", { className: rootClass, ...style !== void 0 && { style }, children: [
-    title !== void 0 && /* @__PURE__ */ jsxs("div", { className: classes.titleRow, children: [
-      /* @__PURE__ */ jsx("span", { className: classes.icon, children: icon ?? DEFAULT_ICON[kind] }),
-      /* @__PURE__ */ jsx("span", { className: classes.title, children: title })
-    ] }),
-    /* @__PURE__ */ jsx("div", { className: classes.body, children })
-  ] });
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cx(classes.root, KIND_CLASS[kind], className),
+      ...style !== void 0 && { style },
+      children: [
+        title !== void 0 && /* @__PURE__ */ jsxs("div", { className: classes.titleRow, children: [
+          /* @__PURE__ */ jsx("span", { className: classes.icon, children: icon ?? DEFAULT_ICON[kind] }),
+          /* @__PURE__ */ jsx("span", { className: classes.title, children: title })
+        ] }),
+        /* @__PURE__ */ jsx("div", { className: classes.body, children })
+      ]
+    }
+  );
 }
 export {
   Callout

package/dist/content/guide.d.ts

@@ -16,8 +16,9 @@
  */
 import type { ReactNode } from 'react';
 import type { DrawerProps } from '@mantine/core';
+import type { BasaltProps } from '../common/props.js';
 import type { ArticleNavTarget } from './article-layout.js';
-export type GuideDrawerProps = {
+export type GuideDrawerProps = BasaltProps & {
     readonly opened: boolean;
     readonly onClose: () => void;
     readonly title: string;
@@ -31,8 +32,8 @@ export type GuideDrawerProps = {
     readonly renderLink?: (target: ArticleNavTarget, node: ReactNode) => ReactNode;
     readonly size?: DrawerProps['size'];
 };
-export declare function GuideDrawer({ opened, onClose, title, children, markdown, fullPageHref, renderLink, size, }: GuideDrawerProps): import("react").JSX.Element;
-export type GuideLinkProps = {
+export declare function GuideDrawer({ opened, onClose, title, children, markdown, fullPageHref, renderLink, size, className, style, }: GuideDrawerProps): import("react").JSX.Element;
+export type GuideLinkProps = BasaltProps & {
     /** Trigger label. Default `'Guide'`. */
     readonly label?: string;
     readonly title: string;
@@ -43,5 +44,5 @@ export type GuideLinkProps = {
     /** Render the trigger as an icon-only `ActionIcon` instead of a labeled button. Default `false`. */
     readonly iconOnly?: boolean;
 };
-export declare function GuideLink({ label, title, children, markdown, fullPageHref, renderLink, iconOnly, }: GuideLinkProps): import("react").JSX.Element;
+export declare function GuideLink({ label, title, children, markdown, fullPageHref, renderLink, iconOnly, className, style, }: GuideLinkProps): import("react").JSX.Element;
 //# sourceMappingURL=guide.d.ts.map

package/dist/content/guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/content/guide.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAmCxD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,SAAS,CAAA;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACpC,CAAA;AAED,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,OAAO,EACP,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,UAA8B,EAC9B,IAAU,GACX,EAAE,gBAAgB,+BA+BlB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,SAAS,CAAA;IAC9E,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED,wBAAgB,SAAS,CAAC,EACxB,KAAe,EACf,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,QAAgB,GACjB,EAAE,cAAc,+BAwChB"}
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/content/guide.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAGlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAmCxD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,SAAS,CAAA;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACpC,CAAA;AAED,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,OAAO,EACP,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,UAA8B,EAC9B,IAAU,EACV,SAAS,EACT,KAAK,GACN,EAAE,gBAAgB,+BAiClB;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG;IACzC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,SAAS,CAAA;IAC9E,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED,wBAAgB,SAAS,CAAC,EACxB,KAAe,EACf,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,QAAgB,EAChB,SAAS,EACT,KAAK,GACN,EAAE,cAAc,+BA0ChB"}

package/dist/content/guide.js

@@ -1,6 +1,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { ActionIcon, Button, Drawer } from "@mantine/core";
 import { useDisclosure } from "@mantine/hooks";
+import { cx } from "../common/props.js";
 import classes from "./guide.module.css";
 import { Markdown } from "./markdown.js";
 import { Prose } from "./prose.js";
@@ -36,7 +37,9 @@ function GuideDrawer({
   markdown,
   fullPageHref,
   renderLink = defaultRenderLink,
-  size = 440
+  size = 440,
+  className,
+  style
 }) {
   return /* @__PURE__ */ jsxs(
     Drawer,
@@ -46,6 +49,8 @@ function GuideDrawer({
       position: "right",
       size,
       title: /* @__PURE__ */ jsx("span", { className: classes.drawerTitle, children: title }),
+      ...className !== void 0 && { className },
+      ...style !== void 0 && { style },
       children: [
         /* @__PURE__ */ jsx("div", { className: classes.body, children: markdown !== void 0 ? /* @__PURE__ */ jsx(Markdown, { density: "article", measure: false, children: markdown }) : /* @__PURE__ */ jsx(Prose, { density: "article", measure: false, children }) }),
         fullPageHref !== void 0 && /* @__PURE__ */ jsx("div", { className: classes.footer, children: renderLink(
@@ -63,7 +68,9 @@ function GuideLink({
   markdown,
   fullPageHref,
   renderLink,
-  iconOnly = false
+  iconOnly = false,
+  className,
+  style
 }) {
   const [opened, { open, close }] = useDisclosure(false);
   return /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -73,9 +80,10 @@ function GuideLink({
         variant: "subtle",
         color: "gray",
         size: "sm",
-        className: classes.trigger,
+        className: cx(classes.trigger, className),
         onClick: open,
         "aria-label": label,
+        ...style !== void 0 && { style },
         children: /* @__PURE__ */ jsx(GuideGlyph, {})
       }
     ) : /* @__PURE__ */ jsx(
@@ -84,9 +92,10 @@ function GuideLink({
         variant: "subtle",
         color: "gray",
         size: "compact-xs",
-        className: classes.trigger,
+        className: cx(classes.trigger, className),
         leftSection: /* @__PURE__ */ jsx(GuideGlyph, {}),
         onClick: open,
+        ...style !== void 0 && { style },
         children: /* @__PURE__ */ jsx("span", { className: classes.triggerLabel, children: label })
       }
     ),

package/dist/content/heading-anchor.d.ts

@@ -1,8 +1,30 @@
-export type HeadingAnchorProps = {
+/**
+ * HeadingAnchor — the hover-revealed "copy a link to this section" affordance on a heading
+ * (docs/CONTENT-SPEC.md §7).
+ *
+ * `./markdown` and `./mdx` render one automatically on every slugged heading. It is exported so
+ * hand-authored `Prose` articles can render the SAME affordance on their own headings — without
+ * it, a JSX article and the identical markdown would not look identical, which is the whole point
+ * of routing every source through one set of primitives (CONTENT-SPEC §1).
+ *
+ * It is a thin wrapper over `CopyAction` — the same component `CodeBlock`'s copy button renders —
+ * so "copy this thing" reads identically everywhere on the surface: subtle icon button, tooltip,
+ * glyph swapping to a teal check. Only the resting glyph differs (a link, not a copy sheet).
+ *
+ * @example
+ * import { headingSlug, HeadingAnchor, Prose } from 'basalt-ui/content'
+ *
+ * const id = headingSlug('Setup')
+ * <Prose>
+ *   <h2 id={id}>Setup<HeadingAnchor id={id} /></h2>
+ * </Prose>
+ */
+import type { BasaltProps } from '../common/props.js';
+export type HeadingAnchorProps = BasaltProps & {
     /** The heading's `id` — the fragment the copied URL points at. */
     readonly id: string;
     /** Accessible name for the trigger. */
     readonly label?: string;
 };
-export declare function HeadingAnchor({ id, label }: HeadingAnchorProps): import("react").JSX.Element;
+export declare function HeadingAnchor({ id, label, className, style, }: HeadingAnchorProps): import("react").JSX.Element;
 //# sourceMappingURL=heading-anchor.d.ts.map

package/dist/content/heading-anchor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heading-anchor.d.ts","sourceRoot":"","sources":["../../src/content/heading-anchor.tsx"],"names":[],"mappings":"AAyBA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,KAA8B,EAAE,EAAE,kBAAkB,+BAqBvF"}
+{"version":3,"file":"heading-anchor.d.ts","sourceRoot":"","sources":["../../src/content/heading-anchor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAMlD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAC7C,kEAAkE;IAClE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAgB,aAAa,CAAC,EAC5B,EAAE,EACF,KAA8B,EAC9B,SAAS,EACT,KAAK,GACN,EAAE,kBAAkB,+BAyBpB"}

package/dist/content/heading-anchor.js

@@ -1,22 +1,36 @@
 import { jsx } from "react/jsx-runtime";
+import { cx } from "../common/props.js";
 import { CopyAction } from "./copy-action.js";
 import { LinkGlyph } from "./glyphs.js";
 import classes from "./prose.module.css";
-function HeadingAnchor({ id, label = "Copy link to section" }) {
+function HeadingAnchor({
+  id,
+  label = "Copy link to section",
+  className,
+  style
+}) {
   const resolveUrl = () => {
     const { origin, pathname, search } = window.location;
     return `${origin}${pathname}${search}#${id}`;
   };
-  return /* @__PURE__ */ jsx("span", { className: classes.headingAnchor, "data-heading-anchor": true, children: /* @__PURE__ */ jsx(
-    CopyAction,
+  return /* @__PURE__ */ jsx(
+    "span",
     {
-      value: resolveUrl,
-      label: "Copy link",
-      ariaLabel: label,
-      tooltipPosition: "top",
-      glyph: /* @__PURE__ */ jsx(LinkGlyph, {})
+      className: cx(classes.headingAnchor, className),
+      "data-heading-anchor": true,
+      ...style !== void 0 && { style },
+      children: /* @__PURE__ */ jsx(
+        CopyAction,
+        {
+          value: resolveUrl,
+          label: "Copy link",
+          ariaLabel: label,
+          tooltipPosition: "top",
+          glyph: /* @__PURE__ */ jsx(LinkGlyph, {})
+        }
+      )
     }
-  ) });
+  );
 }
 export {
   HeadingAnchor

package/dist/content/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AACvC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAClD,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACxE,YAAY,EACV,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1D,YAAY,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE/F,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACjF,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAQhE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACpE,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAChD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AACvC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAI9D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAClD,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACxE,YAAY,EACV,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1D,YAAY,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE/F,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACjF,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAQhE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACpE,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAChD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA"}

package/dist/content/markdown.d.ts

@@ -77,10 +77,9 @@ export type MarkdownProps = {
      * default to same-origin `['/']`; `'trusted'` (your own authored content) keeps
      * `['https://', '/']`. An explicit `allowedImagePrefixes` always wins over both.
      *
-     * Default: `'untrusted'` when `streaming` is set, `'trusted'` otherwise. That default only
-     * preserves the pre-1.12 fail-safe — it is NOT the policy. Settledness has nothing to do with
-     * trust: a FINISHED agent message is still model-generated, so any surface rendering agent text
-     * must pin `contentTrust="untrusted"` explicitly rather than lean on `streaming`.
+     * Default: `'trusted'`. Settledness has nothing to do with trust: a FINISHED agent message is
+     * still model-generated, so any surface rendering agent text must pin `contentTrust="untrusted"`
+     * explicitly rather than lean on `streaming`.
      */
     readonly contentTrust?: MarkdownContentTrust;
     /**

package/dist/content/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/content/markdown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAE/C,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,gBAAgB,CAAA;AAGvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAInD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,OAAO,KAAK,EAAkB,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAO9F,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAK3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEtF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,CAAA;AAE1D,MAAM,MAAM,aAAa,GAAG;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;IAC/B,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B;;iDAE6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAA;IAC5C;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAA;IACxC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,uBAAuB,CAAA;IACjD,4EAA4E;IAC5E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChD;;;sCAGkC;IAClC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjD,uGAAuG;IACvG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC3C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAC/B,CAAA;AAqED,qFAAqF;AACrF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;CACzC,CAAA;AA8ED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,SAAS,EACT,eAAe,EACf,cAAc,GACf,EAAE;IACD,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,uBAAuB,CAAA;CAClD,GAAG,SAAS,OAAO,EAAE,CAKrB;AA2RD,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,OAAmB,EACnB,OAAO,EACP,SAAiB,EAIjB,YAAkD,EAClD,UAAU,EACV,cAAc,EACd,cAAc,EACd,mBAA2C,EAC3C,oBAA0D,EAC1D,aAAa,EACb,aAAa,EACb,aAAa,EACb,SAAS,EACT,KAAK,GACN,EAAE,aAAa,eAiCf"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/content/markdown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAE/C,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,gBAAgB,CAAA;AAGvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAInD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,OAAO,KAAK,EAAkB,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAO9F,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAK3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEtF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,CAAA;AAE1D,MAAM,MAAM,aAAa,GAAG;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;IAC/B,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B;;iDAE6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;;;;OASG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAA;IAC5C;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAA;IACxC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,uBAAuB,CAAA;IACjD,4EAA4E;IAC5E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChD;;;sCAGkC;IAClC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjD,uGAAuG;IACvG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC3C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAC/B,CAAA;AAqED,qFAAqF;AACrF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;CACzC,CAAA;AA8ED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,SAAS,EACT,eAAe,EACf,cAAc,GACf,EAAE;IACD,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,uBAAuB,CAAA;CAClD,GAAG,SAAS,OAAO,EAAE,CAKrB;AA6RD,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,OAAmB,EACnB,OAAO,EACP,SAAiB,EACjB,YAAwB,EACxB,UAAU,EACV,cAAc,EACd,cAAc,EACd,mBAA2C,EAC3C,oBAA0D,EAC1D,aAAa,EACb,aAAa,EACb,aAAa,EACb,SAAS,EACT,KAAK,GACN,EAAE,aAAa,eAiCf"}

package/dist/content/markdown.js

@@ -117,6 +117,7 @@ const LazyReactMarkdown = lazy(
     return { default: Bridge };
   }).catch(() => ({ default: ({ text }) => /* @__PURE__ */ jsx(PlainTextFallback, { text }) }))
 );
+Object.assign(LazyReactMarkdown, { displayName: "LazyReactMarkdown" });
 function BlockRenderer({
   text,
   settled,
@@ -145,6 +146,7 @@ function BlockRenderer({
   );
 }
 const MemoizedBlock = memo(BlockRenderer);
+MemoizedBlock.displayName = "MemoizedBlock";
 let remendPromise = null;
 let resolvedRemend = null;
 function loadRemend() {
@@ -242,10 +244,7 @@ function Markdown({
   density = "article",
   measure,
   streaming = false,
-  // `streaming` as the trust DEFAULT is backward compatibility only (pre-1.12 the image policy was
-  // read straight off `streaming`, so dropping it would silently widen every existing streaming
-  // call site). It is a floor, never the policy — see the prop's JSDoc.
-  contentTrust = streaming ? "untrusted" : "trusted",
+  contentTrust = "trusted",
   components,
   fenceRenderers,
   sanitizeSchema,

package/dist/content/prose.module.css

@@ -32,16 +32,18 @@
   margin-bottom: 0;
 }
 
-/* Sticky-header clearance for in-page anchors. One value on every viewport: since the
- * controls waves the AppShell header is `appShellHeaderHeight` (48px) on phones too — the two-row
- * mobile header and its `-mobile` clearance token are gone (docs/CONTROLS-SPEC.md §2.1, law C14).
- * `--basalt-page-bar-h` (a sticky PageBar row 2, published by the shell) is added on top so a
- * heading never lands under the filter row. A `./content` consumer rendering Prose standalone (no
- * BasaltShell) overrides `--vx-space-sticky-header-clearance` itself. */
+/* Anchor clearance. One value on every viewport, and NO chrome height in it: an anchor scroll
+ * happens inside the scrollport, and since `BasaltShell` made `AppShell.Main` that box both the
+ * AppShell header and `PageBar` row 2's band are regions rendered OUTSIDE it
+ * (`shell/app-main.module.css`) — the `--basalt-page-bar-h` term this rule used to add would now
+ * push every heading a band below where it belongs, and an `--app-shell-header-height` term (gone
+ * since the controls waves) would add a header on top of that. What is left is breathing room,
+ * which is precisely what `--vx-space-sticky-header-clearance` means now (tokens/palette.ts). A
+ * `./content` consumer with its OWN fixed chrome above the scrollport overrides that token. */
 .root h2,
 .root h3,
 .root h4 {
-  scroll-margin-top: calc(var(--vx-space-sticky-header-clearance) + var(--basalt-page-bar-h, 0px));
+  scroll-margin-top: var(--vx-space-sticky-header-clearance);
 }
 
 /* Headings share family/weight/color across densities; size + margin differ below. */

package/dist/content/reading-progress.d.ts

@@ -1,9 +1,14 @@
 /**
  * ReadingProgress — an opt-in, scroll-driven 2px top bar (docs/CONTENT-SPEC.md §3/§7).
  *
- * Progress is how far `target` (default: the whole document) has been scrolled through the
+ * Progress is how far `target` (default: the whole scrollport) has been scrolled through the
  * viewport — 0 at the top of `target`, 1 once its bottom edge has cleared the viewport.
  *
+ * WHICH BOX SCROLLS is resolved, never assumed: inside `BasaltShell` the scroller is
+ * `AppShell.Main` (`shell/app-main.module.css`), where `window.scrollY` is pinned at 0 and a
+ * `scroll` listener on `window` never fires. `scrollParentOf` answers `null` for a shell-less app
+ * and this falls back to the window unchanged.
+ *
  * @example
  * import { ReadingProgress } from 'basalt-ui/content'
  *
@@ -12,9 +17,10 @@
  * <div ref={articleRef}>…</div>
  */
 import type { RefObject } from 'react';
-export type ReadingProgressProps = {
-    /** The element to track scroll progress through. Default: the whole document. */
+import type { BasaltProps } from '../common/props.js';
+export type ReadingProgressProps = BasaltProps & {
+    /** The element to track scroll progress through. Default: the whole scrollport. */
     readonly target?: RefObject<HTMLElement | null>;
 };
-export declare function ReadingProgress({ target }?: ReadingProgressProps): import("react").JSX.Element;
+export declare function ReadingProgress({ target, className, style }?: ReadingProgressProps): import("react").JSX.Element;
 //# sourceMappingURL=reading-progress.d.ts.map

package/dist/content/reading-progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reading-progress.d.ts","sourceRoot":"","sources":["../../src/content/reading-progress.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,MAAM,MAAM,oBAAoB,GAAG;IACjC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CAChD,CAAA;AAgBD,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAE,oBAAyB,+BA8BpE"}
+{"version":3,"file":"reading-progress.d.ts","sourceRoot":"","sources":["../../src/content/reading-progress.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAKlD,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG;IAC/C,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CAChD,CAAA;AAsBD,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAE,oBAAyB,+BAyCtF"}

package/dist/content/reading-progress.js

@@ -1,37 +1,53 @@
 import { jsx } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
+import { cx } from "../common/props.js";
+import { scrollParentOf } from "../common/scroll-parent.js";
 import classes from "./reading-progress.module.css";
-function computeProgress(target) {
-  const viewport = window.innerHeight;
-  const scrollTop = window.scrollY;
-  const start = target ? target.getBoundingClientRect().top + scrollTop : 0;
-  const total = target ? target.offsetHeight - viewport : document.documentElement.scrollHeight - viewport;
+function computeProgress(target, port) {
+  const viewport = port ? port.clientHeight : window.innerHeight;
+  const scrollTop = port ? port.scrollTop : window.scrollY;
+  const originTop = port ? port.getBoundingClientRect().top : 0;
+  const scrollable = port ? port.scrollHeight : document.documentElement.scrollHeight;
+  const start = target ? target.getBoundingClientRect().top - originTop + scrollTop : 0;
+  const total = target ? target.offsetHeight - viewport : scrollable - viewport;
   if (total <= 0) return 0;
   const ratio = (scrollTop - start) / total;
   return Math.min(1, Math.max(0, ratio));
 }
-function ReadingProgress({ target } = {}) {
+function ReadingProgress({ target, className, style } = {}) {
   const [progress, setProgress] = useState(0);
   const frame = useRef(null);
+  const rootRef = useRef(null);
   useEffect(() => {
+    const port = scrollParentOf(target?.current ?? rootRef.current);
+    const scroller = port ?? window;
     const tick = () => {
       frame.current = null;
-      setProgress(computeProgress(target?.current));
+      setProgress(computeProgress(target?.current, port));
     };
     const onScroll = () => {
       if (frame.current !== null) return;
       frame.current = requestAnimationFrame(tick);
     };
     tick();
-    window.addEventListener("scroll", onScroll, { passive: true });
+    scroller.addEventListener("scroll", onScroll, { passive: true });
     window.addEventListener("resize", onScroll, { passive: true });
     return () => {
-      window.removeEventListener("scroll", onScroll);
+      scroller.removeEventListener("scroll", onScroll);
       window.removeEventListener("resize", onScroll);
       if (frame.current !== null) cancelAnimationFrame(frame.current);
     };
   }, [target]);
-  return /* @__PURE__ */ jsx("div", { className: classes.root, "aria-hidden": true, children: /* @__PURE__ */ jsx("div", { className: classes.fill, style: { transform: `scaleX(${progress})` } }) });
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref: rootRef,
+      className: cx(classes.root, className),
+      "aria-hidden": true,
+      ...style !== void 0 && { style },
+      children: /* @__PURE__ */ jsx("div", { className: classes.fill, style: { transform: `scaleX(${progress})` } })
+    }
+  );
 }
 export {
   ReadingProgress

package/dist/content/slug.d.ts

@@ -12,6 +12,10 @@ export declare function headingSlug(text: string): string;
  * Dedupes repeated slugs within one document — the second occurrence of a slug gets `-1`, the
  * third `-2`, and so on (matches github-slugger's own collision behavior). Create one instance
  * per document/render pass; it carries no global state.
+ *
+ * @remarks not a component — an ordinary PascalCase utility class on the `content` barrel
+ * (isomorphic harness finding F-DET-1). It carries no `prototype.isReactComponent` marker, so
+ * `new SlugTracker()`, not `<SlugTracker />`.
  */
 export declare class SlugTracker {
     private readonly counts;

package/dist/content/slug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/content/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,iFAAiF;IACjF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAM3B;AAED,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAA;AAID,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAIrD"}
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/content/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,iFAAiF;IACjF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAM3B;AAED,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAA;AAID,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAIrD"}

package/dist/content/toc.d.ts

@@ -6,6 +6,17 @@
  * `headingSlug`/`SlugTracker` when authoring the headings. Sticky positioning is the consumer's
  * job; this component is just the rail.
  *
+ * The spy resolves WHICH BOX SCROLLS (`scrollParentOf`) instead of assuming the window: inside
+ * `BasaltShell` that is `AppShell.Main` (`shell/app-main.module.css`), so both the observer's root
+ * and the bottom-edge arithmetic have to be that element — a window listener there never fires and
+ * a viewport-rooted observer measures the wrong band. `null` means the document scrolls, which is
+ * the shell-less case and behaves exactly as before.
+ *
+ * The active rail item carries `aria-current="location"` (WAI-ARIA APG's own recommendation for a
+ * link set that navigates within one page, rather than `"page"`/`"true"`) — both a genuine a11y fix
+ * (previously `activeId` drove `classes.active` alone, so a screen reader had no signal at all) and
+ * the one DOM-observable hook for `activeId` that does not depend on a CSS Modules class hash.
+ *
  * @example
  * import { TableOfContents, headingSlug } from 'basalt-ui/content'
  *

package/dist/content/toc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../src/content/toc.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,OAAO,CAAA;AAKlD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IAC1B,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACrD,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AA4BD,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,YAAY,EACZ,MAAuB,EACvB,KAAqB,EACrB,UAAU,EACV,SAAS,GACV,EAAE,oBAAoB,sCAuJtB"}
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../src/content/toc.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,OAAO,CAAA;AAMlD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IAC1B,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACrD,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AA4BD,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,YAAY,EACZ,MAAuB,EACvB,KAAqB,EACrB,UAAU,EACV,SAAS,GACV,EAAE,oBAAoB,sCAgLtB"}

package/dist/content/toc.js

@@ -1,6 +1,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
 import { useReducedMotion } from "@mantine/hooks";
+import { scrollParentOf } from "../common/scroll-parent.js";
 import classes from "./toc.module.css";
 const DEFAULT_LEVELS = [2, 3];
 const DEFAULT_TITLE = "On this page";
@@ -32,6 +33,8 @@ function TableOfContents({
   const reduceMotion = useReducedMotion();
   const pinnedRef = useRef(null);
   const releasePinRef = useRef(null);
+  const navRef = useRef(null);
+  const portRef = useRef(null);
   useEffect(() => {
     return () => releasePinRef.current?.();
   }, []);
@@ -50,11 +53,15 @@ function TableOfContents({
     if (resolvedItems.length === 0) return;
     const elements = resolvedItems.map((item) => document.getElementById(item.id)).filter((el) => el !== null);
     if (elements.length === 0) return;
+    const port = scrollParentOf(containerRef?.current ?? navRef.current);
+    portRef.current = port;
+    const scroller = port ?? window;
     const intersecting = /* @__PURE__ */ new Set();
     const resolve = () => {
       if (pinnedRef.current !== null) return;
-      const doc = document.documentElement;
-      if (window.innerHeight + window.scrollY >= doc.scrollHeight - 2) {
+      const box = port ?? document.documentElement;
+      const seen = port ? port.clientHeight + port.scrollTop : window.innerHeight + window.scrollY;
+      if (seen >= box.scrollHeight - 2) {
         const last = elements[elements.length - 1];
         if (last) setActiveId(last.id);
         return;
@@ -64,7 +71,8 @@ function TableOfContents({
         if (topmost) setActiveId(topmost.id);
         return;
       }
-      const passed = elements.filter((el) => el.getBoundingClientRect().top < 0);
+      const originTop = port ? port.getBoundingClientRect().top : 0;
+      const passed = elements.filter((el) => el.getBoundingClientRect().top < originTop);
       const current = passed[passed.length - 1] ?? elements[0];
       if (current) setActiveId(current.id);
     };
@@ -76,29 +84,33 @@ function TableOfContents({
         }
         resolve();
       },
-      { rootMargin: "-80px 0px -70% 0px" }
+      // `root: null` IS the viewport — the shell-less case, unchanged. Inside a shell the root has
+      // to be the scrollport or the `-70%` dead zone is measured against a box nothing scrolls.
+      { root: port, rootMargin: "-80px 0px -70% 0px" }
     );
     for (const el of elements) observer.observe(el);
-    window.addEventListener("scroll", resolve, { passive: true });
+    scroller.addEventListener("scroll", resolve, { passive: true });
     return () => {
       observer.disconnect();
-      window.removeEventListener("scroll", resolve);
+      scroller.removeEventListener("scroll", resolve);
+      portRef.current = null;
     };
-  }, [resolvedItems]);
+  }, [resolvedItems, containerRef]);
   if (resolvedItems.length === 0) return null;
   const pinActive = (id) => {
     releasePinRef.current?.();
     setActiveId(id);
     pinnedRef.current = id;
+    const scroller = portRef.current ?? window;
     let timer = null;
     const release = () => {
       pinnedRef.current = null;
       if (timer !== null) clearTimeout(timer);
-      window.removeEventListener("scrollend", release);
+      scroller.removeEventListener("scrollend", release);
       releasePinRef.current = null;
     };
     timer = setTimeout(release, CLICK_PIN_MAX_MS);
-    window.addEventListener("scrollend", release, { once: true });
+    scroller.addEventListener("scrollend", release, { once: true });
     releasePinRef.current = release;
   };
   const handleClick = (id) => (event) => {
@@ -112,7 +124,7 @@ function TableOfContents({
     onNavigate?.(id);
   };
   const navClass = [classes.root, className].filter(Boolean).join(" ");
-  return /* @__PURE__ */ jsxs("nav", { className: navClass, "aria-label": title, children: [
+  return /* @__PURE__ */ jsxs("nav", { ref: navRef, className: navClass, "aria-label": title, children: [
     /* @__PURE__ */ jsx("div", { className: classes.header, children: title }),
     /* @__PURE__ */ jsx("ul", { className: classes.list, children: resolvedItems.map((item) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
       "a",
@@ -123,6 +135,7 @@ function TableOfContents({
           item.level >= 3 && classes.sub,
           activeId === item.id && classes.active
         ].filter(Boolean).join(" "),
+        "aria-current": activeId === item.id ? "location" : void 0,
         onClick: handleClick(item.id),
         children: item.label
       }