@stripe/extensibility-tool-utils 0.6.2

package/dist/extensibility-tool-utils-public.d.ts

@@ -0,0 +1,383 @@
+/**
+ * `@stripe/extensibility-tool-utils`
+ *
+ * Internal standalone utilities shared across Stripe extensibility tooling.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+
+import type { MetadataInferenceContext } from '@formspec/core';
+import type { MetadataPolicyInput } from '@formspec/core';
+import pino from 'pino';
+
+/**
+ * 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 well-formed semver version string (e.g. `"1.2.3"`, `"4.0.0-rc.1"`). */
+declare const __semverVersionBrand: unique symbol;
+
+/* Excluded from this release type: _AfterExecuteResult */
+
+/* Excluded from this release type: _ApiExtractorConfig */
+
+/* Excluded from this release type: _ApiExtractorDoc */
+
+/* Excluded from this release type: _ApiNameValidationResult */
+
+/* Excluded from this release type: _Assertion */
+
+/* Excluded from this release type: _AssertionContext */
+
+/* Excluded from this release type: _AssertionError */
+
+/* Excluded from this release type: _AssertOpts */
+
+/* Excluded from this release type: _AsyncAssertion */
+
+/* Excluded from this release type: _BeforeExecuteResult */
+
+/* Excluded from this release type: _beginTransaction */
+
+/* Excluded from this release type: _canonicalNormalize */
+
+/* Excluded from this release type: _canonicalStringify */
+
+/* Excluded from this release type: _check */
+
+/* Excluded from this release type: _CliContext */
+
+/* Excluded from this release type: _CliUx */
+
+/* Excluded from this release type: _CommitOptions */
+
+/* Excluded from this release type: _CommitReport */
+
+/* Excluded from this release type: _compilePointer */
+
+/* Excluded from this release type: _CompilerOptionKey */
+
+/* Excluded from this release type: _CompilerOptions */
+
+/* Excluded from this release type: _CompilerOptionValue */
+
+/* Excluded from this release type: _compositeGenerator */
+
+/* Excluded from this release type: _ConfirmationPolicy */
+
+/* Excluded from this release type: _Conflict */
+
+/* Excluded from this release type: _ConflictAbortedError */
+
+/* Excluded from this release type: _ConflictError */
+
+/* Excluded from this release type: _ConflictPolicy */
+
+/* Excluded from this release type: _ConflictResolution */
+
+/* Excluded from this release type: _ConflictResolver */
+
+/* Excluded from this release type: _createCliContext */
+
+/* Excluded from this release type: _createFilesystemTemplateFS */
+
+/* Excluded from this release type: _createInMemoryTemplateFS */
+
+/* Excluded from this release type: _createLogger */
+
+/* Excluded from this release type: _createSimpleSingleFileTemplate */
+
+/* Excluded from this release type: _createSimpleTemplate */
+
+/* Excluded from this release type: _defaultMeta */
+
+/* Excluded from this release type: _DepKind */
+
+/* Excluded from this release type: _detectFormat */
+
+/* Excluded from this release type: _detectMeta */
+
+/* Excluded from this release type: _Diagnostic */
+
+/* Excluded from this release type: _DiffHunk */
+
+/* Excluded from this release type: _diffHunks */
+
+/* Excluded from this release type: _DiffLine */
+
+/* Excluded from this release type: _DiffOptions */
+
+/* Excluded from this release type: _diffUnified */
+
+/* Excluded from this release type: _Document */
+
+/* Excluded from this release type: _escapeToken */
+
+/* Excluded from this release type: _FileEditorError */
+
+/* Excluded from this release type: _FileWriteOutcome */
+
+/* Excluded from this release type: _fingerprint */
+
+/* Excluded from this release type: _Format */
+
+/* Excluded from this release type: _FormatAdapter */
+
+/* Excluded from this release type: _FormatMeta */
+
+/* Excluded from this release type: _FormatNotSupportedError */
+
+/* Excluded from this release type: _FsCentralManifestStore */
+
+/* Excluded from this release type: _FsCentralManifestStoreOptions */
+
+/* Excluded from this release type: _GeneratedFile */
+
+/* Excluded from this release type: _Generator */
+
+/* Excluded from this release type: _GeneratorContext */
+
+/* Excluded from this release type: _GeneratorDefectError */
+
+/* Excluded from this release type: _GeneratorExecuteContext */
+
+/* Excluded from this release type: _GeneratorExecuteResult */
+
+/* Excluded from this release type: _GeneratorInputError */
+
+/* Excluded from this release type: _GeneratorPlanResult */
+
+/* Excluded from this release type: _GeneratorRunner */
+
+/* Excluded from this release type: _GeneratorWriteResult */
+
+/* Excluded from this release type: _getAdapter */
+
+/* Excluded from this release type: _hasPointer */
+
+/* Excluded from this release type: _inferStripeApiName */
+
+/* Excluded from this release type: _InMemoryStateStore */
+
+/* Excluded from this release type: _InMemoryTemplateFS */
+
+/* Excluded from this release type: _isRecord */
+
+/* Excluded from this release type: _isRecordWithValueType */
+
+/* Excluded from this release type: _isSemverRange */
+
+/* Excluded from this release type: _isSemverVersion */
+
+/* Excluded from this release type: _IsUnknown */
+
+/* Excluded from this release type: _jsonAdapter */
+
+/* Excluded from this release type: _jsoncAdapter */
+
+/* Excluded from this release type: _JsonPointer */
+
+/* Excluded from this release type: _LoggerOptions */
+
+/* Excluded from this release type: _LogLevel */
+
+/* Excluded from this release type: _looksPlural */
+
+/* Excluded from this release type: _looksSingular */
+
+/* Excluded from this release type: _MergeOptions */
+
+/* Excluded from this release type: _MutationOptions */
+
+/* Excluded from this release type: _NarrowedElement */
+
+/* Excluded from this release type: _NarrowedPartial */
+
+/* Excluded from this release type: _NarrowedValue */
+
+/* Excluded from this release type: _openApiExtractor */
+
+/* Excluded from this release type: _openDocument */
+
+/* Excluded from this release type: _openDocumentFromDisk */
+
+/* Excluded from this release type: _OpenDocumentOptions */
+
+/* Excluded from this release type: _openPackageJson */
+
+/* Excluded from this release type: _openStripeAppManifest */
+
+/* Excluded from this release type: _openTsConfig */
+
+/* Excluded from this release type: _PackageJson */
+
+/* Excluded from this release type: _PackageJsonDoc */
+
+/* Excluded from this release type: _parseArrayIndex */
+
+/* Excluded from this release type: _ParseError */
+
+/* Excluded from this release type: _parseLogLevel */
+
+/* Excluded from this release type: _parsePointer */
+
+/* Excluded from this release type: _PathError */
+
+/* Excluded from this release type: _PendingEdit */
+
+/* Excluded from this release type: _PlannedFile */
+
+/* Excluded from this release type: _pointer */
+
+/* Excluded from this release type: _POINTER_STRING */
+
+/* Excluded from this release type: _PointerBuilder */
+
+/* Excluded from this release type: _PointerSegments */
+
+/* Excluded from this release type: _ProjectExecuteContext */
+
+/* Excluded from this release type: _ProjectGeneratorContext */
+
+/* Excluded from this release type: _registerFormatAdapter */
+
+/* Excluded from this release type: _resolvePointer */
+
+/* Excluded from this release type: _runAssertions */
+
+/* Excluded from this release type: _runAsyncAssertions */
+
+/* Excluded from this release type: _SchemaValidationError */
+
+/* Excluded from this release type: _SemverRange */
+
+/* Excluded from this release type: _semverRange */
+
+/* Excluded from this release type: _SemverVersion */
+
+/* Excluded from this release type: _semverVersion */
+
+/* Excluded from this release type: _Severity */
+
+/* Excluded from this release type: _sha256Hex */
+
+/* Excluded from this release type: _SingleTemplateManager */
+
+/* Excluded from this release type: _SplitPointer */
+
+/* Excluded from this release type: _SplitRest */
+
+/* Excluded from this release type: _StandaloneExecuteContext */
+
+/* Excluded from this release type: _StandaloneGeneratorContext */
+
+/* Excluded from this release type: _StandardSchemaV1 */
+
+/* Excluded from this release type: _StateRecord */
+
+/* Excluded from this release type: _StateStore */
+
+/* Excluded from this release type: _StepInto */
+
+/* Excluded from this release type: _StripeAppManifest */
+
+/* Excluded from this release type: _StripeAppManifestDoc */
+
+/* Excluded from this release type: _stripeMetadataPolicy */
+
+/* Excluded from this release type: _StripePermission */
+
+/* Excluded from this release type: _Template */
+
+/* Excluded from this release type: _TemplateContext */
+
+/* Excluded from this release type: _TemplateFS */
+
+/* Excluded from this release type: _TemplateFSImageEntry */
+
+/* Excluded from this release type: _TemplateManager */
+
+/* Excluded from this release type: _TemplateOutput */
+
+/* Excluded from this release type: _toCapitalized */
+
+/* Excluded from this release type: _tokenizeIdentifier */
+
+/* Excluded from this release type: _toPascalCase */
+
+/* Excluded from this release type: _toPlural */
+
+/* Excluded from this release type: _toSentenceDisplayName */
+
+/* Excluded from this release type: _toSingular */
+
+/* Excluded from this release type: _toSnakeCase */
+
+/* Excluded from this release type: _toStripeApiCase */
+
+/* Excluded from this release type: _Transaction */
+
+/* Excluded from this release type: _TransactionOptions */
+
+/* Excluded from this release type: _truncateName */
+
+/* Excluded from this release type: _tryParseSemverRange */
+
+/* Excluded from this release type: _tryParseSemverVersion */
+
+/* Excluded from this release type: _tryValidateWithSchema */
+
+/* Excluded from this release type: _TsConfig */
+
+/* Excluded from this release type: _TsConfigDoc */
+
+/* Excluded from this release type: _TsJsx */
+
+/* Excluded from this release type: _TsModule */
+
+/* Excluded from this release type: _TsModuleResolution */
+
+/* Excluded from this release type: _TsTarget */
+
+/* Excluded from this release type: _TypeMismatchError */
+
+/* Excluded from this release type: _UnescapeToken */
+
+/* Excluded from this release type: _unescapeToken */
+
+/* Excluded from this release type: _validateApiName */
+
+/* Excluded from this release type: _validateDisplayName */
+
+/* Excluded from this release type: _validateWithSchema */
+
+/* Excluded from this release type: _ValueAtPointer */
+
+/* Excluded from this release type: _ValueAtSegments */
+
+/* Excluded from this release type: _workspaceVersion */
+
+/* Excluded from this release type: _WriteAbortedError */
+
+/* Excluded from this release type: _WriteCapability */
+
+/* Excluded from this release type: _WriteConfirm */
+
+/* Excluded from this release type: _WriteDecision */
+
+/* Excluded from this release type: _WriteError */
+
+/* Excluded from this release type: _writeJsonOutput */
+
+/* Excluded from this release type: _WriteReason */
+
+/* Excluded from this release type: _WriteRequest */
+
+/* Excluded from this release type: _yamlAdapter */
+
+export { }

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

@@ -0,0 +1,68 @@
+/**
+ * Read-only predicates that produce {@link _Diagnostic}s. Compose via
+ * {@link _Document.assert}, or call each factory directly on a value.
+ *
+ * Semver checks use npm's `semver` package.
+ *
+ * @see https://github.com/npm/node-semver
+ */
+import type { _StandardSchemaV1 } from '../schema.js';
+import type { _Diagnostic, _JsonPointer, _Severity } from '../types.js';
+/** A read-only predicate over a document-shaped value. @internal */
+export type _Assertion = (ctx: _AssertionContext) => _Diagnostic[];
+/** An assertion that defers to an async validator (e.g. a Standard Schema). @internal */
+export type _AsyncAssertion = (ctx: _AssertionContext) => Promise<_Diagnostic[]>;
+/** Context handed to each assertion. @internal */
+export interface _AssertionContext {
+    readonly path: string;
+    readonly value: unknown;
+}
+/** @internal */
+export interface _AssertOpts {
+    readonly severity?: _Severity;
+    readonly message?: string;
+}
+/**
+ * Read-only predicate factories that produce {@link _Assertion}s and
+ * {@link _AsyncAssertion}s. Compose via {@link _Document.assert}.
+ * @internal
+ */
+export declare const _check: {
+    /** The pointer must resolve to something (including `null`). @internal */
+    readonly exists: (pointer: _JsonPointer, opts?: _AssertOpts) => _Assertion;
+    /** The value at the pointer must deep-equal `expected`. @internal */
+    readonly equals: (pointer: _JsonPointer, expected: unknown, opts?: _AssertOpts) => _Assertion;
+    /** The value at the pointer must equal one of `allowed`. @internal */
+    readonly oneOf: (pointer: _JsonPointer, allowed: readonly unknown[], opts?: _AssertOpts) => _Assertion;
+    /** The string value at the pointer must match the given pattern. @internal */
+    readonly matches: (pointer: _JsonPointer, pattern: RegExp, opts?: _AssertOpts) => _Assertion;
+    /**
+     * The value at the pointer must satisfy a caller predicate.
+     * @internal
+     */
+    readonly satisfies: (pointer: _JsonPointer, predicate: (v: unknown) => boolean, opts?: _AssertOpts) => _Assertion;
+    /**
+     * The value at the pointer must validate against the supplied Standard
+     * Schema (Zod v4, Valibot, ArkType, etc.). Each schema issue becomes a
+     * `SCHEMA_VIOLATION` diagnostic with the pointer extended by the issue's
+     * path.
+     *
+     * NOTE: the validator is invoked synchronously and its result awaited at
+     * call time, so this returns a `Promise<_Diagnostic[]>` rather than a
+     * synchronous `_Assertion`. Wrap the result with `_runAsyncAssertions` if
+     * you need to compose it with other async checks.
+     * @internal
+     */
+    readonly matchesSchema: (pointer: _JsonPointer, schema: _StandardSchemaV1, opts?: _AssertOpts) => _AsyncAssertion;
+    /**
+     * The string value at the pointer must be a valid semver range satisfying
+     * the supplied constraint.
+     * @internal
+     */
+    readonly semverSatisfies: (pointer: _JsonPointer, range: string, opts?: _AssertOpts) => _Assertion;
+};
+/** @internal */
+export declare function _runAssertions(path: string, value: unknown, assertions: readonly _Assertion[]): _Diagnostic[];
+/** @internal */
+export declare function _runAsyncAssertions(path: string, value: unknown, assertions: readonly _AsyncAssertion[]): Promise<_Diagnostic[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/file-editor/assertions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExE,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,WAAW,EAAE,CAAC;AAEnE,yFAAyF;AACzF,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAEjF,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID;;;;GAIG;AACH,eAAO,MAAM,MAAM;IACjB,0EAA0E;+BAC1D,YAAY,SAAQ,WAAW,KAAQ,UAAU;IAiBjE,qEAAqE;+BACrD,YAAY,YAAY,OAAO,SAAQ,WAAW,KAAQ,UAAU;IAmBpF,sEAAsE;8BAE3D,YAAY,WACZ,SAAS,OAAO,EAAE,SACrB,WAAW,KAChB,UAAU;IAoBb,8EAA8E;gCAC7D,YAAY,WAAW,MAAM,SAAQ,WAAW,KAAQ,UAAU;IAkBnF;;;OAGG;kCAEQ,YAAY,aACV,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,SAC5B,WAAW,KAChB,UAAU;IAiBb;;;;;;;;;;;OAWG;sCAEQ,YAAY,UACb,iBAAiB,SACnB,WAAW,KAChB,eAAe;IAkBlB;;;;OAIG;wCAEQ,YAAY,SACd,MAAM,SACP,WAAW,KAChB,UAAU;CAgDL,CAAC;AAEX,gBAAgB;AAChB,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,SAAS,UAAU,EAAE,GAChC,WAAW,EAAE,CAMf;AAED,gBAAgB;AAChB,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,SAAS,eAAe,EAAE,GACrC,OAAO,CAAC,WAAW,EAAE,CAAC,CAMxB"}

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

@@ -0,0 +1,107 @@
+import type { _Assertion } from './assertions/index.js';
+import type { _StandardSchemaV1 } from './schema.js';
+import type { _ConflictPolicy, _Diagnostic, _Format, _FormatMeta, _JsonPointer, _MergeOptions, _PendingEdit } from './types.js';
+import type { _ValueAtPointer } from './value-at-pointer.js';
+/**
+ * Narrow `_ValueAtPointer<T, P>` only when `P` is a string literal. When `P`
+ * widens to `string` (e.g. a computed pointer) the type collapses to
+ * `unknown` so callers keep the freedom they had before.
+ * @internal
+ */
+export type _NarrowedValue<T, P extends string> = string extends P ? unknown : _ValueAtPointer<T, P>;
+/** @internal */
+export type _NarrowedPartial<T, P extends string> = string extends P ? object : Partial<_ValueAtPointer<T, P>> & object;
+/** @internal */
+export type _NarrowedElement<T, P extends string> = string extends P ? unknown : _ValueAtPointer<T, P> extends readonly (infer E)[] ? E : unknown;
+/** Options passed when opening a document directly. */
+/** @internal */
+export interface _OpenDocumentOptions<T = unknown> {
+    readonly format?: _Format;
+    /** Optional schema for runtime validation (any Standard Schema). */
+    readonly schema?: _StandardSchemaV1<T>;
+}
+/** Per-mutation overrides. */
+/** @internal */
+export interface _MutationOptions<T = unknown> {
+    readonly conflictPolicy?: _ConflictPolicy;
+    readonly guard?: (doc: _Document<T>) => boolean;
+}
+/**
+ * A parsed, editable document. Mutations are staged in memory and applied to
+ * the source text on demand (see {@link _Document.preview}).
+ *
+ * `T` is the *expected* shape of the document's root value. When `T` is
+ * `unknown` (the default), mutation signatures collapse to accept any value,
+ * so the class is usable schema-free. When `T` is a concrete interface,
+ * `get`/`set`/`addIfMissing`/etc. narrow both the pointer and the value
+ * type via {@link _ValueAtPointer}.
+ */
+/** @internal */
+export declare class _Document<T = unknown> {
+    readonly absolutePath: string;
+    readonly format: _Format;
+    /** Optional Standard Schema; when set, {@link _Document.validate} runs it. */
+    readonly schema: _StandardSchemaV1<T> | null;
+    /** Original on-disk text (may be `""` for new files). */
+    private readonly originalText;
+    private readonly meta;
+    private readonly edits;
+    private readonly staticDiagnostics;
+    constructor(init: {
+        readonly absolutePath: string;
+        readonly format: _Format;
+        readonly originalText: string;
+        readonly meta: _FormatMeta;
+        readonly schema?: _StandardSchemaV1<T> | null;
+    });
+    /** Get the value at a pointer. Reflects pending edits via `preview()`. */
+    get<P extends _JsonPointer>(pointer: P): _NarrowedValue<T, P> | undefined;
+    /** Like `get` but throws {@link _AssertionError} on miss. */
+    getRequired<P extends _JsonPointer>(pointer: P): _NarrowedValue<T, P>;
+    has(pointer: _JsonPointer): boolean;
+    set<P extends _JsonPointer>(pointer: P, value: _NarrowedValue<T, P>, opts?: _MutationOptions<T>): this;
+    addIfMissing<P extends _JsonPointer>(pointer: P, value: _NarrowedValue<T, P>, opts?: _MutationOptions<T>): this;
+    updateIfPresent<P extends _JsonPointer>(pointer: P, updater: (current: _NarrowedValue<T, P>) => _NarrowedValue<T, P>, opts?: _MutationOptions<T>): this;
+    remove(pointer: _JsonPointer, opts?: _MutationOptions<T>): this;
+    merge<P extends _JsonPointer>(pointer: P, partial: _NarrowedPartial<T, P>, opts?: _MutationOptions<T> & {
+        mergeOptions?: _MergeOptions;
+    }): this;
+    arrayAppend<P extends _JsonPointer>(pointer: P, value: _NarrowedElement<T, P>, opts?: _MutationOptions<T>): this;
+    arrayUpsert<P extends _JsonPointer, E = _NarrowedElement<T, P>>(pointer: P, value: E, keyFn: (el: E) => unknown, opts?: _MutationOptions<T>): this;
+    assert(...checks: readonly _Assertion[]): _Diagnostic[];
+    /**
+     * If a schema is configured, validate the current preview against it and
+     * return a diagnostic per issue. Returns `[]` when no schema is set or
+     * validation passes.
+     *
+     * Each call replaces any previously accumulated `SCHEMA_VIOLATION` diagnostics
+     * so that calling `validate()` multiple times does not duplicate findings.
+     */
+    validate(): Promise<_Diagnostic[]>;
+    diagnostics(): readonly _Diagnostic[];
+    pendingEdits(): readonly _PendingEdit[];
+    /** Serialize with all pending edits applied. Pure — no disk I/O. */
+    preview(): string;
+    /** Reset all pending edits. Used by transactions on rollback. */
+    rollback(): void;
+    /** @internal Metadata for transaction serialization. */
+    getMeta(): _FormatMeta;
+    /** @internal Original text, for transaction fingerprinting. */
+    getOriginalText(): string;
+    private parseCurrentValue;
+    private stage;
+    private opts;
+}
+/**
+ * Open a document from disk. For non-existent files, returns an empty
+ * document whose `format` is inferred from the path (or `options.format`).
+ */
+/** @internal */
+export declare function _openDocumentFromDisk<T = unknown>(absolutePath: string, options?: _OpenDocumentOptions<T>): Promise<_Document<T>>;
+/**
+ * Compute the on-disk fingerprint for a document's current preview text.
+ *
+ * @internal — exposed for transaction commit flow.
+ */
+export declare function _previewFingerprint(doc: _Document): string;
+//# sourceMappingURL=document.d.ts.map

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

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

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

@@ -0,0 +1,66 @@
+import type { _Conflict, _Format, _JsonPointer } from './types.js';
+/** Base class for all errors raised by this library. */
+/** @internal */
+export declare class _FileEditorError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/** Input could not be parsed. */
+/** @internal */
+export declare class _ParseError extends _FileEditorError {
+    readonly format: _Format;
+    readonly offset: number | null;
+    readonly snippet: string | null;
+    constructor(format: _Format, message: string, details?: {
+        offset?: number;
+        snippet?: string;
+    });
+}
+/** A JSON Pointer is syntactically invalid or cannot be resolved. */
+/** @internal */
+export declare class _PathError extends _FileEditorError {
+    readonly pointer: _JsonPointer;
+    constructor(pointer: _JsonPointer, message: string);
+}
+/** A mutation's expected shape doesn't match the current value. */
+/** @internal */
+export declare class _TypeMismatchError extends _FileEditorError {
+    readonly pointer: _JsonPointer;
+    constructor(pointer: _JsonPointer, message: string);
+}
+/** A required value failed an assertion check. */
+/** @internal */
+export declare class _AssertionError extends _FileEditorError {
+    readonly pointer: _JsonPointer;
+    readonly expected: unknown;
+    readonly actual: unknown;
+    constructor(pointer: _JsonPointer, message: string, details?: {
+        expected?: unknown;
+        actual?: unknown;
+    });
+}
+/** Drift detected and policy was "error". */
+/** @internal */
+export declare class _ConflictError extends _FileEditorError {
+    readonly conflict: _Conflict;
+    constructor(conflict: _Conflict);
+}
+/** Resolver or confirmWrite returned "abort". */
+/** @internal */
+export declare class _ConflictAbortedError extends _FileEditorError {
+    readonly path: string;
+    constructor(path: string);
+}
+/** confirmWrite returned "abort". */
+/** @internal */
+export declare class _WriteAbortedError extends _FileEditorError {
+    readonly path: string;
+    constructor(path: string);
+}
+/** Unknown file extension with no format override. */
+/** @internal */
+export declare class _FormatNotSupportedError extends _FileEditorError {
+    readonly path: string;
+    constructor(path: string, message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/file-editor/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE,wDAAwD;AACxD,gBAAgB;AAChB,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKjD;AAED,iCAAiC;AACjC,gBAAgB;AAChB,qBAAa,WAAY,SAAQ,gBAAgB;IAC/C,SAAgB,MAAM,EAAE,OAAO,CAAC;IAChC,SAAgB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,SAAgB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGrC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;CAQtD;AAED,qEAAqE;AACrE,gBAAgB;AAChB,qBAAa,UAAW,SAAQ,gBAAgB;IAC9C,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAEnB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM;CAK1D;AAED,mEAAmE;AACnE,gBAAgB;AAChB,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAEnB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM;CAK1D;AAED,kDAAkD;AAClD,gBAAgB;AAChB,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAClC,SAAgB,MAAM,EAAE,OAAO,CAAC;gBAG9B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO;CAQzD;AAED,6CAA6C;AAC7C,gBAAgB;AAChB,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,SAAgB,QAAQ,EAAE,SAAS,CAAC;gBAEjB,QAAQ,EAAE,SAAS;CAQvC;AAED,iDAAiD;AACjD,gBAAgB;AAChB,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;CAKhC;AAED,qCAAqC;AACrC,gBAAgB;AAChB,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;CAKhC;AAED,sDAAsD;AACtD,gBAAgB;AAChB,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQlD"}

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

@@ -0,0 +1,34 @@
+/**
+ * Typed façade for api-extractor.json (JSONC).
+ *
+ * @see https://api-extractor.com/pages/setup/configure_api_report/
+ */
+import { _Document, type _MutationOptions } from '../document.js';
+import type { _StandardSchemaV1 } from '../schema.js';
+/** @internal */
+export interface _ApiExtractorConfig {
+    readonly projectFolder?: string;
+    readonly mainEntryPointFilePath?: string;
+    readonly apiReport?: {
+        readonly enabled?: boolean;
+        readonly reportFolder?: string;
+        readonly reportFileName?: string;
+    };
+    readonly dtsRollup?: {
+        readonly enabled?: boolean;
+        readonly publicTrimmedFilePath?: string;
+        readonly untrimmedFilePath?: string;
+    };
+}
+/** @internal */
+export declare class _ApiExtractorDoc extends _Document<_ApiExtractorConfig> {
+    setMainEntryPoint(path: string, opts?: _MutationOptions<_ApiExtractorConfig>): this;
+    enableApiReport(folder: string, fileName: string, opts?: _MutationOptions<_ApiExtractorConfig>): this;
+    enableDtsRollup(publicPath: string, opts?: _MutationOptions<_ApiExtractorConfig>): this;
+}
+/** @internal */
+export declare function _openApiExtractor(absolutePath: string, options?: {
+    format?: 'jsonc' | 'json';
+    schema?: _StandardSchemaV1;
+}): Promise<_ApiExtractorDoc>;
+//# sourceMappingURL=api-extractor.d.ts.map