@stati/core 1.27.2 → 1.29.0

package/dist/types/images.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Image pipeline type definitions.
+ *
+ * Stati adds intrinsic dimensions, lazy loading and co-located image output to every
+ * site without configuration. The `responsive` and `og` features below need the
+ * optional `@stati/images` package, which implements {@link ImageProvider}.
+ */
+/** Modern formats that responsive images can add as `<source>` elements. */
+export type ImageVariantFormat = 'avif' | 'webp';
+/** Every format an image provider can be asked to write. */
+export type ImageOutputFormat = 'avif' | 'webp' | 'jpeg' | 'png';
+/** Formats Stati can read intrinsic dimensions from. */
+export type ImageSourceFormat = 'png' | 'jpeg' | 'gif' | 'webp' | 'avif';
+/**
+ * Encoder quality per output format (1-100).
+ * PNG is lossless unless `png` is set, which switches it to palette quantization.
+ */
+export interface ImagesQualityConfig {
+    avif?: number;
+    webp?: number;
+    jpeg?: number;
+    png?: number;
+}
+/**
+ * Responsive image options. Requires `@stati/images`.
+ *
+ * @example
+ * ```typescript
+ * images: {
+ *   responsive: { widths: [480, 960, 1440], formats: ['avif', 'webp'] },
+ * }
+ * ```
+ */
+export interface ResponsiveImagesConfig {
+    /** Candidate widths in pixels. Widths above an image's own width are skipped (default: [480, 960, 1440]) */
+    widths?: number[];
+    /** Modern formats added as `<source>` elements (default: ['avif', 'webp']) */
+    formats?: ImageVariantFormat[];
+    /** Encoder quality per format (default: avif 50, webp 75, jpeg 80, png lossless) */
+    quality?: ImagesQualityConfig;
+    /** Default `sizes` attribute (default: '100vw') */
+    sizes?: string;
+}
+/**
+ * A font made available to Open Graph image templates.
+ * Satori reads TTF, OTF and WOFF files; WOFF2 is not supported.
+ */
+export interface OgImageFontConfig {
+    /** Family name used in `font-family` inside the template */
+    name: string;
+    /** Path to the font file, relative to the project root */
+    path: string;
+    /** Font weight (default: 400) */
+    weight?: number;
+    /** Font style (default: 'normal') */
+    style?: 'normal' | 'italic';
+}
+/**
+ * Open Graph image options. Requires `@stati/images`.
+ *
+ * @example
+ * ```typescript
+ * images: {
+ *   og: { exclude: ['/404'] },
+ * }
+ * ```
+ */
+export interface OgImagesConfig {
+    /** Template file name looked up from the page's directory up to `srcDir` (default: 'og.eta'). The built-in card is used when none is found. */
+    template?: string;
+    /** Image width in pixels (default: 1200) */
+    width?: number;
+    /** Image height in pixels (default: 630) */
+    height?: number;
+    /** Output format (default: 'png') */
+    format?: 'png' | 'jpeg';
+    /** Fonts added to the bundled ones (Archivo, Inter, Fira Code) */
+    fonts?: OgImageFontConfig[];
+    /** URL glob patterns of pages that get no generated image */
+    exclude?: string[];
+}
+/**
+ * Image configuration.
+ *
+ * Stati always adds `width`, `height`, `loading="lazy"` and `decoding="async"` to
+ * Markdown images and emits images that sit next to Markdown files. Set `images: false`
+ * to turn that off. `responsive` and `og` are independent and each needs `@stati/images`.
+ *
+ * @example
+ * ```typescript
+ * images: {
+ *   responsive: true,
+ *   og: true,
+ * }
+ * ```
+ */
+export interface ImagesConfig {
+    /** Load the first image near the top of a page eagerly with high fetch priority (default: true) */
+    eagerFirst?: boolean;
+    /** Generate AVIF/WebP variants with `srcset` and `<picture>`. Requires `@stati/images`. */
+    responsive?: boolean | ResponsiveImagesConfig;
+    /** Generate an Open Graph image for every page. Requires `@stati/images`. */
+    og?: boolean | OgImagesConfig;
+    /** `'fast'` (default) skips `responsive` and `og` in the dev server; `'full'` runs them */
+    dev?: 'fast' | 'full';
+}
+/** One file an image provider writes for a source image. */
+export interface VariantOutput {
+    /** Absolute output path */
+    filePath: string;
+    /** Output width in pixels; the provider never enlarges the source */
+    width: number;
+    /** Output format */
+    format: ImageOutputFormat;
+    /** Encoder quality; omitted for lossless output */
+    quality?: number;
+}
+/** A request to encode one source image into a set of outputs. */
+export interface VariantRequest {
+    /** Absolute path of the source image */
+    sourcePath: string;
+    /** One entry per output file; core has already chosen widths, formats and paths */
+    outputs: VariantOutput[];
+}
+/** Font data passed to an Open Graph image renderer. */
+export interface OgFont {
+    name: string;
+    data: Buffer;
+    weight?: number;
+    style?: 'normal' | 'italic';
+}
+/** A request to rasterize one Open Graph image from template HTML. */
+export interface OgImageRequest {
+    /** HTML produced by the Eta template, with local images inlined as data URIs */
+    html: string;
+    width: number;
+    height: number;
+    format: 'png' | 'jpeg';
+    fonts: OgFont[];
+    /** Absolute output path */
+    filePath: string;
+    /** Template the HTML came from, for error messages */
+    templatePath: string;
+}
+/** The built-in Open Graph card a provider ships. */
+export interface OgDefaults {
+    /** Eta template source */
+    template: string;
+    /** Fonts the template uses, always passed to the renderer */
+    fonts: OgFont[];
+}
+/**
+ * Contract between `@stati/core` and an image provider such as `@stati/images`.
+ * Core decides URLs, widths, formats and caching; the provider only encodes.
+ */
+export interface ImageProvider {
+    /** Contract version; core refuses a provider whose version it does not support */
+    readonly apiVersion: 1;
+    /** Encoder identity, part of every cache key so encoder upgrades produce new URLs */
+    readonly version: string;
+    /**
+     * Encode one source image into the requested outputs. Settles only once no output is still
+     * being written, even when one fails, because core rewrites pages and prunes files next.
+     */
+    createVariants(request: VariantRequest): Promise<void>;
+    /** Rasterize one Open Graph image; required when `images.og` is on */
+    renderOgImage?(request: OgImageRequest): Promise<void>;
+    /** Load the built-in Open Graph template and its fonts */
+    loadOgDefaults?(): Promise<OgDefaults>;
+}
+/**
+ * A generated Open Graph image, as exposed to SEO generation and to templates
+ * through `stati.ogImage`.
+ */
+export interface GeneratedOgImage {
+    /** Absolute URL */
+    url: string;
+    /** Root-relative path */
+    path: string;
+    width: number;
+    height: number;
+    /** Alternative text, the page title */
+    alt?: string;
+}
+//# sourceMappingURL=images.d.ts.map

package/dist/types/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/types/images.ts"],"names":[],"mappings":"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"}

package/dist/types/images.js

@@ -0,0 +1,8 @@
+/**
+ * Image pipeline type definitions.
+ *
+ * Stati adds intrinsic dimensions, lazy loading and co-located image output to every
+ * site without configuration. The `responsive` and `og` features below need the
+ * optional `@stati/images` package, which implements {@link ImageProvider}.
+ */
+export {};

package/dist/types/index.d.ts

@@ -3,13 +3,14 @@
  * This file provides a single entry point for importing types
  */
 export type { AgingRule, ISGConfig, CacheEntry, CacheManifest } from './isg.js';
-export type { SiteConfig, StatiConfig, BuildContext, PageContext, BuildHooks, BuildStats, SEOConfig, RobotsTxtConfig, TypeScriptConfig, BundleConfig, } from './config.js';
-export type { FrontMatter, PageModel, CollectionData, TemplateContext, SEOMetadata, SitemapMetadata, RobotsConfig, OpenGraphConfig, OpenGraphImage, OpenGraphArticle, TwitterCardConfig, AuthorConfig, StatiAssets, TocEntry, } from './content.js';
+export type { SiteConfig, StatiConfig, BuildContext, PageContext, BuildHooks, BuildStats, SEOConfig, RobotsTxtConfig, TypeScriptConfig, BundleConfig, CollectionsConfig, GeneratedPageEntry, } from './config.js';
+export type { FrontMatter, PageModel, CollectionData, PaginationData, GeneratedPageData, PaginateOptions, GenerateOptions, TemplateContext, SEOMetadata, SitemapMetadata, RobotsConfig, OpenGraphConfig, OpenGraphImage, OpenGraphArticle, TwitterCardConfig, AuthorConfig, StatiAssets, TocEntry, } from './content.js';
 export type { SEOContext, SEOValidationResult } from './seo.js';
 export { SEOTagType } from './seo.js';
 export type { ChangeFrequency, SitemapEntry, SitemapConfig, SitemapGenerationResult, } from './sitemap.js';
 export type { RSSConfig, RSSFeedConfig, RSSGenerationResult } from './rss.js';
 export type { SearchConfig, SearchDocument, SearchIndex, SearchIndexMetadata } from './search.js';
 export type { NavNode } from './navigation.js';
+export type { ImagesConfig, ResponsiveImagesConfig, OgImagesConfig, OgImageFontConfig, ImagesQualityConfig, ImageVariantFormat, ImageOutputFormat, ImageSourceFormat, ImageProvider, VariantRequest, VariantOutput, OgImageRequest, OgFont, OgDefaults, GeneratedOgImage, } from './images.js';
 export type { Logger } from './logging.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGhF,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG9E,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlG,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGhF,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG9E,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlG,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,MAAM,EACN,UAAU,EACV,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/isg.d.ts

@@ -81,6 +81,25 @@ export interface CacheEntry {
     readonly ttlSeconds: number;
     /** Maximum age cap for this page in days */
     maxAgeCapDays?: number;
+    /**
+     * Files found while rendering, such as the images a page displays. Their hashes are part
+     * of `inputsHash`, so replacing an image rebuilds only the pages that show it.
+     */
+    assetDeps?: readonly string[];
+    /** Generated image files this page references, relative to the output directory */
+    images?: readonly string[];
+    /**
+     * Whether the last render read `stati.collection`. When it did, the collection's summary
+     * (each member's URL, publish date and summary fields) is part of `inputsHash`, so the page
+     * rebuilds when a page it lists changes. Missing in entries written before Stati recorded
+     * it; such a page rebuilds once to record it.
+     */
+    readsCollection?: boolean;
+    /**
+     * Whether the last render read the navigation tree (`stati.nav` or `stati.page.navNode`).
+     * When it did, the navigation hash is part of `inputsHash`.
+     */
+    readsNav?: boolean;
 }
 /**
  * ISG cache manifest containing all cached page entries.

package/dist/types/isg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isg.d.ts","sourceRoot":"","sources":["../../src/types/isg.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}
+{"version":3,"file":"isg.d.ts","sourceRoot":"","sources":["../../src/types/isg.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,mFAAmF;IACnF,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/types/seo.d.ts

@@ -4,6 +4,7 @@
 import type { PageModel } from './content.js';
 import type { StatiConfig } from './config.js';
 import type { Logger } from './logging.js';
+import type { GeneratedOgImage } from './images.js';
 /**
  * Enum for SEO tag types used in selective generation and detection.
  *
@@ -53,6 +54,14 @@ export interface SEOContext {
     exclude?: Set<SEOTagType>;
     /** Set of tag types to include in generation (whitelist mode) */
     include?: Set<SEOTagType>;
+    /** Open Graph image generated for the page, used when front matter sets none */
+    generatedImage?: GeneratedOgImage | undefined;
+    /**
+     * The page's image is generated but not known yet, as when a partial calls
+     * `stati.generateSEO()` before the image exists: emit placeholders that rendering
+     * replaces once it is known.
+     */
+    deferGeneratedImage?: boolean | undefined;
 }
 /**
  * Result of SEO metadata validation.

package/dist/types/seo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/types/seo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,oBAAY,UAAU;IACpB,uBAAuB;IACvB,KAAK,UAAU;IACf,2BAA2B;IAC3B,WAAW,gBAAgB;IAC3B,wBAAwB;IACxB,QAAQ,aAAa;IACrB,sBAAsB;IACtB,MAAM,WAAW;IACjB,sBAAsB;IACtB,MAAM,WAAW;IACjB,yBAAyB;IACzB,SAAS,cAAc;IACvB,kCAAkC;IAClC,SAAS,cAAc;IACvB,yCAAyC;IACzC,OAAO,YAAY;IACnB,8BAA8B;IAC9B,cAAc,mBAAmB;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,SAAS,CAAC;IAChB,yBAAyB;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1B,iEAAiE;IACjE,OAAO,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/types/seo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,oBAAY,UAAU;IACpB,uBAAuB;IACvB,KAAK,UAAU;IACf,2BAA2B;IAC3B,WAAW,gBAAgB;IAC3B,wBAAwB;IACxB,QAAQ,aAAa;IACrB,sBAAsB;IACtB,MAAM,WAAW;IACjB,sBAAsB;IACtB,MAAM,WAAW;IACjB,yBAAyB;IACzB,SAAS,cAAc;IACvB,kCAAkC;IAClC,SAAS,cAAc;IACvB,yCAAyC;IACzC,OAAO,YAAY;IACnB,8BAA8B;IAC9B,cAAc,mBAAmB;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,SAAS,CAAC;IAChB,yBAAyB;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1B,iEAAiE;IACjE,OAAO,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1B,gFAAgF;IAChF,cAAc,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC9C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stati/core",
-  "version": "1.27.2",
+  "version": "1.29.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",