@tin.so/core 0.2.0 → 0.3.0

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

@@ -1,114 +1,5 @@
 import * as v from "valibot";
 import { InitInput } from "@resvg/resvg-wasm";
-type FontFace = {
-  weight: number;
-  italic: boolean;
-  /** Path relative to the fonts directory of this package */
-  file: string;
-  /** Family name inside the font file, which resvg uses to match the face */
-  family: string;
-};
-type FontMetrics = {
-  unitsPerEm: number;
-  ascender: number;
-  descender: number;
-  lineGap: number;
-};
-type CodeFont = {
-  id: string;
-  name: string;
-  kind: "code";
-  faces: Array<FontFace>;
-  metrics: FontMetrics & {
-    advance: number;
-  };
-};
-type UiFont = {
-  id: string;
-  name: string;
-  kind: "ui";
-  faces: Array<FontFace>;
-  metrics: FontMetrics & {
-    advances: Record<string, number>;
-  };
-};
-type Font = CodeFont | UiFont;
-/** Reads a font file by its path relative to the fonts directory */
-type FontLoader = (file: string) => Promise<Uint8Array>;
-declare const CODE_FONTS: CodeFont[];
-declare const CODE_FONT_IDS: string[];
-declare const DEFAULT_CODE_FONT = "jetbrains-mono";
-declare const UI_FONT: UiFont;
-declare function getCodeFont(id: string): CodeFont;
-/** Picks the face that matches the style best: the exact face, then the regular face of the same style */
-declare function getFace(font: Font, style?: {
-  bold?: boolean;
-  italic?: boolean;
-}): FontFace;
-/**
- * The CSS font family of a face. The first name is for browsers, which load the faces with @font-face
- * rules under that name. The second name is the family inside the file, for resvg. The names stay
- * unquoted, because resvg does not match a quoted name that follows another name.
- */
-declare function cssFontFamily(font: Font, face: FontFace): string;
-/** Width of a text in the UI font, for title layout. Characters outside of ASCII count as an "M". */
-declare function measureUiText(text: string, fontSize: number): number;
-/** An icon on a 24px grid, drawn either filled or as a 2px stroke */
-type Icon = {
-  id: string;
-  title: string;
-  /** SVG elements of the icon, without the root element */
-  body: string;
-  style: "fill" | "stroke";
-};
-/** The icon of the language, from its id in the language list */
-declare const AUTO_ICON = "auto";
-declare const FILE_ICON = "file";
-declare const NO_ICON = "none";
-/** Icon ids that a pane can name, besides "auto" and "none" */
-declare const ICON_IDS: string[];
-declare function getIcon(id: string): Icon | undefined;
-/** Resolves the icon setting of a pane. Returns undefined for "none". */
-declare function resolveIcon(setting: string, language: string): Icon | undefined;
-/** The URL of the JSON Schema of the latest spec version, on the hosted app */
-declare const SPEC_SCHEMA_URL: string;
-/**
- * The spec as a JSON Schema, for editors and agents. JSON Schema cannot express the custom checks of
- * 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://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. 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, options?: DecodeOptions): Promise<unknown>;
 type Mode = "light" | "dark";
 /** Token colors of a theme. Keys that are missing use the foreground color. */
 type Syntax = {
@@ -138,16 +29,24 @@ type Theme = {
     from: string;
     to: string;
   };
-  font?: string;
-  partner?: boolean;
-  hidden?: boolean;
-  lineNumbers?: boolean;
+  /** The colors of the window by mode, as in the editor of the theme. The background is opaque. */
+  window?: Partial<Record<Mode, EditorWindow>>;
+  /** The Shiki theme by mode that colors the code, in place of the token colors of the syntax */
+  textmate: Partial<Record<Mode, string>>;
   syntax: {
     light?: Syntax;
     dark?: Syntax;
   };
 };
-/** Colors of the window around the code, from the ray.so default frame */
+/** The colors of the window of an editor theme */
+type EditorWindow = {
+  background: string;
+  /** The text of the title bar and the tabs */
+  title?: string;
+  lineNumber?: string;
+  divider?: string;
+};
+/** Colors of the window around the code, from the default frame of ray.so */
 type FrameColors = {
   /** The gradient behind the windows */
   backdrop: {
@@ -166,7 +65,7 @@ type FrameColors = {
 };
 declare const THEMES: Array<Theme>;
 declare const THEME_IDS: string[];
-declare const DEFAULT_THEME = "candy";
+declare const DEFAULT_THEME = "github";
 declare function getTheme(id: string): Theme;
 /** A theme with only one mode always uses that mode */
 declare function resolveMode(theme: Theme, mode: Mode): Mode;
@@ -196,6 +95,101 @@ declare function resolveLanguage(language: string): string;
 declare function inferLanguage(fileName: string | undefined): string;
 /** Splits code into lines of colored tokens with the colors of the theme */
 declare function highlight(code: string, language: string, theme: Theme, mode: Mode, syntax: Syntax): Promise<Array<HighlightedLine>>;
+/**
+ * Backgrounds that the renderer makes from the colors of the image:
+ * - ambient-blur: a blurred and larger copy of the code behind the window
+ * - ambient-code: a mesh of the colors that the code uses most
+ * - ambient-theme: a mesh of the keyword, string, function and constant colors of the theme
+ */
+declare const AMBIENT_BACKGROUNDS: readonly ["ambient-blur", "ambient-code", "ambient-theme"];
+declare const AMBIENT_ENABLED = false;
+type AmbientBackground = (typeof AMBIENT_BACKGROUNDS)[number];
+declare function isAmbientBackground(css: string): css is AmbientBackground;
+/** The theme mesh of a theme in a mode, as a preview of the ambient backgrounds before the code is known */
+declare function ambientPreviewCss(theme: Theme, mode: Mode): string;
+/** A background preset of the editor: a gradient, a color or a mesh of radial gradients */
+type BackgroundPreset = {
+  id: string;
+  name: string;
+  kind: "gradient" | "color" | "mesh";
+  /** The CSS background, as the background field of a spec takes it */
+  css: string;
+};
+declare const BACKGROUNDS: Array<BackgroundPreset>;
+/** The background preset of a theme in a mode, or undefined when the theme has none */
+declare function themeBackground(theme: Theme, mode: Mode): BackgroundPreset | undefined;
+type FontFace = {
+  weight: number;
+  italic: boolean;
+  /** Path relative to the fonts directory of this package */
+  file: string;
+  /** Family name inside the font file, which resvg uses to match the face */
+  family: string;
+};
+type FontMetrics = {
+  unitsPerEm: number;
+  ascender: number;
+  descender: number;
+  lineGap: number;
+};
+type CodeFont = {
+  id: string;
+  name: string;
+  kind: "code";
+  faces: Array<FontFace>;
+  metrics: FontMetrics & {
+    advance: number;
+  };
+};
+type UiFont = {
+  id: string;
+  name: string;
+  kind: "ui";
+  faces: Array<FontFace>;
+  metrics: FontMetrics & {
+    advances: Record<string, number>;
+  };
+};
+type Font = CodeFont | UiFont;
+/** Reads a font file by its path relative to the fonts directory */
+type FontLoader = (file: string) => Promise<Uint8Array>;
+declare const CODE_FONTS: CodeFont[];
+declare const CODE_FONT_IDS: string[];
+declare const DEFAULT_CODE_FONT = "jetbrains-mono";
+declare const UI_FONT: UiFont;
+declare function getCodeFont(id: string): CodeFont;
+/** Picks the face that matches the style best: the exact face, then the regular face of the same style */
+declare function getFace(font: Font, style?: {
+  bold?: boolean;
+  italic?: boolean;
+}): FontFace;
+/**
+ * The CSS font family of a face. The first name is for browsers, which load the faces with @font-face
+ * rules under that name. The second name is the family inside the file, for resvg. The names stay
+ * unquoted, because resvg does not match a quoted name that follows another name.
+ */
+declare function cssFontFamily(font: Font, face: FontFace): string;
+/** Width of a text in the UI font, for title layout. Characters outside of ASCII count as an "M". */
+/** The width of text in a code font, which gives each character the same advance */
+declare function measureCodeText(text: string, fontSize: number, font: CodeFont): number;
+declare function measureUiText(text: string, fontSize: number): number;
+/** An icon on a 24px grid, drawn either filled or as a 2px stroke */
+type Icon = {
+  id: string;
+  title: string;
+  /** SVG elements of the icon, without the root element */
+  body: string;
+  style: "fill" | "stroke";
+};
+/** The icon of the language, from its id in the language list */
+declare const AUTO_ICON = "auto";
+declare const FILE_ICON = "file";
+declare const NO_ICON = "none";
+/** Icon ids that a pane can name, besides "auto" and "none" */
+declare const ICON_IDS: string[];
+declare function getIcon(id: string): Icon | undefined;
+/** Resolves the icon setting of a pane. Returns undefined for "none". */
+declare function resolveIcon(setting: string, language: string): Icon | undefined;
 declare const MAC_HEADER: {
   paddingTop: number;
   height: number;
@@ -247,6 +241,8 @@ type AnnotationBox = {
   lines: Array<HighlightedLine>;
   /** true when the popover is smaller than its code, so that it must cut the code off */
   clipped: boolean;
+  /** The background of the popover from the spec */
+  background?: string;
 };
 type PaneBox = Rect & {
   title?: string;
@@ -292,6 +288,8 @@ type WindowBox = Rect & {
   radius: number;
   title?: string;
   controls: "gray" | "color";
+  /** The background of the window from the spec, in place of the theme color */
+  background?: string;
   /** The size that fits the panes. The layout can make a window larger to fill the image. */
   natural: {
     width: number;
@@ -315,7 +313,14 @@ type Scene = {
   mode: Mode;
   syntax: Syntax;
   frame: FrameColors;
+  /** false for a transparent image */
   background: boolean;
+  /** The opacity of the background, from 0 to 1 */
+  backgroundOpacity: number;
+  /** The color or gradient of the image: the one of the spec, or the background preset of the theme */
+  customBackground: CssBackground | undefined;
+  /** Draw a blurred copy of the code of each window behind it, over the background color */
+  ambientBlur: boolean;
   font: CodeFont;
   text: TextMetrics;
   popoverText: TextMetrics;
@@ -334,6 +339,99 @@ type LayoutOptions = {
 declare function normalizeCode(code: string, options?: LayoutOptions): string;
 /** Validates the spec, highlights the code and places every element of the image */
 declare function layout(input: unknown, options?: LayoutOptions): Promise<Scene>;
+/**
+ * The CSS backgrounds that a spec can use: a color, or layers of linear-gradient and
+ * radial-gradient with an optional color as the last layer. Colors are hex, rgb(), rgba() and
+ * transparent.
+ */
+type Rgba = {
+  r: number;
+  g: number;
+  b: number;
+  a: number;
+};
+type Length = {
+  value: number;
+  unit: "%" | "px";
+};
+type ColorStop = {
+  color: Rgba;
+  position?: Length;
+};
+type Extent = "closest-side" | "closest-corner" | "farthest-side" | "farthest-corner";
+type LinearLayer = {
+  type: "linear";
+  /** An angle in degrees, or the corner or side of a "to" keyword as -1, 0 or 1 on each axis */
+  direction: {
+    angle: number;
+  } | {
+    to: {
+      x: number;
+      y: number;
+    };
+  };
+  stops: Array<ColorStop>;
+};
+type RadialLayer = {
+  type: "radial";
+  shape: "circle" | "ellipse";
+  size: Extent | {
+    x: Length;
+    y: Length;
+  };
+  at: {
+    x: Length;
+    y: Length;
+  };
+  stops: Array<ColorStop>;
+};
+type ColorLayer = {
+  type: "color";
+  color: Rgba;
+};
+type Layer = LinearLayer | RadialLayer | ColorLayer;
+/** A parsed CSS background, with the top layer first as in CSS */
+type CssBackground = Array<Layer>;
+declare function isCssBackground(css: string): boolean;
+/** The URL of the JSON Schema of the latest spec version, on the hosted app */
+declare const SPEC_SCHEMA_URL: string;
+/**
+ * The spec as a JSON Schema, for editors and agents. JSON Schema cannot express the custom checks of
+ * 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://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. 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, options?: DecodeOptions): Promise<unknown>;
 /**
  * Whether a render writes the metadata when the caller does not say. This is the one place to
  * change the default.
@@ -386,12 +484,6 @@ declare function schemaVersion(spec: unknown): number | undefined;
  * 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
- * validation reports it.
- */
-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. The version comes from the $schema URL, or is version 1 without it.
@@ -449,9 +541,10 @@ declare const LATEST_SPEC_VERSION = 1;
 declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
   readonly $schema: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UrlAction<string, undefined>]>, undefined>, v.DescriptionAction<string | undefined, string>]>;
   readonly v: v.SchemaWithPipe<readonly [v.OptionalSchema<v.LiteralSchema<1, undefined>, 1>, v.DescriptionAction<1, string>]>;
-  readonly theme: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<string[], undefined>, "candy">, v.DescriptionAction<string, string>]>;
+  readonly theme: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<string[], undefined>, "github">, v.DescriptionAction<string, string>]>;
   readonly mode: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<["dark", "light"], undefined>, "dark">, v.DescriptionAction<"dark" | "light", string>]>;
-  readonly background: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BooleanSchema<undefined>, true>, v.DescriptionAction<boolean, string>]>;
+  readonly background: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "Use a hex color such as \"#1e1e2e\", or a CSS gradient such as \"linear-gradient(135deg, #2e1065, #a78bfa)\". Gradients are linear-gradient and radial-gradient, with hex, rgb(), rgba() or transparent colors, several layers separated by commas, and a color as the last layer">]>, undefined>, v.DescriptionAction<string | undefined, string>]>;
+  readonly backgroundOpacity: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, 1>, v.DescriptionAction<number, string>]>;
   readonly padding: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 256, undefined>]>, 64>, v.DescriptionAction<number, string>]>;
   readonly font: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<string[], undefined>, undefined>, v.DescriptionAction<string | undefined, string>]>;
   readonly lineNumbers: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, v.DescriptionAction<boolean | undefined, string>]>;
@@ -464,6 +557,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
     readonly frame: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BooleanSchema<undefined>, true>, v.DescriptionAction<boolean, string>]>;
     readonly titleBar: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BooleanSchema<undefined>, true>, v.DescriptionAction<boolean, string>]>;
     readonly tabs: v.SchemaWithPipe<readonly [v.OptionalSchema<v.BooleanSchema<undefined>, false>, v.DescriptionAction<boolean, string>]>;
+    readonly background: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "Use a hex color such as \"#ff5c57\"">]>, undefined>, v.DescriptionAction<string | undefined, string>]>;
     readonly controls: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<["gray", "color"], undefined>, "gray">, v.DescriptionAction<"color" | "gray", string>]>;
     readonly title: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>, v.DescriptionAction<string | undefined, string>]>;
     readonly split: v.SchemaWithPipe<readonly [v.OptionalSchema<v.PicklistSchema<["row", "column"], undefined>, "row">, v.DescriptionAction<"column" | "row", string>]>;
@@ -525,6 +619,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[], string>]>;
+        readonly background: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "Use a hex color such as \"#ff5c57\"">]>, undefined>, v.DescriptionAction<string | undefined, string>]>;
       }, undefined>, undefined>, v.MaxLengthAction<{
         type: "popover";
         line: number;
@@ -544,6 +639,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[], number, (issue: v.MaxLengthIssue<{
         type: "popover";
         line: number;
@@ -563,6 +659,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[], number>) => string>]>, readonly []>, v.DescriptionAction<{
         type: "popover";
         line: number;
@@ -582,6 +679,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[], string>]>;
       readonly marks: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
         readonly line: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, v.DescriptionAction<number, string>]>;
@@ -646,6 +744,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -682,6 +781,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -718,6 +818,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -754,6 +855,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -769,6 +871,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
     frame: boolean;
     titleBar: boolean;
     tabs: boolean;
+    background?: string | undefined;
     controls: "color" | "gray";
     title?: string | undefined;
     split: "column" | "row";
@@ -802,6 +905,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -817,6 +921,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
     frame: boolean;
     titleBar: boolean;
     tabs: boolean;
+    background?: string | undefined;
     controls: "color" | "gray";
     title?: string | undefined;
     split: "column" | "row";
@@ -850,6 +955,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -865,6 +971,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
     frame: boolean;
     titleBar: boolean;
     tabs: boolean;
+    background?: string | undefined;
     controls: "color" | "gray";
     title?: string | undefined;
     split: "column" | "row";
@@ -898,6 +1005,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -913,6 +1021,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
     frame: boolean;
     titleBar: boolean;
     tabs: boolean;
+    background?: string | undefined;
     controls: "color" | "gray";
     title?: string | undefined;
     split: "column" | "row";
@@ -946,6 +1055,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -963,7 +1073,8 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
   v: 1;
   theme: string;
   mode: "dark" | "light";
-  background: boolean;
+  background?: string | undefined;
+  backgroundOpacity: number;
   padding: number;
   font?: string | undefined;
   lineNumbers?: boolean | undefined;
@@ -976,6 +1087,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
     frame: boolean;
     titleBar: boolean;
     tabs: boolean;
+    background?: string | undefined;
     controls: "color" | "gray";
     title?: string | undefined;
     split: "column" | "row";
@@ -1009,6 +1121,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -1026,7 +1139,8 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
   v: 1;
   theme: string;
   mode: "dark" | "light";
-  background: boolean;
+  background?: string | undefined;
+  backgroundOpacity: number;
   padding: number;
   font?: string | undefined;
   lineNumbers?: boolean | undefined;
@@ -1039,6 +1153,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
     frame: boolean;
     titleBar: boolean;
     tabs: boolean;
+    background?: string | undefined;
     controls: "color" | "gray";
     title?: string | undefined;
     split: "column" | "row";
@@ -1072,6 +1187,7 @@ declare const SpecSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
           color?: string | undefined;
           background?: string | undefined;
         }[];
+        background?: string | undefined;
       }[];
       marks: {
         line: number;
@@ -1102,9 +1218,9 @@ declare class SpecError extends Error {
   constructor(issues: Array<string>);
 }
 /**
- * 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.
+ * Validates a spec and applies the defaults. It first removes the keys of other tools, 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 */
@@ -1120,4 +1236,4 @@ type SvgOptions = {
 };
 /** Writes the scene as a standalone SVG document */
 declare function toSvg(scene: Scene, options?: SvgOptions): string;
-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 };
+export { WindowBox as $, resolveMode as $t, addPngMetadata as A, AMBIENT_ENABLED as At, isSpecSchemaUrl as B, isKnownLanguage as Bt, schemaVersion as C, getFace as Ct, PNG_KEYWORDS as D, BackgroundPreset as Dt, METADATA_BY_DEFAULT as E, BACKGROUNDS as Et, createLink as F, LANGUAGE_IDS as Ft, LayoutOptions as G, Mode as Gt, isCssBackground as H, DEFAULT_THEME as Ht, decodeSpec as I, PLAIN_TEXT as It, Rect as J, THEME_IDS as Jt, POPOVER as K, Syntax as Kt, encodeSpec as L, Token as Lt, readImageSpec as M, ambientPreviewCss as Mt, DEFAULT_APP_URL as N, isAmbientBackground as Nt, SOFTWARE as O, themeBackground as Ot, DecodeOptions as P, HighlightedLine as Pt, WINDOW_RADIUS as Q, getTheme as Qt, readLink as R, highlight as Rt, IMPLICIT_SPEC_VERSION as S, getCodeFont as St, ImageMetadata as T, measureUiText as Tt, FONT_SIZE as U, EditorWindow as Ut, specJsonSchema as V, resolveLanguage as Vt, LINE_HEIGHT as W, FrameColors as Wt, TAB_HEADER as X, getFrameColors as Xt, Scene as Y, Theme as Yt, TextMetrics as Z, getSyntax as Zt, initPng as _, FontLoader as _t, MARK_STYLES as a, FILE_ICON as at, svgToPng as b, UiFont as bt, SPEC_LIMITS as c, NO_ICON as ct, SpecInput as d, CODE_FONTS as dt, cellCount as et, SpecSchema as f, CODE_FONT_IDS as ft, PngOptions as g, FontFace as gt, parseSpec as h, Font as ht, LATEST_SPEC_VERSION as i, AUTO_ICON as it, createImageMetadata as j, AmbientBackground as jt, SVG_NAMESPACE as k, AMBIENT_BACKGROUNDS as kt, Spec as l, getIcon as lt, expandLineRanges as m, DEFAULT_CODE_FONT as mt, toSvg as n, normalizeCode as nt, MarkStyle as o, ICON_IDS as ot, WindowSpec as p, CodeFont as pt, PaneBox as q, THEMES as qt, ANNOTATION_TYPES as r, MAC_HEADER as rt, PaneSpec as s, Icon as st, SvgOptions as t, layout as tt, SpecError as u, resolveIcon as ut, loadSceneFonts as v, FontMetrics as vt, stampSpecVersion as w, measureCodeText as wt, EXTENSION_PREFIX as x, cssFontFamily as xt, sceneFontFiles as y, UI_FONT as yt, SPEC_SCHEMA_URL as z, inferLanguage as zt };

package/dist/index.d.mts

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

package/dist/index.mjs

@@ -1 +1 @@
-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";
+export { rt as AMBIENT_BACKGROUNDS, it as AMBIENT_ENABLED, T as ANNOTATION_TYPES, J as AUTO_ICON, tt as BACKGROUNDS, mt as CODE_FONTS, ht as CODE_FONT_IDS, z as DEFAULT_APP_URL, gt as DEFAULT_CODE_FONT, st as DEFAULT_THEME, W as EXTENSION_PREFIX, Y as FILE_ICON, p as FONT_SIZE, X as ICON_IDS, G as IMPLICIT_SPEC_VERSION, N 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, Z as NO_ICON, P 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, ct as THEMES, lt as THEME_IDS, _t as UI_FONT, _ as WINDOW_RADIUS, u as addPngMetadata, at as ambientPreviewCss, v as cellCount, d as createImageMetadata, B as createLink, vt as cssFontFamily, V as decodeSpec, H as encodeSpec, j as expandLineRanges, yt as getCodeFont, bt as getFace, ut as getFrameColors, Q as getIcon, dt as getSyntax, ft as getTheme, F as highlight, I as inferLanguage, n as initPng, ot as isAmbientBackground, et as isCssBackground, L as isKnownLanguage, C as isSpecSchemaUrl, y as layout, r as loadSceneFonts, xt as measureCodeText, St as measureUiText, b as normalizeCode, M as parseSpec, f as readImageSpec, U as readLink, $ as resolveIcon, R as resolveLanguage, pt as resolveMode, i as sceneFontFiles, K as schemaVersion, w as specJsonSchema, q as stampSpecVersion, a as svgToPng, nt as themeBackground, t as toSvg } from "./src-Bn8Hly8W.mjs";