@stripe/extensibility-tool-utils 0.6.2

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

@@ -0,0 +1,72 @@
+/**
+ * Standard Schema v1 — a library-agnostic validator interface implemented by
+ * Zod v4, Valibot, ArkType, Effect Schema, and others. By accepting this
+ * interface we remain independent of any particular schema library.
+ *
+ * This module reproduces the tiny interface locally (no runtime dep).
+ *
+ * @see https://standardschema.dev
+ * @see https://github.com/standard-schema/standard-schema
+ */
+/** @internal */
+export declare namespace _StandardSchemaV1 {
+    /** @internal */
+    interface Props<Input = unknown, Output = Input> {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** @internal */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** @internal */
+    interface SuccessResult<Output> {
+        readonly value: Output;
+        readonly issues?: undefined;
+    }
+    /** @internal */
+    interface FailureResult {
+        readonly issues: readonly Issue[];
+    }
+    /** @internal */
+    interface Issue {
+        readonly message: string;
+        readonly path?: readonly (PropertyKey | PathSegment)[] | undefined;
+    }
+    /** @internal */
+    interface PathSegment {
+        readonly key: PropertyKey;
+    }
+    /** @internal */
+    interface Types<Input = unknown, Output = Input> {
+        readonly input: Input;
+        readonly output: Output;
+    }
+    /** Extract the inferred input type. */
+    /** @internal */
+    type InferInput<S extends _StandardSchemaV1> = NonNullable<S['~standard']['types']>['input'];
+    /** Extract the inferred output type. */
+    /** @internal */
+    type InferOutput<S extends _StandardSchemaV1> = NonNullable<S['~standard']['types']>['output'];
+}
+/** @internal */
+export interface _StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly '~standard': _StandardSchemaV1.Props<Input, Output>;
+}
+/**
+ * Validate a value against a Standard Schema. Awaits the validator if it
+ * returns a promise. Returns the parsed value on success, throws on failure
+ * with a formatted message.
+ */
+/** @internal */
+export declare function _validateWithSchema<S extends _StandardSchemaV1>(schema: S, value: unknown): Promise<_StandardSchemaV1.InferOutput<S>>;
+/** Non-throwing variant returning the Standard Schema result directly. */
+/** @internal */
+export declare function _tryValidateWithSchema<S extends _StandardSchemaV1>(schema: S, value: unknown): Promise<_StandardSchemaV1.Result<_StandardSchemaV1.InferOutput<S>>>;
+/** Error thrown by {@link _validateWithSchema}. */
+/** @internal */
+export declare class _SchemaValidationError extends Error {
+    readonly issues: readonly _StandardSchemaV1.Issue[];
+    constructor(message: string, issues: readonly _StandardSchemaV1.Issue[]);
+}
+//# sourceMappingURL=schema.d.ts.map

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

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

package/dist/file-editor/state/fs-manifest.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Filesystem-backed state store. Persists all records in a single JSON
+ * manifest file (default `.file-editor/state.json` under `rootDir`). Records
+ * are keyed by their path relative to `rootDir` so that moving the project
+ * directory on disk does not invalidate fingerprints.
+ */
+import type { _StateRecord } from '../types.js';
+import type { _StateStore } from './store.js';
+/** @internal */
+export interface _FsCentralManifestStoreOptions {
+    /** Root directory under which relative keys are computed. Default: `process.cwd()`. */
+    readonly rootDir?: string;
+    /** Manifest filename relative to `rootDir`. Default: `.file-editor/state.json`. */
+    readonly filename?: string;
+    /**
+     * If true, the manifest retains the full text of each managed file as of
+     * its last write, enabling three-way diffing via `_Conflict.base`.
+     * Off by default to limit disk usage.
+     */
+    readonly keepBaseSnapshots?: boolean;
+}
+/** @internal */
+export interface Manifest {
+    readonly version: 1;
+    readonly records: Record<string, _StateRecord>;
+}
+/** Filesystem-backed manifest store. Safe for concurrent reads; single-writer. */
+/** @internal */
+export declare function _FsCentralManifestStore(options?: _FsCentralManifestStoreOptions): _StateStore;
+//# sourceMappingURL=fs-manifest.d.ts.map

package/dist/file-editor/state/fs-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-manifest.d.ts","sourceRoot":"","sources":["../../../src/file-editor/state/fs-manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,gBAAgB;AAChB,MAAM,WAAW,8BAA8B;IAC7C,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,gBAAgB;AAChB,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAChD;AAED,kFAAkF;AAClF,gBAAgB;AAChB,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,8BAAmC,GAC3C,WAAW,CAwEb"}

package/dist/file-editor/state/in-memory.d.ts

@@ -0,0 +1,5 @@
+import type { _StateStore } from './store.js';
+/** Process-local, non-persistent state store. Useful for tests and dry-runs. */
+/** @internal */
+export declare function _InMemoryStateStore(): _StateStore;
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/file-editor/state/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/file-editor/state/in-memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,gFAAgF;AAChF,gBAAgB;AAChB,wBAAgB,mBAAmB,IAAI,WAAW,CAoBjD"}

package/dist/file-editor/state/store.d.ts

@@ -0,0 +1,19 @@
+import type { _StateRecord } from '../types.js';
+/**
+ * Persistence contract for drift-detection state: one record per managed file,
+ * keyed by absolute path. Library ships {@link _InMemoryStateStore} and
+ * {@link _FsCentralManifestStore}; callers may implement their own (SQLite,
+ * remote cache, etc.).
+ */
+/** @internal */
+export interface _StateStore {
+    read(absolutePath: string): Promise<_StateRecord | null>;
+    write(absolutePath: string, record: _StateRecord): Promise<void>;
+    delete(absolutePath: string): Promise<void>;
+    /** Optional enumeration for maintenance/GC tasks. */
+    list?(): Promise<readonly {
+        path: string;
+        record: _StateRecord;
+    }[]>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/file-editor/state/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/file-editor/state/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,qDAAqD;IACrD,IAAI,CAAC,IAAI,OAAO,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,EAAE,CAAC,CAAC;CACrE"}

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

@@ -0,0 +1,60 @@
+import { type _Document } from './document.js';
+import type { _StateStore } from './state/store.js';
+import type { _Conflict, _ConflictPolicy, _ConflictResolver, _ConfirmationPolicy, _Diagnostic, _Format, _WriteConfirm } from './types.js';
+/** Options common to opening documents inside a transaction. */
+/** @internal */
+export interface _TransactionOptions {
+    readonly format?: _Format;
+    readonly stateStore?: _StateStore;
+    readonly onConflict?: _ConflictResolver;
+    readonly confirmWrite?: _WriteConfirm;
+    readonly confirmationPolicy?: _ConfirmationPolicy;
+    readonly toolId?: string;
+    readonly toolVersion?: string;
+}
+/** Options supplied at {@link _Transaction.commit} time. */
+/** @internal */
+export interface _CommitOptions {
+    readonly defaultPolicy?: _ConflictPolicy;
+}
+/** Full report of a (dry-run or actual) commit. */
+/** @internal */
+export interface _CommitReport {
+    readonly written: readonly {
+        readonly path: string;
+        readonly bytesBefore: number;
+        readonly bytesAfter: number;
+        readonly unifiedDiff: string;
+    }[];
+    readonly skipped: readonly {
+        readonly path: string;
+        readonly reason: 'no-change' | 'conflict-skipped' | 'write-skipped' | 'schema-invalid';
+    }[];
+    readonly conflicts: readonly _Conflict[];
+    readonly diagnostics: readonly _Diagnostic[];
+}
+/** An editing session spanning one or more documents. */
+/** @internal */
+export declare class _Transaction {
+    private readonly documents;
+    private readonly options;
+    constructor(options?: _TransactionOptions);
+    /** Open or return the cached document for a path. Memoized per transaction. */
+    open(absolutePath: string): Promise<_Document>;
+    /** @internal — register a document that was opened externally (e.g. via a façade). */
+    adopt(doc: _Document): void;
+    /** Drop all staged edits across every document in the transaction. */
+    rollback(): void;
+    /** Plan without writing. Invokes `onConflict`/`confirmWrite` as a real commit would. */
+    dryRun(options?: _CommitOptions): Promise<_CommitReport>;
+    /** Apply staged edits to disk. */
+    commit(options?: _CommitOptions): Promise<_CommitReport>;
+    private run;
+}
+/** Begin a new transaction. */
+/** @internal */
+export declare function _beginTransaction(options?: _TransactionOptions): _Transaction;
+/** One-off open helper. Use a {@link _Transaction} for multi-file work. */
+/** @internal */
+export declare function _openDocument(absolutePath: string, options?: _TransactionOptions): Promise<_Document>;
+//# sourceMappingURL=transaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/file-editor/transaction.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,eAAe,CAAC;AAQvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,OAAO,EAEP,aAAa,EAGd,MAAM,YAAY,CAAC;AAIpB,gEAAgE;AAChE,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,4DAA4D;AAC5D,gBAAgB;AAChB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAC;CAC1C;AAED,mDAAmD;AACnD,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,EAAE,CAAC;IACJ,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EACX,WAAW,GACX,kBAAkB,GAClB,eAAe,GACf,gBAAgB,CAAC;KACtB,EAAE,CAAC;IACJ,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,WAAW,EAAE,CAAC;CAC9C;AAED,yDAAyD;AACzD,gBAAgB;AAChB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAE3B,OAAO,GAAE,mBAAwB;IAIpD,+EAA+E;IAClE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAS3D,sFAAsF;IAC/E,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAIlC,sEAAsE;IAC/D,QAAQ,IAAI,IAAI;IAIvB,wFAAwF;IAC3E,MAAM,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzE,kCAAkC;IACrB,MAAM,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;YAI3D,GAAG;CA+HlB;AAiHD,+BAA+B;AAC/B,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAEjF;AAED,2EAA2E;AAC3E,gBAAgB;AAChB,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,CAGpB"}

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

@@ -0,0 +1,131 @@
+/**
+ * Shared types for the structured config editor.
+ *
+ * @see https://datatracker.ietf.org/doc/html/rfc6901 — JSON Pointer
+ */
+/** Supported document formats. */
+/** @internal */
+export type _Format = 'json' | 'jsonc' | 'yaml';
+/**
+ * A JSON Pointer string as defined by RFC 6901.
+ *
+ * Examples: `""` (whole doc), `"/dependencies/lodash"`,
+ * `"/compilerOptions/paths/@scope~1pkg/0"`.
+ */
+/** @internal */
+export type _JsonPointer = string;
+/** Diagnostic severity. */
+/** @internal */
+export type _Severity = 'error' | 'warning' | 'info';
+/** A single finding produced by an assertion or commit flow. */
+/** @internal */
+export interface _Diagnostic {
+    readonly path: string;
+    readonly pointer: _JsonPointer;
+    readonly code: string;
+    readonly severity: _Severity;
+    readonly message: string;
+    readonly expected?: unknown;
+    readonly actual?: unknown;
+}
+/** A staged mutation, before it is serialized and written. */
+/** @internal */
+export interface _PendingEdit {
+    readonly kind: 'set' | 'addIfMissing' | 'updateIfPresent' | 'remove' | 'merge' | 'arrayAppend' | 'arrayUpsert';
+    readonly pointer: _JsonPointer;
+    readonly value?: unknown;
+    readonly updater?: (current: unknown) => unknown;
+    readonly arrayKey?: (element: unknown) => unknown;
+    readonly mergeOptions?: _MergeOptions;
+    readonly conflictPolicy?: _ConflictPolicy;
+    readonly guard?: (docValue: unknown) => boolean;
+}
+/** Policy for handling on-disk drift at commit time. */
+/** @internal */
+export type _ConflictPolicy = 'error' | 'skip' | 'overwrite' | 'ask';
+/** When the `confirmWrite` hook should be invoked. */
+/** @internal */
+export type _ConfirmationPolicy = 'never' | 'on-conflict' | 'always';
+/** Merge-operation options. */
+/** @internal */
+export interface _MergeOptions {
+    /** Array merge strategy. Default: `"replace"`. */
+    readonly arrays?: 'replace' | 'concat' | 'concatUnique';
+    /** Whether to recurse into nested objects. Default: `true`. */
+    readonly deep?: boolean;
+}
+/** Result of resolving a conflict. */
+/** @internal */
+export type _ConflictResolution = 'overwrite' | 'skip' | 'abort';
+/** Result of a write-confirmation request. */
+/** @internal */
+export type _WriteDecision = 'write' | 'skip' | 'abort';
+/** Reason the library is requesting a write. */
+/** @internal */
+export type _WriteReason = 'new-file' | 'update' | 'conflict';
+/** Describes a detected drift event. */
+/** @internal */
+export interface _Conflict {
+    readonly path: string;
+    /** Text the library intended to write. */
+    readonly ours: string;
+    /** Current on-disk text. */
+    readonly theirs: string;
+    /** Text at last recorded write, if retained. */
+    readonly base: string | null;
+    readonly lastWriteAt: string | null;
+    readonly lastWriteTool: string | null;
+}
+/** Structured representation of a unified-diff hunk. */
+/** @internal */
+export interface _DiffHunk {
+    readonly oldStart: number;
+    readonly oldLines: number;
+    readonly newStart: number;
+    readonly newLines: number;
+    readonly lines: readonly _DiffLine[];
+}
+/** A single diff line within a hunk. */
+/** @internal */
+export interface _DiffLine {
+    readonly kind: 'context' | 'add' | 'del';
+    readonly text: string;
+    readonly oldLineNo: number | null;
+    readonly newLineNo: number | null;
+}
+/** Payload handed to the caller-supplied `confirmWrite` hook. */
+/** @internal */
+export interface _WriteRequest {
+    readonly path: string;
+    readonly format: _Format;
+    readonly reason: _WriteReason;
+    readonly currentText: string | null;
+    readonly nextText: string;
+    readonly unifiedDiff: string;
+    readonly hunks: readonly _DiffHunk[];
+    readonly conflict: _Conflict | null;
+}
+/** @internal */
+export type _ConflictResolver = (c: _Conflict) => Promise<_ConflictResolution>;
+/** @internal */
+export type _WriteConfirm = (req: _WriteRequest) => Promise<_WriteDecision>;
+/** Record kept in the state store for each managed file. */
+/** @internal */
+export interface _StateRecord {
+    readonly fingerprint: string;
+    readonly rawSha256: string;
+    readonly writtenAt: string;
+    readonly toolId: string | null;
+    readonly toolVersion: string | null;
+    readonly format: _Format;
+    readonly baseText?: string;
+}
+/** Format-specific metadata discovered while parsing. */
+/** @internal */
+export interface _FormatMeta {
+    readonly indent: string;
+    readonly eol: '\n' | '\r\n';
+    readonly hasFinalNewline: boolean;
+    readonly hasBom: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/file-editor/util/atomic-write.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Write text to `path` atomically via a temp file + rename. Parent directories
+ * are created on demand.
+ */
+/** @internal */
+export declare function _atomicWriteText(path: string, text: string): Promise<void>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/file-editor/util/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../../src/file-editor/util/atomic-write.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,gBAAgB;AAChB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhF"}

package/dist/file-editor/util/diff.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Unified-diff computation. Implements a classic LCS-based line diff and
+ * emits either a plain-text _unified-diff string or structured
+ * {@link _DiffHunk}s that callers can render themselves.
+ */
+import type { _DiffHunk } from '../types.js';
+/** @internal */
+export interface _DiffOptions {
+    /** Number of context lines to include around each hunk. Default: 3. */
+    readonly context?: number;
+    readonly fileNameA?: string;
+    readonly fileNameB?: string;
+}
+/** Produce a _unified-diff string (`--- a / +++ b` headers and `@@` _hunks). */
+/** @internal */
+export declare function _unified(a: string, b: string, opts?: _DiffOptions): string;
+/** Produce structured diff _hunks (for custom TUI rendering). */
+/** @internal */
+export declare function _hunks(a: string, b: string, opts?: _DiffOptions): _DiffHunk[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/file-editor/util/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/file-editor/util/diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,aAAa,CAAC;AAExD,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,gFAAgF;AAChF,gBAAgB;AAChB,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CAiB9E;AAED,iEAAiE;AACjE,gBAAgB;AAChB,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,SAAS,EAAE,CAMjF"}

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

@@ -0,0 +1,46 @@
+/**
+ * Type-level arithmetic for resolving the value type at a JSON Pointer,
+ * given a known schema type.
+ *
+ * `_ValueAtPointer<T, P>` walks `T` segment-by-segment along the decoded
+ * _pointer string `P` and yields the value type at that location. For
+ * unknown or structurally impossible paths it falls back to `unknown`,
+ * so a typed `set(_pointer, value)` signature rejects values that couldn't
+ * possibly belong at that location.
+ *
+ * This entire module is *types only* at runtime — zero code is emitted.
+ *
+ * @see https://datatracker.ietf.org/doc/html/rfc6901
+ */
+/** Unescape a single reference token per RFC 6901 (§4). */
+/** @internal */
+export type _UnescapeToken<S extends string> = S extends `${infer H}~1${infer T}` ? `${H}/${_UnescapeToken<T>}` : S extends `${infer H}~0${infer T}` ? `${H}~${_UnescapeToken<T>}` : S;
+/** Split a JSON Pointer string into its decoded reference tokens. */
+/** @internal */
+export type _SplitPointer<P extends string> = P extends '' ? [] : P extends `/${infer Rest}` ? _SplitRest<Rest> : never;
+/** @internal */
+export type _SplitRest<S extends string> = S extends `${infer Head}/${infer Tail}` ? [_UnescapeToken<Head>, ..._SplitRest<Tail>] : [_UnescapeToken<S>];
+/**
+ * Walk a schema type `T` along a sequence of reference tokens `S`,
+ * yielding the value type at that location (or `unknown` for structurally
+ * impossible paths).
+ * @internal
+ */
+export type _ValueAtSegments<T, S extends readonly string[]> = S extends readonly [] ? T : S extends readonly [infer First extends string, ...infer Rest extends string[]] ? _StepInto<T, First, Rest> : unknown;
+/** @internal */
+export type _StepInto<T, First extends string, Rest extends readonly string[]> = T extends readonly [unknown, ...unknown[]] ? First extends keyof T ? _ValueAtSegments<NonNullable<T[First]>, Rest> : unknown : T extends readonly (infer E)[] ? First extends `${number}` ? _ValueAtSegments<E, Rest> : unknown : T extends object ? First extends keyof T ? _ValueAtSegments<NonNullable<T[First]>, Rest> : string extends keyof T ? _ValueAtSegments<NonNullable<T[keyof T & string]>, Rest> : unknown : unknown;
+/**
+ * Given a schema type `T` and a JSON Pointer string literal `P`, the value
+ * type at the _pointer's location. Empty _pointer yields `T` itself.
+ *
+ * When `T` is `unknown` the arithmetic collapses to `unknown`, so the
+ * generic `_Document<unknown>` transparently accepts any value.
+ * @internal
+ */
+export type _ValueAtPointer<T, P extends string> = _IsUnknown<T> extends true ? unknown : _ValueAtSegments<T, _SplitPointer<P>>;
+/**
+ * `true` iff `T` is exactly `unknown` (not `any`, not `never`).
+ * @internal
+ */
+export type _IsUnknown<T> = unknown extends T ? [T] extends [null | undefined] ? false : T extends unknown ? [unknown] extends [T] ? true : false : false : false;
+//# sourceMappingURL=value-at-pointer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"value-at-pointer.d.ts","sourceRoot":"","sources":["../../src/file-editor/value-at-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,2DAA2D;AAC3D,gBAAgB;AAChB,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC,EAAE,GAC7E,GAAG,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,GAC3B,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC,EAAE,GAChC,GAAG,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,GAC3B,CAAC,CAAC;AAER,qEAAqE;AACrE,gBAAgB;AAChB,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,EAAE,GACtD,EAAE,GACF,CAAC,SAAS,IAAI,MAAM,IAAI,EAAE,GACxB,UAAU,CAAC,IAAI,CAAC,GAChB,KAAK,CAAC;AAEZ,gBAAgB;AAChB,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GAC9E,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,GAC3C,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAExB;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,IAAI,CAAC,SAAS,SAAS,EAAE,GAChF,CAAC,GACD,CAAC,SAAS,SAAS,CAAC,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,MAAM,IAAI,SAAS,MAAM,EAAE,CAAC,GAC7E,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GACzB,OAAO,CAAC;AAEd,gBAAgB;AAChB,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,KAAK,SAAS,MAAM,EAAE,IAAI,SAAS,SAAS,MAAM,EAAE,IAE3E,CAAC,SAAS,SAAS,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,GACtC,KAAK,SAAS,MAAM,CAAC,GACnB,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAC7C,OAAO,GAET,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC5B,KAAK,SAAS,GAAG,MAAM,EAAE,GACvB,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,GACzB,OAAO,GAET,CAAC,SAAS,MAAM,GACd,KAAK,SAAS,MAAM,CAAC,GACnB,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAE7C,MAAM,SAAS,MAAM,CAAC,GACpB,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,GACxD,OAAO,GACX,OAAO,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAC7C,UAAU,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,OAAO,GAAG,gBAAgB,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,OAAO,SAAS,CAAC,GACzC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC,GAC5B,KAAK,GACL,CAAC,SAAS,OAAO,GACf,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GACnB,IAAI,GACJ,KAAK,GACP,KAAK,GACT,KAAK,CAAC"}