@tin.so/core 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Cook
+
+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.

package/README.md

@@ -1,33 +1,121 @@
 # @tin.so/core
 
-Renders code images from a JSON spec. The pipeline is `spec → Shiki tokens → layout → SVG → PNG` and needs no browser: the layout places every character on a monospace grid with the metrics of the bundled fonts, and [resvg](https://github.com/linebender/resvg) (WebAssembly) rasterizes the SVG. The same code runs in Node and in the browser.
+Renders code images from a JSON spec, to SVG and PNG. One image can show several snippets: windows next to each other or below each other, panes in a window, and popovers that point to a word. It has all [ray.so](https://ray.so) themes, line highlights, text styles and colors, tabs with file icons, and fixed aspect ratios for social media.
+
+The pipeline is `spec → Shiki tokens → layout → SVG → PNG` and needs no browser. The layout puts every character on a monospace grid with the metrics of the bundled fonts, and [resvg](https://github.com/linebender/resvg) (WebAssembly) rasterizes the SVG. The same code runs in Node and in the browser.
+
+This package is the renderer of the [tin.so](https://tin.so) web editor and of the [`tin` CLI](https://www.npmjs.com/package/tin.so). To make images from the command line, use the CLI.
+
+## Installation
+
+```bash
+npm install @tin.so/core
+```
+
+Node 22.18 or later.
+
+## Usage
 
 ```ts
+import { writeFile } from "node:fs/promises";
 import { render } from "@tin.so/core/node";
 
 const png = await render({
   theme: "vercel",
   windows: [
     {
-      titleBar: false,
       tabs: true,
-      split: "row",
+      titleBar: false,
       panes: [
-        { title: "main.ts", code: 'import plans from "./plans.toml";' },
+        {
+          title: "main.ts",
+          code: 'import plans from "./plans.toml";\n\nplans.free.price;',
+          highlight: [3],
+          annotations: [
+            { line: 1, match: "plans", code: "const plans: {\n  free: { price: 0 };\n}" },
+          ],
+        },
         { title: "plans.toml", code: "[free]\nprice = 0" },
       ],
     },
   ],
 });
+
+await writeFile("plans.png", png);
+```
+
+`render(spec, { format: "svg" })` gives an SVG with the fonts inside it. `scale` sets the pixel ratio of a PNG (default 2). By default, the image contains the spec and a link that opens it in the web editor. `metadata: false` turns this off.
+
+`createLink(spec)` gives that link without an image:
+
+```ts
+import { createLink } from "@tin.so/core";
+
+const link = await createLink(spec); // https://tin.so/#spec=…
+```
+
+## The spec
+
+A spec is JSON with the image settings, its windows, the panes of each window, and the code of each pane. A spec needs only `windows`, `panes` and `code`.
+
+```json
+{
+  "$schema": "https://tin.so/schema/v1.json",
+  "theme": "candy",
+  "windows": [{ "panes": [{ "title": "main.ts", "code": "const a = 1;" }] }]
+}
+```
+
+| Level  | Fields                                                                                                                                       |
+| ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| Image  | `theme`, `mode`, `background`, `padding`, `font`, `lineNumbers`, `direction`, `gap`, `aspectRatio`, `width`, `height`, `windows`             |
+| Window | `panes`, `split`, `titleBar`, `tabs`, `frame`, `controls`, `title`, `width`, `height`, `x`, `y`                                              |
+| Pane   | `code`, `title`, `language`, `highlight`, `marks` (bold, italic, colors, highlighter fills), `annotations` (popovers), `icon`, `lineNumbers` |
+
+The full spec, with a description, a default and the limits of each field, is the JSON Schema at [`https://tin.so/schema/v1.json`](https://tin.so/schema/v1.json). `specJsonSchema()` gives the same schema.
+
+The `$schema` URL (`/schema/v1.json`) or the field `v` gives the version of the spec. A spec without both is version 1. A new version comes only with a change that can break a spec. New optional fields and new themes, fonts or languages come without one.
+
+The renderer ignores keys that start with `x-` in every object, so a spec can carry data of other tools.
+
+An invalid spec throws a `SpecError` that names each problem with its path, for example `windows.0.panes.0.annotations.0.match: "plnas" (occurrence 1) is not in line 1`.
+
+## API
+
+| Function                                                 | What it does                                                                               |
+| -------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| `render(spec, options?)`                                 | Renders a spec to PNG or SVG bytes, in Node (`@tin.so/core/node`)                          |
+| `parseSpec(input)`                                       | Checks a spec and fills in the defaults. Throws a `SpecError`                              |
+| `layout(spec, options?)`                                 | Highlights the code and places the windows, panes and popovers. Gives a `Scene`            |
+| `toSvg(scene, options?)`                                 | Writes the SVG of a scene, with or without embedded fonts and metadata                     |
+| `initPng(load)`, `svgToPng(svg, fonts, options?)`        | Loads the resvg WebAssembly once, then rasterizes an SVG                                   |
+| `loadSceneFonts(scene, loadFont)`                        | Loads the font files that a scene uses                                                     |
+| `createLink(spec, appUrl?)`, `readLink(link)`            | Writes a spec into an editor link, and reads it back                                       |
+| `encodeSpec(spec)`, `decodeSpec(encoded)`                | The compressed spec of a link, without the URL                                             |
+| `readImageSpec(image)`                                   | Reads the spec from a PNG or SVG that has the metadata. Gives `undefined` for other images |
+| `specJsonSchema()`, `SPEC_SCHEMA_URL`                    | The JSON Schema of the spec, and its URL                                                   |
+| `THEME_IDS`, `CODE_FONT_IDS`, `LANGUAGE_IDS`, `ICON_IDS` | The ids that the spec accepts                                                              |
+
+### In the browser
+
+Import from `@tin.so/core`, and give the steps that read files a loader, because the browser has no file system:
+
+```ts
+import { initPng, layout, loadSceneFonts, svgToPng, toSvg } from "@tin.so/core";
+
+const scene = await layout(spec);
+// loadFont gets a path in the fonts/ directory of this package, for example "fira-code/fira-code-400.ttf"
+const fonts = await loadSceneFonts(scene, loadFont);
+await initPng(() => fetch(wasmUrl)); // the index_bg.wasm file of @resvg/resvg-wasm
+const png = await svgToPng(toSvg(scene), fonts.values());
 ```
 
 ## Scripts
 
 - `pnpm port-themes` fetches the ray.so themes at a pinned commit and writes `src/themes/*.json`.
 - `pnpm download-fonts` downloads the fonts to `fonts/` and writes their metrics to `src/fonts/fonts.generated.json`.
+- `pnpm generate-icons` writes the language icons from Simple Icons.
 
-## Attribution
+## License
 
-- The themes, the token colors and the frame styles come from [ray.so](https://github.com/raycast/ray-so) (MIT).
-- The fonts are under the SIL Open Font License, except Commit Mono (MIT). Each font directory contains its license.
-- The file icon is from [Lucide](https://lucide.dev) (ISC), the language icons from [Simple Icons](https://simpleicons.org) (CC0).
+MIT. The themes come from ray.so (MIT), the file icon from Lucide (ISC), the language icons from Simple Icons (CC0), and the fonts are under the SIL Open Font License, except Commit Mono (MIT). See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,61 @@
+# Third-party notices
+
+`@tin.so/core` contains work of other projects. Their licenses follow.
+
+## ray.so
+
+The themes, the token colors and the frame styles come from [ray.so](https://github.com/raycast/ray-so).
+
+```
+MIT License
+
+Copyright (c) 2024 Raycast Technologies Ltd
+
+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.
+```
+
+## Lucide
+
+The file icon comes from [Lucide](https://lucide.dev).
+
+```
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+```
+
+## Simple Icons
+
+The language icons come from [Simple Icons](https://simpleicons.org), under [CC0 1.0](https://github.com/simple-icons/simple-icons/blob/develop/LICENSE.md).
+
+## Fonts
+
+The fonts in `fonts/` are under the SIL Open Font License 1.1, except Commit Mono, which is under the MIT License. Each font directory contains its license.

package/dist/{index-CtUX1lFe.d.mts → index-blYEvwPp.d.mts}

@@ -77,25 +77,38 @@ declare const SPEC_SCHEMA_URL: string;
  * the spec, such as line ranges, so their rules are only in the descriptions.
  */
 declare function specJsonSchema(): Record<string, unknown>;
+/**
+ * True when the value is the URL of a tin.so spec schema: a path that ends with
+ * /schema/v<number>.json on the host of the hosted app, on an earlier host of the app, or on the
+ * host of the given app URL (for example a local editor).
+ */
+declare function isSpecSchemaUrl(value: unknown, appUrl?: string): boolean;
 /**
  * The hosted web app. The CLI takes another app from its TIN_APP_URL environment variable,
  * for example the local editor during development.
  */
-declare const DEFAULT_APP_URL = "https://code-image.zirkelc.workers.dev/";
+declare const DEFAULT_APP_URL = "https://tin.so/";
+type DecodeOptions = {
+  /** The largest size of the inflated spec in bytes, so that a hostile input cannot use much memory */
+  maxBytes?: number;
+};
 /**
  * Compresses a spec into a URL-safe string. A spec without a version gets version 1, so that the
  * link keeps its meaning when a later version changes the format.
  */
 declare function encodeSpec(spec: unknown): Promise<string>;
-/** Reads a spec from a string of the encoder, with the fields of older links changed */
-declare function decodeSpec(encoded: string): Promise<unknown>;
+/**
+ * Reads a spec from a string of the encoder, with the fields of older links changed. Throws for
+ * bad data and for a spec larger than the limit.
+ */
+declare function decodeSpec(encoded: string, options?: DecodeOptions): Promise<unknown>;
 /**
  * A link that opens the spec in the web app. The spec is in the fragment, so it never goes to a
  * server and has no length limit of a request line.
  */
 declare function createLink(spec: unknown, appUrl?: string): Promise<string>;
 /** Reads the spec from the fragment of a link, or returns undefined when the fragment has none */
-declare function readLink(link: string): Promise<unknown>;
+declare function readLink(link: string, options?: DecodeOptions): Promise<unknown>;
 type Mode = "light" | "dark";
 /** Token colors of a theme. Keys that are missing use the foreground color. */
 type Syntax = {
@@ -332,14 +345,16 @@ declare const SOFTWARE = "tin.so";
 declare const PNG_KEYWORDS: {
   readonly software: "Software";
   readonly source: "Source";
-  readonly link: "code-image:link";
-  readonly spec: "code-image:spec";
+  readonly link: "tin.so:link";
 };
 /** The namespace of the metadata element in an SVG */
-declare const SVG_NAMESPACE = "urn:code-image:metadata:1";
-/** The data that an exported image carries, so that the editor can open the image again */
+declare const SVG_NAMESPACE = "urn:tin.so:metadata:1";
+/**
+ * The data that an exported image carries, so that the editor can open the image again. The image
+ * stores only the link, because the link holds the whole spec.
+ */
 type ImageMetadata = {
-  /** The spec input, as the user wrote it */
+  /** The spec input, as the user wrote it, with its version */
   spec: unknown;
   /** A link that opens the spec in the editor */
   link: string;
@@ -350,8 +365,8 @@ type ImageMetadata = {
  */
 declare function createImageMetadata(spec: unknown, appUrl?: string): Promise<ImageMetadata>;
 /**
- * Adds text chunks after the header of a PNG: the program, the app URL, the editor link and the
- * compressed spec. A PNG without the expected header comes back unchanged.
+ * Adds text chunks after the header of a PNG: the program, the app URL and the editor link. A PNG
+ * without the expected header comes back unchanged.
  */
 declare function addPngMetadata(png: Uint8Array, metadata: ImageMetadata): Promise<Uint8Array>;
 /**
@@ -361,6 +376,16 @@ declare function addPngMetadata(png: Uint8Array, metadata: ImageMetadata): Promi
  */
 declare function readImageSpec(input: Uint8Array | ArrayBuffer | Blob | string): Promise<unknown>;
 declare const IMPLICIT_SPEC_VERSION = 1;
+/**
+ * The version that the $schema URL of a spec names, or undefined when the spec has no such URL.
+ * Only the path counts, so that the URL of each host that serves the schema gives the version.
+ */
+declare function schemaVersion(spec: unknown): number | undefined;
+/**
+ * Keys with this prefix hold data of other tools, such as an editor state. The renderer ignores
+ * them in each object of a spec, so that a spec with such keys stays valid in all versions.
+ */
+declare const EXTENSION_PREFIX = "x-";
 /**
  * Changes the fields of older specs from before the v field to the current fields, so that old
  * links, files and images stay valid. Input that is not a spec stays as it is, so that the spec
@@ -369,7 +394,8 @@ declare const IMPLICIT_SPEC_VERSION = 1;
 declare function migrateLegacySpec(spec: unknown): unknown;
 /**
  * Adds the version to a spec without one, so that a stored spec keeps its meaning when a later
- * version changes the format. A spec with a version stays as it is.
+ * version changes the format. The version comes from the $schema URL, or is version 1 without it.
+ * A spec with a version stays as it is.
  */
 declare function stampSpecVersion(spec: unknown): unknown;
 type PngOptions = {
@@ -400,12 +426,19 @@ declare const SPEC_LIMITS: {
   readonly size: 8192;
 };
 declare const MARK_STYLES: readonly ["strong", "emphasis", "underline", "strikethrough"];
+declare const ANNOTATION_TYPES: readonly ["popover"];
 /**
  * Versions of the spec format.
  *
  * - Increase v only for a breaking change: a field that changes its meaning, gets a new name or
- *   goes away. A new optional field does not increase v, because older specs stay valid.
- * - A spec without v is version 1, now and in all later versions, because older specs have no v.
+ *   goes away, a changed default, a value that a list no longer has (a theme, font, icon or
+ *   language id), or a smaller limit. Specs leave out the defaults, so a new default changes old
+ *   images. A new optional field, a new value or a larger limit does not increase v, because older
+ *   specs stay valid.
+ * - The version is v, or the version of the $schema URL (/schema/v<number>.json) without v. When
+ *   both are there, they must be the same. A spec without both is version 1, now and in all later
+ *   versions, because older specs have neither.
+ * - Keys that start with "x-" are for other tools. The renderer ignores them in every object.
  * - For a new version, add its schema (with v as a required literal of the new number) to
  *   SPEC_SCHEMAS, a function that changes a parsed spec of the version before into the new
  *   version to MIGRATIONS, and increase LATEST_SPEC_VERSION. The schema of the latest version is
@@ -446,6 +479,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       readonly icon: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<["auto", "none", ...string[]], undefined>, "auto">, v.DescriptionAction<string, string>]>;
       readonly lineNumbers: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, v.DescriptionAction<boolean | undefined, string>]>;
       readonly annotations: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
+        readonly type: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<readonly ["popover"], undefined>, "popover">, v.DescriptionAction<"popover", string>]>;
         readonly line: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, v.DescriptionAction<number, string>]>;
         readonly match: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, v.DescriptionAction<string, string>]>;
         readonly occurrence: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, 1>, v.DescriptionAction<number, string>]>;
@@ -492,6 +526,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           background?: string | undefined;
         }[], string>]>;
       }, undefined>, undefined>, v.MaxLengthAction<{
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -510,6 +545,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           background?: string | undefined;
         }[];
       }[], number, (issue: v.MaxLengthIssue<{
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -528,6 +564,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           background?: string | undefined;
         }[];
       }[], number>) => string>]>, readonly []>, v.DescriptionAction<{
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -591,6 +628,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -626,6 +664,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -661,6 +700,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -696,6 +736,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -743,6 +784,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -790,6 +832,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -837,6 +880,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -884,6 +928,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -946,6 +991,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -1008,6 +1054,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
       icon: string;
       lineNumbers?: boolean | undefined;
       annotations: {
+        type: "popover";
         line: number;
         match: string;
         occurrence: number;
@@ -1055,9 +1102,9 @@ declare class SpecError extends Error {
   constructor(issues: Array<string>);
 }
 /**
- * Validates a spec and applies the defaults. It first changes the fields of older specs, then
- * validates the spec with the schema of its version and changes it to the latest version. Throws
- * a SpecError that lists every issue.
+ * Validates a spec and applies the defaults. It first removes the keys of other tools and changes
+ * the fields of older specs, then validates the spec with the schema of its version and changes it
+ * to the latest version. Throws a SpecError that lists every issue.
  */
 declare function parseSpec(input: unknown): Spec;
 /** Expands highlight entries such as [2, "4-6"] to a set of line numbers, up to the last line */
@@ -1073,4 +1120,4 @@ type SvgOptions = {
 };
 /** Writes the scene as a standalone SVG document */
 declare function toSvg(scene: Scene, options?: SvgOptions): string;
-export { resolveLanguage as $, readImageSpec as A, FontFace as At, WINDOW_RADIUS as B, ImageMetadata as C, getIcon as Ct, SVG_NAMESPACE as D, CodeFont as Dt, SOFTWARE as E, CODE_FONT_IDS as Et, PaneBox as F, cssFontFamily as Ft, MAC_HEADER as G, cellCount as H, Rect as I, getCodeFont as It, PLAIN_TEXT as J, HighlightedLine as K, Scene as L, getFace as Lt, LINE_HEIGHT as M, FontMetrics as Mt, LayoutOptions as N, UI_FONT as Nt, addPngMetadata as O, DEFAULT_CODE_FONT as Ot, POPOVER as P, UiFont as Pt, isKnownLanguage as Q, TAB_HEADER as R, measureUiText as Rt, stampSpecVersion as S, NO_ICON as St, PNG_KEYWORDS as T, CODE_FONTS as Tt, layout as U, WindowBox as V, normalizeCode as W, highlight as X, Token as Y, inferLanguage as Z, loadSceneFonts as _, specJsonSchema as _t, MarkStyle as a, THEME_IDS as at, IMPLICIT_SPEC_VERSION as b, ICON_IDS as bt, Spec as c, getSyntax as ct, SpecSchema as d, DEFAULT_APP_URL as dt, DEFAULT_THEME as et, WindowSpec as f, createLink as ft, initPng as g, SPEC_SCHEMA_URL as gt, PngOptions as h, readLink as ht, MARK_STYLES as i, THEMES as it, FONT_SIZE as j, FontLoader as jt, createImageMetadata as k, Font as kt, SpecError as l, getTheme as lt, parseSpec as m, encodeSpec as mt, toSvg as n, Mode as nt, PaneSpec as o, Theme as ot, expandLineRanges as p, decodeSpec as pt, LANGUAGE_IDS as q, LATEST_SPEC_VERSION as r, Syntax as rt, SPEC_LIMITS as s, getFrameColors as st, SvgOptions as t, FrameColors as tt, SpecInput as u, resolveMode as ut, sceneFontFiles as v, AUTO_ICON as vt, METADATA_BY_DEFAULT as w, resolveIcon as wt, migrateLegacySpec as x, Icon as xt, svgToPng as y, FILE_ICON as yt, TextMetrics as z };
+export { highlight as $, SVG_NAMESPACE as A, CODE_FONTS as At, Scene as B, cssFontFamily as Bt, migrateLegacySpec as C, AUTO_ICON as Ct, METADATA_BY_DEFAULT as D, NO_ICON as Dt, ImageMetadata as E, Icon as Et, LINE_HEIGHT as F, FontFace as Ft, cellCount as G, TextMetrics as H, getFace as Ht, LayoutOptions as I, FontLoader as It, MAC_HEADER as J, layout as K, POPOVER as L, FontMetrics as Lt, createImageMetadata as M, CodeFont as Mt, readImageSpec as N, DEFAULT_CODE_FONT as Nt, PNG_KEYWORDS as O, getIcon as Ot, FONT_SIZE as P, Font as Pt, Token as Q, PaneBox as R, UI_FONT as Rt, IMPLICIT_SPEC_VERSION as S, specJsonSchema as St, stampSpecVersion as T, ICON_IDS as Tt, WINDOW_RADIUS as U, measureUiText as Ut, TAB_HEADER as V, getCodeFont as Vt, WindowBox as W, LANGUAGE_IDS as X, HighlightedLine as Y, PLAIN_TEXT as Z, initPng as _, decodeSpec as _t, MARK_STYLES as a, Mode as at, svgToPng as b, SPEC_SCHEMA_URL as bt, SPEC_LIMITS as c, THEME_IDS as ct, SpecInput as d, getSyntax as dt, inferLanguage as et, SpecSchema as f, getTheme as ft, PngOptions as g, createLink as gt, parseSpec as h, DecodeOptions as ht, LATEST_SPEC_VERSION as i, FrameColors as it, addPngMetadata as j, CODE_FONT_IDS as jt, SOFTWARE as k, resolveIcon as kt, Spec as l, Theme as lt, expandLineRanges as m, DEFAULT_APP_URL as mt, toSvg as n, resolveLanguage as nt, MarkStyle as o, Syntax as ot, WindowSpec as p, resolveMode as pt, normalizeCode as q, ANNOTATION_TYPES as r, DEFAULT_THEME as rt, PaneSpec as s, THEMES as st, SvgOptions as t, isKnownLanguage as tt, SpecError as u, getFrameColors as ut, loadSceneFonts as v, encodeSpec as vt, schemaVersion as w, FILE_ICON as wt, EXTENSION_PREFIX as x, isSpecSchemaUrl as xt, sceneFontFiles as y, readLink as yt, Rect as z, UiFont as zt };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as resolveLanguage, A as readImageSpec, At as FontFace, B as WINDOW_RADIUS, C as ImageMetadata, Ct as getIcon, D as SVG_NAMESPACE, Dt as CodeFont, E as SOFTWARE, Et as CODE_FONT_IDS, F as PaneBox, Ft as cssFontFamily, G as MAC_HEADER, H as cellCount, I as Rect, It as getCodeFont, J as PLAIN_TEXT, K as HighlightedLine, L as Scene, Lt as getFace, M as LINE_HEIGHT, Mt as FontMetrics, N as LayoutOptions, Nt as UI_FONT, O as addPngMetadata, Ot as DEFAULT_CODE_FONT, P as POPOVER, Pt as UiFont, Q as isKnownLanguage, R as TAB_HEADER, Rt as measureUiText, S as stampSpecVersion, St as NO_ICON, T as PNG_KEYWORDS, Tt as CODE_FONTS, U as layout, V as WindowBox, W as normalizeCode, X as highlight, Y as Token, Z as inferLanguage, _ as loadSceneFonts, _t as specJsonSchema, a as MarkStyle, at as THEME_IDS, b as IMPLICIT_SPEC_VERSION, bt as ICON_IDS, c as Spec, ct as getSyntax, d as SpecSchema, dt as DEFAULT_APP_URL, et as DEFAULT_THEME, f as WindowSpec, ft as createLink, g as initPng, gt as SPEC_SCHEMA_URL, h as PngOptions, ht as readLink, i as MARK_STYLES, it as THEMES, j as FONT_SIZE, jt as FontLoader, k as createImageMetadata, kt as Font, l as SpecError, lt as getTheme, m as parseSpec, mt as encodeSpec, n as toSvg, nt as Mode, o as PaneSpec, ot as Theme, p as expandLineRanges, pt as decodeSpec, q as LANGUAGE_IDS, r as LATEST_SPEC_VERSION, rt as Syntax, s as SPEC_LIMITS, st as getFrameColors, t as SvgOptions, tt as FrameColors, u as SpecInput, ut as resolveMode, v as sceneFontFiles, vt as AUTO_ICON, w as METADATA_BY_DEFAULT, wt as resolveIcon, x as migrateLegacySpec, xt as Icon, y as svgToPng, yt as FILE_ICON, z as TextMetrics } from "./index-CtUX1lFe.mjs";
-export { AUTO_ICON, CODE_FONTS, CODE_FONT_IDS, CodeFont, DEFAULT_APP_URL, DEFAULT_CODE_FONT, DEFAULT_THEME, FILE_ICON, FONT_SIZE, Font, FontFace, FontLoader, FontMetrics, FrameColors, type HighlightedLine, ICON_IDS, IMPLICIT_SPEC_VERSION, type Icon, type ImageMetadata, LANGUAGE_IDS, LATEST_SPEC_VERSION, LINE_HEIGHT, type LayoutOptions, MAC_HEADER, MARK_STYLES, METADATA_BY_DEFAULT, type MarkStyle, Mode, NO_ICON, PLAIN_TEXT, PNG_KEYWORDS, POPOVER, type PaneBox, type PaneSpec, type PngOptions, type Rect, SOFTWARE, SPEC_LIMITS, SPEC_SCHEMA_URL, SVG_NAMESPACE, type Scene, type Spec, SpecError, type SpecInput, SpecSchema, type SvgOptions, Syntax, TAB_HEADER, THEMES, THEME_IDS, type TextMetrics, Theme, type Token, UI_FONT, UiFont, WINDOW_RADIUS, type WindowBox, type WindowSpec, addPngMetadata, cellCount, createImageMetadata, createLink, cssFontFamily, decodeSpec, encodeSpec, expandLineRanges, getCodeFont, getFace, getFrameColors, getIcon, getSyntax, getTheme, highlight, inferLanguage, initPng, isKnownLanguage, layout, loadSceneFonts, measureUiText, migrateLegacySpec, normalizeCode, parseSpec, readImageSpec, readLink, resolveIcon, resolveLanguage, resolveMode, sceneFontFiles, specJsonSchema, stampSpecVersion, svgToPng, toSvg };
+import { $ as highlight, A as SVG_NAMESPACE, At as CODE_FONTS, B as Scene, Bt as cssFontFamily, C as migrateLegacySpec, Ct as AUTO_ICON, D as METADATA_BY_DEFAULT, Dt as NO_ICON, E as ImageMetadata, Et as Icon, F as LINE_HEIGHT, Ft as FontFace, G as cellCount, H as TextMetrics, Ht as getFace, I as LayoutOptions, It as FontLoader, J as MAC_HEADER, K as layout, L as POPOVER, Lt as FontMetrics, M as createImageMetadata, Mt as CodeFont, N as readImageSpec, Nt as DEFAULT_CODE_FONT, O as PNG_KEYWORDS, Ot as getIcon, P as FONT_SIZE, Pt as Font, Q as Token, R as PaneBox, Rt as UI_FONT, S as IMPLICIT_SPEC_VERSION, St as specJsonSchema, T as stampSpecVersion, Tt as ICON_IDS, U as WINDOW_RADIUS, Ut as measureUiText, V as TAB_HEADER, Vt as getCodeFont, W as WindowBox, X as LANGUAGE_IDS, Y as HighlightedLine, Z as PLAIN_TEXT, _ as initPng, _t as decodeSpec, a as MARK_STYLES, at as Mode, b as svgToPng, bt as SPEC_SCHEMA_URL, c as SPEC_LIMITS, ct as THEME_IDS, d as SpecInput, dt as getSyntax, et as inferLanguage, f as SpecSchema, ft as getTheme, g as PngOptions, gt as createLink, h as parseSpec, ht as DecodeOptions, i as LATEST_SPEC_VERSION, it as FrameColors, j as addPngMetadata, jt as CODE_FONT_IDS, k as SOFTWARE, kt as resolveIcon, l as Spec, lt as Theme, m as expandLineRanges, mt as DEFAULT_APP_URL, n as toSvg, nt as resolveLanguage, o as MarkStyle, ot as Syntax, p as WindowSpec, pt as resolveMode, q as normalizeCode, r as ANNOTATION_TYPES, rt as DEFAULT_THEME, s as PaneSpec, st as THEMES, t as SvgOptions, tt as isKnownLanguage, u as SpecError, ut as getFrameColors, v as loadSceneFonts, vt as encodeSpec, w as schemaVersion, wt as FILE_ICON, x as EXTENSION_PREFIX, xt as isSpecSchemaUrl, y as sceneFontFiles, yt as readLink, z as Rect, zt as UiFont } from "./index-blYEvwPp.mjs";
+export { ANNOTATION_TYPES, AUTO_ICON, CODE_FONTS, CODE_FONT_IDS, CodeFont, DEFAULT_APP_URL, DEFAULT_CODE_FONT, DEFAULT_THEME, type DecodeOptions, EXTENSION_PREFIX, FILE_ICON, FONT_SIZE, Font, FontFace, FontLoader, FontMetrics, FrameColors, type HighlightedLine, ICON_IDS, IMPLICIT_SPEC_VERSION, type Icon, type ImageMetadata, LANGUAGE_IDS, LATEST_SPEC_VERSION, LINE_HEIGHT, type LayoutOptions, MAC_HEADER, MARK_STYLES, METADATA_BY_DEFAULT, type MarkStyle, Mode, NO_ICON, PLAIN_TEXT, PNG_KEYWORDS, POPOVER, type PaneBox, type PaneSpec, type PngOptions, type Rect, SOFTWARE, SPEC_LIMITS, SPEC_SCHEMA_URL, SVG_NAMESPACE, type Scene, type Spec, SpecError, type SpecInput, SpecSchema, type SvgOptions, Syntax, TAB_HEADER, THEMES, THEME_IDS, type TextMetrics, Theme, type Token, UI_FONT, UiFont, WINDOW_RADIUS, type WindowBox, type WindowSpec, addPngMetadata, cellCount, createImageMetadata, createLink, cssFontFamily, decodeSpec, encodeSpec, expandLineRanges, getCodeFont, getFace, getFrameColors, getIcon, getSyntax, getTheme, highlight, inferLanguage, initPng, isKnownLanguage, isSpecSchemaUrl, layout, loadSceneFonts, measureUiText, migrateLegacySpec, normalizeCode, parseSpec, readImageSpec, readLink, resolveIcon, resolveLanguage, resolveMode, sceneFontFiles, schemaVersion, specJsonSchema, stampSpecVersion, svgToPng, toSvg };

package/dist/index.mjs

@@ -1 +1 @@
-export { Q as AUTO_ICON, it as CODE_FONTS, at as CODE_FONT_IDS, W as DEFAULT_APP_URL, ot as DEFAULT_CODE_FONT, j as DEFAULT_THEME, $ as FILE_ICON, p as FONT_SIZE, et as ICON_IDS, Y as IMPLICIT_SPEC_VERSION, R as LANGUAGE_IDS, w as LATEST_SPEC_VERSION, m as LINE_HEIGHT, x as MAC_HEADER, T as MARK_STYLES, o as METADATA_BY_DEFAULT, tt as NO_ICON, z as PLAIN_TEXT, s as PNG_KEYWORDS, h as POPOVER, c as SOFTWARE, E as SPEC_LIMITS, S as SPEC_SCHEMA_URL, l as SVG_NAMESPACE, D as SpecError, O as SpecSchema, g as TAB_HEADER, M as THEMES, N as THEME_IDS, st as UI_FONT, _ as WINDOW_RADIUS, u as addPngMetadata, v as cellCount, d as createImageMetadata, G as createLink, ct as cssFontFamily, K as decodeSpec, q as encodeSpec, k as expandLineRanges, lt as getCodeFont, ut as getFace, P as getFrameColors, nt as getIcon, F as getSyntax, I as getTheme, B as highlight, V as inferLanguage, n as initPng, H as isKnownLanguage, y as layout, r as loadSceneFonts, dt as measureUiText, X as migrateLegacySpec, b as normalizeCode, A as parseSpec, f as readImageSpec, J as readLink, rt as resolveIcon, U as resolveLanguage, L as resolveMode, i as sceneFontFiles, C as specJsonSchema, Z as stampSpecVersion, a as svgToPng, t as toSvg } from "./src-BdXa6abO.mjs";
+export { T as ANNOTATION_TYPES, nt as AUTO_ICON, ct as CODE_FONTS, lt as CODE_FONT_IDS, K as DEFAULT_APP_URL, ut as DEFAULT_CODE_FONT, N as DEFAULT_THEME, Z as EXTENSION_PREFIX, rt as FILE_ICON, p as FONT_SIZE, it as ICON_IDS, Q as IMPLICIT_SPEC_VERSION, B as LANGUAGE_IDS, E as LATEST_SPEC_VERSION, m as LINE_HEIGHT, x as MAC_HEADER, D as MARK_STYLES, o as METADATA_BY_DEFAULT, at as NO_ICON, V as PLAIN_TEXT, s as PNG_KEYWORDS, h as POPOVER, c as SOFTWARE, O as SPEC_LIMITS, S as SPEC_SCHEMA_URL, l as SVG_NAMESPACE, k as SpecError, A as SpecSchema, g as TAB_HEADER, P as THEMES, F as THEME_IDS, dt as UI_FONT, _ as WINDOW_RADIUS, u as addPngMetadata, v as cellCount, d as createImageMetadata, q as createLink, ft as cssFontFamily, J as decodeSpec, Y as encodeSpec, j as expandLineRanges, pt as getCodeFont, mt as getFace, I as getFrameColors, ot as getIcon, L as getSyntax, R as getTheme, H as highlight, U as inferLanguage, n as initPng, W as isKnownLanguage, C as isSpecSchemaUrl, y as layout, r as loadSceneFonts, ht as measureUiText, $ as migrateLegacySpec, b as normalizeCode, M as parseSpec, f as readImageSpec, X as readLink, st as resolveIcon, G as resolveLanguage, z as resolveMode, i as sceneFontFiles, et as schemaVersion, w as specJsonSchema, tt as stampSpecVersion, a as svgToPng, t as toSvg } from "./src-VhDXsdB0.mjs";

package/dist/node.d.mts

@@ -1,4 +1,4 @@
-import { $ as resolveLanguage, A as readImageSpec, At as FontFace, B as WINDOW_RADIUS, C as ImageMetadata, Ct as getIcon, D as SVG_NAMESPACE, Dt as CodeFont, E as SOFTWARE, Et as CODE_FONT_IDS, F as PaneBox, Ft as cssFontFamily, G as MAC_HEADER, H as cellCount, I as Rect, It as getCodeFont, J as PLAIN_TEXT, K as HighlightedLine, L as Scene, Lt as getFace, M as LINE_HEIGHT, Mt as FontMetrics, N as LayoutOptions, Nt as UI_FONT, O as addPngMetadata, Ot as DEFAULT_CODE_FONT, P as POPOVER, Pt as UiFont, Q as isKnownLanguage, R as TAB_HEADER, Rt as measureUiText, S as stampSpecVersion, St as NO_ICON, T as PNG_KEYWORDS, Tt as CODE_FONTS, U as layout, V as WindowBox, W as normalizeCode, X as highlight, Y as Token, Z as inferLanguage, _ as loadSceneFonts, _t as specJsonSchema, a as MarkStyle, at as THEME_IDS, b as IMPLICIT_SPEC_VERSION, bt as ICON_IDS, c as Spec, ct as getSyntax, d as SpecSchema, dt as DEFAULT_APP_URL, et as DEFAULT_THEME, f as WindowSpec, ft as createLink, g as initPng, gt as SPEC_SCHEMA_URL, h as PngOptions, ht as readLink, i as MARK_STYLES, it as THEMES, j as FONT_SIZE, jt as FontLoader, k as createImageMetadata, kt as Font, l as SpecError, lt as getTheme, m as parseSpec, mt as encodeSpec, n as toSvg, nt as Mode, o as PaneSpec, ot as Theme, p as expandLineRanges, pt as decodeSpec, q as LANGUAGE_IDS, r as LATEST_SPEC_VERSION, rt as Syntax, s as SPEC_LIMITS, st as getFrameColors, t as SvgOptions, tt as FrameColors, u as SpecInput, ut as resolveMode, v as sceneFontFiles, vt as AUTO_ICON, w as METADATA_BY_DEFAULT, wt as resolveIcon, x as migrateLegacySpec, xt as Icon, y as svgToPng, yt as FILE_ICON, z as TextMetrics } from "./index-CtUX1lFe.mjs";
+import { $ as highlight, A as SVG_NAMESPACE, At as CODE_FONTS, B as Scene, Bt as cssFontFamily, C as migrateLegacySpec, Ct as AUTO_ICON, D as METADATA_BY_DEFAULT, Dt as NO_ICON, E as ImageMetadata, Et as Icon, F as LINE_HEIGHT, Ft as FontFace, G as cellCount, H as TextMetrics, Ht as getFace, I as LayoutOptions, It as FontLoader, J as MAC_HEADER, K as layout, L as POPOVER, Lt as FontMetrics, M as createImageMetadata, Mt as CodeFont, N as readImageSpec, Nt as DEFAULT_CODE_FONT, O as PNG_KEYWORDS, Ot as getIcon, P as FONT_SIZE, Pt as Font, Q as Token, R as PaneBox, Rt as UI_FONT, S as IMPLICIT_SPEC_VERSION, St as specJsonSchema, T as stampSpecVersion, Tt as ICON_IDS, U as WINDOW_RADIUS, Ut as measureUiText, V as TAB_HEADER, Vt as getCodeFont, W as WindowBox, X as LANGUAGE_IDS, Y as HighlightedLine, Z as PLAIN_TEXT, _ as initPng, _t as decodeSpec, a as MARK_STYLES, at as Mode, b as svgToPng, bt as SPEC_SCHEMA_URL, c as SPEC_LIMITS, ct as THEME_IDS, d as SpecInput, dt as getSyntax, et as inferLanguage, f as SpecSchema, ft as getTheme, g as PngOptions, gt as createLink, h as parseSpec, ht as DecodeOptions, i as LATEST_SPEC_VERSION, it as FrameColors, j as addPngMetadata, jt as CODE_FONT_IDS, k as SOFTWARE, kt as resolveIcon, l as Spec, lt as Theme, m as expandLineRanges, mt as DEFAULT_APP_URL, n as toSvg, nt as resolveLanguage, o as MarkStyle, ot as Syntax, p as WindowSpec, pt as resolveMode, q as normalizeCode, r as ANNOTATION_TYPES, rt as DEFAULT_THEME, s as PaneSpec, st as THEMES, t as SvgOptions, tt as isKnownLanguage, u as SpecError, ut as getFrameColors, v as loadSceneFonts, vt as encodeSpec, w as schemaVersion, wt as FILE_ICON, x as EXTENSION_PREFIX, xt as isSpecSchemaUrl, y as sceneFontFiles, yt as readLink, z as Rect, zt as UiFont } from "./index-blYEvwPp.mjs";
 export type RenderFormat = "png" | "svg";
 export type RenderOptions = {
   format?: RenderFormat;
@@ -18,4 +18,4 @@ export declare const loadFont: FontLoader;
 export declare function render(spec: unknown, options?: RenderOptions): Promise<Uint8Array>;
 /** Renders the scene of a layout, so that a caller that needs the scene lays out only once */
 export declare function renderScene(scene: Scene, options?: RenderSceneOptions): Promise<Uint8Array>;
-export { AUTO_ICON, CODE_FONTS, CODE_FONT_IDS, CodeFont, DEFAULT_APP_URL, DEFAULT_CODE_FONT, DEFAULT_THEME, FILE_ICON, FONT_SIZE, Font, FontFace, FontLoader, FontMetrics, FrameColors, type HighlightedLine, ICON_IDS, IMPLICIT_SPEC_VERSION, type Icon, type ImageMetadata, LANGUAGE_IDS, LATEST_SPEC_VERSION, LINE_HEIGHT, type LayoutOptions, MAC_HEADER, MARK_STYLES, METADATA_BY_DEFAULT, type MarkStyle, Mode, NO_ICON, PLAIN_TEXT, PNG_KEYWORDS, POPOVER, type PaneBox, type PaneSpec, type PngOptions, type Rect, SOFTWARE, SPEC_LIMITS, SPEC_SCHEMA_URL, SVG_NAMESPACE, type Scene, type Spec, SpecError, type SpecInput, SpecSchema, type SvgOptions, Syntax, TAB_HEADER, THEMES, THEME_IDS, type TextMetrics, Theme, type Token, UI_FONT, UiFont, WINDOW_RADIUS, type WindowBox, type WindowSpec, addPngMetadata, cellCount, createImageMetadata, createLink, cssFontFamily, decodeSpec, encodeSpec, expandLineRanges, getCodeFont, getFace, getFrameColors, getIcon, getSyntax, getTheme, highlight, inferLanguage, initPng, isKnownLanguage, layout, loadSceneFonts, measureUiText, migrateLegacySpec, normalizeCode, parseSpec, readImageSpec, readLink, resolveIcon, resolveLanguage, resolveMode, sceneFontFiles, specJsonSchema, stampSpecVersion, svgToPng, toSvg };
+export { ANNOTATION_TYPES, AUTO_ICON, CODE_FONTS, CODE_FONT_IDS, CodeFont, DEFAULT_APP_URL, DEFAULT_CODE_FONT, DEFAULT_THEME, type DecodeOptions, EXTENSION_PREFIX, FILE_ICON, FONT_SIZE, Font, FontFace, FontLoader, FontMetrics, FrameColors, type HighlightedLine, ICON_IDS, IMPLICIT_SPEC_VERSION, type Icon, type ImageMetadata, LANGUAGE_IDS, LATEST_SPEC_VERSION, LINE_HEIGHT, type LayoutOptions, MAC_HEADER, MARK_STYLES, METADATA_BY_DEFAULT, type MarkStyle, Mode, NO_ICON, PLAIN_TEXT, PNG_KEYWORDS, POPOVER, type PaneBox, type PaneSpec, type PngOptions, type Rect, SOFTWARE, SPEC_LIMITS, SPEC_SCHEMA_URL, SVG_NAMESPACE, type Scene, type Spec, SpecError, type SpecInput, SpecSchema, type SvgOptions, Syntax, TAB_HEADER, THEMES, THEME_IDS, type TextMetrics, Theme, type Token, UI_FONT, UiFont, WINDOW_RADIUS, type WindowBox, type WindowSpec, addPngMetadata, cellCount, createImageMetadata, createLink, cssFontFamily, decodeSpec, encodeSpec, expandLineRanges, getCodeFont, getFace, getFrameColors, getIcon, getSyntax, getTheme, highlight, inferLanguage, initPng, isKnownLanguage, isSpecSchemaUrl, layout, loadSceneFonts, measureUiText, migrateLegacySpec, normalizeCode, parseSpec, readImageSpec, readLink, resolveIcon, resolveLanguage, resolveMode, sceneFontFiles, schemaVersion, specJsonSchema, stampSpecVersion, svgToPng, toSvg };

package/dist/node.mjs

@@ -1,4 +1,4 @@
-import { $ as FILE_ICON, A as parseSpec, B as highlight, C as specJsonSchema, D as SpecError, E as SPEC_LIMITS, F as getSyntax, G as createLink, H as isKnownLanguage, I as getTheme, J as readLink, K as decodeSpec, L as resolveMode, M as THEMES, N as THEME_IDS, O as SpecSchema, P as getFrameColors, Q as AUTO_ICON, R as LANGUAGE_IDS, S as SPEC_SCHEMA_URL, T as MARK_STYLES, U as resolveLanguage, V as inferLanguage, W as DEFAULT_APP_URL, X as migrateLegacySpec, Y as IMPLICIT_SPEC_VERSION, Z as stampSpecVersion, _ as WINDOW_RADIUS, a as svgToPng, at as CODE_FONT_IDS, b as normalizeCode, c as SOFTWARE, ct as cssFontFamily, d as createImageMetadata, dt as measureUiText, et as ICON_IDS, f as readImageSpec, g as TAB_HEADER, h as POPOVER, i as sceneFontFiles, it as CODE_FONTS, j as DEFAULT_THEME, k as expandLineRanges, l as SVG_NAMESPACE, lt as getCodeFont, m as LINE_HEIGHT, n as initPng, nt as getIcon, o as METADATA_BY_DEFAULT, ot as DEFAULT_CODE_FONT, p as FONT_SIZE, q as encodeSpec, r as loadSceneFonts, rt as resolveIcon, s as PNG_KEYWORDS, st as UI_FONT, t as toSvg, tt as NO_ICON, u as addPngMetadata, ut as getFace, v as cellCount, w as LATEST_SPEC_VERSION, x as MAC_HEADER, y as layout, z as PLAIN_TEXT } from "./src-BdXa6abO.mjs";
+import { $ as migrateLegacySpec, A as SpecSchema, B as LANGUAGE_IDS, C as isSpecSchemaUrl, D as MARK_STYLES, E as LATEST_SPEC_VERSION, F as THEME_IDS, G as resolveLanguage, H as highlight, I as getFrameColors, J as decodeSpec, K as DEFAULT_APP_URL, L as getSyntax, M as parseSpec, N as DEFAULT_THEME, O as SPEC_LIMITS, P as THEMES, Q as IMPLICIT_SPEC_VERSION, R as getTheme, S as SPEC_SCHEMA_URL, T as ANNOTATION_TYPES, U as inferLanguage, V as PLAIN_TEXT, W as isKnownLanguage, X as readLink, Y as encodeSpec, Z as EXTENSION_PREFIX, _ as WINDOW_RADIUS, a as svgToPng, at as NO_ICON, b as normalizeCode, c as SOFTWARE, ct as CODE_FONTS, d as createImageMetadata, dt as UI_FONT, et as schemaVersion, f as readImageSpec, ft as cssFontFamily, g as TAB_HEADER, h as POPOVER, ht as measureUiText, i as sceneFontFiles, it as ICON_IDS, j as expandLineRanges, k as SpecError, l as SVG_NAMESPACE, lt as CODE_FONT_IDS, m as LINE_HEIGHT, mt as getFace, n as initPng, nt as AUTO_ICON, o as METADATA_BY_DEFAULT, ot as getIcon, p as FONT_SIZE, pt as getCodeFont, q as createLink, r as loadSceneFonts, rt as FILE_ICON, s as PNG_KEYWORDS, st as resolveIcon, t as toSvg, tt as stampSpecVersion, u as addPngMetadata, ut as DEFAULT_CODE_FONT, v as cellCount, w as specJsonSchema, x as MAC_HEADER, y as layout, z as resolveMode } from "./src-VhDXsdB0.mjs";
 import { createRequire } from "node:module";
 import { readFile } from "node:fs/promises";
 // src/node.ts
@@ -28,4 +28,4 @@ async function renderScene(scene, options = {}) {
 		metadata
 	});
 }
-export { AUTO_ICON, CODE_FONTS, CODE_FONT_IDS, DEFAULT_APP_URL, DEFAULT_CODE_FONT, DEFAULT_THEME, FILE_ICON, FONT_SIZE, ICON_IDS, IMPLICIT_SPEC_VERSION, LANGUAGE_IDS, LATEST_SPEC_VERSION, LINE_HEIGHT, MAC_HEADER, MARK_STYLES, METADATA_BY_DEFAULT, NO_ICON, PLAIN_TEXT, PNG_KEYWORDS, POPOVER, SOFTWARE, SPEC_LIMITS, SPEC_SCHEMA_URL, SVG_NAMESPACE, SpecError, SpecSchema, TAB_HEADER, THEMES, THEME_IDS, UI_FONT, WINDOW_RADIUS, addPngMetadata, cellCount, createImageMetadata, createLink, cssFontFamily, decodeSpec, encodeSpec, expandLineRanges, getCodeFont, getFace, getFrameColors, getIcon, getSyntax, getTheme, highlight, inferLanguage, initPng, isKnownLanguage, layout, loadFont, loadSceneFonts, measureUiText, migrateLegacySpec, normalizeCode, parseSpec, readImageSpec, readLink, render, renderScene, resolveIcon, resolveLanguage, resolveMode, sceneFontFiles, specJsonSchema, stampSpecVersion, svgToPng, toSvg };
+export { ANNOTATION_TYPES, AUTO_ICON, CODE_FONTS, CODE_FONT_IDS, DEFAULT_APP_URL, DEFAULT_CODE_FONT, DEFAULT_THEME, EXTENSION_PREFIX, FILE_ICON, FONT_SIZE, ICON_IDS, IMPLICIT_SPEC_VERSION, LANGUAGE_IDS, LATEST_SPEC_VERSION, LINE_HEIGHT, MAC_HEADER, MARK_STYLES, METADATA_BY_DEFAULT, NO_ICON, PLAIN_TEXT, PNG_KEYWORDS, POPOVER, SOFTWARE, SPEC_LIMITS, SPEC_SCHEMA_URL, SVG_NAMESPACE, SpecError, SpecSchema, TAB_HEADER, THEMES, THEME_IDS, UI_FONT, WINDOW_RADIUS, addPngMetadata, cellCount, createImageMetadata, createLink, cssFontFamily, decodeSpec, encodeSpec, expandLineRanges, getCodeFont, getFace, getFrameColors, getIcon, getSyntax, getTheme, highlight, inferLanguage, initPng, isKnownLanguage, isSpecSchemaUrl, layout, loadFont, loadSceneFonts, measureUiText, migrateLegacySpec, normalizeCode, parseSpec, readImageSpec, readLink, render, renderScene, resolveIcon, resolveLanguage, resolveMode, sceneFontFiles, schemaVersion, specJsonSchema, stampSpecVersion, svgToPng, toSvg };

package/dist/{src-BdXa6abO.mjs → src-VhDXsdB0.mjs}

@@ -773,6 +773,29 @@ function base64UrlToBytes(base64url) {
 }
 // src/migrate.ts
 const IMPLICIT_SPEC_VERSION = 1;
+const SCHEMA_VERSION = /\/schema\/v(\d+)\.json$/;
+/**
+* The version that the $schema URL of a spec names, or undefined when the spec has no such URL.
+* Only the path counts, so that the URL of each host that serves the schema gives the version.
+*/
+function schemaVersion(spec) {
+	if (typeof spec !== "object" || spec === null || !("$schema" in spec)) return void 0;
+	const url = spec.$schema;
+	if (typeof url !== "string" || !URL.canParse(url)) return void 0;
+	const match = SCHEMA_VERSION.exec(new URL(url).pathname);
+	return match ? Number(match[1]) : void 0;
+}
+/**
+* Keys with this prefix hold data of other tools, such as an editor state. The renderer ignores
+* them in each object of a spec, so that a spec with such keys stays valid in all versions.
+*/
+const EXTENSION_PREFIX = "x-";
+/** Removes the keys of other tools from all objects of a spec */
+function withoutExtensions(value) {
+	if (Array.isArray(value)) return value.map(withoutExtensions);
+	if (typeof value !== "object" || value === null) return value;
+	return Object.fromEntries(Object.entries(value).filter(([key]) => !key.startsWith("x-")).map(([key, entry]) => [key, withoutExtensions(entry)]));
+}
 const CHROME_FIELDS = {
 	mac: {},
 	tabs: {
@@ -806,12 +829,13 @@ function migrateLegacySpec(spec) {
 }
 /**
 * Adds the version to a spec without one, so that a stored spec keeps its meaning when a later
-* version changes the format. A spec with a version stays as it is.
+* version changes the format. The version comes from the $schema URL, or is version 1 without it.
+* A spec with a version stays as it is.
 */
 function stampSpecVersion(spec) {
 	if (typeof spec !== "object" || spec === null || Array.isArray(spec) || "v" in spec) return spec;
 	return {
-		v: 1,
+		v: schemaVersion(spec) ?? 1,
 		...spec
 	};
 }
@@ -820,22 +844,53 @@ function stampSpecVersion(spec) {
 * The hosted web app. The CLI takes another app from its TIN_APP_URL environment variable,
 * for example the local editor during development.
 */
-const DEFAULT_APP_URL = "https://code-image.zirkelc.workers.dev/";
+const DEFAULT_APP_URL = "https://tin.so/";
 const HASH_KEY = "spec=";
-async function transform(bytes, stream) {
-	const response = new Response(new Blob([bytes]).stream().pipeThrough(stream));
-	return new Uint8Array(await response.arrayBuffer());
+async function compress(bytes) {
+	const stream = new Blob([bytes]).stream().pipeThrough(new CompressionStream("deflate-raw"));
+	return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+/** Inflates data, or returns undefined when the data is bad or larger than the limit */
+async function inflate$1(bytes, format, limit = Number.POSITIVE_INFINITY) {
+	const reader = new Blob([bytes]).stream().pipeThrough(new DecompressionStream(format)).getReader();
+	const parts = [];
+	let size = 0;
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			size += value.length;
+			if (size > limit) {
+				await reader.cancel().catch(() => void 0);
+				return;
+			}
+			parts.push(value);
+		}
+	} catch {
+		return;
+	}
+	const out = new Uint8Array(size);
+	let offset = 0;
+	for (const part of parts) {
+		out.set(part, offset);
+		offset += part.length;
+	}
+	return out;
 }
 /**
 * Compresses a spec into a URL-safe string. A spec without a version gets version 1, so that the
 * link keeps its meaning when a later version changes the format.
 */
 async function encodeSpec(spec) {
-	return bytesToBase64Url(await transform(new TextEncoder().encode(JSON.stringify(stampSpecVersion(spec))), new CompressionStream("deflate-raw")));
+	return bytesToBase64Url(await compress(new TextEncoder().encode(JSON.stringify(stampSpecVersion(spec)))));
 }
-/** Reads a spec from a string of the encoder, with the fields of older links changed */
-async function decodeSpec(encoded) {
-	const json = await transform(base64UrlToBytes(encoded), new DecompressionStream("deflate-raw"));
+/**
+* Reads a spec from a string of the encoder, with the fields of older links changed. Throws for
+* bad data and for a spec larger than the limit.
+*/
+async function decodeSpec(encoded, options = {}) {
+	const json = await inflate$1(base64UrlToBytes(encoded), "deflate-raw", options.maxBytes);
+	if (!json) throw new Error("The link has bad data or a spec that is too large");
 	return migrateLegacySpec(JSON.parse(new TextDecoder().decode(json)));
 }
 /**
@@ -848,10 +903,10 @@ async function createLink(spec, appUrl = DEFAULT_APP_URL) {
 	return url.toString();
 }
 /** Reads the spec from the fragment of a link, or returns undefined when the fragment has none */
-async function readLink(link) {
+async function readLink(link, options = {}) {
 	const hash = new URL(link).hash.slice(1);
 	if (!hash.startsWith(HASH_KEY)) return void 0;
-	return decodeSpec(hash.slice(5));
+	return decodeSpec(hash.slice(5), options);
 }
 // src/themes/tailwind-dark.json
 var tailwind_dark_default = {
@@ -1704,7 +1759,43 @@ const EXTENSIONS = {
 	htm: "html",
 	txt: PLAIN_TEXT,
 	makefile: "make",
-	gemfile: "ruby"
+	gemfile: "ruby",
+	adb: "ada",
+	as: "actionscript-3",
+	bal: "ballerina",
+	bib: "bibtex",
+	clar: "clarity",
+	cls: "apex",
+	cob: "cobol",
+	cr: "crystal",
+	dm: "dream-maker",
+	do: "stata",
+	el: "emacs-lisp",
+	ex: "elixir",
+	feature: "gherkin",
+	fnl: "fennel",
+	gs: "genie",
+	hx: "haxe",
+	ll: "llvm",
+	ml: "ocaml",
+	mm: "objective-cpp",
+	msg: "rosmsg",
+	nsi: "nsis",
+	pas: "pascal",
+	pp: "puppet",
+	pq: "powerquery",
+	purs: "purescript",
+	rkt: "racket",
+	scm: "scheme",
+	service: "systemd",
+	sol: "solidity",
+	st: "smalltalk",
+	sv: "system-verilog",
+	ttl: "turtle",
+	vhd: "vhdl",
+	wat: "wasm",
+	wy: "wenyan",
+	zs: "zenscript"
 };
 const TAILWIND_THEMES = {
 	light: {
@@ -3407,7 +3498,9 @@ const MarkSchema = v.strictObject({
 	background: describe(v.optional(hexColor()), "Fill behind the text, as a hex color such as \"#ffd60a\" or \"#ffd60a40\" with alpha")
 });
 const MarkWithEffectSchema = v.pipe(MarkSchema, v.check((mark) => mark.style !== void 0 || mark.color !== void 0 || mark.background !== void 0, "A mark needs a style, a color or a background"));
+const ANNOTATION_TYPES = ["popover"];
 const AnnotationSchema = v.strictObject({
+	type: describe(v.optional(v.picklist(ANNOTATION_TYPES), "popover"), "Kind of the annotation. popover is a card below the text, as the hover card of an editor"),
 	line: describe(v.pipe(v.number(), v.integer(), v.minValue(1)), "Line of the anchor, from 1"),
 	match: describe(v.pipe(v.string(), v.minLength(1)), "Text in the line that the popover points to"),
 	occurrence: describe(v.optional(v.pipe(v.number(), v.integer(), v.minValue(1)), 1), "Which occurrence of the match in the line, from 1"),
@@ -3451,8 +3544,14 @@ const WindowSchema = v.strictObject({
 * Versions of the spec format.
 *
 * - Increase v only for a breaking change: a field that changes its meaning, gets a new name or
-*   goes away. A new optional field does not increase v, because older specs stay valid.
-* - A spec without v is version 1, now and in all later versions, because older specs have no v.
+*   goes away, a changed default, a value that a list no longer has (a theme, font, icon or
+*   language id), or a smaller limit. Specs leave out the defaults, so a new default changes old
+*   images. A new optional field, a new value or a larger limit does not increase v, because older
+*   specs stay valid.
+* - The version is v, or the version of the $schema URL (/schema/v<number>.json) without v. When
+*   both are there, they must be the same. A spec without both is version 1, now and in all later
+*   versions, because older specs have neither.
+* - Keys that start with "x-" are for other tools. The renderer ignores them in every object.
 * - For a new version, add its schema (with v as a required literal of the new number) to
 *   SPEC_SCHEMAS, a function that changes a parsed spec of the version before into the new
 *   version to MIGRATIONS, and increase LATEST_SPEC_VERSION. The schema of the latest version is
@@ -3460,8 +3559,8 @@ const WindowSchema = v.strictObject({
 */
 const LATEST_SPEC_VERSION = 1;
 const SpecV1Schema = v.pipe(v.strictObject({
-	$schema: describe(v.optional(v.pipe(v.string(), v.url())), "URL of the JSON Schema of the spec, so that an editor can check the spec and complete its fields. The renderer does not use it"),
-	v: describe(v.optional(v.literal(1), 1), "Version of the spec format. Leave it out or use 1. A spec without v is version 1"),
+	$schema: describe(v.optional(v.pipe(v.string(), v.url())), "URL of the JSON Schema of the spec, so that an editor can check the spec and complete its fields. Its path names the version, such as /schema/v1.json, which counts as v. The CLI also uses it to tell a spec from other JSON"),
+	v: describe(v.optional(v.literal(1), 1), "Version of the spec format. Leave it out or use 1. Without v, the version of the $schema URL counts, and without both, the version is 1"),
 	theme: describe(v.optional(v.picklist(THEME_IDS), DEFAULT_THEME), "Theme from ray.so"),
 	mode: describe(v.optional(v.picklist(["dark", "light"]), "dark"), "Color mode. A theme with only one mode ignores it"),
 	background: describe(v.optional(v.boolean(), true), "Gradient background. false is transparent"),
@@ -3495,25 +3594,36 @@ function formatIssue(issue) {
 	const path = v.getDotPath(issue) ?? "(root)";
 	if (issue.type === "strict_object" && issue.expected === "never") return `${path}: unknown field. Check the name, or update tin.so, because a newer version can support it`;
 	if (issue.type === "strict_object" && issue.input === void 0) return `${path}: required field missing`;
-	if (issue.type === "picklist" && issue.expected) return `${path}: expected one of ${issue.expected}, received ${issue.received}`;
+	if (issue.type === "picklist" && issue.expected) return `${path}: expected one of ${issue.expected}, received ${issue.received}. Check the value, or update tin.so, because a newer version can support it`;
 	return `${path}: ${issue.message}`;
 }
-/** The version of a spec input. A spec without v is version 1. */
+/**
+* The version of a spec input: v, or the version of the $schema URL without v. A spec without
+* both is version 1.
+*/
 function readVersion(input) {
-	if (typeof input !== "object" || input === null || !("v" in input)) return 1;
-	const version = input.v;
-	if (version === void 0) return 1;
-	if (typeof version !== "number" || !Number.isInteger(version) || version < 1) throw new SpecError([`v: the version must be a whole number from 1, received ${typeof version === "number" ? version : JSON.stringify(version) ?? typeof version}`]);
-	if (version > 1) throw new SpecError([`v: This spec has version ${version}, but this tin.so supports up to version 1. Update tin.so.`]);
+	const fromSchema = schemaVersion(input);
+	const field = typeof input === "object" && input !== null && "v" in input ? input.v : void 0;
+	if (field === void 0) {
+		const version = fromSchema ?? 1;
+		if (version < 1) throw new SpecError([`$schema: the URL names version ${version}, but versions start at 1`]);
+		return checkSupported(version, "$schema");
+	}
+	if (typeof field !== "number" || !Number.isInteger(field) || field < 1) throw new SpecError([`v: the version must be a whole number from 1, received ${typeof field === "number" ? field : JSON.stringify(field) ?? typeof field}`]);
+	if (fromSchema !== void 0 && fromSchema !== field) throw new SpecError([`v: the spec has version ${field}, but its $schema URL names version ${fromSchema}. Make them the same, or remove one`]);
+	return checkSupported(field, "v");
+}
+function checkSupported(version, path) {
+	if (version > 1) throw new SpecError([`${path}: This spec has version ${version}, but this tin.so supports up to version 1. Update tin.so.`]);
 	return version;
 }
 /**
-* Validates a spec and applies the defaults. It first changes the fields of older specs, then
-* validates the spec with the schema of its version and changes it to the latest version. Throws
-* a SpecError that lists every issue.
+* Validates a spec and applies the defaults. It first removes the keys of other tools and changes
+* the fields of older specs, then validates the spec with the schema of its version and changes it
+* to the latest version. Throws a SpecError that lists every issue.
 */
 function parseSpec(input) {
-	const migrated = migrateLegacySpec(input);
+	const migrated = migrateLegacySpec(withoutExtensions(input));
 	const version = readVersion(migrated);
 	const result = v.safeParse(SPEC_SCHEMAS[version], migrated);
 	if (!result.success) throw new SpecError(result.issues.map(formatIssue));
@@ -3547,9 +3657,32 @@ function specJsonSchema() {
 		$schema,
 		$id: SPEC_SCHEMA_URL,
 		title: "tin.so spec",
-		...schema
+		...allowExtensions(schema)
 	};
 }
+function allowExtensions(node) {
+	if (Array.isArray(node)) return node.map(allowExtensions);
+	if (typeof node !== "object" || node === null) return node;
+	const out = Object.fromEntries(Object.entries(node).map(([key, value]) => [key, allowExtensions(value)]));
+	if (out.type === "object" && out.additionalProperties === false) out.patternProperties = { [`^x-`]: {} };
+	return out;
+}
+const SPEC_SCHEMA_HOSTS = ["code-image.zirkelc.workers.dev"];
+const SPEC_SCHEMA_PATH = /\/schema\/v\d+\.json$/;
+/**
+* True when the value is the URL of a tin.so spec schema: a path that ends with
+* /schema/v<number>.json on the host of the hosted app, on an earlier host of the app, or on the
+* host of the given app URL (for example a local editor).
+*/
+function isSpecSchemaUrl(value, appUrl) {
+	if (typeof value !== "string" || !URL.canParse(value)) return false;
+	const url = new URL(value);
+	if (url.protocol !== "https:" && url.protocol !== "http:") return false;
+	if (!SPEC_SCHEMA_PATH.test(url.pathname)) return false;
+	const hosts = [new URL(SPEC_SCHEMA_URL).host, ...SPEC_SCHEMA_HOSTS];
+	if (appUrl !== void 0 && URL.canParse(appUrl)) hosts.push(new URL(appUrl).host);
+	return hosts.includes(url.host);
+}
 // src/sizes.ts
 const MAC_HEADER = {
 	paddingTop: 10,
@@ -3590,7 +3723,7 @@ function line(x1, y1, x2, y2, extra) {
 		...extra
 	})}/>`;
 }
-function inflate$1(rect, by) {
+function inflate(rect, by) {
 	return {
 		x: rect.x - by,
 		y: rect.y - by,
@@ -4036,7 +4169,7 @@ function boxShadow(context, window, layers) {
 	})}><rect width="${width}" height="${height}" fill="white"/>${roundedRect(window, window.radius, { fill: "black" })}</mask></defs>`, `<g mask="url(#${mask})">`];
 	for (const layer of layers) {
 		const spread = layer.spread ?? 0;
-		const box = inflate$1({
+		const box = inflate({
 			...window,
 			y: window.y + layer.y
 		}, spread);
@@ -4134,11 +4267,11 @@ const DEFAULT_FRAME = {
 	behind: (context, window) => window.frame ? boxShadow(context, window, RAYSO_SHADOW) : "",
 	body: ({ scene }, window) => roundedRect(window, window.radius, { fill: scene.frame.background }),
 	header: (context, window) => windowControls(window, context.scene.frame.control) + titleBarText(context, window, { title: context.scene.frame.title }),
-	border: ({ scene }, window) => roundedRect(inflate$1(window, .5), window.radius + .5, {
+	border: ({ scene }, window) => roundedRect(inflate(window, .5), window.radius + .5, {
 		fill: "none",
 		stroke: scene.frame.highlightBorder,
 		"stroke-width": 1
-	}) + roundedRect(inflate$1(window, 1.25), window.radius + 1.25, {
+	}) + roundedRect(inflate(window, 1.25), window.radius + 1.25, {
 		fill: "none",
 		stroke: scene.frame.shadowBorder,
 		"stroke-width": .5
@@ -4319,11 +4452,11 @@ const frame$20 = {
 			x2: 0,
 			y2: inner.y + inner.height * .15
 		})}><stop offset="0" stop-color="${style.shine[0]}"/><stop offset="1" stop-color="${style.shine[1]}"/></linearGradient>`}</defs>`, roundedRect(window, window.radius, { fill: style.shell })];
-		if (context.mode === "light") out.push(roundedRect(inflate$1(window, .5), window.radius + .5, {
+		if (context.mode === "light") out.push(roundedRect(inflate(window, .5), window.radius + .5, {
 			fill: "none",
 			stroke: style.ring
 		}));
-		out.push(roundedRect(inner, 10, { fill: style.window }), roundedRect(inner, 10, { fill: `url(#${shine})` }), roundedRect(inflate$1(inner, .5), 10.5, {
+		out.push(roundedRect(inner, 10, { fill: style.window }), roundedRect(inner, 10, { fill: `url(#${shine})` }), roundedRect(inflate(inner, .5), 10.5, {
 			fill: "none",
 			stroke: style.ring
 		}));
@@ -4556,7 +4689,7 @@ const frame$18 = {
 	behind: (context, window) => {
 		if (window.frame) return DEFAULT_FRAME.behind(context, window);
 		const id = context.id(`haze-${window.x}-${window.y}`);
-		return `<defs>${blurFilter(id, 12)}</defs>${roundedRect(inflate$1(window, 8), 24, {
+		return `<defs>${blurFilter(id, 12)}</defs>${roundedRect(inflate(window, 8), 24, {
 			fill: context.scene.frame.background,
 			filter: `url(#${id})`
 		})}`;
@@ -4635,7 +4768,7 @@ const frame$17 = {
 		return out.join("");
 	},
 	behind: () => "",
-	border: ({ mode }, window) => roundedRect(inflate$1(window, -.5), 0, {
+	border: ({ mode }, window) => roundedRect(inflate(window, -.5), 0, {
 		fill: "none",
 		stroke: COLORS$14[mode].border
 	})
@@ -5114,7 +5247,7 @@ function diagonals(window, stroke) {
 }
 /** The thin rounded outline of the window */
 function outline(window, stroke) {
-	return roundedRect(inflate$1(window, -.5), 23.5, {
+	return roundedRect(inflate(window, -.5), 23.5, {
 		fill: "none",
 		stroke
 	});
@@ -5901,7 +6034,7 @@ const frame$9 = {
 	behind: (context, window) => {
 		if (window.frame) return DEFAULT_FRAME.behind(context, window);
 		const id = context.id(`haze-${window.x}-${window.y}`);
-		return `<defs>${blurFilter(id, 12)}</defs>${roundedRect(inflate$1(window, 8), 24, {
+		return `<defs>${blurFilter(id, 12)}</defs>${roundedRect(inflate(window, 8), 24, {
 			fill: context.scene.frame.background,
 			filter: `url(#${id})`
 		})}`;
@@ -6032,7 +6165,7 @@ function glows(context, window) {
 function rings(context, window, from) {
 	const out = [];
 	RINGS.slice(from).forEach((ring, index) => {
-		const box = inflate$1(window, ring.offset);
+		const box = inflate(window, ring.offset);
 		const id = context.id(`ring-${index + from}-${window.x}-${window.y}`);
 		const [a, b, c, d] = ring.stops;
 		out.push(`<defs>${linearGradient(id, 135, box, [
@@ -6042,7 +6175,7 @@ function rings(context, window, from) {
 			[c, "rgba(0, 220, 130, 0)"],
 			[d, GREEN],
 			[1, GREEN]
-		])}</defs>`, roundedRect(inflate$1(box, -.5), window.radius + ring.radius - .5, {
+		])}</defs>`, roundedRect(inflate(box, -.5), window.radius + ring.radius - .5, {
 			fill: "none",
 			stroke: `url(#${id})`,
 			"stroke-opacity": ring.opacity
@@ -6200,7 +6333,7 @@ const frame$7 = {
 		return `<defs>${linearGradient(id, 238, box, [[0, from], [1, to]])}</defs><rect width="${scene.width}" height="${scene.height}" fill="url(#${id})"/>`;
 	},
 	behind: (context, window) => window.frame ? boxShadow(context, window, shadow(context.mode)) : "",
-	border: ({ mode }, window) => roundedRect(inflate$1(window, -.25), window.radius - .25, {
+	border: ({ mode }, window) => roundedRect(inflate(window, -.25), window.radius - .25, {
 		fill: "none",
 		stroke: COLORS$5[mode].border,
 		"stroke-width": .5
@@ -6399,19 +6532,19 @@ const frame$6 = {
 	border: (context, window) => {
 		const style = COLORS$4[context.mode];
 		const r = window.radius;
-		const inner = inflate$1(window, -1);
+		const inner = inflate(window, -1);
 		const mask = context.id(`highlight-${window.x}-${window.y}`);
 		return `<defs><mask ${attrs({
 			id: mask,
 			maskUnits: "userSpaceOnUse",
-			...inflate$1(window, 2)
-		})}>${roundedRect(inflate$1(window, 2), 0, { fill: "white" })}${roundedRect({
+			...inflate(window, 2)
+		})}>${roundedRect(inflate(window, 2), 0, { fill: "white" })}${roundedRect({
 			...inner,
 			y: inner.y + 1
 		}, r - 1, { fill: "black" })}</mask></defs>${roundedRect(inner, r - 1, {
 			fill: style.highlight,
 			mask: `url(#${mask})`
-		})}` + roundedRect(inflate$1(window, -.5), r - .5, {
+		})}` + roundedRect(inflate(window, -.5), r - .5, {
 			fill: "none",
 			stroke: style.border
 		});
@@ -6737,7 +6870,7 @@ const frame$4 = {
 		}]));
 		return out.join("");
 	},
-	border: (_context, window) => roundedRect(inflate$1(window, -.5), window.radius - .5, {
+	border: (_context, window) => roundedRect(inflate(window, -.5), window.radius - .5, {
 		fill: "none",
 		stroke: COLORS$3.border
 	})
@@ -6856,7 +6989,7 @@ const frame$3 = {
 		}));
 		return out.join("");
 	},
-	border: ({ mode }, window) => roundedRect(inflate$1(window, .5), window.radius + .5, {
+	border: ({ mode }, window) => roundedRect(inflate(window, .5), window.radius + .5, {
 		fill: "none",
 		stroke: COLORS$2[mode].border
 	})
@@ -7025,7 +7158,7 @@ function blur(id, radius, box) {
 	return `<filter ${attrs({
 		id,
 		filterUnits: "userSpaceOnUse",
-		...inflate$1(box, radius * 3)
+		...inflate(box, radius * 3)
 	})}><feGaussianBlur stdDeviation="${radius}"/></filter>`;
 }
 /** A thin line of light from sky blue to pink on the lower grid line, which glows downward */
@@ -7138,11 +7271,11 @@ const frame$2 = {
 		return line(header.x, y, header.x + header.width, y, { stroke: scene.frame.divider }) + controls(window, scene.frame.control) + titleBarText(context, window, { title: scene.frame.title });
 	},
 	border: ({ mode }, window) => {
-		const out = [roundedRect(inflate$1(window, -.5), window.radius - .5, {
+		const out = [roundedRect(inflate(window, -.5), window.radius - .5, {
 			fill: "none",
 			stroke: COLORS$1[mode].border
 		})];
-		if (mode === "light") out.push(roundedRect(inflate$1(window, .5), window.radius + .5, {
+		if (mode === "light") out.push(roundedRect(inflate(window, .5), window.radius + .5, {
 			fill: "none",
 			stroke: "rgba(15, 23, 42, 0.1)"
 		}));
@@ -7960,11 +8093,25 @@ const SOFTWARE = "tin.so";
 const PNG_KEYWORDS = {
 	software: "Software",
 	source: "Source",
-	link: "code-image:link",
-	spec: "code-image:spec"
+	link: "tin.so:link"
 };
 /** The namespace of the metadata element in an SVG */
-const SVG_NAMESPACE = "urn:code-image:metadata:1";
+const SVG_NAMESPACE = "urn:tin.so:metadata:1";
+/**
+* The keywords and the SVG element of the first image format, which stored the spec a second time
+* next to the link. The reader still reads them, so that older images open.
+*/
+const LEGACY = {
+	link: "code-image:link",
+	spec: "code-image:spec",
+	element: "code-image",
+	namespace: "urn:code-image:metadata:1"
+};
+const OUR_KEYWORDS = /* @__PURE__ */ new Set([
+	PNG_KEYWORDS.link,
+	LEGACY.link,
+	LEGACY.spec
+]);
 const MAX_INPUT_BYTES = 67108864;
 const MAX_CHUNK_BYTES = 4194304;
 const MAX_SPEC_BYTES = 16777216;
@@ -7990,27 +8137,20 @@ async function createImageMetadata(spec, appUrl = DEFAULT_APP_URL) {
 		link: await createLink(stamped, appUrl)
 	};
 }
-/**
-* The spec as JSON that is safe in XML text. JSON escapes the control characters, and this escapes
-* the two noncharacters that XML does not allow. Both are only possible in JSON strings.
-*/
-function specJson(spec) {
-	return (JSON.stringify(spec) ?? "null").replace(/[￾￿]/g, (char) => `\\u${char.charCodeAt(0).toString(16)}`);
-}
 /** The app URL of a link, without the spec in the fragment */
 function sourceUrl(link) {
 	const url = new URL(link);
 	url.hash = "";
 	return url.toString();
 }
-/** The metadata element of an SVG */
+/** The metadata element of an SVG: the program, the app URL and the editor link */
 function svgMetadata(metadata) {
-	return `<metadata><code-image ${[
+	return `<metadata><tin ${[
 		`xmlns="${SVG_NAMESPACE}"`,
 		`software="${SOFTWARE}"`,
 		`source="${escapeXml(sourceUrl(metadata.link))}"`,
 		`link="${escapeXml(metadata.link)}"`
-	].join(" ")}>${escapeXml(specJson(metadata.spec))}</code-image></metadata>`;
+	].join(" ")}/></metadata>`;
 }
 const CRC_TABLE = (() => {
 	const table = /* @__PURE__ */ new Uint32Array(256);
@@ -8053,60 +8193,20 @@ function textChunk(keyword, text) {
 		encoder.encode(text)
 	]));
 }
-function compressedTextChunk(keyword, compressed) {
-	return pngChunk("iTXt", concat([
-		encoder.encode(keyword),
-		new Uint8Array([
-			0,
-			1,
-			0,
-			0,
-			0
-		]),
-		compressed
-	]));
-}
-async function deflate(bytes) {
-	const stream = new Blob([bytes]).stream().pipeThrough(new CompressionStream("deflate"));
-	return new Uint8Array(await new Response(stream).arrayBuffer());
-}
-/** Inflates zlib data, or returns undefined when the data is bad or larger than the limit */
-async function inflate(bytes, limit) {
-	const reader = new Blob([bytes]).stream().pipeThrough(new DecompressionStream("deflate")).getReader();
-	const parts = [];
-	let size = 0;
-	try {
-		for (;;) {
-			const { done, value } = await reader.read();
-			if (done) break;
-			size += value.length;
-			if (size > limit) {
-				await reader.cancel().catch(() => void 0);
-				return;
-			}
-			parts.push(value);
-		}
-	} catch {
-		return;
-	}
-	return concat(parts);
-}
 function isPng(bytes) {
 	return PNG_SIGNATURE.every((byte, index) => bytes[index] === byte);
 }
 /**
-* Adds text chunks after the header of a PNG: the program, the app URL, the editor link and the
-* compressed spec. A PNG without the expected header comes back unchanged.
+* Adds text chunks after the header of a PNG: the program, the app URL and the editor link. A PNG
+* without the expected header comes back unchanged.
 */
 async function addPngMetadata(png, metadata) {
 	if (!isPng(png) || png.length < IHDR_END || decoder.decode(png.subarray(12, 16)) !== "IHDR") return png;
-	const spec = await deflate(encoder.encode(specJson(metadata.spec)));
 	return concat([
 		png.subarray(0, IHDR_END),
 		textChunk(PNG_KEYWORDS.software, SOFTWARE),
 		textChunk(PNG_KEYWORDS.source, sourceUrl(metadata.link)),
 		textChunk(PNG_KEYWORDS.link, metadata.link),
-		compressedTextChunk(PNG_KEYWORDS.spec, spec),
 		png.subarray(IHDR_END)
 	]);
 }
@@ -8115,7 +8215,7 @@ function readTextChunk(type, data) {
 	const end = data.indexOf(0);
 	if (end < 1 || end > 79) return void 0;
 	const keyword = decoder.decode(data.subarray(0, end));
-	if (keyword !== PNG_KEYWORDS.spec && keyword !== PNG_KEYWORDS.link) return void 0;
+	if (!OUR_KEYWORDS.has(keyword)) return void 0;
 	if (type === "tEXt") return {
 		keyword,
 		entry: {
@@ -8160,7 +8260,7 @@ function readPngEntries(png) {
 async function entryText(entry) {
 	if (!entry) return void 0;
 	if (!entry.compressed) return decoder.decode(entry.text);
-	const bytes = await inflate(entry.text, MAX_SPEC_BYTES);
+	const bytes = await inflate$1(entry.text, "deflate", MAX_SPEC_BYTES);
 	return bytes && decoder.decode(bytes);
 }
 function parseSpecJson(json) {
@@ -8175,7 +8275,7 @@ function parseSpecJson(json) {
 async function specFromLink(link) {
 	if (!link) return void 0;
 	try {
-		const spec = await readLink(link);
+		const spec = await readLink(link, { maxBytes: MAX_SPEC_BYTES });
 		return typeof spec === "object" && spec !== null ? spec : void 0;
 	} catch {
 		return;
@@ -8183,7 +8283,9 @@ async function specFromLink(link) {
 }
 async function readPngSpec(png) {
 	const entries = readPngEntries(png);
-	return parseSpecJson(await entryText(entries.get(PNG_KEYWORDS.spec))) ?? specFromLink(await entryText(entries.get(PNG_KEYWORDS.link)));
+	const fromLink = await specFromLink(await entryText(entries.get(PNG_KEYWORDS.link)));
+	if (fromLink !== void 0) return fromLink;
+	return parseSpecJson(await entryText(entries.get(LEGACY.spec))) ?? specFromLink(await entryText(entries.get(LEGACY.link)));
 }
 const ENTITIES = {
 	amp: "&",
@@ -8199,18 +8301,32 @@ function unescapeXml(text) {
 		return code <= 1114111 ? String.fromCodePoint(code) : match;
 	});
 }
+/** The value of the link attribute of an element tag, unescaped */
+function linkAttribute(tag) {
+	const link = /\slink=(?:"([^"]*)"|'([^']*)')/.exec(tag);
+	return link ? unescapeXml(link[1] ?? link[2]) : void 0;
+}
 function readSvgSpec(svg) {
-	const start = svg.indexOf("<code-image ");
+	const start = svg.indexOf("<tin ");
+	if (start >= 0) {
+		const end = svg.indexOf(">", start);
+		const tag = end < 0 ? "" : svg.slice(start, end);
+		if (tag.includes("urn:tin.so:metadata:1")) return specFromLink(linkAttribute(tag));
+	}
+	return readLegacySvgSpec(svg);
+}
+/** An SVG of the first format, with the spec as the text of the element and the link */
+function readLegacySvgSpec(svg) {
+	const start = svg.indexOf(`<${LEGACY.element} `);
 	if (start < 0) return void 0;
 	const tagEnd = svg.indexOf(">", start);
-	const close = svg.indexOf("</code-image>", tagEnd);
+	const close = svg.indexOf(`</${LEGACY.element}>`, tagEnd);
 	if (tagEnd < 0 || close < 0) return void 0;
 	const tag = svg.slice(start, tagEnd);
-	if (!tag.includes("urn:code-image:metadata:1")) return void 0;
+	if (!tag.includes(LEGACY.namespace)) return void 0;
 	const spec = parseSpecJson(unescapeXml(svg.slice(tagEnd + 1, close)));
 	if (spec !== void 0) return Promise.resolve(spec);
-	const link = /\slink=(?:"([^"]*)"|'([^']*)')/.exec(tag);
-	return specFromLink(link ? unescapeXml(link[1] ?? link[2]) : void 0);
+	return specFromLink(linkAttribute(tag));
 }
 /**
 * Reads the spec from a PNG or an SVG that this package made with metadata, with the fields of
@@ -8543,4 +8659,4 @@ function toSvg(scene, options = {}) {
 		"</svg>"
 	].join("\n");
 }
-export { FILE_ICON as $, parseSpec as A, highlight as B, specJsonSchema as C, SpecError as D, SPEC_LIMITS as E, getSyntax as F, createLink as G, isKnownLanguage as H, getTheme as I, readLink as J, decodeSpec as K, resolveMode as L, THEMES as M, THEME_IDS as N, SpecSchema as O, getFrameColors as P, AUTO_ICON as Q, LANGUAGE_IDS as R, SPEC_SCHEMA_URL as S, MARK_STYLES as T, resolveLanguage as U, inferLanguage as V, DEFAULT_APP_URL as W, migrateLegacySpec as X, IMPLICIT_SPEC_VERSION as Y, stampSpecVersion as Z, WINDOW_RADIUS as _, svgToPng as a, CODE_FONT_IDS as at, normalizeCode as b, SOFTWARE as c, cssFontFamily as ct, createImageMetadata as d, measureUiText as dt, ICON_IDS as et, readImageSpec as f, TAB_HEADER as g, POPOVER as h, sceneFontFiles as i, CODE_FONTS as it, DEFAULT_THEME as j, expandLineRanges as k, SVG_NAMESPACE as l, getCodeFont as lt, LINE_HEIGHT as m, initPng as n, getIcon as nt, METADATA_BY_DEFAULT as o, DEFAULT_CODE_FONT as ot, FONT_SIZE as p, encodeSpec as q, loadSceneFonts as r, resolveIcon as rt, PNG_KEYWORDS as s, UI_FONT as st, toSvg as t, NO_ICON as tt, addPngMetadata as u, getFace as ut, cellCount as v, LATEST_SPEC_VERSION as w, MAC_HEADER as x, layout as y, PLAIN_TEXT as z };
+export { migrateLegacySpec as $, SpecSchema as A, LANGUAGE_IDS as B, isSpecSchemaUrl as C, MARK_STYLES as D, LATEST_SPEC_VERSION as E, THEME_IDS as F, resolveLanguage as G, highlight as H, getFrameColors as I, decodeSpec as J, DEFAULT_APP_URL as K, getSyntax as L, parseSpec as M, DEFAULT_THEME as N, SPEC_LIMITS as O, THEMES as P, IMPLICIT_SPEC_VERSION as Q, getTheme as R, SPEC_SCHEMA_URL as S, ANNOTATION_TYPES as T, inferLanguage as U, PLAIN_TEXT as V, isKnownLanguage as W, readLink as X, encodeSpec as Y, EXTENSION_PREFIX as Z, WINDOW_RADIUS as _, svgToPng as a, NO_ICON as at, normalizeCode as b, SOFTWARE as c, CODE_FONTS as ct, createImageMetadata as d, UI_FONT as dt, schemaVersion as et, readImageSpec as f, cssFontFamily as ft, TAB_HEADER as g, POPOVER as h, measureUiText as ht, sceneFontFiles as i, ICON_IDS as it, expandLineRanges as j, SpecError as k, SVG_NAMESPACE as l, CODE_FONT_IDS as lt, LINE_HEIGHT as m, getFace as mt, initPng as n, AUTO_ICON as nt, METADATA_BY_DEFAULT as o, getIcon as ot, FONT_SIZE as p, getCodeFont as pt, createLink as q, loadSceneFonts as r, FILE_ICON as rt, PNG_KEYWORDS as s, resolveIcon as st, toSvg as t, stampSpecVersion as tt, addPngMetadata as u, DEFAULT_CODE_FONT as ut, cellCount as v, specJsonSchema as w, MAC_HEADER as x, layout as y, resolveMode as z };

package/package.json

@@ -1,29 +1,27 @@
 {
   "name": "@tin.so/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Renders code images from a JSON spec to SVG and PNG",
-  "license": "MIT",
-  "author": "Chris Cook",
-  "homepage": "https://tin.so",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zirkelc/code-image.git"
-  },
   "keywords": [
+    "cli",
     "code",
-    "screenshot",
-    "image",
     "code-image",
+    "image",
     "ray.so",
-    "shiki",
-    "cli"
+    "screenshot",
+    "shiki"
   ],
-  "publishConfig": {
-    "access": "public"
+  "homepage": "https://tin.so",
+  "license": "MIT",
+  "author": "Chris Cook",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zirkelc/tin.so.git"
   },
   "files": [
     "dist",
-    "fonts"
+    "fonts",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "type": "module",
   "exports": {
@@ -31,6 +29,9 @@
     "./node": "./dist/node.mjs",
     "./package.json": "./package.json"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@resvg/resvg-wasm": "^2.6.2",
     "@valibot/to-json-schema": "^1.8.0",