@stripe/extensibility-tool-utils 0.6.2

package/dist/file-editor/facades/api-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-extractor.d.ts","sourceRoot":"","sources":["../../../src/file-editor/facades/api-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAyB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACrC,CAAC;CACH;AAED,gBAAgB;AAChB,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,mBAAmB,CAAC;IAC3D,iBAAiB,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,GAC3C,IAAI;IAIA,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,GAC3C,IAAI;IAOA,eAAe,CACpB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,GAC3C,IAAI;CAKR;AAED,gBAAgB;AAChB,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACvB,GACL,OAAO,CAAC,gBAAgB,CAAC,CAkB3B"}

package/dist/file-editor/facades/brands.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Branded string types with validating smart constructors.
+ *
+ * Brands use symbol keys so they do not appear in IDE autocomplete
+ * (per project convention).
+ */
+declare const __semverRangeBrand: unique symbol;
+/**
+ * A validated npm semver range string (e.g. `"^1.2.3"`, `">=1.0 <2.0"`, `"1.x"`).
+ *
+ * Obtain a {@link _SemverRange} via {@link _semverRange} (throws on invalid
+ * input) or {@link _tryParseSemverRange} (returns `null`).
+ *
+ * @see https://github.com/npm/node-semver#ranges
+ */
+/** @internal */
+export type _SemverRange = string & {
+    readonly [__semverRangeBrand]: '_SemverRange';
+};
+/** A well-formed semver version string (e.g. `"1.2.3"`, `"4.0.0-rc.1"`). */
+declare const __semverVersionBrand: unique symbol;
+/** @internal */
+export type _SemverVersion = string & {
+    readonly [__semverVersionBrand]: '_SemverVersion';
+};
+/** Validating factory for {@link _SemverRange}. Throws on invalid input. */
+/** @internal */
+export declare function _semverRange(input: string): _SemverRange;
+/** Non-throwing variant of {@link _semverRange}. */
+/** @internal */
+export declare function _tryParseSemverRange(input: string): _SemverRange | null;
+/** Runtime type guard. */
+/** @internal */
+export declare function _isSemverRange(input: unknown): input is _SemverRange;
+/** Validating factory for {@link _SemverVersion}. Throws on invalid input. */
+/** @internal */
+export declare function _semverVersion(input: string): _SemverVersion;
+/** Non-throwing variant of {@link _semverVersion}. */
+/** @internal */
+export declare function _tryParseSemverVersion(input: string): _SemverVersion | null;
+/** Runtime type guard. */
+/** @internal */
+export declare function _isSemverVersion(input: unknown): input is _SemverVersion;
+export {};
+//# sourceMappingURL=brands.d.ts.map

package/dist/file-editor/facades/brands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brands.d.ts","sourceRoot":"","sources":["../../../src/file-editor/facades/brands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAEhD;;;;;;;GAOG;AACH,gBAAgB;AAChB,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC;AAEtF,4EAA4E;AAC5E,OAAO,CAAC,MAAM,oBAAoB,EAAE,OAAO,MAAM,CAAC;AAClD,gBAAgB;AAChB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IACpC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,gBAAgB,CAAC;CACnD,CAAC;AAEF,4EAA4E;AAC5E,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAOxD;AAED,oDAAoD;AACpD,gBAAgB;AAChB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAGvE;AAED,0BAA0B;AAC1B,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAM5D;AAED,sDAAsD;AACtD,gBAAgB;AAChB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAG3E;AAED,0BAA0B;AAC1B,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE"}

package/dist/file-editor/facades/package-json.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Typed façade for package.json — strict JSON only, with dependency-aware ops.
+ *
+ * @see https://docs.npmjs.com/cli/v10/configuring-npm/package-json
+ */
+import { _Document, type _MutationOptions } from '../document.js';
+import type { _StandardSchemaV1 } from '../schema.js';
+import type { _Diagnostic } from '../types.js';
+import type { _SemverRange, _SemverVersion } from './brands.js';
+/** @internal */
+export type _DepKind = 'dependencies' | 'devDependencies' | 'peerDependencies' | 'optionalDependencies';
+/** @internal */
+export interface _PackageJson {
+    readonly name?: string;
+    readonly version?: _SemverVersion | string;
+    readonly scripts?: Readonly<Record<string, string>>;
+    readonly dependencies?: Readonly<Record<string, _SemverRange | string>>;
+    readonly devDependencies?: Readonly<Record<string, _SemverRange | string>>;
+    readonly peerDependencies?: Readonly<Record<string, _SemverRange | string>>;
+    readonly optionalDependencies?: Readonly<Record<string, _SemverRange | string>>;
+    readonly engines?: Readonly<Record<string, _SemverRange | string>>;
+}
+/** _Document subclass with typed package.json helpers. */
+/** @internal */
+export declare class _PackageJsonDoc extends _Document<_PackageJson> {
+    setScript(name: string, command: string, opts?: _MutationOptions<_PackageJson>): this;
+    requireScript(name: string, command?: string): this;
+    addDependency(name: string, range: _SemverRange, kind?: _DepKind, opts?: _MutationOptions<_PackageJson>): this;
+    updateDependency(name: string, range: _SemverRange, kind?: _DepKind, opts?: _MutationOptions<_PackageJson>): this;
+    removeDependency(name: string, kind?: _DepKind, opts?: _MutationOptions<_PackageJson>): this;
+    ensureDependency(name: string, range: _SemverRange, kind?: _DepKind, opts?: _MutationOptions<_PackageJson>): this;
+    mustHaveScript(name: string, opts?: {
+        equals?: string;
+        matches?: RegExp;
+    }): _Diagnostic[];
+    mustHaveDependency(name: string, opts?: {
+        range?: _SemverRange;
+        kind?: _DepKind;
+    }): _Diagnostic[];
+}
+/**
+ * Open a package.json file and return a typed façade.
+ *
+ * The `schema` option accepts any Standard Schema-compliant validator
+ * (Zod v4, Valibot, ArkType, Effect Schema, …). It is not constrained to
+ * `_StandardSchemaV1<_PackageJson>` because schema libraries typically emit
+ * `string | undefined` for optional fields, which does not match exact
+ * optional-property-typed interfaces structurally.
+ */
+/** @internal */
+export declare function _openPackageJson(absolutePath: string, options?: {
+    format?: 'json';
+    schema?: _StandardSchemaV1;
+}): Promise<_PackageJsonDoc>;
+//# sourceMappingURL=package-json.d.ts.map

package/dist/file-editor/facades/package-json.d.ts.map

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

package/dist/file-editor/facades/stripe-app-manifest.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Typed façade for the Stripe App Manifest (JSON or YAML flavors).
+ *
+ * _Format is inferred from the file extension; the typed API is identical
+ * across flavors.
+ *
+ * @see https://docs.stripe.com/stripe-apps/reference/app-manifest
+ */
+import { _Document, type _MutationOptions } from '../document.js';
+import type { _StandardSchemaV1 } from '../schema.js';
+import type { _SemverVersion } from './brands.js';
+/**
+ * Stripe app permission strings follow the convention `{verb}_{resource}` —
+ * e.g. `read_customers`, `write_products`. The template literal enforces the
+ * prefix while keeping the resource portion open so the type doesn't go
+ * stale as Stripe adds resources.
+ *
+ * @see https://docs.stripe.com/stripe-apps/reference/permissions
+ */
+/** @internal */
+export type _StripePermission = `${'read' | 'write'}_${string}`;
+/** @internal */
+export interface _StripeAppManifest {
+    readonly id?: string;
+    readonly name?: string;
+    readonly version?: _SemverVersion | string;
+    readonly permissions?: readonly _StripePermission[];
+    readonly app_backend?: unknown;
+    readonly ui_extension?: unknown;
+    readonly custom_object_definitions?: {
+        readonly definitions?: readonly {
+            readonly id: string;
+            readonly specification: {
+                readonly type: string;
+                readonly content: string;
+            };
+        }[];
+    };
+}
+/** @internal */
+export declare class _StripeAppManifestDoc extends _Document<_StripeAppManifest> {
+    setName(name: string, opts?: _MutationOptions<_StripeAppManifest>): this;
+    setVersion(version: _SemverVersion, opts?: _MutationOptions<_StripeAppManifest>): this;
+    addPermission(permission: _StripePermission, opts?: _MutationOptions<_StripeAppManifest>): this;
+    removePermission(permission: _StripePermission, opts?: _MutationOptions<_StripeAppManifest>): this;
+    /**
+     * Add a custom object definition. Uses arrayUpsert to avoid duplicates
+     * (keyed on `id`). Creates the `custom_object_definitions.definitions`
+     * array if it doesn't exist.
+     */
+    addCustomObject(id: string, content: string, type?: string, opts?: _MutationOptions<_StripeAppManifest>): this;
+    /**
+     * Check if a custom object definition exists by id.
+     */
+    hasCustomObject(id: string): boolean;
+}
+/** @internal */
+export declare function _openStripeAppManifest(absolutePath: string, options?: {
+    format?: 'json' | 'jsonc' | 'yaml';
+    schema?: _StandardSchemaV1;
+}): Promise<_StripeAppManifestDoc>;
+//# sourceMappingURL=stripe-app-manifest.d.ts.map

package/dist/file-editor/facades/stripe-app-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-app-manifest.d.ts","sourceRoot":"","sources":["../../../src/file-editor/facades/stripe-app-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAyB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;GAOG;AACH,gBAAgB;AAChB,MAAM,MAAM,iBAAiB,GAAG,GAAG,MAAM,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;AAEhE,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,yBAAyB,CAAC,EAAE;QACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS;YAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,aAAa,EAAE;gBACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;aAC1B,CAAC;SACH,EAAE,CAAC;KACL,CAAC;CACH;AAED,gBAAgB;AAChB,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,kBAAkB,CAAC;IAC/D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAIxE,UAAU,CACf,OAAO,EAAE,cAAc,EACvB,IAAI,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAC1C,IAAI;IAIA,aAAa,CAClB,UAAU,EAAE,iBAAiB,EAC7B,IAAI,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAC1C,IAAI;IASA,gBAAgB,CACrB,UAAU,EAAE,iBAAiB,EAC7B,IAAI,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAC1C,IAAI;IAMP;;;;OAIG;IACI,eAAe,CACpB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,IAAI,SAAe,EACnB,IAAI,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAC1C,IAAI;IAeP;;OAEG;IACI,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAK5C;AAED,gBAAgB;AAChB,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACvB,GACL,OAAO,CAAC,qBAAqB,CAAC,CAiBhC"}

package/dist/file-editor/facades/tsconfig-options.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Typed surface for tsconfig.json `compilerOptions`. Covers the keys most
+ * commonly touched by build tooling; keys outside this set remain editable
+ * through the generic {@link _Document} API as an escape hatch.
+ *
+ * @see https://www.typescriptlang.org/tsconfig
+ */
+/** Canonical TypeScript language-target values. */
+/** @internal */
+export type _TsTarget = 'ES3' | 'ES5' | 'ES6' | 'ES2015' | 'ES2016' | 'ES2017' | 'ES2018' | 'ES2019' | 'ES2020' | 'ES2021' | 'ES2022' | 'ES2023' | 'ES2024' | 'ESNext';
+/** @internal */
+export type _TsModule = 'None' | 'CommonJS' | 'AMD' | 'System' | 'UMD' | 'ES6' | 'ES2015' | 'ES2020' | 'ES2022' | 'ESNext' | 'Node16' | 'NodeNext' | 'Preserve';
+/** @internal */
+export type _TsModuleResolution = 'Classic' | 'Node' | 'Node10' | 'Node16' | 'NodeNext' | 'Bundler';
+/** @internal */
+export type _TsJsx = 'preserve' | 'react' | 'react-jsx' | 'react-jsxdev' | 'react-native';
+/** Typed subset of `compilerOptions`. Unknown keys can still be set via the generic API. */
+/** @internal */
+export interface _CompilerOptions {
+    readonly target?: _TsTarget;
+    readonly module?: _TsModule;
+    readonly moduleResolution?: _TsModuleResolution;
+    readonly lib?: readonly string[];
+    readonly types?: readonly string[];
+    readonly jsx?: _TsJsx;
+    readonly jsxImportSource?: string;
+    readonly strict?: boolean;
+    readonly noImplicitAny?: boolean;
+    readonly strictNullChecks?: boolean;
+    readonly strictFunctionTypes?: boolean;
+    readonly strictBindCallApply?: boolean;
+    readonly strictPropertyInitialization?: boolean;
+    readonly alwaysStrict?: boolean;
+    readonly noImplicitThis?: boolean;
+    readonly noUncheckedIndexedAccess?: boolean;
+    readonly noImplicitOverride?: boolean;
+    readonly noPropertyAccessFromIndexSignature?: boolean;
+    readonly exactOptionalPropertyTypes?: boolean;
+    readonly noFallthroughCasesInSwitch?: boolean;
+    readonly noImplicitReturns?: boolean;
+    readonly noUnusedLocals?: boolean;
+    readonly noUnusedParameters?: boolean;
+    readonly useUnknownInCatchVariables?: boolean;
+    readonly outDir?: string;
+    readonly rootDir?: string;
+    readonly declaration?: boolean;
+    readonly declarationMap?: boolean;
+    readonly declarationDir?: string;
+    readonly sourceMap?: boolean;
+    readonly inlineSources?: boolean;
+    readonly noEmit?: boolean;
+    readonly noEmitOnError?: boolean;
+    readonly removeComments?: boolean;
+    readonly importHelpers?: boolean;
+    readonly downlevelIteration?: boolean;
+    readonly esModuleInterop?: boolean;
+    readonly allowSyntheticDefaultImports?: boolean;
+    readonly forceConsistentCasingInFileNames?: boolean;
+    readonly isolatedModules?: boolean;
+    readonly verbatimModuleSyntax?: boolean;
+    readonly resolveJsonModule?: boolean;
+    readonly skipLibCheck?: boolean;
+    readonly baseUrl?: string;
+    readonly paths?: Readonly<Record<string, readonly string[]>>;
+    readonly composite?: boolean;
+    readonly incremental?: boolean;
+    readonly tsBuildInfoFile?: string;
+}
+/**
+ * Key of {@link _CompilerOptions}. Method signatures use
+ * `<K extends _CompilerOptionKey>(name: K, value: _CompilerOptions[K])`
+ * so the value type is narrowed by the key.
+ */
+/** @internal */
+export type _CompilerOptionKey = keyof _CompilerOptions;
+//# sourceMappingURL=tsconfig-options.d.ts.map

package/dist/file-editor/facades/tsconfig-options.d.ts.map

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

package/dist/file-editor/facades/tsconfig.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Typed façade for tsconfig.json (JSONC).
+ *
+ * @see https://www.typescriptlang.org/tsconfig
+ */
+import { _Document, type _MutationOptions } from '../document.js';
+import type { _StandardSchemaV1 } from '../schema.js';
+import type { _Diagnostic } from '../types.js';
+import type { _CompilerOptionKey, _CompilerOptions } from './tsconfig-options.js';
+/** @internal */
+export type { _CompilerOptionKey, _CompilerOptions, _TsJsx, _TsModule, _TsModuleResolution, _TsTarget, } from './tsconfig-options.js';
+/** Defined (non-undefined) value type at a given key. */
+/** @internal */
+export type _CompilerOptionValue<K extends _CompilerOptionKey> = NonNullable<_CompilerOptions[K]>;
+/** @internal */
+export interface _TsConfig {
+    readonly extends?: string | readonly string[];
+    readonly compilerOptions?: _CompilerOptions;
+    readonly include?: readonly string[];
+    readonly exclude?: readonly string[];
+    readonly files?: readonly string[];
+    readonly references?: readonly {
+        readonly path: string;
+    }[];
+}
+/** @internal */
+export declare class _TsConfigDoc extends _Document<_TsConfig> {
+    setCompilerOption<K extends _CompilerOptionKey>(name: K, value: _CompilerOptionValue<K>, opts?: _MutationOptions<_TsConfig>): this;
+    ensureCompilerOption<K extends _CompilerOptionKey>(name: K, value: _CompilerOptionValue<K>, opts?: _MutationOptions<_TsConfig>): this;
+    addInclude(pattern: string, opts?: _MutationOptions<_TsConfig>): this;
+    addExclude(pattern: string, opts?: _MutationOptions<_TsConfig>): this;
+    addReference(path: string, opts?: _MutationOptions<_TsConfig>): this;
+    mustHaveCompilerOption<K extends _CompilerOptionKey>(name: K, opts?: {
+        readonly equals?: _CompilerOptionValue<K>;
+        readonly oneOf?: readonly _CompilerOptionValue<K>[];
+    }): _Diagnostic[];
+}
+/** @internal */
+export declare function _openTsConfig(absolutePath: string, options?: {
+    format?: 'jsonc' | 'json';
+    schema?: _StandardSchemaV1;
+}): Promise<_TsConfigDoc>;
+//# sourceMappingURL=tsconfig.d.ts.map

package/dist/file-editor/facades/tsconfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.d.ts","sourceRoot":"","sources":["../../../src/file-editor/facades/tsconfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAyB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAElF,gBAAgB;AAChB,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,MAAM,EACN,SAAS,EACT,mBAAmB,EACnB,SAAS,GACV,MAAM,uBAAuB,CAAC;AAE/B,yDAAyD;AACzD,gBAAgB;AAChB,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,kBAAkB,IAAI,WAAW,CAC1E,gBAAgB,CAAC,CAAC,CAAC,CACpB,CAAC;AAEF,gBAAgB;AAChB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5D;AAED,gBAAgB;AAChB,qBAAa,YAAa,SAAQ,SAAS,CAAC,SAAS,CAAC;IAC7C,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,EACnD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAC9B,IAAI,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACjC,IAAI;IAIA,oBAAoB,CAAC,CAAC,SAAS,kBAAkB,EACtD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAC9B,IAAI,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACjC,IAAI;IAIA,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAAG,IAAI;IAIrE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAAG,IAAI;IAIrE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAAG,IAAI;IASpE,sBAAsB,CAAC,CAAC,SAAS,kBAAkB,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,GAAE;QACJ,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;QAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,GACL,WAAW,EAAE;CAOjB;AAMD,gBAAgB;AAChB,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAO,GACtE,OAAO,CAAC,YAAY,CAAC,CAcvB"}

package/dist/file-editor/fingerprint.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Canonical normalization and SHA-256 fingerprinting for drift detection.
+ *
+ * The fingerprint is invariant under: indentation, line endings, BOM,
+ * trailing newline, comment insertion/removal (JSONC/YAML), and object-key
+ * reordering. It is NOT invariant under semantic changes (value edits,
+ * array reordering).
+ *
+ * @see https://www.rfc-editor.org/rfc/rfc8259 — JSON
+ * @see https://yaml.org/spec/1.2.2/ — YAML 1.2
+ */
+import type { _Format } from './types.js';
+/**
+ * Produce a canonical, deterministic string form of the document's *semantic*
+ * content. Two documents with identical semantics produce identical canonical
+ * strings regardless of formatting or comments.
+ */
+/** @internal */
+export declare function _canonicalNormalize(text: string, format: _Format): string;
+/** SHA-256 hex digest of the canonical-normalized form. */
+/** @internal */
+export declare function _fingerprint(text: string, format: _Format): string;
+/** SHA-256 hex digest of arbitrary bytes (for rawSha256 tracking). */
+/** @internal */
+export declare function _sha256Hex(input: string | Uint8Array): string;
+/**
+ * Deterministic stringification of a plain-JSON value.
+ *
+ * Rules:
+ * - Object keys sorted ascending by UTF-16 code unit.
+ * - Strings Unicode NFC-normalized and emitted as JSON strings.
+ * - Numbers: finite → canonical form (JSON.stringify); NaN/Infinity reject.
+ * - Arrays preserve element order (order is semantic).
+ * - `undefined` anywhere in an object drops the key (matches JSON semantics);
+ *   inside an array it serializes as `null`.
+ */
+/** @internal */
+export declare function _canonicalStringify(value: unknown): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/file-editor/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/file-editor/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;GAIG;AACH,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAGzE;AAED,2DAA2D;AAC3D,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAGlE;AAED,sEAAsE;AACtE,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAI7D;AA0DD;;;;;;;;;;GAUG;AACH,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D"}

package/dist/file-editor/formats/adapter.d.ts

@@ -0,0 +1,29 @@
+import type { _Format, _FormatMeta, _PendingEdit } from '../types.js';
+/**
+ * A format adapter knows how to parse a textual document, apply pending edits
+ * to that text while preserving formatting, and compute a canonical form for
+ * fingerprinting.
+ */
+/** @internal */
+export interface _FormatAdapter {
+    readonly format: _Format;
+    readonly permitsComments: boolean;
+    /** Parse text; throws {@link _ParseError} on failure. */
+    parse(text: string): {
+        value: unknown;
+        meta: _FormatMeta;
+    };
+    /**
+     * Apply edits to the source text and return the updated text.
+     * Must preserve all formatting (indent/EOL/BOM/comments) except at the
+     * precise locations touched by each edit.
+     */
+    applyEdits(text: string, edits: readonly _PendingEdit[], meta: _FormatMeta): string;
+}
+/** Default format metadata used when no source text exists yet. */
+/** @internal */
+export declare function _defaultMeta(): _FormatMeta;
+/** Detect indentation, EOL style, BOM, and final-newline from source text. */
+/** @internal */
+export declare function _detectMeta(text: string): _FormatMeta;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/file-editor/formats/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/file-editor/formats/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;GAIG;AACH,gBAAgB;AAChB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,yDAAyD;IACzD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAE3D;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;CACrF;AAED,mEAAmE;AACnE,gBAAgB;AAChB,wBAAgB,YAAY,IAAI,WAAW,CAE1C;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAOrD"}

package/dist/file-editor/formats/detect.d.ts

@@ -0,0 +1,9 @@
+import type { _Format } from '../types.js';
+/**
+ * Infer a {@link _Format} for a path, optionally using the file's text to
+ * disambiguate. Falls back to a {@link _FormatNotSupportedError} if no
+ * reasonable inference is possible.
+ */
+/** @internal */
+export declare function _detectFormat(path: string, text?: string): _Format;
+//# sourceMappingURL=detect.d.ts.map

package/dist/file-editor/formats/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/file-editor/formats/detect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAgBlE"}

package/dist/file-editor/formats/index.d.ts

@@ -0,0 +1,13 @@
+import type { _Format } from '../types.js';
+import type { _FormatAdapter } from './adapter.js';
+/** Look up the adapter for a format. Built-ins always resolve. @internal */
+export declare function _getAdapter(format: _Format): _FormatAdapter;
+/**
+ * Register or replace a format adapter.
+ * @internal
+ */
+export declare function _registerFormatAdapter(format: _Format, adapter: _FormatAdapter): void;
+export { _detectFormat } from './detect.js';
+export type { _FormatAdapter } from './adapter.js';
+export { _defaultMeta, _detectMeta } from './adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/file-editor/formats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/file-editor/formats/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAUnD,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAM3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAErF;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/file-editor/formats/jsonc.d.ts

@@ -0,0 +1,14 @@
+/**
+ * JSON and JSONC format adapters — backed by Microsoft's `jsonc-parser`,
+ * which preserves comments and unrelated formatting when applying edits.
+ *
+ * @see https://github.com/microsoft/node-jsonc-parser
+ */
+import type { _FormatAdapter } from './adapter.js';
+/** JSON (strict) adapter. Comments and trailing commas cause parse errors. */
+/** @internal */
+export declare const jsonAdapter: _FormatAdapter;
+/** JSONC adapter. Comments and trailing commas allowed. */
+/** @internal */
+export declare const jsoncAdapter: _FormatAdapter;
+//# sourceMappingURL=jsonc.d.ts.map

package/dist/file-editor/formats/jsonc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.d.ts","sourceRoot":"","sources":["../../../src/file-editor/formats/jsonc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA6PnD,8EAA8E;AAC9E,gBAAgB;AAChB,eAAO,MAAM,WAAW,EAAE,cAAiD,CAAC;AAE5E,2DAA2D;AAC3D,gBAAgB;AAChB,eAAO,MAAM,YAAY,EAAE,cAAiD,CAAC"}

package/dist/file-editor/formats/yaml.d.ts

@@ -0,0 +1,11 @@
+/**
+ * YAML format adapter. Uses eemeli/yaml's Document API, which preserves
+ * comments, anchors, block/flow style, and key order across mutations.
+ *
+ * @see https://eemeli.org/yaml/
+ * @see https://yaml.org/spec/1.2.2/
+ */
+import type { _FormatAdapter } from './adapter.js';
+/** @internal */
+export declare const yamlAdapter: _FormatAdapter;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/file-editor/formats/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../../src/file-editor/formats/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,gBAAgB;AAChB,eAAO,MAAM,WAAW,EAAE,cAuDzB,CAAC"}

package/dist/file-editor/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Public entry point for file-editor.
+ *
+ * @see https://datatracker.ietf.org/doc/html/rfc6901 — JSON Pointer
+ * @see https://www.rfc-editor.org/rfc/rfc8259 — JSON
+ * @see https://yaml.org/spec/1.2.2/ — YAML 1.2
+ */
+export { _Document, _openDocumentFromDisk } from './document.js';
+export type { _MutationOptions, _OpenDocumentOptions, _NarrowedValue, _NarrowedPartial, _NarrowedElement, } from './document.js';
+export { _beginTransaction, _openDocument, _Transaction } from './transaction.js';
+export type { _CommitOptions, _CommitReport, _TransactionOptions, } from './transaction.js';
+export { _compilePointer, _escapeToken, _hasPointer, _parseArrayIndex, _parsePointer, _pointer, _POINTER_STRING, _resolvePointer, _unescapeToken, } from './pointer.js';
+export type { _PointerBuilder, _PointerSegments } from './pointer.js';
+export { _canonicalNormalize, _canonicalStringify, _fingerprint, _sha256Hex, } from './fingerprint.js';
+export { _hunks as _diffHunks, _unified as _diffUnified } from './util/diff.js';
+export type { _DiffOptions } from './util/diff.js';
+export { _check, _runAssertions, _runAsyncAssertions } from './assertions/index.js';
+export type { _Assertion, _AssertionContext, _AsyncAssertion, _AssertOpts, } from './assertions/index.js';
+export { _SchemaValidationError, _tryValidateWithSchema, _validateWithSchema, } from './schema.js';
+export type { _StandardSchemaV1 } from './schema.js';
+export type { _IsUnknown, _SplitPointer, _SplitRest, _UnescapeToken, _ValueAtPointer, _StepInto, _ValueAtSegments, } from './value-at-pointer.js';
+export { _defaultMeta, _detectFormat, _detectMeta, _getAdapter, _registerFormatAdapter, } from './formats/index.js';
+export type { _FormatAdapter } from './formats/index.js';
+export { jsonAdapter as _jsonAdapter, jsoncAdapter as _jsoncAdapter, } from './formats/jsonc.js';
+export { yamlAdapter as _yamlAdapter } from './formats/yaml.js';
+export type { _StateStore } from './state/store.js';
+export { _InMemoryStateStore } from './state/in-memory.js';
+export { _FsCentralManifestStore } from './state/fs-manifest.js';
+export type { _FsCentralManifestStoreOptions } from './state/fs-manifest.js';
+export { _AssertionError, _ConflictAbortedError, _ConflictError, _FileEditorError, _FormatNotSupportedError, _ParseError, _PathError, _TypeMismatchError, _WriteAbortedError, } from './errors.js';
+export type { _Conflict, _ConflictPolicy, _ConflictResolution, _ConflictResolver, _ConfirmationPolicy, _Diagnostic, _DiffHunk, _DiffLine, _Format, _FormatMeta, _JsonPointer, _MergeOptions, _PendingEdit, _Severity, _StateRecord, _WriteConfirm, _WriteDecision, _WriteReason, _WriteRequest, } from './types.js';
+export { _openPackageJson, _PackageJsonDoc } from './facades/package-json.js';
+export type { _DepKind, _PackageJson } from './facades/package-json.js';
+export { _openTsConfig, _TsConfigDoc } from './facades/tsconfig.js';
+export type { _CompilerOptionKey, _CompilerOptionValue, _CompilerOptions, _TsConfig, _TsJsx, _TsModule, _TsModuleResolution, _TsTarget, } from './facades/tsconfig.js';
+export { _openApiExtractor, _ApiExtractorDoc } from './facades/api-extractor.js';
+export type { _ApiExtractorConfig } from './facades/api-extractor.js';
+export { _openStripeAppManifest, _StripeAppManifestDoc, } from './facades/stripe-app-manifest.js';
+export type { _StripeAppManifest, _StripePermission, } from './facades/stripe-app-manifest.js';
+export { _isSemverRange, _isSemverVersion, _semverRange, _semverVersion, _tryParseSemverRange, _tryParseSemverVersion, } from './facades/brands.js';
+export type { _SemverRange, _SemverVersion } from './facades/brands.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/file-editor/index.d.ts.map

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

package/dist/file-editor/pointer.d.ts

@@ -0,0 +1,74 @@
+/**
+ * JSON Pointer parsing and resolution per RFC 6901.
+ *
+ * @see https://datatracker.ietf.org/doc/html/rfc6901
+ */
+import type { _JsonPointer } from './types.js';
+/** Decoded form of a JSON Pointer — an array of unescaped reference tokens. */
+/** @internal */
+export type _PointerSegments = readonly string[];
+/**
+ * Parse a JSON Pointer string into its decoded reference tokens.
+ *
+ * The empty string `""` refers to the whole document and yields `[]`.
+ * `"/"` refers to the value keyed by the empty string and yields `[""]`.
+ *
+ * @throws {@link _PathError} if the pointer does not start with `/` (and is non-empty).
+ */
+/** @internal */
+export declare function _parsePointer(pointer: _JsonPointer): _PointerSegments;
+/** Compile an array of raw (unescaped) tokens into a JSON Pointer string. */
+/** @internal */
+export declare function _compilePointer(segments: readonly (string | number)[]): _JsonPointer;
+/** Unescape a single JSON Pointer reference token (RFC 6901 §4). */
+/** @internal */
+export declare function _unescapeToken(token: string): string;
+/** Escape a raw string into its JSON Pointer reference-token form. */
+/** @internal */
+export declare function _escapeToken(raw: string): string;
+/**
+ * Resolve a pointer against a plain JS value. Returns `undefined` if any segment
+ * of the path is missing.
+ *
+ * Array indices must be decimal digits with no leading zeros (except `"0"` itself).
+ * The special token `"-"` (past-the-end) always resolves to `undefined` here;
+ * mutation operations handle it separately.
+ */
+/** @internal */
+export declare function _resolvePointer(root: unknown, pointer: _JsonPointer): unknown;
+/** Returns `true` iff a pointer resolves to a value (including `null`) in the given root. */
+/** @internal */
+export declare function _hasPointer(root: unknown, pointer: _JsonPointer): boolean;
+/**
+ * Parse an array index token per RFC 6901: must be either `"0"` or a sequence
+ * of digits `[1-9][0-9]*`. No leading zeros, no signs, no whitespace.
+ *
+ * Returns `null` for any invalid input (including the past-the-end token `"-"`).
+ */
+/** @internal */
+export declare function _parseArrayIndex(token: string): number | null;
+/**
+ * Proxy-based typed pointer builder. Every property access records a segment;
+ * the terminal `$` property yields the RFC 6901 string.
+ *
+ * ```ts
+ * const p = _pointer<_PackageJson>().dependencies.lodash.$; // "/dependencies/lodash"
+ * ```
+ */
+/** @internal */
+export declare function _pointer<T>(): _PointerBuilder<T>;
+/** Terminal sentinel for the typed pointer builder. */
+/** @internal */
+export declare const _POINTER_STRING: "$";
+/** @internal */
+export type _PointerBuilder<T> = T extends readonly (infer U)[] ? {
+    readonly [index: number]: _PointerBuilder<U>;
+    readonly $: _JsonPointer;
+} : T extends object ? {
+    readonly [K in keyof T & string]-?: _PointerBuilder<NonNullable<T[K]>>;
+} & {
+    readonly $: _JsonPointer;
+} : {
+    readonly $: _JsonPointer;
+};
+//# sourceMappingURL=pointer.d.ts.map

package/dist/file-editor/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../src/file-editor/pointer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,+EAA+E;AAC/E,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,SAAS,MAAM,EAAE,CAAC;AAEjD;;;;;;;GAOG;AACH,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAUrE;AAED,6EAA6E;AAC7E,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,YAAY,CAGpF;AAED,oEAAoE;AACpE,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,sEAAsE;AACtE,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;;;;;GAOG;AACH,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAoB7E;AAED,6FAA6F;AAC7F,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAoBzE;AAED;;;;;GAKG;AACH,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI7D;AAED;;;;;;;GAOG;AACH,gBAAgB;AAChB,wBAAgB,QAAQ,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,CAGhD;AAED,uDAAuD;AACvD,gBAAgB;AAChB,eAAO,MAAM,eAAe,EAAG,GAAY,CAAC;AAE5C,gBAAgB;AAChB,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC3D;IAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAA;CAAE,GAC1E,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;IAC3E,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC;CAC1B,GACD;IAAE,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC"}