@kensio/colophon 2.15.3 → 2.15.5

package/README.md

@@ -99,7 +99,7 @@ together.
 Full documentation is in [`docs/`](./docs/).
 
 - [Getting started](./docs/getting-started/ "Install, frontmatter, config and the CLI")
-- [The command line](./docs/cli/ "Every command and flag, including init, preview, eject, dry runs and watching")
+- [The command line](./docs/cli/ "Every command and flag, including init, preview, playground links, eject, dry runs and watching")
 - [Templates](./docs/templates/ "The built-in layouts and how to register your own")
 - [The code template](./docs/code-template/ "Syntax-highlighted code images")
 - [Astro](./docs/astro/ "The integration and the meta tags component")

package/dist/cli/args/command.d.ts

@@ -1,13 +1,13 @@
 /** What the CLI has been asked to do. */
-export type CliCommand = "generate" | "init" | "preview" | "eject";
+export type CliCommand = "generate" | "init" | "preview" | "playground" | "eject";
 /**
  * Read the command out of the first argument.
  *
  * It is a command only where it names one: `colophon content` has always meant
  * "build this tree", so a bare positional stays the content directory, and a
  * subcommand is an addition to that rather than a replacement for it. The cost
- * is that a content directory called `init` or `preview` has to be written as
- * `./init`, which is worth saying in the help text and no more.
+ * is that a content directory named after any command has to be written with
+ * a relative path such as `./init`. The help text says so.
  */
 export declare function commandOf(first: string | undefined): CliCommand;
 //# sourceMappingURL=command.d.ts.map

package/dist/cli/args/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/cli/args/command.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAYnE;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAE/D"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/cli/args/command.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,MAAM,GACN,SAAS,GACT,YAAY,GACZ,OAAO,CAAC;AAaZ;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAE/D"}

package/dist/cli/args/command.js

@@ -5,6 +5,7 @@
 const named = {
     init: "init",
     preview: "preview",
+    playground: "playground",
     eject: "eject",
 };
 /**
@@ -13,8 +14,8 @@ const named = {
  * It is a command only where it names one: `colophon content` has always meant
  * "build this tree", so a bare positional stays the content directory, and a
  * subcommand is an addition to that rather than a replacement for it. The cost
- * is that a content directory called `init` or `preview` has to be written as
- * `./init`, which is worth saying in the help text and no more.
+ * is that a content directory named after any command has to be written with
+ * a relative path such as `./init`. The help text says so.
  */
 export function commandOf(first) {
     return (first === undefined ? undefined : named[first]) ?? "generate";

package/dist/cli/args/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/cli/args/command.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,KAAK,GAAyC;IAClD,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC;AACxE,CAAC"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/cli/args/command.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,KAAK,GAAyC;IAClD,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC;AACxE,CAAC"}

package/dist/cli/args/index.d.ts

@@ -11,7 +11,7 @@ export interface CliArgs {
      * `generate` reads as the default and `init` as an invitation to guess.
      */
     readonly contentDir: string | undefined;
-    /** The post `preview` renders. */
+    /** The post `preview` renders or `playground` includes. */
     readonly file: string | undefined;
     /** What `eject` writes, naming the generator it is for. */
     readonly adapter: string | undefined;
@@ -20,7 +20,7 @@ export interface CliArgs {
     readonly dryRun: boolean;
     readonly watch: boolean;
     readonly concurrency: number | undefined;
-    /** Which configured size `preview` renders. */
+    /** Which configured size `preview` renders or `playground` opens. */
     readonly size: string | undefined;
 }
 /** Read the command line into the options each command takes. */

package/dist/cli/args/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/args/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AA2CD,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAyC7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/args/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AA4CD,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAyC7D"}

package/dist/cli/args/index.js

@@ -13,7 +13,8 @@ function target(command, positionals) {
     const first = positionals[0];
     const empty = { contentDir: undefined, file: undefined, adapter: undefined };
     switch (command) {
-        case "preview": {
+        case "preview":
+        case "playground": {
             return { ...empty, file: first };
         }
         case "eject": {

package/dist/cli/args/index.js.map

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

package/dist/cli/args/usage.d.ts

@@ -1,3 +1,3 @@
 /** Help text for `--help`, and for a run that asks for nothing else. */
-export declare const usage = "colophon: generate social meta images from frontmatter\n\nUsage:\n  colophon [contentDir] [options]    Render the images for a content tree\n  colophon init [contentDir]         Write a starter config module\n  colophon preview <file> [options]  Render one post and open it\n  colophon eject hugo                Write a Hugo partial that reads the\n                                     manifest and emits the meta tags\n\nImages carry a stamp of the props, config and size they came from, so a rebuild\nrenders only the ones that have actually changed.\n\nOptions:\n  -c, --config <path>   Load a config module. Its default export is either a\n                        ColophonConfig or a function (async or not) returning\n                        one, for a config that has to compute something.\n  -f, --force           Re-render every image, ignoring the stamps. For init\n                        and eject, overwrite a file that is already there\n  -o, --overwrite       Alias for --force\n  -n, --dry-run         Report what would change and write nothing\n  -w, --watch           Rebuild whenever a content file changes\n  --concurrency <n>     How many images to render at once\n  --size <name>         Which configured size preview renders\n  -h, --help            Show this help\n\nDefaults:\n  contentDir            content\n  --concurrency         one per available CPU\n  --size                the first configured size\n\nThe first argument is a command where it names one, so a content directory\ncalled init, preview or eject has to be written as ./init.";
+export declare const usage = "colophon: generate social meta images from frontmatter\n\nUsage:\n  colophon [contentDir] [options]    Render the images for a content tree\n  colophon init [contentDir]         Write a starter config module\n  colophon preview <file> [options]  Render one post and open it\n  colophon playground [file] [options]\n                                     Print a playground link for this project\n  colophon eject hugo                Write a Hugo partial that reads the\n                                     manifest and emits the meta tags\n\nImages carry a stamp of the props, config and size they came from, so a rebuild\nrenders only the ones that have actually changed.\n\nOptions:\n  -c, --config <path>   Load a config module. Its default export is either a\n                        ColophonConfig or a function (async or not) returning\n                        one, for a config that has to compute something.\n  -f, --force           Re-render every image, ignoring the stamps. For init\n                        and eject, overwrite a file that is already there\n  -o, --overwrite       Alias for --force\n  -n, --dry-run         Report what would change and write nothing\n  -w, --watch           Rebuild whenever a content file changes\n  --concurrency <n>     How many images to render at once\n  --size <name>         Which configured size preview renders, or the\n                        playground link opens\n  -h, --help            Show this help\n\nDefaults:\n  contentDir            content\n  --concurrency         one per available CPU\n  --size                the first configured size\n\nRendering happens on the libuv thread pool, four threads deep unless\nUV_THREADPOOL_SIZE says otherwise. A higher concurrency than that queues, and\nthe build warns. Raise the pool by setting the variable in the environment.\n\nThe first argument is a command where it names one, so a content directory\ncalled init, preview, playground or eject has to be written as ./init.";
 //# sourceMappingURL=usage.d.ts.map

package/dist/cli/args/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/cli/args/usage.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,KAAK,qiDA+ByC,CAAC"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/cli/args/usage.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,KAAK,m8DAsCqD,CAAC"}

package/dist/cli/args/usage.js

@@ -5,6 +5,8 @@ Usage:
   colophon [contentDir] [options]    Render the images for a content tree
   colophon init [contentDir]         Write a starter config module
   colophon preview <file> [options]  Render one post and open it
+  colophon playground [file] [options]
+                                     Print a playground link for this project
   colophon eject hugo                Write a Hugo partial that reads the
                                      manifest and emits the meta tags
 
@@ -21,7 +23,8 @@ Options:
   -n, --dry-run         Report what would change and write nothing
   -w, --watch           Rebuild whenever a content file changes
   --concurrency <n>     How many images to render at once
-  --size <name>         Which configured size preview renders
+  --size <name>         Which configured size preview renders, or the
+                        playground link opens
   -h, --help            Show this help
 
 Defaults:
@@ -29,6 +32,10 @@ Defaults:
   --concurrency         one per available CPU
   --size                the first configured size
 
+Rendering happens on the libuv thread pool, four threads deep unless
+UV_THREADPOOL_SIZE says otherwise. A higher concurrency than that queues, and
+the build warns. Raise the pool by setting the variable in the environment.
+
 The first argument is a command where it names one, so a content directory
-called init, preview or eject has to be written as ./init.`;
+called init, preview, playground or eject has to be written as ./init.`;
 //# sourceMappingURL=usage.js.map

package/dist/cli/args/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/cli/args/usage.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DA+BsC,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/cli/args/usage.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAsCkD,CAAC"}

package/dist/cli/index.js

@@ -4,6 +4,7 @@ import { runBuild } from "./build.js";
 import { runEject } from "./eject/index.js";
 import { runInit } from "./init/index.js";
 import { messageOf } from "./message.js";
+import { runPlayground } from "./playground/index.js";
 import { runPreview } from "./preview/index.js";
 /** Run whichever command the arguments asked for. */
 async function run(args) {
@@ -14,6 +15,9 @@ async function run(args) {
         case "preview": {
             return runPreview(args);
         }
+        case "playground": {
+            return runPlayground(args);
+        }
         case "eject": {
             return runEject(args);
         }

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,qDAAqD;AACrD,KAAK,UAAU,GAAG,CAAC,IAAa;IAC9B,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,MAAM,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YACf,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,UAAU,EAAE,CAAC;YAChB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,CAAC;IACH,MAAM,IAAI,EAAE,CAAC;AACf,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,qDAAqD;AACrD,KAAK,UAAU,GAAG,CAAC,IAAa;IAC9B,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,MAAM,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YACf,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,YAAY,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,UAAU,EAAE,CAAC;YAChB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,CAAC;IACH,MAAM,IAAI,EAAE,CAAC;AACf,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/cli/playground/background.d.ts

@@ -0,0 +1,6 @@
+import type { Background, OutputSize } from "../../types.js";
+/** Drop a background image, whose source the browser cannot load. */
+export declare function browserBackground(background: Background | undefined, label: string, omitted: string[]): Background | undefined;
+/** Drop an image background from one size override. */
+export declare function browserSize(size: OutputSize, omitted: string[]): OutputSize;
+//# sourceMappingURL=background.d.ts.map

package/dist/cli/playground/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/cli/playground/background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,GAChB,UAAU,GAAG,SAAS,CAOxB;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAS3E"}

package/dist/cli/playground/background.js

@@ -0,0 +1,15 @@
+/** Drop a background image, whose source the browser cannot load. */
+export function browserBackground(background, label, omitted) {
+    if (background?.type === "image") {
+        omitted.push(label);
+        return undefined;
+    }
+    return background;
+}
+/** Drop an image background from one size override. */
+export function browserSize(size, omitted) {
+    const { background, ...rest } = size;
+    const kept = browserBackground(background, `sizes.${size.name}.background`, omitted);
+    return { ...rest, ...(kept === undefined ? {} : { background: kept }) };
+}
+//# sourceMappingURL=background.js.map

package/dist/cli/playground/background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.js","sourceRoot":"","sources":["../../../src/cli/playground/background.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAC/B,UAAkC,EAClC,KAAa,EACb,OAAiB;IAEjB,IAAI,UAAU,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,OAAiB;IAC7D,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IACrC,MAAM,IAAI,GAAG,iBAAiB,CAC5B,UAAU,EACV,SAAS,IAAI,CAAC,IAAI,aAAa,EAC/B,OAAO,CACR,CAAC;IAEF,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC1E,CAAC"}

package/dist/cli/playground/config.d.ts

@@ -0,0 +1,8 @@
+import type { ColophonConfig } from "../../types.js";
+export interface PlaygroundConfig {
+    readonly text: string;
+    readonly omitted: readonly string[];
+}
+/** Write the JSON subset of a project config that the browser can use. */
+export declare function configForPlayground(config: ColophonConfig | undefined): PlaygroundConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/playground/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/playground/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAGrE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAiBD,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,gBAAgB,CAiDlB"}

package/dist/cli/playground/config.js

@@ -0,0 +1,46 @@
+import { browserBackground, browserSize } from "./background.js";
+function browserContent(content, omitted) {
+    if (content === undefined) {
+        return undefined;
+    }
+    const { props, ...rest } = content;
+    if (props !== undefined) {
+        omitted.push("content.props");
+    }
+    return rest;
+}
+/** Write the JSON subset of a project config that the browser can use. */
+export function configForPlayground(config) {
+    if (config === undefined) {
+        return { text: "{}", omitted: [] };
+    }
+    const omitted = [];
+    const { background, content, extra, fonts, logo, manifest, onWarning, placement, rasteriser, sizes, templates, ...rest } = config;
+    const named = [
+        ["extra", extra],
+        ["fonts", fonts],
+        ["logo", logo],
+        ["manifest", manifest],
+        ["onWarning", onWarning],
+        ["placement", placement],
+        ["rasteriser", rasteriser],
+        ["templates", templates],
+    ];
+    for (const [name, value] of named) {
+        if (value !== undefined) {
+            omitted.push(name);
+        }
+    }
+    const keptBackground = browserBackground(background, "background", omitted);
+    const keptContent = browserContent(content, omitted);
+    const browserConfig = {
+        ...rest,
+        ...(keptBackground === undefined ? {} : { background: keptBackground }),
+        ...(keptContent === undefined ? {} : { content: keptContent }),
+        ...(sizes === undefined
+            ? {}
+            : { sizes: sizes.map((size) => browserSize(size, omitted)) }),
+    };
+    return { text: JSON.stringify(browserConfig, undefined, 2), omitted };
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/playground/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/playground/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAOjE,SAAS,cAAc,CACrB,OAAmC,EACnC,OAAiB;IAEjB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CACjC,MAAkC;IAElC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,EACJ,UAAU,EACV,OAAO,EACP,KAAK,EACL,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,KAAK,EACL,SAAS,EACT,GAAG,IAAI,EACR,GAAG,MAAM,CAAC;IAEX,MAAM,KAAK,GAAG;QACZ,CAAC,OAAO,EAAE,KAAK,CAAC;QAChB,CAAC,OAAO,EAAE,KAAK,CAAC;QAChB,CAAC,MAAM,EAAE,IAAI,CAAC;QACd,CAAC,UAAU,EAAE,QAAQ,CAAC;QACtB,CAAC,WAAW,EAAE,SAAS,CAAC;QACxB,CAAC,WAAW,EAAE,SAAS,CAAC;QACxB,CAAC,YAAY,EAAE,UAAU,CAAC;QAC1B,CAAC,WAAW,EAAE,SAAS,CAAC;KAChB,CAAC;IACX,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,aAAa,GAAmB;QACpC,GAAG,IAAI;QACP,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;QACvE,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAC9D,GAAG,CAAC,KAAK,KAAK,SAAS;YACrB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;KAChE,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;AACxE,CAAC"}

package/dist/cli/playground/discover.d.ts

@@ -0,0 +1,6 @@
+import type { ColophonConfig, ContentFile } from "../../types.js";
+/** The requested config, or the conventional config found in the project. */
+export declare function playgroundConfigPath(requested: string | undefined, dir: string): Promise<string | undefined>;
+/** Find the named post, or the first image post in a conventional content tree. */
+export declare function playgroundSample(file: string | undefined, config: ColophonConfig | undefined, dir: string): Promise<ContentFile | undefined>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/cli/playground/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/cli/playground/discover.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlE,6EAA6E;AAC7E,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7B;AAsCD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAIlC"}

package/dist/cli/playground/discover.js

@@ -0,0 +1,37 @@
+import path from "node:path";
+import { readContentFile, walkContent } from "../../content/index.js";
+import { guessContentDir } from "../init/guess.js";
+import { existingConfig } from "../init/module.js";
+/** The requested config, or the conventional config found in the project. */
+export async function playgroundConfigPath(requested, dir) {
+    if (requested !== undefined) {
+        return path.resolve(dir, requested);
+    }
+    const found = await existingConfig(dir);
+    return found === undefined ? undefined : path.join(dir, found);
+}
+async function namedFile(file, config, dir) {
+    const read = await readContentFile(path.resolve(dir, file), dir, config?.content);
+    if (read === undefined) {
+        throw new Error(`${file} declares no image props to send to the playground.`);
+    }
+    return read;
+}
+async function discoveredFile(config, dir) {
+    const contentDir = await guessContentDir(dir);
+    if (contentDir === undefined) {
+        return undefined;
+    }
+    const files = await walkContent({
+        dir: path.join(dir, contentDir),
+        ...config?.content,
+    });
+    return files.toSorted((a, b) => a.contentPath.localeCompare(b.contentPath))[0];
+}
+/** Find the named post, or the first image post in a conventional content tree. */
+export function playgroundSample(file, config, dir) {
+    return file === undefined
+        ? discoveredFile(config, dir)
+        : namedFile(file, config, dir);
+}
+//# sourceMappingURL=discover.js.map

package/dist/cli/playground/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../src/cli/playground/discover.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAA6B,EAC7B,GAAW;IAEX,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,IAAY,EACZ,MAAkC,EAClC,GAAW;IAEX,MAAM,IAAI,GAAG,MAAM,eAAe,CAChC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EACvB,GAAG,EACH,MAAM,EAAE,OAAO,CAChB,CAAC;IACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,qDAAqD,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAkC,EAClC,GAAW;IAEX,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;QAC9B,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC;QAC/B,GAAG,MAAM,EAAE,OAAO;KACnB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC7B,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAC3C,CAAC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAC9B,IAAwB,EACxB,MAAkC,EAClC,GAAW;IAEX,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC;QAC7B,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/cli/playground/index.d.ts

@@ -0,0 +1,10 @@
+import type { CliArgs } from "../args/index.js";
+export interface PlaygroundLink {
+    readonly url: string;
+    readonly omitted: readonly string[];
+}
+/** Build a colophonjs.dev link carrying this project's config and one post. */
+export declare function playgroundLink(args: CliArgs, dir?: string): Promise<PlaygroundLink>;
+/** Print a colophonjs.dev link carrying this project's config and one post. */
+export declare function runPlayground(args: CliArgs, dir?: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/playground/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/playground/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,EACb,GAAG,SAAgB,GAClB,OAAO,CAAC,cAAc,CAAC,CAsBzB;AAED,+EAA+E;AAC/E,wBAAsB,aAAa,CACjC,IAAI,EAAE,OAAO,EACb,GAAG,SAAgB,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/cli/playground/index.js

@@ -0,0 +1,37 @@
+import { DEFAULT_SIZES } from "../../config/index.js";
+import { loadConfig } from "../config.js";
+import { pickSize } from "../preview/size.js";
+import { configForPlayground } from "./config.js";
+import { playgroundConfigPath, playgroundSample } from "./discover.js";
+import { fallbackFrontmatter, sampleFrontmatter } from "./sample.js";
+import { shareUrl } from "./share.js";
+/** Build a colophonjs.dev link carrying this project's config and one post. */
+export async function playgroundLink(args, dir = process.cwd()) {
+    const config = await loadConfig(await playgroundConfigPath(args.configPath, dir));
+    if (args.size !== undefined) {
+        pickSize(config?.sizes ?? DEFAULT_SIZES, args.size);
+    }
+    const file = await playgroundSample(args.file, config, dir);
+    const frontmatter = file === undefined
+        ? { text: fallbackFrontmatter(config), omitted: [] }
+        : await sampleFrontmatter(file, config);
+    const shared = configForPlayground(config);
+    return {
+        url: shareUrl({
+            config: shared.text,
+            frontmatter: frontmatter.text,
+            ...(args.size === undefined ? {} : { size: args.size }),
+        }),
+        omitted: [...shared.omitted, ...frontmatter.omitted],
+    };
+}
+/** Print a colophonjs.dev link carrying this project's config and one post. */
+export async function runPlayground(args, dir = process.cwd()) {
+    const link = await playgroundLink(args, dir);
+    if (link.omitted.length > 0) {
+        console.warn(`The playground cannot use: ${link.omitted.join(", ")}. ` +
+            "The link leaves them out.");
+    }
+    console.log(link.url);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/playground/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/playground/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAa,EACb,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,MAAM,oBAAoB,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CACjD,CAAC;IACF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,WAAW,GACf,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QACpD,CAAC,CAAC,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE3C,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC;YACZ,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,WAAW,EAAE,WAAW,CAAC,IAAI;YAC7B,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;SACxD,CAAC;QACF,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAa,EACb,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE7C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CACV,8BAA8B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACvD,2BAA2B,CAC9B,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/cli/playground/sample.d.ts

@@ -0,0 +1,10 @@
+import type { ContentFile, ColophonConfig } from "../../types.js";
+export interface PlaygroundFrontmatter {
+    readonly text: string;
+    readonly omitted: readonly string[];
+}
+/** A generic post for a project where no content file could be found. */
+export declare function fallbackFrontmatter(config: ColophonConfig | undefined): string;
+/** Read a post and make its mapper-produced props explicit for the playground. */
+export declare function sampleFrontmatter(file: ContentFile, config: ColophonConfig | undefined): Promise<PlaygroundFrontmatter>;
+//# sourceMappingURL=sample.d.ts.map

package/dist/cli/playground/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../../src/cli/playground/sample.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAEf,MAAM,gBAAgB,CAAC;AAKxB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AA4BD,yEAAyE;AACzE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,MAAM,CASR;AAED,kFAAkF;AAClF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAYhC"}

package/dist/cli/playground/sample.js

@@ -0,0 +1,46 @@
+import { readFile } from "node:fs/promises";
+import matter from "gray-matter";
+const defaultPropsKey = "meta_img_props";
+const defaultTemplateField = "template";
+function browserProps(props) {
+    const kept = { ...props };
+    const omitted = [];
+    for (const name of ["avatar", "image"]) {
+        const value = kept[name];
+        if (typeof value === "string" && !value.startsWith("data:")) {
+            delete kept[name];
+            omitted.push(`frontmatter.${name}`);
+        }
+    }
+    return { props: kept, omitted };
+}
+/** Put the effective props under the frontmatter names this config reads. */
+function declaredProps(props, config) {
+    const templateField = config?.content?.templateField ?? defaultTemplateField;
+    const { template, ...rest } = props;
+    return { [templateField]: template, ...rest };
+}
+/** A generic post for a project where no content file could be found. */
+export function fallbackFrontmatter(config) {
+    const propsKey = config?.content?.propsKey ?? defaultPropsKey;
+    const templateField = config?.content?.templateField ?? defaultTemplateField;
+    const template = config?.content?.defaultTemplate ?? "banner";
+    return matter.stringify("", {
+        title: "Sample post",
+        [propsKey]: { [templateField]: template },
+    });
+}
+/** Read a post and make its mapper-produced props explicit for the playground. */
+export async function sampleFrontmatter(file, config) {
+    const parsed = matter(await readFile(file.absolutePath, "utf8"));
+    const propsKey = config?.content?.propsKey ?? defaultPropsKey;
+    const browser = browserProps(file.props);
+    return {
+        text: matter.stringify("", {
+            ...parsed.data,
+            [propsKey]: declaredProps(browser.props, config),
+        }),
+        omitted: browser.omitted,
+    };
+}
+//# sourceMappingURL=sample.js.map

package/dist/cli/playground/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../../src/cli/playground/sample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,MAAM,MAAM,aAAa,CAAC;AAQjC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AACzC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAOxC,SAAS,YAAY,CAAC,KAAqB;IAIzC,MAAM,IAAI,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IACnD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAU,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAsB,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC;AAED,6EAA6E;AAC7E,SAAS,aAAa,CACpB,KAAqB,EACrB,MAAkC;IAElC,MAAM,aAAa,GAAG,MAAM,EAAE,OAAO,EAAE,aAAa,IAAI,oBAAoB,CAAC;IAC7E,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACpC,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CACjC,MAAkC;IAElC,MAAM,QAAQ,GAAG,MAAM,EAAE,OAAO,EAAE,QAAQ,IAAI,eAAe,CAAC;IAC9D,MAAM,aAAa,GAAG,MAAM,EAAE,OAAO,EAAE,aAAa,IAAI,oBAAoB,CAAC;IAC7E,MAAM,QAAQ,GAAG,MAAM,EAAE,OAAO,EAAE,eAAe,IAAI,QAAQ,CAAC;IAE9D,OAAO,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE;QAC1B,KAAK,EAAE,aAAa;QACpB,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE;KAC1C,CAAC,CAAC;AACL,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAiB,EACjB,MAAkC;IAElC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,MAAM,EAAE,OAAO,EAAE,QAAQ,IAAI,eAAe,CAAC;IAC9D,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE;YACzB,GAAG,MAAM,CAAC,IAAI;YACd,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACjD,CAAC;QACF,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC"}

package/dist/cli/playground/share.d.ts

@@ -0,0 +1,9 @@
+/** The state understood by colophonjs.dev's playground. */
+export interface PlaygroundState {
+    readonly config: string;
+    readonly frontmatter: string;
+    readonly size?: string;
+}
+/** Build the public playground URL for one config and post. */
+export declare function shareUrl(state: PlaygroundState): string;
+//# sourceMappingURL=share.d.ts.map

package/dist/cli/playground/share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../../../src/cli/playground/share.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAOvD"}

package/dist/cli/playground/share.js

@@ -0,0 +1,11 @@
+import { deflateRawSync } from "node:zlib";
+const playground = "https://colophonjs.dev/playground/";
+/** Build the public playground URL for one config and post. */
+export function shareUrl(state) {
+    const json = JSON.stringify(state);
+    const encoded = deflateRawSync(json).toString("base64url");
+    const url = new URL(playground);
+    url.searchParams.set("s", encoded);
+    return url.href;
+}
+//# sourceMappingURL=share.js.map

package/dist/cli/playground/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../../../src/cli/playground/share.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAS3C,MAAM,UAAU,GAAG,oCAAoC,CAAC;AAExD,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,KAAsB;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAChC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAEnC,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/generate/index.d.ts

@@ -13,7 +13,10 @@ export type { GeneratedImage, GenerateOptions } from "./options.js";
  * everything. Sizes with no image to render are never rasterised.
  *
  * Rendering runs `concurrency` images at a time rather than all of them, so a
- * large tree does not start hundreds of rasterisations at once.
+ * large tree does not start hundreds of rasterisations at once. How many of
+ * those make progress at a time is the libuv thread pool's business, and a
+ * build asking for more than the pool has says so in a warning. See
+ * {@link GenerateOptions.concurrency}.
  *
  * `dryRun` stops short of writing: the plan is built and the stamps are read,
  * so the results say which images are out of date, but nothing is rendered and

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CA+B3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CAgC3B"}

package/dist/generate/index.js

@@ -4,6 +4,7 @@ import { readImageStamp } from "../stamp/index.js";
 import { resolveConcurrency } from "./options.js";
 import { planBuild } from "./plan.js";
 import { renderImage } from "./render-image.js";
+import { warnIfPoolIsSmaller } from "./thread-pool.js";
 export { defaultOutputPath } from "./output-path.js";
 /**
  * Walk a content tree and render meta images for every file that declares
@@ -17,7 +18,10 @@ export { defaultOutputPath } from "./output-path.js";
  * everything. Sizes with no image to render are never rasterised.
  *
  * Rendering runs `concurrency` images at a time rather than all of them, so a
- * large tree does not start hundreds of rasterisations at once.
+ * large tree does not start hundreds of rasterisations at once. How many of
+ * those make progress at a time is the libuv thread pool's business, and a
+ * build asking for more than the pool has says so in a warning. See
+ * {@link GenerateOptions.concurrency}.
  *
  * `dryRun` stops short of writing: the plan is built and the stamps are read,
  * so the results say which images are out of date, but nothing is rendered and
@@ -26,6 +30,7 @@ export { defaultOutputPath } from "./output-path.js";
 export async function generate(options) {
     const concurrency = resolveConcurrency(options.concurrency);
     const plan = await planBuild(options);
+    warnIfPoolIsSmaller(concurrency, plan.config.onWarning);
     const results = await mapConcurrent(plan.jobs, concurrency, async (job) => {
         const isSkipped = options.overwrite !== true &&
             (await readImageStamp(job.outputPath)) === job.stamp;

package/dist/generate/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAwB;IAExB,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACxE,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,KAAK,IAAI;YAC1B,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC;QAEvD,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,MAAM,GAAmB;YAC7B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,OAAO,EAAE,SAAS;SACnB,CAAC;QACF,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,kEAAkE;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAwB;IAExB,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACxE,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,KAAK,IAAI;YAC1B,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC;QAEvD,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,MAAM,GAAmB;YAC7B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,OAAO,EAAE,SAAS;SACnB,CAAC;QACF,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,kEAAkE;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/generate/options.d.ts

@@ -51,6 +51,14 @@ export interface GenerateOptions {
     /**
      * How many images to render at once. Defaults to the number of CPUs the
      * process can use. Must be a positive integer.
+     *
+     * The parts of a render that take real time (the rasteriser, the PNG
+     * recompression and the quantiser) all run on the libuv thread pool. That
+     * pool has four threads unless `UV_THREADPOOL_SIZE` says otherwise, so on a
+     * machine with more cores than that a higher concurrency only queues work
+     * up. libuv sizes the pool from the environment before the process starts,
+     * and a build can only read it. Where the pool is the smaller of the two,
+     * `generate` warns.
      */
     readonly concurrency?: number;
     /** Called after each image is written or skipped. */
@@ -61,6 +69,12 @@ export interface GenerateOptions {
  * the process can actually use. Rasterising is CPU-bound, so starting more
  * than that only queues the work up while holding every pending image in
  * memory.
+ *
+ * The real ceiling is the smaller of this and the libuv thread pool. That
+ * pool holds four threads unless `UV_THREADPOOL_SIZE` was set in the
+ * environment, so the default here is reached on a machine of four cores or
+ * fewer, or with the pool sized to match. `generate` warns where the two
+ * disagree.
  */
 export declare function resolveConcurrency(concurrency: number | undefined): number;
 //# sourceMappingURL=options.d.ts.map

package/dist/generate/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/generate/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;IACtE;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAY1E"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/generate/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;IACtE;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAY1E"}

package/dist/generate/options.js

@@ -4,6 +4,12 @@ import { availableParallelism } from "node:os";
  * the process can actually use. Rasterising is CPU-bound, so starting more
  * than that only queues the work up while holding every pending image in
  * memory.
+ *
+ * The real ceiling is the smaller of this and the libuv thread pool. That
+ * pool holds four threads unless `UV_THREADPOOL_SIZE` was set in the
+ * environment, so the default here is reached on a machine of four cores or
+ * fewer, or with the pool sized to match. `generate` warns where the two
+ * disagree.
  */
 export function resolveConcurrency(concurrency) {
     if (concurrency === undefined) {

package/dist/generate/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/generate/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA+D/C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAA+B;IAChE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,oBAAoB,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,uBAAuB,MAAM,CAAC,WAAW,CAAC,gCAAgC,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/generate/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAuE/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAA+B;IAChE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,oBAAoB,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,uBAAuB,MAAM,CAAC,WAAW,CAAC,gCAAgC,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/generate/plan.d.ts

@@ -1,5 +1,6 @@
 import type { PlannedManifest } from "../manifest/index.js";
 import type { Stamper } from "../stamp/index.js";
+import type { ResolvedConfig } from "../types.js";
 import type { RenderJob } from "./job.js";
 import type { GenerateOptions } from "./options.js";
 /**
@@ -9,6 +10,13 @@ import type { GenerateOptions } from "./options.js";
 export interface BuildPlan {
     readonly jobs: readonly RenderJob[];
     readonly stamper: Stamper;
+    /**
+     * The build's own config, before any per-size overrides. Where a build has
+     * something to say about the run as a whole, this is where its `onWarning`
+     * comes from. The per-image handler lives on each job, and a tree with no
+     * images to render has no job to take one from.
+     */
+    readonly config: ResolvedConfig;
     /** What to write down about the build, where a config asked for it. */
     readonly manifest: PlannedManifest | undefined;
 }

package/dist/generate/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/generate/plan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAMjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;CAChD;AAqBD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAmD5E"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/generate/plan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;CAChD;AAqBD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAoD5E"}

package/dist/generate/plan.js

@@ -66,6 +66,7 @@ export async function planBuild(options) {
     return {
         jobs: all,
         stamper,
+        config: resolved,
         manifest: planManifest(options.config?.manifest, all),
     };
 }

package/dist/generate/plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/generate/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAatB;;;;;;;;GAQG;AACH,SAAS,MAAM,CAAC,OAAwB,EAAE,MAAoB;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAEpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAwB;IACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI;QACT,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KAC3C,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzC,aAAa,CAAC,QAAQ,CAAC;QACvB,2EAA2E;QAC3E,wEAAwE;QACxE,WAAW,CAAC;YACV,GAAG,EAAE,OAAO,CAAC,UAAU;YACvB,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO;YAC1B,GAAG,OAAO,CAAC,IAAI;SAChB,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAClC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,qEAAqE;QACrE,oEAAoE;QACpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAExC,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI;YACJ,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,KAAK;YACL,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ;SAChD,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC3B,0BAA0B,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAE1D,OAAO;QACL,IAAI,EAAE,GAAG;QACT,OAAO;QACP,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC;KACtD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/generate/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAoBtB;;;;;;;;GAQG;AACH,SAAS,MAAM,CAAC,OAAwB,EAAE,MAAoB;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAEpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAwB;IACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI;QACT,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KAC3C,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzC,aAAa,CAAC,QAAQ,CAAC;QACvB,2EAA2E;QAC3E,wEAAwE;QACxE,WAAW,CAAC;YACV,GAAG,EAAE,OAAO,CAAC,UAAU;YACvB,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO;YAC1B,GAAG,OAAO,CAAC,IAAI;SAChB,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAClC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,qEAAqE;QACrE,oEAAoE;QACpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAExC,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI;YACJ,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,KAAK;YACL,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ;SAChD,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC3B,0BAA0B,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAE1D,OAAO;QACL,IAAI,EAAE,GAAG;QACT,OAAO;QACP,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/generate/thread-pool.d.ts

@@ -0,0 +1,30 @@
+import type { WarningHandler } from "../types.js";
+/**
+ * How many threads this process's libuv pool has.
+ *
+ * The pool is sized once from the environment, the first time anything asks it
+ * to do work. A `process.env.UV_THREADPOOL_SIZE` written from inside the
+ * process arrives after that moment and changes nothing. This function only
+ * reads.
+ *
+ * libuv reads the setting with `atoi` and treats a zero as unset, and an
+ * unparseable value gives it a zero. Anything short of a positive integer
+ * therefore reads back here as the default.
+ */
+export declare function threadPoolSize(setting?: string | undefined): number;
+/**
+ * A warner that says the concurrency a build asked for is above what the
+ * thread pool can serve, and says it once.
+ *
+ * Once, because the ceiling belongs to the process. A watch rebuilding on
+ * every content change would otherwise repeat the same line all day, and no
+ * build can act on it while it runs. The state lives in the returned function,
+ * so a test can hold one of its own and the shared warner stays shared.
+ */
+export declare function createThreadPoolWarner(): (concurrency: number, onWarning: WarningHandler, poolSize?: number) => void;
+/**
+ * Tell a build that its concurrency is capped by the thread pool. One warner
+ * for the process, so every build in it shares the one warning.
+ */
+export declare const warnIfPoolIsSmaller: (concurrency: number, onWarning: WarningHandler, poolSize?: number) => void;
+//# sourceMappingURL=thread-pool.d.ts.map

package/dist/generate/thread-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-pool.d.ts","sourceRoot":"","sources":["../../src/generate/thread-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,MAAM,GAAG,SAA6C,GAC9D,MAAM,CAQR;AAcD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE,MAAM,KACd,IAAI,CAWR;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gBApBjB,MAAM,aACR,cAAc,aACd,MAAM,KACd,IAiBsD,CAAC"}

package/dist/generate/thread-pool.js

@@ -0,0 +1,59 @@
+/**
+ * How many threads libuv starts when `UV_THREADPOOL_SIZE` says nothing, and
+ * the largest pool it will build however big the setting is.
+ */
+const DEFAULT_POOL_SIZE = 4;
+const MAX_POOL_SIZE = 1024;
+/**
+ * How many threads this process's libuv pool has.
+ *
+ * The pool is sized once from the environment, the first time anything asks it
+ * to do work. A `process.env.UV_THREADPOOL_SIZE` written from inside the
+ * process arrives after that moment and changes nothing. This function only
+ * reads.
+ *
+ * libuv reads the setting with `atoi` and treats a zero as unset, and an
+ * unparseable value gives it a zero. Anything short of a positive integer
+ * therefore reads back here as the default.
+ */
+export function threadPoolSize(setting = process.env["UV_THREADPOOL_SIZE"]) {
+    const parsed = Number(setting);
+    if (!Number.isSafeInteger(parsed) || parsed < 1) {
+        return DEFAULT_POOL_SIZE;
+    }
+    return Math.min(parsed, MAX_POOL_SIZE);
+}
+/** What to say about a concurrency the pool is too small to serve. */
+function message(concurrency, poolSize) {
+    return (`Rendering ${String(concurrency)} images at once, but the libuv thread` +
+        ` pool has ${String(poolSize)} threads. Rasterising, PNG recompression` +
+        ` and quantising all run on that pool, so only ${String(poolSize)}` +
+        " renders make progress at a time. Set" +
+        ` UV_THREADPOOL_SIZE=${String(concurrency)} in the environment before the` +
+        " process starts to lift the ceiling.");
+}
+/**
+ * A warner that says the concurrency a build asked for is above what the
+ * thread pool can serve, and says it once.
+ *
+ * Once, because the ceiling belongs to the process. A watch rebuilding on
+ * every content change would otherwise repeat the same line all day, and no
+ * build can act on it while it runs. The state lives in the returned function,
+ * so a test can hold one of its own and the shared warner stays shared.
+ */
+export function createThreadPoolWarner() {
+    let hasWarned = false;
+    return (concurrency, onWarning, poolSize = threadPoolSize()) => {
+        if (hasWarned || concurrency <= poolSize) {
+            return;
+        }
+        hasWarned = true;
+        onWarning(message(concurrency, poolSize));
+    };
+}
+/**
+ * Tell a build that its concurrency is capped by the thread pool. One warner
+ * for the process, so every build in it shares the one warning.
+ */
+export const warnIfPoolIsSmaller = createThreadPoolWarner();
+//# sourceMappingURL=thread-pool.js.map

package/dist/generate/thread-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-pool.js","sourceRoot":"","sources":["../../src/generate/thread-pool.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAO,GAAuB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAE/D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAE/B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AACzC,CAAC;AAED,sEAAsE;AACtE,SAAS,OAAO,CAAC,WAAmB,EAAE,QAAgB;IACpD,OAAO,CACL,aAAa,MAAM,CAAC,WAAW,CAAC,uCAAuC;QACvE,aAAa,MAAM,CAAC,QAAQ,CAAC,0CAA0C;QACvE,iDAAiD,MAAM,CAAC,QAAQ,CAAC,EAAE;QACnE,uCAAuC;QACvC,uBAAuB,MAAM,CAAC,WAAW,CAAC,gCAAgC;QAC1E,sCAAsC,CACvC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB;IAKpC,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,GAAG,cAAc,EAAE,EAAE,EAAE;QAC7D,IAAI,SAAS,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QAED,SAAS,GAAG,IAAI,CAAC;QACjB,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,EAAE,CAAC"}

package/package.json

@@ -5,7 +5,7 @@
   "repository": "https://github.com/KensioSoftware/colophon",
   "homepage": "https://github.com/KensioSoftware/colophon#readme",
   "license": "Apache-2.0",
-  "version": "2.15.3",
+  "version": "2.15.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -95,7 +95,7 @@
     "conventional-changelog-conventionalcommits": "9.3.1",
     "dejavu-fonts-ttf": "^2.37.3",
     "fta-cli": "^3.0.0",
-    "oxfmt": "^0.63.0",
+    "oxfmt": "^0.65.0",
     "oxlint": "^1.77.0",
     "oxlint-tsgolint": "^7.0.2001",
     "semantic-release": "25.0.9",