interscript 2.4.1 → 3.0.0

package/dist/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../src/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACrB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAA;IACnC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAA;IAEnC,IAAI,IAAI,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC1C,IAAI,IAAI,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAE/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC1C,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAChB,IAAI,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,WAAW;YACzB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAAE,YAAY;YAC9B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CACpB,CAAA;QACH,CAAC;QACD,CAAC;QAAA,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAE,CAAA;AACxB,CAAC;AAED,mDAAmD;AACnD,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAClF,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,MAAc,EACd,MAAiB,EACjB,OAAsB,EAAE,EACxB,SAAgC;IAEhC,MAAM,UAAU,GAAsB,EAAE,CAAA;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACrE,MAAM,OAAO,GAAG,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAA;IAEhD,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,SAAQ;QAEhD,IAAI,cAAsB,CAAA;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACnC,cAAc,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAC3D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,gBAAgB;gBAAE,SAAQ;YAC3C,MAAM,CAAC,CAAA;QACT,CAAC;QACD,UAAU,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC;SAC9C,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAA;AAC3D,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Typed error hierarchy for Interscript-TS.
+ *
+ * Hierarchy is intentionally shallow so callers can rescue a single base
+ * class or a specific subclass without traversing a deep inheritance tree
+ * (MECE: each error class has exactly one responsibility).
+ */
+export declare class InterscriptError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class MapNotFoundError extends InterscriptError {
+    readonly systemCode: string;
+    constructor(systemCode: string);
+}
+export declare class SystemConversionError extends InterscriptError {
+}
+export declare class MapLogicError extends InterscriptError {
+}
+export declare class DependencyMissingError extends InterscriptError {
+    readonly dependency: string;
+    constructor(dependency: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAA;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK3D;AAED,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBACf,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,qBAAsB,SAAQ,gBAAgB;CAAG;AAE9D,qBAAa,aAAc,SAAQ,gBAAgB;CAAG;AAEtD,qBAAa,sBAAuB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBACf,UAAU,EAAE,MAAM;CAI/B"}

package/dist/errors.js

@@ -0,0 +1,34 @@
+/**
+ * Typed error hierarchy for Interscript-TS.
+ *
+ * Hierarchy is intentionally shallow so callers can rescue a single base
+ * class or a specific subclass without traversing a deep inheritance tree
+ * (MECE: each error class has exactly one responsibility).
+ */
+export class InterscriptError extends Error {
+    cause;
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+        this.cause = options?.cause;
+    }
+}
+export class MapNotFoundError extends InterscriptError {
+    systemCode;
+    constructor(systemCode) {
+        super(`Map not found: ${systemCode}`);
+        this.systemCode = systemCode;
+    }
+}
+export class SystemConversionError extends InterscriptError {
+}
+export class MapLogicError extends InterscriptError {
+}
+export class DependencyMissingError extends InterscriptError {
+    dependency;
+    constructor(dependency) {
+        super(`Map dependency missing: ${dependency}`);
+        this.dependency = dependency;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACvB,KAAK,CAAU;IAEjC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAA;QAC3B,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAA;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IAC3C,UAAU,CAAQ;IAC3B,YAAY,UAAkB;QAC5B,KAAK,CAAC,kBAAkB,UAAU,EAAE,CAAC,CAAA;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;CAAG;AAE9D,MAAM,OAAO,aAAc,SAAQ,gBAAgB;CAAG;AAEtD,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IACjD,UAAU,CAAQ;IAC3B,YAAY,UAAkB;QAC5B,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAA;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF"}

package/dist/http-loader.d.ts

@@ -0,0 +1,42 @@
+/**
+ * HTTP map loading strategy — fetches map IR from a base URL on demand.
+ *
+ * Browser-safe: uses the global `fetch()`. Suitable for browser bundles,
+ * Cloudflare Workers, Deno, Bun. Node 18+ also has global fetch.
+ *
+ * Two-tier caching: in-memory (instant) + optional persistent via
+ * localStorage (survives reloads). Set `cacheKeyPrefix` to enable.
+ */
+import type { LoadStrategy, SystemCode } from "./index.js";
+export interface HttpStrategyOptions {
+    /**
+     * Base URL or function returning a URL for a given system code.
+     * Defaults to `/maps/${code}.json` (works with the interscript.org
+     * deployment).
+     */
+    readonly baseUrl?: string | ((code: SystemCode) => string);
+    /**
+     * Optional request init passed to fetch() (headers, mode, etc.).
+     */
+    readonly fetchInit?: RequestInit;
+    /**
+     * Persistent cache prefix. When set, fetched maps are stored in
+     * localStorage so they survive page reloads. Disabled by default.
+     */
+    readonly cacheKeyPrefix?: string;
+}
+/**
+ * Strategy that fetches map IR over HTTP on demand.
+ *
+ * Async: returns a Promise. Use `MapLoader.loadAsync()` or
+ * `InterscriptRuntime.transliterate()` (which auto-awaits async
+ * strategies when present).
+ *
+ * Caching:
+ *   - In-memory: every fetched map stays in the loader's cache for
+ *     the lifetime of the page/process.
+ *   - Persistent: optional localStorage cache (set `cacheKeyPrefix`)
+ *     so maps don't re-fetch on subsequent visits.
+ */
+export declare function httpStrategy(options?: HttpStrategyOptions): LoadStrategy;
+//# sourceMappingURL=http-loader.d.ts.map

package/dist/http-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-loader.d.ts","sourceRoot":"","sources":["../src/http-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAgC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGxF,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC,CAAA;IAC1D;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AA2CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA6B5E"}

package/dist/http-loader.js

@@ -0,0 +1,95 @@
+/**
+ * HTTP map loading strategy — fetches map IR from a base URL on demand.
+ *
+ * Browser-safe: uses the global `fetch()`. Suitable for browser bundles,
+ * Cloudflare Workers, Deno, Bun. Node 18+ also has global fetch.
+ *
+ * Two-tier caching: in-memory (instant) + optional persistent via
+ * localStorage (survives reloads). Set `cacheKeyPrefix` to enable.
+ */
+import { normaliseMap } from "./loaders.js";
+const MAX_CACHE_AGE_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+function resolveUrl(code, baseUrl) {
+    if (typeof baseUrl === "function")
+        return baseUrl(code);
+    if (baseUrl)
+        return baseUrl.replace(/\/$/, "") + "/" + code + ".json";
+    return `/maps/${code}.json`;
+}
+function readPersistent(prefix, code) {
+    if (typeof localStorage === "undefined")
+        return undefined;
+    try {
+        const raw = localStorage.getItem(prefix + code);
+        if (!raw)
+            return undefined;
+        const entry = JSON.parse(raw);
+        if (Date.now() - entry.fetchedAt > MAX_CACHE_AGE_MS)
+            return undefined;
+        return entry;
+    }
+    catch {
+        return undefined;
+    }
+}
+function writePersistent(prefix, code, json) {
+    if (typeof localStorage === "undefined")
+        return;
+    try {
+        const entry = {
+            schemaVersion: 1,
+            fetchedAt: Date.now(),
+            json,
+        };
+        localStorage.setItem(prefix + code, JSON.stringify(entry));
+    }
+    catch {
+        // Quota exceeded or serialization failure — silently drop.
+    }
+}
+/**
+ * Strategy that fetches map IR over HTTP on demand.
+ *
+ * Async: returns a Promise. Use `MapLoader.loadAsync()` or
+ * `InterscriptRuntime.transliterate()` (which auto-awaits async
+ * strategies when present).
+ *
+ * Caching:
+ *   - In-memory: every fetched map stays in the loader's cache for
+ *     the lifetime of the page/process.
+ *   - Persistent: optional localStorage cache (set `cacheKeyPrefix`)
+ *     so maps don't re-fetch on subsequent visits.
+ */
+export function httpStrategy(options = {}) {
+    const inMemory = new Map();
+    return async (systemCode) => {
+        const cached = inMemory.get(systemCode);
+        if (cached)
+            return cached;
+        if (options.cacheKeyPrefix) {
+            const entry = readPersistent(options.cacheKeyPrefix, systemCode);
+            if (entry) {
+                const map = normaliseMap(entry.json);
+                inMemory.set(systemCode, map);
+                return map;
+            }
+        }
+        const url = resolveUrl(systemCode, options.baseUrl);
+        let res;
+        try {
+            res = await fetch(url, options.fetchInit);
+        }
+        catch {
+            return undefined;
+        }
+        if (!res.ok)
+            return undefined;
+        const json = (await res.json());
+        if (options.cacheKeyPrefix)
+            writePersistent(options.cacheKeyPrefix, systemCode, json);
+        const map = normaliseMap(json);
+        inMemory.set(systemCode, map);
+        return map;
+    };
+}
+//# sourceMappingURL=http-loader.js.map

package/dist/http-loader.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Public API surface of Interscript-TS.
+ *
+ * Mirrors `interscript-ruby/lib/interscript.rb`:
+ *   - transliterate(systemCode, input)
+ *   - loadMap(systemCode)
+ *   - detect(input, output)
+ *
+ * The runtime is configured with a MapLoader. Callers can supply their
+ * own (e.g. for browser fetch, for fs reads) without modifying the
+ * interpreter (OCP).
+ */
+import type { CompiledMap, DetectionResult, DetectOptions, SystemCode } from "./types.js";
+import { type LoadStrategy } from "./loader.js";
+export { InterscriptError, MapNotFoundError, SystemConversionError, DependencyMissingError, MapLogicError, } from "./errors.js";
+export type { CompiledMap, CompiledMapJson, DetectionResult, DetectOptions, FunctionDef, MapInfo, SystemCode, Stage, Rule, Item, SubRule, RunRule, FuncallRule, ParallelRule, SequentialRule, StringItem, CaptureGroupItem, CaptureRefItem, AliasItem, AnyItem, GroupItem, RepeatItem, StageItem, } from "./types.js";
+export type { LoadStrategy, MapLoader } from "./loader.js";
+export { normaliseMap, bundledStrategy } from "./loaders.js";
+export { httpStrategy, type HttpStrategyOptions } from "./http-loader.js";
+export { iscStrategy, iscBundledStrategy, type IscStrategyOptions } from "./isc/loader.js";
+export type { IscDocument, IscItem, IscRule, IscStage, IscStageItem, IscTest, IscConstraint, } from "./isc/types.js";
+export { parseIsc } from "./isc/parser.js";
+export { IscParseError } from "./isc/types.js";
+export { iscToCompiledMap } from "./isc/converter.js";
+export { setRababaConfig, resetRababaConfigs, type RababaConfigEntry } from "./stdlib/ml.js";
+export interface InterscriptConfig {
+    /** Strategies consulted in order when loading a map. */
+    readonly strategies?: LoadStrategy[];
+    /** Default stage to execute if not specified. Default: "main". */
+    readonly defaultStage?: string;
+}
+/** Configure the default runtime with custom strategies. */
+export declare function configure(config: InterscriptConfig): void;
+/** Public API — mirrors Interscript.transliterate from Ruby. */
+export declare function transliterate(systemCode: SystemCode, input: string, stage?: string): string;
+/**
+ * Async transliterate. Use when async strategies (httpStrategy) are
+ * configured and the map may not be in the cache yet.
+ */
+export declare function transliterateAsync(systemCode: SystemCode, input: string, stage?: string): Promise<string>;
+/** Public API — mirrors Interscript.load. */
+export declare function loadMap(systemCode: SystemCode): CompiledMap;
+/** Async version — needed when async strategies may be used. */
+export declare function loadMapAsync(systemCode: SystemCode): Promise<CompiledMap>;
+/** Public API — mirrors Interscript.detect. */
+export declare function detect(input: string, output: string, opts?: DetectOptions): DetectionResult[];
+/** Reset the default runtime (mainly for tests). */
+export declare function reset(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACzF,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAU1D,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,aAAa,EACb,WAAW,EACX,OAAO,EACP,UAAU,EACV,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,EACP,WAAW,EACX,YAAY,EACZ,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,OAAO,EACP,SAAS,EACT,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAK1D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAC1F,YAAY,EACV,WAAW,EACX,OAAO,EACP,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,aAAa,GACd,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE5F,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;IACpC,kEAAkE;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAoID,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAEzD;AASD,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAE3D;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAEzE;AAED,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,eAAe,EAAE,CAE7F;AAED,oDAAoD;AACpD,wBAAgB,KAAK,IAAI,IAAI,CAE5B"}

package/dist/index.js

@@ -0,0 +1,182 @@
+/**
+ * Public API surface of Interscript-TS.
+ *
+ * Mirrors `interscript-ruby/lib/interscript.rb`:
+ *   - transliterate(systemCode, input)
+ *   - loadMap(systemCode)
+ *   - detect(input, output)
+ *
+ * The runtime is configured with a MapLoader. Callers can supply their
+ * own (e.g. for browser fetch, for fs reads) without modifying the
+ * interpreter (OCP).
+ */
+import { MapLoader } from "./loader.js";
+import { executeStage, executeStageAsync } from "./runtime/interpreter.js";
+import { DependencyMissingError, InterscriptError, MapNotFoundError, SystemConversionError, } from "./errors.js";
+import { detectInMaps } from "./detector.js";
+export { InterscriptError, MapNotFoundError, SystemConversionError, DependencyMissingError, MapLogicError, } from "./errors.js";
+// Only re-export browser-safe loaders from the main entry. Filesystem
+// strategies live in `./loaders.node.ts` and pull in `node:fs`; importing
+// them via the main entry would break browser bundles. Node callers
+// (CLI, server tests) should import directly from `./loaders.node.js`.
+export { normaliseMap, bundledStrategy } from "./loaders.js";
+export { httpStrategy } from "./http-loader.js";
+export { iscStrategy, iscBundledStrategy } from "./isc/loader.js";
+export { parseIsc } from "./isc/parser.js";
+export { IscParseError } from "./isc/types.js";
+export { iscToCompiledMap } from "./isc/converter.js";
+export { setRababaConfig, resetRababaConfigs } from "./stdlib/ml.js";
+const DEFAULT_STAGE = "main";
+class InterscriptRuntime {
+    loader;
+    defaultStage;
+    constructor(config = {}) {
+        this.loader = new MapLoader(config.strategies ?? []);
+        this.defaultStage = config.defaultStage ?? DEFAULT_STAGE;
+    }
+    /**
+     * Pre-load a map so subsequent transliterate() calls are fast.
+     * Throws MapNotFoundError if the map can't be located.
+     */
+    loadMap(systemCode) {
+        const map = this.loader.load(systemCode);
+        for (const dep of map.dependencies) {
+            try {
+                this.loader.load(dep);
+            }
+            catch (e) {
+                if (e instanceof MapNotFoundError) {
+                    throw new DependencyMissingError(dep);
+                }
+                throw e;
+            }
+        }
+        return map;
+    }
+    /**
+     * Async pre-load. Required when async strategies (HTTP) are configured
+     * and the map isn't already cached.
+     *
+     * Recursively loads all transitive dependencies so the synchronous
+     * execution path can resolve deps without awaiting.
+     */
+    async loadMapAsync(systemCode) {
+        const map = await this.loader.loadAsync(systemCode);
+        // Recursively load every transitive dep. The synchronous executor
+        // calls loader.load() during execution and can't await async
+        // strategies — so we preload the entire closure upfront.
+        const seen = new Set();
+        const queue = [...map.dependencies];
+        while (queue.length > 0) {
+            const dep = queue.shift();
+            if (seen.has(dep))
+                continue;
+            seen.add(dep);
+            try {
+                const depMap = await this.loader.loadAsync(dep);
+                for (const d of depMap.dependencies) {
+                    if (!seen.has(d))
+                        queue.push(d);
+                }
+            }
+            catch (e) {
+                if (e instanceof MapNotFoundError) {
+                    throw new DependencyMissingError(dep);
+                }
+                throw e;
+            }
+        }
+        return map;
+    }
+    /**
+     * Transliterate `input` using `systemCode`. Loads the map on first use,
+     * caches it.
+     */
+    transliterate(systemCode, input, stage) {
+        try {
+            const map = this.loadMap(systemCode);
+            const stageName = stage ?? this.defaultStage;
+            return executeStage(map, stageName, input, this.loader);
+        }
+        catch (e) {
+            if (e instanceof InterscriptError)
+                throw e;
+            throw new SystemConversionError(`Transliteration failed for ${systemCode}: ${e.message}`, { cause: e });
+        }
+    }
+    /**
+     * Async transliterate. Required when the configured strategies include
+     * async loaders (e.g. httpStrategy) and the map may not be cached.
+     * Also handles ML-powered maps (rababa, secryst) — use this instead
+     * of transliterate() for any map that might contain ML funcalls.
+     */
+    async transliterateAsync(systemCode, input, stage) {
+        try {
+            const map = await this.loadMapAsync(systemCode);
+            const stageName = stage ?? this.defaultStage;
+            return await executeStageAsync(map, stageName, input, this.loader);
+        }
+        catch (e) {
+            if (e instanceof InterscriptError)
+                throw e;
+            throw new SystemConversionError(`Transliteration failed for ${systemCode}: ${e.message}`, { cause: e });
+        }
+    }
+    /** List all maps currently loaded in the cache. */
+    loadedMaps() {
+        return this.loader.loadedMaps();
+    }
+    /** Direct loader access (for detector + advanced use). */
+    getLoader() {
+        return this.loader;
+    }
+    /**
+     * Detect which transliteration system best explains how `input` became
+     * `output`. Returns candidates ranked by edit distance.
+     *
+     * Iterates every loaded map; for large map sets, supply `mapPattern`
+     * to pre-filter.
+     */
+    detect(input, output, opts = {}, knownMaps) {
+        return detectInMaps(input, output, this.loader, opts, knownMaps);
+    }
+}
+let defaultRuntime;
+/** Configure the default runtime with custom strategies. */
+export function configure(config) {
+    defaultRuntime = new InterscriptRuntime(config);
+}
+function runtime() {
+    if (!defaultRuntime) {
+        defaultRuntime = new InterscriptRuntime();
+    }
+    return defaultRuntime;
+}
+/** Public API — mirrors Interscript.transliterate from Ruby. */
+export function transliterate(systemCode, input, stage) {
+    return runtime().transliterate(systemCode, input, stage);
+}
+/**
+ * Async transliterate. Use when async strategies (httpStrategy) are
+ * configured and the map may not be in the cache yet.
+ */
+export function transliterateAsync(systemCode, input, stage) {
+    return runtime().transliterateAsync(systemCode, input, stage);
+}
+/** Public API — mirrors Interscript.load. */
+export function loadMap(systemCode) {
+    return runtime().loadMap(systemCode);
+}
+/** Async version — needed when async strategies may be used. */
+export function loadMapAsync(systemCode) {
+    return runtime().loadMapAsync(systemCode);
+}
+/** Public API — mirrors Interscript.detect. */
+export function detect(input, output, opts) {
+    return runtime().detect(input, output, opts);
+}
+/** Reset the default runtime (mainly for tests). */
+export function reset() {
+    defaultRuntime = undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/isc/converter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Converts an IscDocument (parsed from .isc source) to a CompiledMapJson
+ * (the runtime representation consumed by the existing TS runtime).
+ *
+ * This bridges the ISC parser output to the existing runtime without
+ * modifying any runtime code (OCP).
+ */
+import type { IscDocument } from "./types.js";
+import type { CompiledMapJson } from "../types.js";
+export declare function iscToCompiledMap(doc: IscDocument): CompiledMapJson;
+//# sourceMappingURL=converter.d.ts.map

package/dist/isc/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/isc/converter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAkC,MAAM,YAAY,CAAA;AAC7E,OAAO,KAAK,EAMV,eAAe,EAahB,MAAM,aAAa,CAAA;AAEpB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe,CAgClE"}

package/dist/isc/converter.js

@@ -0,0 +1,177 @@
+/**
+ * Converts an IscDocument (parsed from .isc source) to a CompiledMapJson
+ * (the runtime representation consumed by the existing TS runtime).
+ *
+ * This bridges the ISC parser output to the existing runtime without
+ * modifying any runtime code (OCP).
+ */
+export function iscToCompiledMap(doc) {
+    const aliases = {};
+    for (const a of doc.aliases) {
+        aliases[a.name] = convertItem(a.value);
+    }
+    // Build alias → target system code map for run-rule resolution.
+    const depAliases = new Map();
+    for (const d of doc.dependencies) {
+        if (d.aliasName)
+            depAliases.set(d.aliasName, d.target);
+    }
+    const resolveDep = (name) => depAliases.get(name) ?? name;
+    const stages = doc.stages.map((s) => convertStage(s, resolveDep));
+    if (Object.keys(doc.metadata).length === 0) {
+        return {
+            schemaVersion: 1,
+            systemCode: doc.systemCode,
+            dependencies: doc.dependencies.map((d) => d.target),
+            stages,
+            aliases,
+            functions: {},
+        };
+    }
+    return {
+        schemaVersion: 1,
+        systemCode: doc.systemCode,
+        dependencies: doc.dependencies.map((d) => d.target),
+        metadata: doc.metadata,
+        stages,
+        aliases,
+        functions: {},
+    };
+}
+function convertStage(stage, resolveDep) {
+    return {
+        kind: "stage",
+        name: stage.name,
+        rules: stage.body.map((item) => convertStageItem(item, resolveDep)),
+    };
+}
+function convertStageItem(item, resolveDep) {
+    switch (item.kind) {
+        case "parallel": {
+            const r = { kind: "parallel", rules: item.rules.map(convertRule) };
+            return r;
+        }
+        case "sequence": {
+            const r = { kind: "sequential", rules: item.rules.map(convertRule) };
+            return r;
+        }
+        case "bare_rule":
+            return convertRule(item.rule);
+        case "run": {
+            const r = item.dependency
+                ? { kind: "run", stage: item.stage, docName: resolveDep(item.dependency) }
+                : { kind: "run", stage: item.stage };
+            return r;
+        }
+        case "separate": {
+            if (item.separator && item.separator.type === "string") {
+                const r = {
+                    kind: "funcall",
+                    name: "separate",
+                    kwargs: { separator: item.separator.value },
+                };
+                return r;
+            }
+            const r = { kind: "funcall", name: "separate" };
+            return r;
+        }
+        case "compose": {
+            const r = { kind: "funcall", name: "compose" };
+            return r;
+        }
+        case "decompose": {
+            const r = { kind: "funcall", name: "decompose" };
+            return r;
+        }
+        case "string_case": {
+            const r = { kind: "funcall", name: item.op };
+            return r;
+        }
+        case "funcall": {
+            const r = { kind: "funcall", name: item.name, kwargs: item.kwargs };
+            return r;
+        }
+    }
+}
+function convertRule(rule) {
+    const before = findConstraint(rule, "before");
+    const after = findConstraint(rule, "after");
+    const notBefore = findConstraint(rule, "not_before");
+    const notAfter = findConstraint(rule, "not_after");
+    // `to` may be a function (upcase/downcase/title_case/etc.) — represented
+    // as FuncallInline rather than an Item.
+    const toItem = rule.to;
+    const to = toItem.type === "function" ? { kind: "funcall_inline", name: toItem.name } : convertItem(toItem);
+    const r = {
+        kind: "sub",
+        from: convertItem(rule.from),
+        to,
+        ...(before !== undefined ? { before } : {}),
+        ...(after !== undefined ? { after } : {}),
+        ...(notBefore !== undefined ? { notBefore } : {}),
+        ...(notAfter !== undefined ? { notAfter } : {}),
+    };
+    return r;
+}
+function findConstraint(rule, kind) {
+    const c = rule.constraints.find((x) => x.kind === kind);
+    return c ? convertItem(c.item) : undefined;
+}
+function convertItem(item) {
+    switch (item.type) {
+        case "string": {
+            const r = { kind: "string", value: item.value };
+            return r;
+        }
+        case "none": {
+            const r = { kind: "string", value: "" };
+            return r;
+        }
+        case "primitive": {
+            const r = { kind: "alias", name: item.name };
+            return r;
+        }
+        case "function": {
+            // Functions in non-`to` positions are unexpected — fall back to alias
+            // lookup so a clear error surfaces at runtime.
+            const r = { kind: "alias", name: item.name };
+            return r;
+        }
+        case "alias_ref": {
+            const r = { kind: "alias", name: item.name };
+            return r;
+        }
+        case "capture": {
+            const r = { kind: "capture_ref", id: item.index };
+            return r;
+        }
+        case "capture_group": {
+            const r = { kind: "capture_group", data: convertItem(item.inner) };
+            return r;
+        }
+        case "concat": {
+            const parts = item.parts.map(convertItem);
+            if (parts.length === 1)
+                return parts[0];
+            const r = { kind: "group", items: parts };
+            return r;
+        }
+        case "set": {
+            const r = { kind: "any", of: item.items.map(convertItem) };
+            return r;
+        }
+        case "range": {
+            const r = { kind: "any_char_class", range: [item.lo, item.hi] };
+            return r;
+        }
+        case "maybe": {
+            const r = { kind: "repeat", item: convertItem(item.inner), min: 0, max: 1 };
+            return r;
+        }
+        case "some": {
+            const r = { kind: "repeat", item: convertItem(item.inner), min: 1, max: null };
+            return r;
+        }
+    }
+}
+//# sourceMappingURL=converter.js.map