@bendyline/squisq 2.2.0 → 2.3.1

package/NOTICE.md

@@ -1,24 +1,26 @@
 # Third-Party Notices for @bendyline/squisq
 
-This notice applies to the `@bendyline/squisq` npm package. Squisq-authored
-code is licensed under the MIT license in `LICENSE`. Third-party components
-remain under their respective license terms.
+This notice applies to the `@bendyline/squisq` npm package.
+Squisq-authored code is licensed under the MIT license in `LICENSE`.
+Third-party components remain under their respective license terms.
 
-## Runtime dependencies
+## Runtime and generated-data dependencies
 
-| Package             | Version | License    | Repository                                                             |
-| ------------------- | ------- | ---------- | ---------------------------------------------------------------------- |
-| genson-js           | 0.0.8   | Apache-2.0 | https://github.com/aspecto-io/genson-js                                |
-| hast-util-from-html | 2.0.3   | MIT        | https://github.com/syntax-tree/hast-util-from-html                     |
-| localforage         | 1.10.0  | Apache-2.0 | https://github.com/localForage/localForage                             |
-| ngeohash            | 0.6.3   | MIT        | https://github.com/sunng87/node-geohash                                |
-| remark-directive    | 3.0.1   | MIT        | https://github.com/remarkjs/remark-directive                           |
-| remark-frontmatter  | 5.0.0   | MIT        | https://github.com/remarkjs/remark-frontmatter                         |
-| remark-gfm          | 4.0.1   | MIT        | https://github.com/remarkjs/remark-gfm                                 |
-| remark-math         | 6.0.0   | MIT        | https://github.com/remarkjs/remark-math                                |
-| remark-parse        | 11.0.0  | MIT        | https://github.com/remarkjs/remark/tree/main/packages/remark-parse     |
-| remark-stringify    | 11.0.0  | MIT        | https://github.com/remarkjs/remark/tree/main/packages/remark-stringify |
-| unified             | 11.0.5  | MIT        | https://unifiedjs.com                                                  |
+| Package                                   | Version | License                       | Repository                                                             |
+| ----------------------------------------- | ------- | ----------------------------- | ---------------------------------------------------------------------- |
+| genson-js                                 | 0.0.8   | Apache-2.0                    | https://github.com/aspecto-io/genson-js                                |
+| hast-util-from-html                       | 2.0.3   | MIT                           | https://github.com/syntax-tree/hast-util-from-html                     |
+| localforage                               | 1.10.0  | Apache-2.0                    | https://github.com/localForage/localForage                             |
+| ngeohash                                  | 0.6.3   | MIT                           | https://github.com/sunng87/node-geohash                                |
+| remark-directive                          | 3.0.1   | MIT                           | https://github.com/remarkjs/remark-directive                           |
+| remark-frontmatter                        | 5.0.0   | MIT                           | https://github.com/remarkjs/remark-frontmatter                         |
+| remark-gfm                                | 4.0.1   | MIT                           | https://github.com/remarkjs/remark-gfm                                 |
+| remark-math                               | 6.0.0   | MIT                           | https://github.com/remarkjs/remark-math                                |
+| remark-parse                              | 11.0.0  | MIT                           | https://github.com/remarkjs/remark/tree/main/packages/remark-parse     |
+| remark-stringify                          | 11.0.0  | MIT                           | https://github.com/remarkjs/remark/tree/main/packages/remark-stringify |
+| unified                                   | 11.0.5  | MIT                           | https://unifiedjs.com                                                  |
+| @fortawesome/fontawesome-free _(bundled)_ | 7.2.0   | CC-BY-4.0 AND OFL-1.1 AND MIT | https://github.com/FortAwesome/Font-Awesome                            |
 
-Copyright and complete license texts for these dependencies are included in
-their respective npm distributions and source repositories.
+The generated icon catalog incorporates Font Awesome Free metadata. Exact
+third-party license texts for bundled code and data are shipped in
+THIRD_PARTY_LICENSES.txt.

package/README.md

@@ -25,14 +25,14 @@ npm install @bendyline/squisq
 
 ## New in this release
 
-The Squiggly Square markdown standard (see [`docs/SquigglySquare.md`](../../docs/SquigglySquare.md)) gained several authoring capabilities:
-
-- **[Standalone annotations](../../docs/SquigglySquare.md#standalone-annotations)** — a top-level paragraph that is exactly `{[templateName …]}` becomes a heading-less template block; the body that follows it is its contents.
-- **[Inline attribute coercion](../../docs/SquigglySquare.md#inline-attribute-coercion)** — `{[map center="47.6,-122.3" zoom=9]}` and `{[twoColumn left="Espresso|Bold"]}` now render without a data fence (typed via `TEMPLATE_INPUT_DESCRIPTORS`).
-- **[Validation additions](../../docs/SquigglySquare.md#validation)** — new `unknown-input` / `invalid-input-value` / `missing-input` warnings plus `possible-data-fence` / `conflicting-annotation-key` info diagnostics (a new `info` severity).
-- **[YAML data fences](../../docs/SquigglySquare.md#structured-data-fences)** now accept one level of nested mappings (a `map` `center` can be pure YAML).
-- **[Multi-line frontmatter](../../docs/SquigglySquare.md#multi-line-frontmatter)** — `squisq-custom-templates` / `squisq-custom-themes` can be authored as pretty JSON via YAML literal block scalars (`key: |-`).
-- **Custom-template tokens v2** (see [`docs/SquigglySquare.md`](../../docs/SquigglySquare.md), "Registering custom templates") — `{attr:key}`, pipe defaults on every token, and per-layer `repeat` with `{item}` / `{index}` tokens.
+The Squiggly Square markdown standard (see [`docs/SquigglySquare.md`](https://github.com/bendyline/squisq/blob/main/docs/SquigglySquare.md)) gained several authoring capabilities:
+
+- **[Standalone annotations](https://github.com/bendyline/squisq/blob/main/docs/SquigglySquare.md#standalone-annotations)** — a top-level paragraph that is exactly `{[templateName …]}` becomes a heading-less template block; the body that follows it is its contents.
+- **[Inline attribute coercion](https://github.com/bendyline/squisq/blob/main/docs/SquigglySquare.md#inline-attribute-coercion)** — `{[map center="47.6,-122.3" zoom=9]}` and `{[twoColumn left="Espresso|Bold"]}` now render without a data fence (typed via `TEMPLATE_INPUT_DESCRIPTORS`).
+- **[Validation additions](https://github.com/bendyline/squisq/blob/main/docs/SquigglySquare.md#validation)** — new `unknown-input` / `invalid-input-value` / `missing-input` warnings plus `possible-data-fence` / `conflicting-annotation-key` info diagnostics (a new `info` severity).
+- **[YAML data fences](https://github.com/bendyline/squisq/blob/main/docs/SquigglySquare.md#structured-data-fences)** now accept one level of nested mappings (a `map` `center` can be pure YAML).
+- **[Multi-line frontmatter](https://github.com/bendyline/squisq/blob/main/docs/SquigglySquare.md#multi-line-frontmatter)** — `squisq-custom-templates` / `squisq-custom-themes` can be authored as pretty JSON via YAML literal block scalars (`key: |-`).
+- **Custom-template tokens v2** (see [`docs/SquigglySquare.md`](https://github.com/bendyline/squisq/blob/main/docs/SquigglySquare.md), "Registering custom templates") — `{attr:key}`, pipe defaults on every token, and per-layer `repeat` with `{item}` / `{index}` tokens.
 
 New `@bendyline/squisq/doc` exports powering the above: `coerceTemplateParams`, `lintTemplateParams`, `TEMPLATE_INPUT_DESCRIPTORS`, and `replaceDataFence`.
 

package/THIRD_PARTY_LICENSES.txt

@@ -0,0 +1,178 @@
+THIRD-PARTY LICENSES FOR @bendyline/squisq
+
+Generated from the actual esbuild input graph. Package-local license, copying,
+and notice files are reproduced verbatim. When an npm tarball omits its
+repository license, the pinned upstream copy is vendored and identified below.
+
+COMPONENTS
+- @fortawesome/fontawesome-free@7.2.0 ((CC-BY-4.0 AND OFL-1.1 AND MIT)); files: LICENSE.txt
+
+==============================================================================
+@fortawesome/fontawesome-free@7.2.0 - LICENSE.txt
+==============================================================================
+Fonticons, Inc. (https://fontawesome.com)
+
+--------------------------------------------------------------------------------
+
+Font Awesome Free License
+
+Font Awesome Free is free, open source, and GPL friendly. You can use it for
+commercial projects, open source projects, or really almost whatever you want.
+Full Font Awesome Free license: https://fontawesome.com/license/free.
+
+--------------------------------------------------------------------------------
+
+# Icons: CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)
+
+The Font Awesome Free download is licensed under a Creative Commons
+Attribution 4.0 International License and applies to all icons packaged
+as SVG and JS file types.
+
+--------------------------------------------------------------------------------
+
+# Fonts: SIL OFL 1.1 License
+
+In the Font Awesome Free download, the SIL OFL license applies to all icons
+packaged as web and desktop font files.
+
+Copyright (c) 2026 Fonticons, Inc. (https://fontawesome.com)
+with Reserved Font Name: "Font Awesome".
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+SIL OPEN FONT LICENSE
+Version 1.1 - 26 February 2007
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting — in part or in whole — any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+# Code: MIT License (https://opensource.org/licenses/MIT)
+
+In the Font Awesome Free download, the MIT license applies to all non-font and
+non-icon files.
+
+Copyright 2026 Fonticons, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in the
+Software without restriction, including without limitation the rights to use, copy,
+modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
+and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+# Attribution
+
+Attribution is required by MIT, SIL OFL, and CC BY licenses. Downloaded Font
+Awesome Free files already contain embedded comments with sufficient
+attribution, so you shouldn't need to do anything additional when using these
+files normally.
+
+We've kept attribution comments terse, so we ask that you do not actively work
+to remove them from files, especially code. They're a great way for folks to
+learn about Font Awesome.
+
+--------------------------------------------------------------------------------
+
+# Brand Icons
+
+All brand icons are trademarks of their respective owners. The use of these
+trademarks does not indicate endorsement of the trademark holder by Font
+Awesome, nor vice versa. **Please do not use brand logos for any purpose except
+to represent the company, product, or service to which they refer.**
+

package/dist/{Doc-BubIpWsp.d.ts → Doc-COe-rPQB.d.ts}

@@ -415,6 +415,8 @@ interface StatHighlightInput extends BaseTemplateBlock {
  */
 interface QuoteBlockInput extends BaseTemplateBlock {
     template: 'quote';
+    /** Optional heading above the quote. */
+    title?: string;
     /** The quote text (supports \n for line breaks) */
     quote: string;
     /** Attribution (author, source) */
@@ -757,10 +759,10 @@ interface VideoWithCaptionInput extends BaseTemplateBlock {
     posterSrc?: string;
     /** Alt text for accessibility */
     videoAlt: string;
-    /** Start time within source video (seconds) */
-    clipStart: number;
-    /** End time within source video (seconds) */
-    clipEnd: number;
+    /** Start time within source video (seconds). Defaults to 0. */
+    clipStart?: number;
+    /** End time within source video (seconds). Defaults to the block duration. */
+    clipEnd?: number;
     /** Source video total duration (for validation) */
     sourceDuration?: number;
     /** Caption text overlay */

package/dist/{ImageEditDoc-CGxk5CHc.d.ts → ImageEditDoc-dtKahVyD.d.ts}

@@ -1,4 +1,4 @@
-import { R as ImageLayer, a$ as TextLayer, aO as ShapeLayer, aw as PathLayer } from './Doc-BubIpWsp.js';
+import { R as ImageLayer, a$ as TextLayer, aO as ShapeLayer, aw as PathLayer } from './Doc-COe-rPQB.js';
 
 /**
  * ImageEditDoc — JSON document describing a layered, editable image.

package/dist/{chunk-I2O6W7DX.js → chunk-3FRUQLQR.js}

@@ -24,7 +24,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-7ARJZYQY.js";
+} from "./chunk-E3RXZUNP.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -40,7 +40,7 @@ import {
   toCells,
   toGrid,
   traceBoxes
-} from "./chunk-FDYDYL77.js";
+} from "./chunk-QWCFK5FN.js";
 import {
   defaultPageStyle,
   resolveMediaSchedule
@@ -537,8 +537,12 @@ function resolvePageBlock(block) {
   };
   const coercedParams = coerceTemplateParams(rawName, rawParams).input;
   let base;
+  let derivedInputs = null;
   if (annotation) {
     const headingText = extractPlainText(block.sourceHeading);
+    derivedInputs = deriveTemplateInputs(rawName, headingText, block.contents, {
+      placeholders: true
+    });
     base = {
       id: block.id,
       template: rawName,
@@ -548,9 +552,7 @@ function resolvePageBlock(block) {
       title: headingText,
       contents: block.contents,
       children: block.children,
-      ...deriveTemplateInputs(rawName, headingText, block.contents, {
-        placeholders: true
-      }) ?? {}
+      ...derivedInputs ?? {}
     };
   } else {
     base = {
@@ -566,6 +568,14 @@ function resolvePageBlock(block) {
     ...block.templateData ?? {},
     ...coercedParams
   };
+  const explicitQuote = Object.prototype.hasOwnProperty.call(coercedParams, "quote") ? coercedParams.quote : block.templateData?.quote;
+  if (templateName === "quote" && derivedInputs && !Object.prototype.hasOwnProperty.call(derivedInputs, "title") && !(typeof explicitQuote === "string" && explicitQuote.trim())) {
+    const quoteInput = templateBlock;
+    quoteInput.quote = derivedInputs.quote;
+    if (!Object.prototype.hasOwnProperty.call(block.templateData ?? {}, "title") && !Object.prototype.hasOwnProperty.call(coercedParams, "title")) {
+      delete quoteInput.title;
+    }
+  }
   return { templated: true, templateName, templateBlock };
 }
 
@@ -642,6 +652,7 @@ var quote = (input) => {
     kind: "quote-band",
     variant: "plain",
     slots: {
+      title: q.title,
       body: { text: q.quote ?? "" },
       attribution: q.attribution,
       media: accentImageMedia(q.accentImage)
@@ -1791,9 +1802,10 @@ var PAGE_BASE_CSS = `
 .squisq-page-prose p + p { margin-top: 1.25em; }
 .squisq-page-prose > * + * { margin-top: 1.1em; }
 .squisq-page-prose a { color: var(--squisq-page-primary); text-decoration-color: color-mix(in srgb, var(--squisq-page-primary) 40%, transparent); }
-.squisq-page-prose code { font-family: var(--squisq-page-mono-font); font-size: 0.9em; background: color-mix(in srgb, var(--squisq-page-text) 8%, transparent); border-radius: 4px; padding: 0.12em 0.35em; }
+.squisq-page-prose code { font-family: var(--squisq-page-mono-font); font-size: 0.9em; }
+.squisq-page-prose :not(pre) > code { background: color-mix(in srgb, var(--squisq-page-text) 8%, transparent); border-radius: 4px; padding: 0.12em 0.35em; }
 .squisq-page-prose pre { background: color-mix(in srgb, var(--squisq-page-text) 6%, transparent); border-radius: var(--squisq-page-radius); padding: 1em 1.25em; overflow-x: auto; }
-.squisq-page-prose pre code { background: none; padding: 0; }
+.squisq-page-prose pre code { background: none; border-radius: 0; padding: 0; }
 .squisq-page-prose blockquote { margin: 0; border-left: 4px solid var(--squisq-page-accent); padding-left: 1.25em; color: var(--squisq-page-text-muted); }
 .squisq-page-prose ul, .squisq-page-prose ol { padding-left: 1.5em; margin: 0; }
 .squisq-page-prose li + li { margin-top: 0.4em; }
@@ -2488,33 +2500,45 @@ function checkAssets(markdownDoc, blocks, hasAsset, diagnostics) {
       ...line != null ? { line } : {}
     });
   };
+  const markdownUrls = /* @__PURE__ */ new Set();
   const walk = (node) => {
     if (node.type === "image") {
+      markdownUrls.add(node.url);
       report(node.url, node.position?.start.line);
     }
     if (node.type === "htmlBlock" || node.type === "htmlInline") {
-      walkHtmlImages(node.htmlChildren, (src) => report(src, node.position?.start.line));
+      walkHtmlImages(node.htmlChildren, (src) => {
+        markdownUrls.add(src);
+        report(src, node.position?.start.line);
+      });
     }
     for (const child of getChildren(node)) walk(child);
   };
   for (const child of markdownDoc.children) walk(child);
   for (const block of blocks) {
+    const authoredUrls = /* @__PURE__ */ new Set();
     const sources = [
-      block.templateOverrides,
-      block.templateData
+      { value: block.templateOverrides, derived: false },
+      { value: block.templateData, derived: true }
     ];
-    for (const source of sources) {
+    for (const { value: source, derived } of sources) {
       if (!source) continue;
       for (const key of ASSET_PARAM_KEYS) {
         const value = source[key];
         if (typeof value === "string") {
-          report(value, block.sourceHeading?.position?.start.line, block.id);
+          if (!derived) authoredUrls.add(value);
+          if (!derived || !markdownUrls.has(value) && !authoredUrls.has(value)) {
+            report(value, block.sourceHeading?.position?.start.line, block.id);
+          }
         }
       }
       const images = source["images"];
       const list2 = typeof images === "string" ? images.split(",").map((s) => s.trim()) : Array.isArray(images) ? images.filter((i) => typeof i === "string") : [];
       for (const img of list2) {
-        report(img, block.sourceHeading?.position?.start.line, block.id);
+        if (!derived) authoredUrls.add(img);
+        if (!derived || !markdownUrls.has(img) && !authoredUrls.has(img)) {
+          report(img, block.sourceHeading?.position?.start.line, block.id);
+        }
       }
     }
   }