@pixerate/editor 0.175.0 → 0.177.0

package/dist/typography/registry.d.cts

@@ -14,6 +14,8 @@ export interface FontSummary {
     source: FontSource;
     /** Platforms that ship it, for system fonts. */
     platforms?: FontPlatform[];
+    /** Lowercase, hyphenated classes from the provider, e.g. `display`, `slab-serif`, `variable-wdth`. */
+    tags?: string[];
 }
 export interface FontProvider {
     readonly id: string;
@@ -33,6 +35,8 @@ export interface FontFilter {
     /** Case-insensitive substring of the family name. */
     query?: string;
     isVariable?: boolean;
+    /** Keep fonts carrying every one of these tags (any case, spaces as hyphens). */
+    tags?: readonly string[];
 }
 /** Whether a font offers a weight (variable fonts offer every weight in their range). */
 export declare function fontHasWeight(font: FontSummary, weight: FontWeight): boolean;

package/dist/typography/registry.d.ts

@@ -14,6 +14,8 @@ export interface FontSummary {
     source: FontSource;
     /** Platforms that ship it, for system fonts. */
     platforms?: FontPlatform[];
+    /** Lowercase, hyphenated classes from the provider, e.g. `display`, `slab-serif`, `variable-wdth`. */
+    tags?: string[];
 }
 export interface FontProvider {
     readonly id: string;
@@ -33,6 +35,8 @@ export interface FontFilter {
     /** Case-insensitive substring of the family name. */
     query?: string;
     isVariable?: boolean;
+    /** Keep fonts carrying every one of these tags (any case, spaces as hyphens). */
+    tags?: readonly string[];
 }
 /** Whether a font offers a weight (variable fonts offer every weight in their range). */
 export declare function fontHasWeight(font: FontSummary, weight: FontWeight): boolean;

package/dist/typography/stylesheet.d.cts

@@ -0,0 +1,86 @@
+/**
+ * Font services that serve CSS (Google Fonts, Bunny Fonts, a self-hosted css2-compatible proxy):
+ * a provider that loads a family by adding the service's stylesheet and waiting for the face,
+ * and an adapter for the Google Fonts catalog and stylesheet URLs.
+ */
+import { type FontProvider, type FontSummary } from './registry.cjs';
+import { type FontStyle, type FontWeight } from './types.cjs';
+/** The parts of `document.fonts` the stylesheet provider uses. */
+export interface StylesheetFontSetLike {
+    load(font: string, text?: string): Promise<readonly unknown[]>;
+}
+export interface StylesheetFontProviderOptions {
+    id?: string;
+    /** The service's families; called once, on first use. */
+    listFonts: () => FontSummary[] | Promise<FontSummary[]>;
+    /** The stylesheet URL that declares one face. */
+    stylesheetUrl: (family: string, weight: FontWeight, style: FontStyle) => string;
+    /**
+     * Adds a stylesheet and resolves when it has loaded (default: a `<link rel="stylesheet">` in
+     * `document.head`). Inject a fake in tests: nothing then hits the network.
+     */
+    addStylesheet?: (url: string) => Promise<void>;
+    /** Where faces are waited for (default `document.fonts`). */
+    fontFaceSet?: StylesheetFontSetLike;
+    /**
+     * Characters the face must cover once loaded (default Latin letters and digits). Services split
+     * a family into `unicode-range` subsets, and `document.fonts.load` without text fetches none of
+     * the files a page needs for words.
+     */
+    sampleText?: string;
+}
+/**
+ * Fonts from a service that serves CSS. `loadFont` asks for the nearest weight and style the
+ * family offers, adds that face's stylesheet once, then resolves `true` when the browser has the face (`document.fonts.load` matched it), `false` when the family
+ * is not listed, the stylesheet fails or no face matches. Loads are cached per face; failures can
+ * be retried.
+ */
+export declare function createStylesheetFontProvider(options: StylesheetFontProviderOptions): FontProvider & {
+    loaded(family: string, weight?: FontWeight, style?: FontStyle): boolean;
+};
+/** One family in the Google Fonts metadata (`https://fonts.google.com/metadata/fonts`), as far as this module reads it. */
+export interface GoogleFontsFamilyMetadata {
+    family: string;
+    /** `Sans Serif`, `Serif`, `Display`, `Handwriting` or `Monospace`. */
+    category?: string;
+    /** Further classes, e.g. `Display`, `Handwriting`, `Monospace`, `Symbols`. */
+    classifications?: readonly string[];
+    /** Stroke class, e.g. `Sans Serif`, `Serif`, `Slab Serif`. */
+    stroke?: string | null;
+    /** Faces by weight, `i` for italic: `{ "400": …, "700i": … }`. */
+    fonts?: Record<string, unknown>;
+    axes?: ReadonlyArray<{
+        tag: string;
+        min: number;
+        max: number;
+    }>;
+    /** Rank, 1 = most popular. */
+    popularity?: number;
+    subsets?: readonly string[];
+}
+/**
+ * The families in a Google Fonts metadata response (the object, its `familyMetadataList`, or the
+ * raw text with its `)]}'` prefix), most popular first. A family classified as display,
+ * handwriting or monospace takes that category even when Google files it under sans serif or
+ * serif (Anton is a sans serif classified as display); its classes, stroke and axes become
+ * `tags` (`display`, `slab-serif`, `variable-wdth`…).
+ */
+export declare function googleFontsCatalog(metadata: unknown): FontSummary[];
+/** The Google Fonts css2 URL for one face, e.g. `…/css2?family=Space+Grotesk:ital,wght@0,700&display=swap`. */
+export declare function googleFontsStylesheetUrl(family: string, weight?: FontWeight, style?: FontStyle, options?: {
+    baseUrl?: string;
+    display?: string;
+}): string;
+export interface GoogleFontsProviderOptions extends Omit<StylesheetFontProviderOptions, 'listFonts' | 'stylesheetUrl'> {
+    /**
+     * The Google Fonts metadata, or the catalog already built from it. fonts.google.com does not
+     * allow cross-origin reads, so a browser host fetches it through its own server.
+     */
+    catalog: () => Promise<unknown>;
+    /** css2-compatible stylesheet endpoint (default `https://fonts.googleapis.com/css2`). */
+    baseUrl?: string;
+}
+/** Google Fonts (or a css2-compatible mirror): its catalog, loaded face by face through its stylesheets. */
+export declare function createGoogleFontsProvider(options: GoogleFontsProviderOptions): FontProvider & {
+    loaded(family: string, weight?: FontWeight, style?: FontStyle): boolean;
+};

package/dist/typography/stylesheet.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Font services that serve CSS (Google Fonts, Bunny Fonts, a self-hosted css2-compatible proxy):
+ * a provider that loads a family by adding the service's stylesheet and waiting for the face,
+ * and an adapter for the Google Fonts catalog and stylesheet URLs.
+ */
+import { type FontProvider, type FontSummary } from './registry.js';
+import { type FontStyle, type FontWeight } from './types.js';
+/** The parts of `document.fonts` the stylesheet provider uses. */
+export interface StylesheetFontSetLike {
+    load(font: string, text?: string): Promise<readonly unknown[]>;
+}
+export interface StylesheetFontProviderOptions {
+    id?: string;
+    /** The service's families; called once, on first use. */
+    listFonts: () => FontSummary[] | Promise<FontSummary[]>;
+    /** The stylesheet URL that declares one face. */
+    stylesheetUrl: (family: string, weight: FontWeight, style: FontStyle) => string;
+    /**
+     * Adds a stylesheet and resolves when it has loaded (default: a `<link rel="stylesheet">` in
+     * `document.head`). Inject a fake in tests: nothing then hits the network.
+     */
+    addStylesheet?: (url: string) => Promise<void>;
+    /** Where faces are waited for (default `document.fonts`). */
+    fontFaceSet?: StylesheetFontSetLike;
+    /**
+     * Characters the face must cover once loaded (default Latin letters and digits). Services split
+     * a family into `unicode-range` subsets, and `document.fonts.load` without text fetches none of
+     * the files a page needs for words.
+     */
+    sampleText?: string;
+}
+/**
+ * Fonts from a service that serves CSS. `loadFont` asks for the nearest weight and style the
+ * family offers, adds that face's stylesheet once, then resolves `true` when the browser has the face (`document.fonts.load` matched it), `false` when the family
+ * is not listed, the stylesheet fails or no face matches. Loads are cached per face; failures can
+ * be retried.
+ */
+export declare function createStylesheetFontProvider(options: StylesheetFontProviderOptions): FontProvider & {
+    loaded(family: string, weight?: FontWeight, style?: FontStyle): boolean;
+};
+/** One family in the Google Fonts metadata (`https://fonts.google.com/metadata/fonts`), as far as this module reads it. */
+export interface GoogleFontsFamilyMetadata {
+    family: string;
+    /** `Sans Serif`, `Serif`, `Display`, `Handwriting` or `Monospace`. */
+    category?: string;
+    /** Further classes, e.g. `Display`, `Handwriting`, `Monospace`, `Symbols`. */
+    classifications?: readonly string[];
+    /** Stroke class, e.g. `Sans Serif`, `Serif`, `Slab Serif`. */
+    stroke?: string | null;
+    /** Faces by weight, `i` for italic: `{ "400": …, "700i": … }`. */
+    fonts?: Record<string, unknown>;
+    axes?: ReadonlyArray<{
+        tag: string;
+        min: number;
+        max: number;
+    }>;
+    /** Rank, 1 = most popular. */
+    popularity?: number;
+    subsets?: readonly string[];
+}
+/**
+ * The families in a Google Fonts metadata response (the object, its `familyMetadataList`, or the
+ * raw text with its `)]}'` prefix), most popular first. A family classified as display,
+ * handwriting or monospace takes that category even when Google files it under sans serif or
+ * serif (Anton is a sans serif classified as display); its classes, stroke and axes become
+ * `tags` (`display`, `slab-serif`, `variable-wdth`…).
+ */
+export declare function googleFontsCatalog(metadata: unknown): FontSummary[];
+/** The Google Fonts css2 URL for one face, e.g. `…/css2?family=Space+Grotesk:ital,wght@0,700&display=swap`. */
+export declare function googleFontsStylesheetUrl(family: string, weight?: FontWeight, style?: FontStyle, options?: {
+    baseUrl?: string;
+    display?: string;
+}): string;
+export interface GoogleFontsProviderOptions extends Omit<StylesheetFontProviderOptions, 'listFonts' | 'stylesheetUrl'> {
+    /**
+     * The Google Fonts metadata, or the catalog already built from it. fonts.google.com does not
+     * allow cross-origin reads, so a browser host fetches it through its own server.
+     */
+    catalog: () => Promise<unknown>;
+    /** css2-compatible stylesheet endpoint (default `https://fonts.googleapis.com/css2`). */
+    baseUrl?: string;
+}
+/** Google Fonts (or a css2-compatible mirror): its catalog, loaded face by face through its stylesheets. */
+export declare function createGoogleFontsProvider(options: GoogleFontsProviderOptions): FontProvider & {
+    loaded(family: string, weight?: FontWeight, style?: FontStyle): boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.175.0",
+  "version": "0.177.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

package/skills/pixerate-image-editor/SKILL.md

@@ -390,7 +390,8 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `apply_effect` | Run a provider filter effect on a layer as a smart filter (`target`, `effect`, `values`, `index`, `enabled`, `opacity`); a pixel, shape or type layer becomes a smart object in the same undo step (`converted`). Returns the filter id. |
 | `update_effect` | Change an effect smart filter (`values` merged, `null` resets; `enabled`, `opacity`, `index`) or redraw an effect layer (`effect: "generator"`, values only). |
 | `remove_effect` | Remove an effect smart filter, or (`generator`) keep an effect layer's pixels as a plain layer. |
-| `add_effect_layer` | Add a layer drawn by a generator, overlay or title effect at the document's size and bit depth (`values`, `time`, `name`, `aboveId` / `belowId`, `opacity`, `blend`). Returns the layer id. |
+| `add_effect_layer` | Add a layer drawn by a generator, overlay or title effect at the document's size and bit depth (`values`, `time`, `animate`, `name`, `aboveId` / `belowId`, `opacity`, `blend`). An effect with its own background (`backgroundOpacity` in `describe_effect`) starts with it transparent when there are layers below. Returns the layer id. |
+| `set_effect_layer` | Change an effect layer: swap its `effect` (its defaults plus `values`), pick the still frame (`time`, ms), or make it play in an animation (`animate: { duration }`; `null` for a still frame). The longest animating layer sets the animation's length. |
 | `apply_selection_as_mask` | Mask a layer with the current selection: pass `layerId` to mask an existing layer, or `kind` (plus optional `params`) to create a new masked layer in one step. `density` 0..1 and `feather` px soften the mask non-destructively. Returns `layerId`, kind, mask info and the selection summary. |
 
 ### Save and open

package/skills/pixerate-typography/SKILL.md

@@ -23,8 +23,12 @@ what this machine has.
 
 ## Working method
 
-1. **Find fonts.** `list_fonts` with `category`, `weight`, `style` or `query`. Only use families it
-   returns (or that the user names), and always ship them inside a stack from `resolve_font_stack`.
+1. **Find fonts.** `list_fonts` with `category`, `weight`, `style`, `tags` or `query`. Only use
+   families it returns (or that the user names), and always ship them inside a stack from
+   `resolve_font_stack`. When the host offers a web font service (`source: 'web'`, e.g. Google
+   Fonts), its catalog is far larger than the installed fonts and listed most popular first:
+   narrow it by `category` and by the `tags` the result counts (`display`, `slab-serif`,
+   `variable-wdth`…) to find faces with the character you want, rather than taking the top few.
 2. **Load before rendering.** `load_font` before drawing or capturing text in a web font, so the
    first frame does not use the fallback. `loaded: false` means the fallback will show.
 3. **Set up the scale.** `generate_type_hierarchy` for named tokens and ready CSS custom
@@ -62,7 +66,7 @@ what this machine has.
 
 | Tool | When to use | Returns |
 | --- | --- | --- |
-| `list_fonts` | Discover families the host offers; filter by `category`, `source`, `weight`, `style`, `query`; `limit` default 50 | `{ fonts: [{ family, category, weights, styles, isVariable?, source }], total, truncated }` |
+| `list_fonts` | Discover families the host offers; filter by `category`, `source`, `weight`, `style`, `tags`, `query`; `limit` default 50 | `{ fonts: [{ family, category, weights, styles, isVariable?, source, tags? }], total, truncated, tags: [{ tag, count }] }` |
 | `resolve_font_stack` | Turn a family (or stack) into a resilient `font-family` value for its category; also says if the provider lists it | `{ stack, families, category, available }` |
 | `suggest_type_scale` | Sizes for arbitrary integer `steps` (-12…12) from `baseSize` (px, default 16) and `ratio` (name or number, default major-third) | `{ ratio, baseSize, steps: [{ name, step, size, lineHeight, letterSpacing }] }` |
 | `generate_type_hierarchy` | Named tokens caption…display on one scale, with CSS custom properties (`prefix`, `selector`) | `{ ratio, ratioName?, baseSize, steps: { body, h1, … }, css }` |