@morphemeris/armilla-core 0.2.0 → 0.3.0

package/dist/armilla.d.ts

@@ -29,8 +29,13 @@ export declare function unbookmark(s: string): ViewStateDoc;
 export declare function explain(scene: Scene, themeChain: readonly ThemeDoc[], markId: string, property: string): Explanation;
 /** Validate a workspace, returning it normalized (spec §12). */
 export declare function validateWorkspace(workspace: WorkspaceDoc): Workspace;
-/** The compiled-in default theme (spec §10.2). */
-export declare function defaultTheme(): ThemeDoc;
+/**
+ * The compiled-in default theme (spec §10.2), or, with a `version`, the
+ * historical snapshot `default_v<version>` a host supplies as the pinned base
+ * of a chain whose leaf says `extends: "default_v<version>"`. Versions run
+ * `1..=DEFAULT_THEME_VERSION`; anything else throws.
+ */
+export declare function defaultTheme(version?: number): ThemeDoc;
 /** Build a table panel's row model (spec §12.1). */
 export declare function tableRows(chartInput: ChartInputDoc, viewState: ViewStateDoc, environment: EnvironmentDoc, options: TableOptions): TableModel;
 /** Build the map panels' line model (spec §12.2). */

package/dist/armilla.js

@@ -1,3 +1,4 @@
+import { DEFAULT_THEME_VERSION, defaultThemeHistory } from './default-themes.generated.js';
 import { wasm } from './runtime.js';
 /** A core failure: the spec §15 error record as a JavaScript error. */
 export class ArmillaError extends Error {
@@ -71,9 +72,20 @@ export function explain(scene, themeChain, markId, property) {
 export function validateWorkspace(workspace) {
     return call(() => wasm().validate_workspace(JSON.stringify(workspace)));
 }
-/** The compiled-in default theme (spec §10.2). */
-export function defaultTheme() {
-    return call(() => wasm().default_theme());
+/**
+ * The compiled-in default theme (spec §10.2), or, with a `version`, the
+ * historical snapshot `default_v<version>` a host supplies as the pinned base
+ * of a chain whose leaf says `extends: "default_v<version>"`. Versions run
+ * `1..=DEFAULT_THEME_VERSION`; anything else throws.
+ */
+export function defaultTheme(version) {
+    if (version === undefined)
+        return call(() => wasm().default_theme());
+    const doc = Number.isInteger(version) ? defaultThemeHistory[version] : undefined;
+    if (doc === undefined) {
+        throw new Error(`unknown default-theme version ${String(version)}: the history is 1..=${String(DEFAULT_THEME_VERSION)}`);
+    }
+    return structuredClone(doc);
 }
 /** Build a table panel's row model (spec §12.1). */
 export function tableRows(chartInput, viewState, environment, options) {

package/dist/default-themes.generated.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GENERATED by scripts/gen-default-themes.mjs — do not edit.
+ * Source: crates/core/themes/history/default_v<n>.json (append-only).
+ * The versioned default-theme bases hosts pin via `extends: "default_v<n>"`
+ * (spec §10.2); `DEFAULT_THEME_VERSION` is the newest, matching the built-in
+ * default's content.
+ */
+import type { ThemeDoc } from './types.js';
+export declare const DEFAULT_THEME_VERSION: number;
+export declare const defaultThemeHistory: Readonly<Record<number, ThemeDoc>>;