@sakura-ui/sakura-ui 0.5.2 → 0.5.4

package/packages/markdown/dist/types/components/Markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../src/components/Markdown.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,KAAK,WAAW,EAA6B,MAAM,WAAW,CAAA;AASvE,UAAU,QAAQ;IAChB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AAED,eAAO,MAAM,eAAe,GAAI,WAAW,QAAQ,sBAelD,CAAA;AAED,yBAAiB,QAAQ,CAAC;IACxB,UAAiB,KAAK;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,0DAA0D;QAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;KACjB;CACF;AAED,eAAO,MAAM,QAAQ,GAAI,4DAMtB,QAAQ,CAAC,KAAK,sBAoChB,CAAA"}
+{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../src/components/Markdown.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,KAAK,WAAW,EAA6B,MAAM,WAAW,CAAA;AASvE,UAAU,QAAQ;IAChB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AAED,eAAO,MAAM,eAAe,GAAI,WAAW,QAAQ,sBAelD,CAAA;AAED,yBAAiB,QAAQ,CAAC;IACxB,UAAiB,KAAK;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,0DAA0D;QAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;KACjB;CACF;AAED,eAAO,MAAM,QAAQ,GAAI,4DAMtB,QAAQ,CAAC,KAAK,sBAkDhB,CAAA"}

package/packages/markdown/dist/types/decorate.d.ts

@@ -1,11 +1,8 @@
 /**
  * Applies the look of the design system to the finished document.
  *
- * This runs over the sanitised DOM rather than inside the markdown renderer so
- * that a table written as raw HTML — 56 of the guide's documents do — is styled
- * the same as one written with pipes. The pipeline this replaces had the same
- * property, because rehype-raw turned the raw HTML into real nodes before the
- * tag to component mapping ran.
+ * Runs over the sanitised DOM rather than inside the markdown renderer, so that
+ * a table written as raw HTML is styled the same as one written with pipes.
  */
 export type HeadingItem = {
     id?: string;

package/packages/markdown/dist/types/decorate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorate.d.ts","sourceRoot":"","sources":["../../src/decorate.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CACzB,CAAA;AAsDD,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAA;CACxB,CAAA;AAID,eAAO,MAAM,QAAQ,GACnB,MAAM,gBAAgB,GAAG,OAAO,EAChC,UAAU,QAAQ,EAClB,SAAS,eAAe,KACvB,cA2EF,CAAA"}
+{"version":3,"file":"decorate.d.ts","sourceRoot":"","sources":["../../src/decorate.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CACzB,CAAA;AAsDD,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAA;CACxB,CAAA;AAID,eAAO,MAAM,QAAQ,GACnB,MAAM,gBAAgB,GAAG,OAAO,EAChC,UAAU,QAAQ,EAClB,SAAS,eAAe,KACvB,cAyEF,CAAA"}

package/packages/markdown/dist/types/marked/attributes.d.ts

@@ -2,14 +2,11 @@ export type Attrs = Record<string, string>;
 /**
  * Where `{#name}` is kept, apart from anything written as `key=value`.
  *
- * A sigil says something about the element itself and means the same on every
- * directive; an attribute is the directive's own, and each reads the ones it
- * knows. Keeping them in one place would let a directive that wanted an
- * attribute called `id` take the anchor's place, which is how the video on a
- * youtube embed came to be called `id` and stayed that way.
- *
+ * A sigil describes the element and means the same on every directive; an
+ * attribute belongs to whichever directive reads it. Held apart so that a
+ * directive wanting an attribute called `id` cannot take the anchor's place.
  * A key beginning with `#` cannot be written as `key=value`, since an attribute
- * name has to start with a letter, so there is nowhere for the two to meet.
+ * name has to start with a letter.
  */
 export declare const ANCHOR = "#id";
 /** Parses the inside of `{...}`: `key=value key2="値 2" #id .cls` */

package/packages/markdown/dist/types/marked/attributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/marked/attributes.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE1C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,oEAAoE;AACpE,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,GAAG,IAAI,KAAG,KAkBhD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,KAAK,MAAM,EACX,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,OAAO,MAAM,KACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAkBnC,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,QAAQ,GACnB,KAAK,MAAM,EACX,GAAG,MAAM,KACR;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAcnD,CAAA"}
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/marked/attributes.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,oEAAoE;AACpE,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,GAAG,IAAI,KAAG,KAkBhD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,KAAK,MAAM,EACX,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,OAAO,MAAM,KACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAkBnC,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,QAAQ,GACnB,KAAK,MAAM,EACX,GAAG,MAAM,KACR;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAcnD,CAAA"}

package/packages/markdown/dist/types/marked/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/marked/registry.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,cAAc,CAAA;AACpC,eAAO,MAAM,IAAI,SAAS,CAAA;AAC1B,eAAO,MAAM,IAAI,SAAS,CAAA;AAE1B,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,GAAG,OAAO,IAAI,GAAG,OAAO,IAAI,CAAA;AAyBxE,+EAA+E;AAC/E,eAAO,MAAM,OAAO,QAAiC,CAAA;AAErD,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,EAAE,MAAM,aAAa,KAAG,OACmB,CAAA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/marked/registry.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,cAAc,CAAA;AACpC,eAAO,MAAM,IAAI,SAAS,CAAA;AAC1B,eAAO,MAAM,IAAI,SAAS,CAAA;AAE1B,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,GAAG,OAAO,IAAI,GAAG,OAAO,IAAI,CAAA;AAsBxE,+EAA+E;AAC/E,eAAO,MAAM,OAAO,QAAiC,CAAA;AAErD,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,EAAE,MAAM,aAAa,KAAG,OACmB,CAAA"}

package/packages/markdown/dist/types/marked/renderer.d.ts

@@ -1,13 +1,11 @@
 import type { DirectiveToken } from './tokenizer';
 import { type Parser, type RendererOptions } from './directives';
 /**
- * Builds what a directive renderer is given, then hands the token to the one
- * that knows it. The renderers themselves live in `directives/`, a file to a
- * feature: `card.ts` holds the card and everything written inside one, because
- * a title has to know whether the card gave it an href.
+ * Builds the context, then hands the token to the renderer that knows its name.
+ * The renderers live in `directives/`, a file to a feature, so that a card and
+ * everything written inside one stay together.
  *
- * A name with no renderer falls through to its own children, which is what a
- * directive the registry allows but nobody has drawn yet looks like.
+ * A name with no renderer falls through to its own children.
  */
 export declare function directiveRenderer(this: {
     parser: Parser;

package/packages/markdown/dist/types/marked/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/marked/renderer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,eAAe,EACrB,MAAM,cAAc,CAAA;AAErB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACxB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,eAAe,GACvB,MAAM,CAyBR;AAED,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/marked/renderer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,eAAe,EACrB,MAAM,cAAc,CAAA;AAErB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACxB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,eAAe,GACvB,MAAM,CAyBR;AAED,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/packages/markdown/dist/types/marked/tokenizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../src/marked/tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,cAAc,CAAA;AACnD,OAAO,EAAa,KAAK,aAAa,EAAuB,MAAM,YAAY,CAAA;AAE/E,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,OAAO;IACpD,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AA4BD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAGjD,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAGlD,CAAA;AA+CD,wBAAgB,cAAc,CAC5B,IAAI,EAAE;IACJ,KAAK,EAAE;QACL,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,EAAE,CAAA;QACrC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,CAAA;KAC/C,CAAA;CACF,EACD,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,SAAS,CAsC5B;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE;IAAE,KAAK,EAAE;QAAE,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,EAAE,CAAA;KAAE,CAAA;CAAE,EAC3D,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,SAAS,CAiB5B"}
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../src/marked/tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,cAAc,CAAA;AACnD,OAAO,EAAa,KAAK,aAAa,EAAuB,MAAM,YAAY,CAAA;AAE/E,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,OAAO;IACpD,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AA4BD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAGjD,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAGlD,CAAA;AA6CD,wBAAgB,cAAc,CAC5B,IAAI,EAAE;IACJ,KAAK,EAAE;QACL,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,EAAE,CAAA;QACrC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,CAAA;KAC/C,CAAA;CACF,EACD,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,SAAS,CAsC5B;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE;IAAE,KAAK,EAAE;QAAE,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,EAAE,CAAA;KAAE,CAAA;CAAE,EAC3D,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,SAAS,CAiB5B"}

package/packages/markdown/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sakura-ui/markdown",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "",
   "keywords": [
     "markdown"

package/packages/markdown/src/components/Markdown.tsx

@@ -1,4 +1,4 @@
-import { H2, Link, Ul } from '@sakura-ui/core'
+import { Link, Ul } from '@sakura-ui/core'
 import React from 'react'
 import { type HeadingItem, render, type RenderResult } from '../render'
 
@@ -74,14 +74,28 @@ export const Markdown = ({
     <div className="py-8 flex flex-col gap-8">
       {showToc && headings.length > 0 && (
         <nav className="rounded-3xl p-10 bg-yellow-50">
-          <H2 className="pt-0">{tocTitle}</H2>
+          {/*
+            The label on a box, not a heading in the document, so it does not
+            use core's H2 and its heading size and spacing.
+          */}
+          <h2 className="mb-4 font-bold text-h-xs-m sm:text-h-xs">
+            {tocTitle}
+          </h2>
           <Ul>
             <TableOfContents items={headings} />
           </Ul>
         </nav>
       )}
-      {/* The markup is sanitised in src/sanitize.ts before it gets here. */}
-      <div dangerouslySetInnerHTML={{ __html: html }} />
+      {/*
+        The document's blocks are children of this element, not of the wrapper,
+        so the space between them is set here.
+
+        The markup is sanitised in src/sanitize.ts before it gets here.
+      */}
+      <div
+        className="flex flex-col gap-8"
+        dangerouslySetInnerHTML={{ __html: html }}
+      />
     </div>
   )
 }

package/packages/markdown/src/decorate.ts

@@ -5,11 +5,8 @@ import { classNames } from './marked/html'
 /**
  * Applies the look of the design system to the finished document.
  *
- * This runs over the sanitised DOM rather than inside the markdown renderer so
- * that a table written as raw HTML — 56 of the guide's documents do — is styled
- * the same as one written with pipes. The pipeline this replaces had the same
- * property, because rehype-raw turned the raw HTML into real nodes before the
- * tag to component mapping ran.
+ * Runs over the sanitised DOM rather than inside the markdown renderer, so that
+ * a table written as raw HTML is styled the same as one written with pipes.
  */
 
 export type HeadingItem = {
@@ -113,9 +110,7 @@ export const decorate = (
     const tag = element.tagName.toLowerCase()
 
     // One id, generated once, for headings from markdown and from raw HTML
-    // alike. The pipeline this replaces generated them in two passes that
-    // disagreed whenever a heading held an image, raw HTML or a directive, and
-    // the table of contents then linked to anchors that were not there.
+    // alike, so the table of contents and the body cannot disagree.
     if (HEADINGS.has(tag)) {
       const text = element.textContent ?? ''
       const asked = element.getAttribute('id')

package/packages/markdown/src/marked/attributes.ts

@@ -6,14 +6,11 @@ export type Attrs = Record<string, string>
 /**
  * Where `{#name}` is kept, apart from anything written as `key=value`.
  *
- * A sigil says something about the element itself and means the same on every
- * directive; an attribute is the directive's own, and each reads the ones it
- * knows. Keeping them in one place would let a directive that wanted an
- * attribute called `id` take the anchor's place, which is how the video on a
- * youtube embed came to be called `id` and stayed that way.
- *
+ * A sigil describes the element and means the same on every directive; an
+ * attribute belongs to whichever directive reads it. Held apart so that a
+ * directive wanting an attribute called `id` cannot take the anchor's place.
  * A key beginning with `#` cannot be written as `key=value`, since an attribute
- * name has to start with a letter, so there is nowhere for the two to meet.
+ * name has to start with a letter.
  */
 export const ANCHOR = '#id'
 

package/packages/markdown/src/marked/directives/card.ts

@@ -12,8 +12,8 @@ const iconHtml = (name: string, altText: string): string =>
 
 export const cardRenderers: Record<string, DirectiveRenderer> = {
   card: ({ token, attrs, root, body, nl }) => {
-    // The tokenizer withholds linked from a card with no title, which has no
-    // link to give and so must not look as though it had one.
+    // Set by the tokenizer, and only when the card has a title to put the
+    // link on. A card without one must not look as though it were clickable.
     const isLink = Boolean(token.linked)
     const cls = classNames(
       styles.cardStyle,

package/packages/markdown/src/marked/html.ts

@@ -31,9 +31,9 @@ export const cleanUrl = (href: string | undefined): string | undefined => {
   if (href == null || href === '') return undefined
   const trimmed = stripControl(String(href)).trim()
   if (/^(?:javascript|vbscript|file):/i.test(trimmed)) return undefined
-  // Images written as data: used to be kept here and dropped nowhere, since
-  // DOMPurify allows the scheme on an img whatever ALLOWED_URI_REGEXP says. The
-  // content has no use for it, so both this and the sanitiser refuse it now.
+  // Refused here and in the sanitiser both: DOMPurify allows the scheme on an
+  // img whatever ALLOWED_URI_REGEXP says, so this is the only place a directive
+  // writing one is turned back.
   if (/^data:/i.test(trimmed)) return undefined
   return trimmed
 }

package/packages/markdown/src/marked/registry.ts

@@ -6,11 +6,8 @@ export type DirectiveKind = typeof CONTAINER | typeof LEAF | typeof TEXT
 
 /**
  * The whitelist. A name that is not here is not a directive, and the text
- * carrying it is left alone.
- *
- * The remark pipeline this replaces turned any name into a tag of the same
- * name, so ordinary prose lost characters: "HH:MM" rendered as "HH", and
- * "chat:write" as "chat".
+ * carrying it is left alone — which is what keeps "HH:MM" and "chat:write"
+ * intact in the prose.
  */
 const STATIC: Record<string, DirectiveKind[]> = {
   card: [CONTAINER],

package/packages/markdown/src/marked/renderer.ts

@@ -10,13 +10,11 @@ import {
 } from './directives'
 
 /**
- * Builds what a directive renderer is given, then hands the token to the one
- * that knows it. The renderers themselves live in `directives/`, a file to a
- * feature: `card.ts` holds the card and everything written inside one, because
- * a title has to know whether the card gave it an href.
+ * Builds the context, then hands the token to the renderer that knows its name.
+ * The renderers live in `directives/`, a file to a feature, so that a card and
+ * everything written inside one stay together.
  *
- * A name with no renderer falls through to its own children, which is what a
- * directive the registry allows but nobody has drawn yet looks like.
+ * A name with no renderer falls through to its own children.
  */
 export function directiveRenderer(
   this: { parser: Parser },

package/packages/markdown/src/marked/tokenizer.ts

@@ -60,14 +60,12 @@ export const inlineStart = (src: string): number | undefined => {
 }
 
 /**
- * A grid of cards is a list. The cards are things of one kind, and how many
- * there are is part of what the page says; a grid holding anything else, or
- * cards and something else together, is a layout — prose beside a figure is not
- * two of something. Nothing is written to ask for this, the way nothing is
- * written to ask a run of "- " for a <ul>.
+ * A grid of cards is a list: the cards are things of one kind, and how many
+ * there are is part of what the page says. A grid holding anything else, or
+ * cards mixed with something else, is a layout.
  *
- * Marked here rather than worked out while rendering, because by then the
- * children have become one string and the boundaries between them are gone.
+ * Marked here rather than while rendering, because by then the children are one
+ * string with no boundaries between them.
  */
 const markCardList = (token: DirectiveToken): void => {
   if (!/^grid-cols-\d+$/.test(token.name)) return