@gobing-ai/ts-runtime 0.2.7 → 0.2.9

package/dist/fs.js

@@ -1,22 +1,36 @@
-import { createWriteStream, mkdirSync } from 'node:fs';
-import { access, appendFile, cp, mkdir, readdir, readFile, realpath, rename, rm, stat, writeFile, } from 'node:fs/promises';
-import { dirname, join, resolve } from 'node:path';
+import { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirnamePath, getProcessCwd, joinPath, resolvePath } from './path.js';
+let fsPromisesModule = null;
+let fsModule = null;
+function nodeFsPromises() {
+    fsPromisesModule ??= import('node:fs/promises');
+    return fsPromisesModule;
+}
+function nodeFs() {
+    fsModule ??= import('node:fs');
+    return fsModule;
+}
 export class NodeFileSystem {
     async readFile(path) {
+        const { readFile } = await nodeFsPromises();
         return await readFile(path, 'utf-8');
     }
     async writeFile(path, content) {
+        const { writeFile } = await nodeFsPromises();
         await ensureDirForFile(path, this);
         await writeFile(path, content, 'utf-8');
     }
     async appendFile(path, content) {
+        const { appendFile } = await nodeFsPromises();
         await ensureDirForFile(path, this);
         await appendFile(path, content, 'utf-8');
     }
     async mkdir(path) {
+        const { mkdir } = await nodeFsPromises();
         await mkdir(path, { recursive: true });
     }
     async exists(path) {
+        const { access } = await nodeFsPromises();
         try {
             await access(path);
             return true;
@@ -26,12 +40,15 @@ export class NodeFileSystem {
         }
     }
     async readDir(path) {
+        const { readdir } = await nodeFsPromises();
         return await readdir(path);
     }
     async unlink(path) {
+        const { rm } = await nodeFsPromises();
         await rm(path, { recursive: true, force: true });
     }
     async stat(path) {
+        const { stat } = await nodeFsPromises();
         try {
             const value = await stat(path);
             return {
@@ -46,17 +63,67 @@ export class NodeFileSystem {
         }
     }
     async realpath(path) {
+        const { realpath } = await nodeFsPromises();
         return await realpath(path);
     }
     async copy(src, dest) {
+        const { cp } = await nodeFsPromises();
         await cp(src, dest, { recursive: true });
     }
     async rename(src, dest) {
+        const { rename } = await nodeFsPromises();
         await rename(src, dest);
     }
     createLogStream(path) {
-        mkdirSync(dirname(path), { recursive: true });
-        return createWriteStream(path, { flags: 'a' });
+        return new LazyNodeLogStream(path);
+    }
+}
+export class NodeSyncFileSystem {
+    readFile(path) {
+        return readFileSync(path, 'utf-8');
+    }
+    writeFile(path, content) {
+        ensureDirForFileSync(path, this);
+        writeFileSync(path, content, 'utf-8');
+    }
+    mkdir(path) {
+        mkdirSync(path, { recursive: true });
+    }
+    readDir(path) {
+        return readdirSync(path);
+    }
+    unlink(path) {
+        rmSync(path, { recursive: true, force: true });
+    }
+}
+class LazyNodeLogStream {
+    ready;
+    ended = false;
+    // Single serialized chain: every write/end is appended here, so the underlying stream observes
+    // them in call order regardless of how the resolving microtasks interleave. A per-write `shift()`
+    // off a shared buffer (the previous approach) could reorder writes that arrived in the same tick.
+    tail;
+    constructor(path) {
+        this.ready = nodeFs().then(({ createWriteStream, mkdirSync }) => {
+            mkdirSync(dirnamePath(path), { recursive: true });
+            const stream = createWriteStream(path, { flags: 'a' });
+            return {
+                write: (chunk) => stream.write(chunk),
+                end: () => stream.end(),
+            };
+        });
+        this.tail = this.ready;
+    }
+    write(chunk) {
+        if (this.ended)
+            return;
+        this.tail = this.tail.then(() => this.ready.then((stream) => stream.write(chunk)));
+    }
+    end() {
+        if (this.ended)
+            return;
+        this.ended = true;
+        this.tail = this.tail.then(() => this.ready.then((stream) => stream.end()));
     }
 }
 const CLOUDFLARE_FS_ERROR = 'FileSystem is not available on Cloudflare Workers. Use D1, KV, or R2.';
@@ -113,11 +180,14 @@ export function getFs() {
     return activeFileSystem;
 }
 export async function ensureDirForFile(path, fs = getFs()) {
-    await fs.mkdir(dirname(path));
+    await fs.mkdir(dirnamePath(path));
+}
+export function ensureDirForFileSync(path, fs) {
+    fs.mkdir(dirnamePath(path));
 }
 export async function atomicWriteFile(path, content, fs = getFs()) {
     await ensureDirForFile(path, fs);
-    const tempPath = `${path}.${process.pid}.${Date.now()}.tmp`;
+    const tempPath = `${path}.${getProcessPid()}.${uniqueToken()}.tmp`;
     await fs.writeFile(tempPath, content);
     await fs.rename(tempPath, path);
 }
@@ -134,7 +204,7 @@ export async function walkDir(path, fs = getFs()) {
     const entries = (await fs.readDir(path)).sort();
     const result = [];
     for (const entry of entries) {
-        const fullPath = join(path, entry);
+        const fullPath = joinPath(path, entry);
         const entryStat = await fs.stat(fullPath);
         if (entryStat?.isDirectory()) {
             result.push(...(await walkDir(fullPath, fs)));
@@ -145,13 +215,13 @@ export async function walkDir(path, fs = getFs()) {
     }
     return result;
 }
-export function getProjectRoot(startDir = process.cwd()) {
-    let current = resolve(startDir);
+export function getProjectRoot(startDir = getProcessCwd()) {
+    let current = resolvePath(startDir);
     for (let i = 0; i < 12; i++) {
-        if (Bun.file(join(current, 'bun.lock')).size !== 0 || Bun.file(join(current, 'package.json')).size !== 0) {
+        if (hasBunFile(joinPath(current, 'bun.lock')) || hasBunFile(joinPath(current, 'package.json'))) {
             return current;
         }
-        const parent = dirname(current);
+        const parent = dirnamePath(current);
         if (parent === current)
             return startDir;
         current = parent;
@@ -159,8 +229,22 @@ export function getProjectRoot(startDir = process.cwd()) {
     return startDir;
 }
 export function resolveProjectPath(...segments) {
-    return resolve(getProjectRoot(), ...segments);
+    return resolvePath(getProjectRoot(), ...segments);
 }
 export function createLogStream(path, fs = getFs()) {
     return fs.createLogStream(path);
 }
+function hasBunFile(path) {
+    const bun = globalThis.Bun;
+    if (bun === undefined)
+        return false;
+    return bun.file(path).size !== 0;
+}
+function getProcessPid() {
+    return globalThis.process?.pid ?? 0;
+}
+// Two writers to the same path in the same millisecond must not share a temp name, or one clobbers
+// the other before rename. randomUUID disambiguates; Date.now keeps names sortable for debugging.
+function uniqueToken() {
+    return `${Date.now()}.${crypto.randomUUID()}`;
+}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export * from './config';
 export * from './context';
 export * from './fs';
+export * from './path';
 export * from './process-executor';
+export * from './schema-validation';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 export * from './config.js';
 export * from './context.js';
 export * from './fs.js';
+export * from './path.js';
 export * from './process-executor.js';
+export * from './schema-validation.js';
 export * from './types.js';

package/dist/path.d.ts

@@ -0,0 +1,7 @@
+export declare function normalizeSeparators(path: string): string;
+export declare function isAbsolutePath(path: string): boolean;
+export declare function dirnamePath(path: string): string;
+export declare function joinPath(...segments: string[]): string;
+export declare function resolvePath(...segments: string[]): string;
+export declare function getProcessCwd(): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAShD;AAED,wBAAgB,QAAQ,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAMtD;AAED,wBAAgB,WAAW,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBzD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/path.js

@@ -0,0 +1,55 @@
+// Runtime-portable path math. Deliberately avoids `node:path` so the same logic works on
+// `cloudflare-workers` (no `node:*`) as on node-bun (ADR-008). POSIX-style separators throughout;
+// Windows drive paths (`C:/...`) are normalized and treated as absolute.
+export function normalizeSeparators(path) {
+    return path.replaceAll('\\', '/');
+}
+export function isAbsolutePath(path) {
+    return path.startsWith('/') || /^[A-Za-z]:\//.test(normalizeSeparators(path));
+}
+export function dirnamePath(path) {
+    const input = normalizeSeparators(path);
+    if (/^\/+$/.test(input))
+        return '/';
+    const normalized = input.replace(/\/+$/, '');
+    if (normalized === '' || normalized === '/')
+        return normalized || '.';
+    const index = normalized.lastIndexOf('/');
+    if (index < 0)
+        return '.';
+    if (index === 0)
+        return '/';
+    return normalized.slice(0, index);
+}
+export function joinPath(...segments) {
+    const filtered = segments.filter((segment) => segment.length > 0).map(normalizeSeparators);
+    if (filtered.length === 0)
+        return '.';
+    const absolute = isAbsolutePath(filtered[0] ?? '');
+    const joined = filtered.join('/').replace(/\/+/g, '/');
+    return absolute ? joined : joined.replace(/^\//, '');
+}
+export function resolvePath(...segments) {
+    const candidates = segments.length === 0 ? [getProcessCwd()] : segments;
+    let resolved = '';
+    for (const segment of candidates.map(normalizeSeparators)) {
+        if (segment.length === 0)
+            continue;
+        resolved = isAbsolutePath(segment) ? segment : joinPath(resolved || getProcessCwd(), segment);
+    }
+    const parts = [];
+    const absolute = isAbsolutePath(resolved);
+    for (const part of resolved.split('/')) {
+        if (part === '' || part === '.')
+            continue;
+        if (part === '..') {
+            parts.pop();
+            continue;
+        }
+        parts.push(part);
+    }
+    return `${absolute ? '/' : ''}${parts.join('/')}` || (absolute ? '/' : '.');
+}
+export function getProcessCwd() {
+    return globalThis.process?.cwd?.() ?? '/';
+}

package/dist/process-executor.d.ts

@@ -13,6 +13,11 @@ export interface ProcessOptions {
     command: string;
     args?: string[];
     cwd?: string;
+    /**
+     * Environment forwarded verbatim to the child process. Caller-controlled — when launching an
+     * untrusted command, pass an explicit allowlist rather than the parent's full environment, so
+     * inherited secrets are not leaked into the subprocess.
+     */
     env?: Record<string, string>;
     timeout?: number;
     /** Maximum output buffer size in bytes (maps to execa `maxBuffer`). */
@@ -33,9 +38,40 @@ export interface ProcessResult {
 export interface ProcessExecutor {
     run(options: ProcessOptions): Promise<ProcessResult>;
 }
+export interface SyncProcessExecutor {
+    runSync(options: Omit<ProcessOptions, 'timeout'>): ProcessResult;
+}
+export interface PipeProcessOptions {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    /** Forwarded verbatim to the child — pass an allowlist for untrusted commands (see {@link ProcessOptions.env}). */
+    env?: Record<string, string>;
+}
+export interface PipeProcess {
+    readonly pid: number | null;
+    readonly stdout: ReadableStream<Uint8Array> | null;
+    readonly stderr: ReadableStream<Uint8Array> | null;
+    readonly exited: Promise<number | null>;
+    writeStdin(input: string | Uint8Array): void;
+    endStdin(): void;
+    kill(signal?: ProcessSignal): void;
+}
+export interface PipeProcessSpawner {
+    spawn(options: PipeProcessOptions): PipeProcess;
+}
 export declare class NodeProcessExecutor implements ProcessExecutor {
     private readonly config;
     constructor(config?: ProcessExecutorConfig);
     run(options: ProcessOptions): Promise<ProcessResult>;
 }
+export declare class BunSyncProcessExecutor implements SyncProcessExecutor {
+    runSync(options: Omit<ProcessOptions, 'timeout'>): ProcessResult;
+}
+export declare class BunPipeProcessSpawner implements PipeProcessSpawner {
+    spawn(options: PipeProcessOptions): PipeProcess;
+}
+type BunSubprocess = ReturnType<typeof Bun.spawn>;
+type ProcessSignal = Parameters<BunSubprocess['kill']>[0];
+export {};
 //# sourceMappingURL=process-executor.d.ts.map

package/dist/process-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-executor.d.ts","sourceRoot":"","sources":["../src/process-executor.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtF,MAAM,WAAW,qBAAqB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC5B,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACxD;AAED,qBAAa,mBAAoB,YAAW,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,qBAA0B;IAEzD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA2C7D"}
+{"version":3,"file":"process-executor.d.ts","sourceRoot":"","sources":["../src/process-executor.ts"],"names":[],"mappings":"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"}

package/dist/process-executor.js

@@ -44,6 +44,74 @@ export class NodeProcessExecutor {
         }
     }
 }
+export class BunSyncProcessExecutor {
+    runSync(options) {
+        const args = options.args ?? [];
+        const startedAt = Date.now();
+        const result = Bun.spawnSync({
+            cmd: [options.command, ...args],
+            stdout: 'pipe',
+            stderr: 'pipe',
+            stdin: 'ignore',
+            ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+            ...(options.env !== undefined ? { env: options.env } : {}),
+        });
+        if (options.rejectOnError === true && result.exitCode !== 0) {
+            throw new Error(`${options.command} ${args.join(' ')} failed with exit code ${result.exitCode}: ${stripFinalNewline(asString(result.stderr))}`);
+        }
+        return {
+            command: options.command,
+            args,
+            exitCode: result.exitCode,
+            stdout: stripFinalNewline(asString(result.stdout)),
+            stderr: stripFinalNewline(asString(result.stderr)),
+            durationMs: Date.now() - startedAt,
+        };
+    }
+}
+export class BunPipeProcessSpawner {
+    spawn(options) {
+        const subprocess = Bun.spawn({
+            cmd: [options.command, ...(options.args ?? [])],
+            stdin: 'pipe',
+            stdout: 'pipe',
+            stderr: 'pipe',
+            ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+            ...(options.env !== undefined ? { env: options.env } : {}),
+        });
+        return new BunPipeProcess(subprocess);
+    }
+}
+class BunPipeProcess {
+    subprocess;
+    writer;
+    constructor(subprocess) {
+        this.subprocess = subprocess;
+        this.writer = subprocess.stdin;
+    }
+    get pid() {
+        return this.subprocess.pid ?? null;
+    }
+    get stdout() {
+        return isReadableStream(this.subprocess.stdout) ? this.subprocess.stdout : null;
+    }
+    get stderr() {
+        return isReadableStream(this.subprocess.stderr) ? this.subprocess.stderr : null;
+    }
+    get exited() {
+        return this.subprocess.exited;
+    }
+    writeStdin(input) {
+        this.writer.write(input);
+        this.writer.flush?.();
+    }
+    endStdin() {
+        this.writer.end?.();
+    }
+    kill(signal) {
+        this.subprocess.kill(signal);
+    }
+}
 function buildExecaOptions(opts) {
     const canStream = !opts.forceBuffered &&
         opts.outputPolicy?.mode === 'stream' &&
@@ -68,3 +136,9 @@ function asString(value) {
         return value.map(String).join('');
     return '';
 }
+function stripFinalNewline(value) {
+    return value.endsWith('\r\n') ? value.slice(0, -2) : value.endsWith('\n') ? value.slice(0, -1) : value;
+}
+function isReadableStream(value) {
+    return value instanceof ReadableStream;
+}

package/dist/schema-validation.d.ts

@@ -0,0 +1,42 @@
+export interface JsonSchemaViolation {
+    path: string;
+    message: string;
+}
+export interface JsonSchema {
+    type?: string | string[];
+    required?: string[];
+    properties?: Record<string, JsonSchema>;
+    additionalProperties?: boolean | JsonSchema;
+    items?: JsonSchema;
+    enum?: unknown[];
+    const?: unknown;
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    $ref?: string;
+    $defs?: Record<string, JsonSchema>;
+}
+export interface StructuredConfigLoadOptions {
+    validateSchema?: boolean;
+    /**
+     * Allow `http(s)://` `$schema` refs. Off by default: remote fetches are an SSRF/DoS surface when
+     * configs are authored by third parties. Prefer bundled package-specifier refs (resolved from
+     * `node_modules`). Supplying `fetch` explicitly also opts into remote resolution.
+     */
+    allowRemote?: boolean;
+    fetch?: (input: string) => Promise<Response>;
+    /**
+     * Module resolver for bare package-specifier `$schema` refs (e.g.
+     * `@gobing-ai/ts-rule-engine/schemas/rule-file.schema.json`). Defaults to `Bun.resolveSync`.
+     * Injectable for testing.
+     */
+    resolve?: (specifier: string, from: string) => string;
+}
+export declare class StructuredConfigSchemaError extends Error {
+    readonly violations: readonly JsonSchemaViolation[];
+    constructor(message: string, violations?: readonly JsonSchemaViolation[]);
+}
+export declare function loadStructuredConfig(path: string, options?: StructuredConfigLoadOptions): Promise<unknown>;
+export declare function parseStructuredConfig(content: string, source: string, options?: StructuredConfigLoadOptions): Promise<unknown>;
+export declare function validateDeclaredJsonSchema(value: unknown, source: string, options?: StructuredConfigLoadOptions): Promise<void>;
+export declare function validateJsonSchema(value: unknown, schema: JsonSchema, path?: string, defs?: Record<string, JsonSchema>, seenRefs?: ReadonlySet<string>): JsonSchemaViolation[];
+//# sourceMappingURL=schema-validation.d.ts.map

package/dist/schema-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validation.d.ts","sourceRoot":"","sources":["../src/schema-validation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACzD;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IAG9C,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE;gBADnD,OAAO,EAAE,MAAM,EACN,UAAU,GAAE,SAAS,mBAAmB,EAAO;CAK/D;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC,GAAG,OAAO,CAAC,OAAO,CAAC,CAGpH;AAED,wBAAsB,qBAAqB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wBAAsB,0BAA0B,CAC5C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,UAAU,EAClB,IAAI,SAAK,EACT,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAM,EACrC,QAAQ,GAAE,WAAW,CAAC,MAAM,CAAa,GAC1C,mBAAmB,EAAE,CAwDvB"}