firebase-contract 0.1.0-rc.0

package/dist/lib/_internal/parser/raw-document.d.ts

@@ -0,0 +1,230 @@
+/**
+ * The raw, still-YAML-shaped model produced by the parser. It mirrors the YAML
+ * document one-to-one after shorthand normalization. Only the parser and import
+ * resolver deal with these types; everything downstream works on the IR.
+ */
+export interface RawField {
+    type: string;
+    optional?: boolean;
+    nullable?: boolean;
+    /** Render the description as a JSDoc block instead of line comments. */
+    jsdoc?: boolean;
+    list?: boolean;
+    id?: boolean;
+    unique?: boolean;
+    relation?: boolean;
+    default?: unknown;
+    description?: string;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    nonempty?: boolean;
+    email?: boolean;
+    url?: boolean;
+    col?: string;
+    literal?: string;
+}
+export interface RawEnum {
+    description?: string;
+    values: string[];
+    valueComments?: Record<string, string>;
+    /** Const-object key overrides, keyed by value (e.g. Q → QA). */
+    valueKeys?: Record<string, string>;
+    gqlName?: string;
+    /** TypeScript-side rename used by Firestore projections (e.g. `Status` → `ReviewStatus`). */
+    fsName?: string;
+    /** Firestore-side comment override (when it differs from the DC description). */
+    fsDescription?: string;
+}
+export interface RawIndex {
+    fields: string[];
+    name?: string;
+    unique?: boolean;
+    expand?: boolean;
+}
+export interface RawSqlConstraints {
+    checks?: string[];
+    foreignKeys?: {
+        columns: string[];
+        references: string;
+        name?: string;
+    }[];
+    indexes?: {
+        columns: string[];
+        name?: string;
+        unique?: boolean;
+    }[];
+}
+export interface RawModel {
+    description?: string;
+    fields: Record<string, RawField>;
+    key?: string[];
+    table?: string;
+    gqlName?: string;
+    directives?: string;
+    footer?: string;
+    /** TypeScript-side rename used by Firestore projections. */
+    fsName?: string;
+    indexes?: RawIndex[];
+    sql?: RawSqlConstraints;
+}
+export interface RawOperation {
+    description?: string;
+    type: string;
+    model: string;
+    action?: string;
+    auth?: string;
+    authReason?: string;
+    inputs?: {
+        field: string;
+        required?: boolean;
+        description?: string;
+        var?: string;
+        flat?: boolean;
+        literal?: string;
+        quote?: boolean;
+        inc?: boolean;
+        asKey?: boolean;
+    }[];
+    /** Normalized to `{ field, op, required? }` by the parser. */
+    where?: {
+        field: string;
+        op: string;
+        required?: boolean;
+        description?: string;
+        var?: string;
+        literal?: string;
+        flat?: boolean;
+    }[];
+    select?: {
+        field: string;
+        select?: unknown[];
+        description?: string;
+        alias?: string;
+        args?: string;
+    }[];
+    orderBy?: {
+        field: string;
+        dir: string;
+    }[];
+    limit?: number | {
+        var: string;
+        default?: number;
+        required?: boolean;
+    };
+    single?: string;
+    keyArg?: string;
+    keyVars?: Record<string, string>;
+    aggregate?: {
+        count?: boolean;
+        sum?: string[];
+    };
+    exprs?: {
+        field: string;
+        expr: string;
+    }[];
+    inc?: {
+        field: string;
+        var?: string;
+    }[];
+    /** Connectors (output targets) this operation is emitted into. */
+    connectors?: string[];
+    entityDir?: string;
+    whereAnd?: boolean;
+    gqlName?: string;
+    footer?: string;
+    raw?: string;
+    directives?: string;
+    style?: {
+        signature?: string;
+        args?: string;
+        data?: string;
+        orderBy?: string;
+        auth?: string;
+        key?: string;
+        and?: string;
+        where?: string;
+    };
+}
+export interface RawApiPayload {
+    model?: string;
+    fields?: Record<string, RawField>;
+    void?: boolean;
+}
+export interface RawApi {
+    description?: string;
+    kind: string;
+    method?: string;
+    request?: RawApiPayload;
+    response?: RawApiPayload;
+    envelope?: string;
+    maxAttempts?: number;
+    timeoutSeconds?: number;
+    topic?: string;
+}
+export interface RawEnvelope {
+    description?: string;
+    fields: Record<string, RawField>;
+}
+export interface RawFirestoreDoc {
+    description?: string;
+    from?: string;
+    collection?: string;
+    pick?: string[];
+    omit?: string[];
+    fields?: Record<string, RawField>;
+    meta?: boolean;
+    /** Embedded models to host in this projection file even when unreferenced. */
+    include?: string[];
+    /** Verbatim TypeScript helpers emitted into the projection file. */
+    helpers?: string;
+}
+export interface RawUnion {
+    description?: string;
+    discriminant: string;
+    variants: string[];
+}
+export interface RawService {
+    name: string;
+    database?: string;
+    location?: string;
+    connectors?: string[];
+}
+export interface RawProject {
+    services?: RawService[];
+    codebases?: Record<string, string>;
+    /** Sqids settings for the generated id-core (encode/decode primitives). */
+    idCodec?: {
+        minLength?: number;
+        alphabet?: string;
+    };
+}
+/** A declared generation target: run `generators` into `out` (relative to the yml). */
+export interface RawOutputTarget {
+    out: string;
+    generators: string[];
+}
+export interface RawContract {
+    /** Absolute path of the source file. */
+    filePath: string;
+    /** Generation targets declared in this file's `generate:` section. */
+    outputs?: RawOutputTarget[];
+    version: number;
+    /** Raw header text prepended to generated files (`default` = built-in banner). */
+    header?: string;
+    project?: RawProject;
+    /** Import specifiers exactly as written (relative paths or npm packages). */
+    imports: string[];
+    /** File-level default connectors applied to operations lacking their own. */
+    defaultConnectors: string[];
+    enums: Record<string, RawEnum>;
+    models: Record<string, RawModel>;
+    operations: Record<string, RawOperation>;
+    apis: Record<string, RawApi>;
+    firestore: Record<string, RawFirestoreDoc>;
+    unions: Record<string, RawUnion>;
+    envelopes: Record<string, RawEnvelope>;
+}
+//# sourceMappingURL=raw-document.d.ts.map

package/dist/lib/_internal/parser/raw-document.d.ts.map

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

package/dist/lib/_internal/parser/raw-document.js

@@ -0,0 +1,6 @@
+/**
+ * The raw, still-YAML-shaped model produced by the parser. It mirrors the YAML
+ * document one-to-one after shorthand normalization. Only the parser and import
+ * resolver deal with these types; everything downstream works on the IR.
+ */
+export {};

package/dist/lib/_internal/resolver/import-resolver.d.ts

@@ -0,0 +1,25 @@
+import { Diagnostic } from '../diagnostics.js';
+import { RawContract } from '../parser/raw-document.js';
+import { ModuleLoader } from './module-loader.js';
+export interface ResolveResult {
+    /**
+     * Every document reachable from the entry, in dependency order: an imported
+     * document always appears before the document that imports it. This gives the
+     * IR builder a deterministic merge order.
+     */
+    documents: RawContract[];
+    diagnostics: Diagnostic[];
+}
+/**
+ * Load the entry contract and everything it imports (transitively), following
+ * both relative and npm specifiers via the {@link ModuleLoader}.
+ *
+ * Detects and reports:
+ * - circular imports (`IMPORT_CYCLE`)
+ * - unresolved/unreadable modules (`UNRESOLVED_IMPORT`, `MODULE_NOT_FOUND`)
+ *
+ * Duplicate *definitions* across files are detected later, during IR build,
+ * because that is where names from every document are merged.
+ */
+export declare const resolveImports: (entryPath: string, loader: ModuleLoader) => ResolveResult;
+//# sourceMappingURL=import-resolver.d.ts.map

package/dist/lib/_internal/resolver/import-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-resolver.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/resolver/import-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,UAAU,EAAS,MAAM,mBAAmB,CAAA;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,SAAS,EAAE,WAAW,EAAE,CAAA;IACxB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,EAAE,QAAQ,YAAY,KAAG,aA8DxE,CAAA"}

package/dist/lib/_internal/resolver/import-resolver.js

@@ -0,0 +1,73 @@
+import { resolve } from 'node:path';
+import { ContractError, error } from '../diagnostics.js';
+import { parseContract } from '../parser/parse.js';
+/**
+ * Load the entry contract and everything it imports (transitively), following
+ * both relative and npm specifiers via the {@link ModuleLoader}.
+ *
+ * Detects and reports:
+ * - circular imports (`IMPORT_CYCLE`)
+ * - unresolved/unreadable modules (`UNRESOLVED_IMPORT`, `MODULE_NOT_FOUND`)
+ *
+ * Duplicate *definitions* across files are detected later, during IR build,
+ * because that is where names from every document are merged.
+ */
+export const resolveImports = (entryPath, loader) => {
+    const entryId = resolve(entryPath);
+    const documents = [];
+    const loaded = new Set();
+    const visiting = new Set();
+    const diagnostics = [];
+    const collectFrom = (thrown) => {
+        if (thrown instanceof ContractError && thrown.diagnostics.length > 0) {
+            diagnostics.push(...thrown.diagnostics);
+        }
+        else {
+            const message = thrown instanceof Error ? thrown.message : String(thrown);
+            diagnostics.push(error('LOAD_ERROR', message));
+        }
+    };
+    const visit = (id, chain) => {
+        if (visiting.has(id)) {
+            const cycle = [...chain.slice(chain.indexOf(id)), id].join(' -> ');
+            diagnostics.push(error('IMPORT_CYCLE', `Circular import detected: ${cycle}`, { file: id }));
+            return;
+        }
+        if (loaded.has(id)) {
+            return;
+        }
+        let content;
+        try {
+            content = loader.load(id);
+        }
+        catch (thrown) {
+            collectFrom(thrown);
+            return;
+        }
+        let document;
+        try {
+            document = parseContract(content, id);
+        }
+        catch (thrown) {
+            collectFrom(thrown);
+            return;
+        }
+        visiting.add(id);
+        for (const specifier of document.imports) {
+            let importId;
+            try {
+                importId = loader.resolveId(specifier, id);
+            }
+            catch (thrown) {
+                collectFrom(thrown);
+                continue;
+            }
+            visit(importId, [...chain, id]);
+        }
+        visiting.delete(id);
+        loaded.add(id);
+        documents.push(document);
+    };
+    visit(entryId, []);
+    return { documents, diagnostics };
+};

package/dist/lib/_internal/resolver/module-loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Abstracts how import specifiers turn into absolute ids and how their content
+ * is read. The default implementation hits the file system, but the resolver
+ * depends only on this interface so tests can supply in-memory modules and the
+ * pipeline stays free of hard file-system coupling.
+ */
+export interface ModuleLoader {
+    /** Resolve `specifier`, as imported from `importer`, to an absolute id. */
+    resolveId(specifier: string, importer: string): string;
+    /** Read the raw text of a module by its absolute id. */
+    load(id: string): string;
+}
+/**
+ * File-system loader. Relative specifiers resolve against the importer's
+ * directory; everything else is treated as an npm package specifier and
+ * resolved through Node's module resolution (supports subpath exports).
+ */
+export declare const createFsLoader: () => ModuleLoader;
+/**
+ * In-memory loader for tests and programmatic use. `files` maps absolute ids to
+ * their text content. Relative imports are resolved with the same rules as the
+ * FS loader; npm specifiers are looked up directly in the map.
+ */
+export declare const createMemoryLoader: (files: Record<string, string>) => ModuleLoader;
+//# sourceMappingURL=module-loader.d.ts.map

package/dist/lib/_internal/resolver/module-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-loader.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/resolver/module-loader.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACtD,wDAAwD;IACxD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CACzB;AAKD;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,YAwBhC,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,YAoBjE,CAAA"}

package/dist/lib/_internal/resolver/module-loader.js

@@ -0,0 +1,62 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, isAbsolute, resolve } from 'node:path';
+import { ContractError, error } from '../diagnostics.js';
+const isRelative = (specifier) => specifier.startsWith('./') || specifier.startsWith('../') || isAbsolute(specifier);
+/**
+ * File-system loader. Relative specifiers resolve against the importer's
+ * directory; everything else is treated as an npm package specifier and
+ * resolved through Node's module resolution (supports subpath exports).
+ */
+export const createFsLoader = () => ({
+    resolveId(specifier, importer) {
+        if (isRelative(specifier)) {
+            return resolve(dirname(importer), specifier);
+        }
+        try {
+            const require = createRequire(importer);
+            return require.resolve(specifier);
+        }
+        catch {
+            throw new ContractError(`Cannot resolve npm import "${specifier}"`, [
+                error('UNRESOLVED_IMPORT', `Cannot resolve npm import "${specifier}"`, {
+                    file: importer,
+                }),
+            ]);
+        }
+    },
+    load(id) {
+        if (!existsSync(id)) {
+            throw new ContractError(`Module not found: ${id}`, [
+                error('MODULE_NOT_FOUND', `Module not found: ${id}`, { file: id }),
+            ]);
+        }
+        return readFileSync(id, 'utf8');
+    },
+});
+/**
+ * In-memory loader for tests and programmatic use. `files` maps absolute ids to
+ * their text content. Relative imports are resolved with the same rules as the
+ * FS loader; npm specifiers are looked up directly in the map.
+ */
+export const createMemoryLoader = (files) => ({
+    resolveId(specifier, importer) {
+        const id = isRelative(specifier) ? resolve(dirname(importer), specifier) : specifier;
+        if (!(id in files)) {
+            throw new ContractError(`Cannot resolve import "${specifier}"`, [
+                error('UNRESOLVED_IMPORT', `Cannot resolve import "${specifier}" from ${importer}`, {
+                    file: importer,
+                }),
+            ]);
+        }
+        return id;
+    },
+    load(id) {
+        if (!(id in files)) {
+            throw new ContractError(`Module not found: ${id}`, [
+                error('MODULE_NOT_FOUND', `Module not found: ${id}`, { file: id }),
+            ]);
+        }
+        return files[id];
+    },
+});

package/dist/lib/_internal/runtime/data-connect-adapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Runtime helpers for the Data Connect `Any` boundary.
+ *
+ * Data Connect stores JSON and embedded objects as the `Any` scalar, which
+ * erases the logical type. Generated adapters call {@link fromAny}/{@link toAny}
+ * to cross that boundary so application code keeps working with the logical
+ * TypeScript type. These are intentionally minimal (typed pass-through) because
+ * the Data Connect client already parses JSON; swap in {@link jsonStringAdapter}
+ * when a value is stored as a raw JSON string instead.
+ */
+/** The type of a value once it has crossed into Data Connect's `Any` scalar. */
+export type Any = unknown;
+export interface JsonAdapter<T> {
+    toAny(value: T): Any;
+    fromAny(value: Any): T;
+}
+/** Restore a logical value from an `Any` field (typed pass-through). */
+export declare const fromAny: <T>(value: Any) => T;
+/** Send a logical value into an `Any` field (typed pass-through). */
+export declare const toAny: <T>(value: T) => Any;
+/** Adapter that trusts the client to have already parsed the JSON. */
+export declare const identityAdapter: <T>() => JsonAdapter<T>;
+/** Adapter for `Any` fields stored/received as raw JSON strings. */
+export declare const jsonStringAdapter: <T>() => JsonAdapter<T>;
+//# sourceMappingURL=data-connect-adapter.d.ts.map

package/dist/lib/_internal/runtime/data-connect-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-connect-adapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/runtime/data-connect-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,MAAM,MAAM,GAAG,GAAG,OAAO,CAAA;AAEzB,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,CAAA;IACpB,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAA;CACvB;AAED,wEAAwE;AACxE,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,GAAG,KAAG,CAAe,CAAA;AAEvD,qEAAqE;AACrE,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,GAAmB,CAAA;AAEvD,sEAAsE;AACtE,eAAO,MAAM,eAAe,GAAI,CAAC,OAAK,WAAW,CAAC,CAAC,CAGjD,CAAA;AAEF,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,GAAI,CAAC,OAAK,WAAW,CAAC,CAAC,CAGnD,CAAA"}

package/dist/lib/_internal/runtime/data-connect-adapter.js

@@ -0,0 +1,24 @@
+/**
+ * Runtime helpers for the Data Connect `Any` boundary.
+ *
+ * Data Connect stores JSON and embedded objects as the `Any` scalar, which
+ * erases the logical type. Generated adapters call {@link fromAny}/{@link toAny}
+ * to cross that boundary so application code keeps working with the logical
+ * TypeScript type. These are intentionally minimal (typed pass-through) because
+ * the Data Connect client already parses JSON; swap in {@link jsonStringAdapter}
+ * when a value is stored as a raw JSON string instead.
+ */
+/** Restore a logical value from an `Any` field (typed pass-through). */
+export const fromAny = (value) => value;
+/** Send a logical value into an `Any` field (typed pass-through). */
+export const toAny = (value) => value;
+/** Adapter that trusts the client to have already parsed the JSON. */
+export const identityAdapter = () => ({
+    toAny: value => toAny(value),
+    fromAny: value => fromAny(value),
+});
+/** Adapter for `Any` fields stored/received as raw JSON strings. */
+export const jsonStringAdapter = () => ({
+    toAny: value => JSON.stringify(value),
+    fromAny: value => (typeof value === 'string' ? JSON.parse(value) : value),
+});

package/dist/lib/_internal/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export type { Any, JsonAdapter } from './data-connect-adapter.js';
+export { fromAny, toAny, identityAdapter, jsonStringAdapter } from './data-connect-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/_internal/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/lib/_internal/runtime/index.js

@@ -0,0 +1 @@
+export { fromAny, toAny, identityAdapter, jsonStringAdapter } from './data-connect-adapter.js';

package/dist/lib/_internal/validation/rules.d.ts

@@ -0,0 +1,32 @@
+import { Diagnostic } from '../diagnostics.js';
+import { Ir } from '../ir/ir.js';
+/**
+ * A validation rule inspects the IR and returns any problems it finds. Rules are
+ * independent and side-effect free so new checks can be added (open/closed)
+ * without touching existing ones or the runner.
+ */
+export type ValidationRule = (ir: Ir) => Diagnostic[];
+/** Every field type must resolve to a known scalar, enum, or model. */
+export declare const unresolvedTypes: ValidationRule;
+/** Enums must declare at least one value. */
+export declare const emptyEnums: ValidationRule;
+/** Enum values should be unique. */
+export declare const duplicateEnumValues: ValidationRule;
+/** Model and enum names must be valid identifiers so generators can emit them. */
+export declare const validNames: ValidationRule;
+/** Primary-identifier constraints: at most one, not a list, ideally required. */
+export declare const idFields: ValidationRule;
+/** Composite key and index field names must exist on the model. */
+export declare const modelKeysAndIndexes: ValidationRule;
+/** A `relation` flag is only meaningful on a model-typed field. */
+export declare const relationFields: ValidationRule;
+/** Operations must target a known model, use valid field names, and pair type/action correctly. */
+export declare const operations: ValidationRule;
+/** API request/response payloads that reference a model must reference a known one. */
+export declare const apis: ValidationRule;
+/** Firestore projections must derive from a known model with valid pick/omit fields. */
+export declare const firestore: ValidationRule;
+/** Union variants must be known models, each carrying the discriminant field. */
+export declare const unions: ValidationRule;
+export declare const DEFAULT_RULES: ValidationRule[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/lib/_internal/validation/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/validation/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkB,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAa,EAAE,EAAgB,MAAM,aAAa,CAAA;AAEzD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,UAAU,EAAE,CAAA;AAIrD,uEAAuE;AACvE,eAAO,MAAM,eAAe,EAAE,cAU3B,CAAA;AAEH,6CAA6C;AAC7C,eAAO,MAAM,UAAU,EAAE,cAQpB,CAAA;AAEL,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,EAAE,cAgB9B,CAAA;AAEJ,kFAAkF;AAClF,eAAO,MAAM,UAAU,EAAE,cAiCxB,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,QAAQ,EAAE,cA+BnB,CAAA;AAEJ,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,EAAE,cAkC9B,CAAA;AAEJ,mEAAmE;AACnE,eAAO,MAAM,cAAc,EAAE,cAU1B,CAAA;AAEH,mGAAmG;AACnG,eAAO,MAAM,UAAU,EAAE,cA+ErB,CAAA;AAEJ,uFAAuF;AACvF,eAAO,MAAM,IAAI,EAAE,cAYf,CAAA;AAEJ,wFAAwF;AACxF,eAAO,MAAM,SAAS,EAAE,cA+BpB,CAAA;AAEJ,iFAAiF;AACjF,eAAO,MAAM,MAAM,EAAE,cAoBjB,CAAA;AAEJ,eAAO,MAAM,aAAa,EAAE,cAAc,EAYzC,CAAA"}