@cleocode/contracts 2026.5.130 → 2026.5.132

package/dist/__tests__/atomic-tools-contract.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Contract tests for the atomic-tool primitive contracts
+ * (`@cleocode/contracts/tools/atomic`, E3 · T11403).
+ *
+ * Pins the canonical tool taxonomy + primitive registry so the CORE SDK
+ * implementations (T11405-T11407) and the MCP catalog (T11411) bind to a stable
+ * shape.
+ *
+ * @epic T11390
+ * @task T11403
+ * @saga T11387
+ */
+export {};
+//# sourceMappingURL=atomic-tools-contract.test.d.ts.map

package/dist/__tests__/atomic-tools-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-tools-contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/atomic-tools-contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/__tests__/atomic-tools-contract.test.js

@@ -0,0 +1,55 @@
+/**
+ * Contract tests for the atomic-tool primitive contracts
+ * (`@cleocode/contracts/tools/atomic`, E3 · T11403).
+ *
+ * Pins the canonical tool taxonomy + primitive registry so the CORE SDK
+ * implementations (T11405-T11407) and the MCP catalog (T11411) bind to a stable
+ * shape.
+ *
+ * @epic T11390
+ * @task T11403
+ * @saga T11387
+ */
+import { describe, expect, it } from 'vitest';
+import { ATOMIC_TOOL_PRIMITIVES, TOOL_CLASSES, } from '../tools/atomic.js';
+describe('atomic-tool taxonomy', () => {
+    it('declares exactly the five canonical tool classes', () => {
+        expect([...TOOL_CLASSES]).toEqual(['fs', 'shell', 'search', 'net', 'notebook']);
+    });
+});
+describe('atomic-tool primitive registry', () => {
+    it('every primitive has a class in the taxonomy and is stateless', () => {
+        const classes = new Set(TOOL_CLASSES);
+        for (const p of ATOMIC_TOOL_PRIMITIVES) {
+            expect(classes.has(p.class)).toBe(true);
+            expect(p.stateless).toBe(true);
+            expect(p.name.length).toBeGreaterThan(0);
+            expect(p.responsibility.length).toBeGreaterThan(0);
+        }
+    });
+    it('primitive names are unique', () => {
+        const names = ATOMIC_TOOL_PRIMITIVES.map((p) => p.name);
+        expect(new Set(names).size).toBe(names.length);
+    });
+    it('covers each class with at least one primitive', () => {
+        const covered = new Set(ATOMIC_TOOL_PRIMITIVES.map((p) => p.class));
+        for (const c of TOOL_CLASSES) {
+            expect(covered.has(c)).toBe(true);
+        }
+    });
+    it('includes the canonical fs + shell primitives', () => {
+        const names = new Set(ATOMIC_TOOL_PRIMITIVES.map((p) => p.name));
+        for (const n of ['readFileText', 'writeFileAtomic', 'executeShell', 'runGit']) {
+            expect(names.has(n)).toBe(true);
+        }
+    });
+});
+describe('atomic-tool I/O contracts (type-level)', () => {
+    it('a ReadFile round-trip is well-typed', () => {
+        const input = { path: '/abs/file.ts' };
+        const result = { path: input.path, content: 'hello' };
+        expect(result.path).toBe('/abs/file.ts');
+        expect(result.content).toBe('hello');
+    });
+});
+//# sourceMappingURL=atomic-tools-contract.test.js.map

package/dist/__tests__/atomic-tools-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-tools-contract.test.js","sourceRoot":"","sources":["../../src/__tests__/atomic-tools-contract.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/gateway-contract.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Contract snapshot + validation tests for the promoted gateway contract
+ * (`@cleocode/contracts/gateway`).
+ *
+ * The gateway contract is the transport-agnostic CQRS dispatch shape that every
+ * adapter (CLI, MCP, RPC, HTTP) shares. These tests pin:
+ *   - the frozen contract version + the four canonical transport sources,
+ *   - the zod schemas' accepted/rejected inputs at the (untrusted) transport
+ *     boundary (AC8 — the reason the contract is zod-typed),
+ *   - the public field shape of each schema as a snapshot, so an accidental
+ *     add/remove/rename of a request/response field fails loudly.
+ *
+ * @epic T4820
+ * @task T11446
+ * @saga T11243
+ */
+export {};
+//# sourceMappingURL=gateway-contract.test.d.ts.map

package/dist/__tests__/gateway-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/gateway-contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/gateway-contract.test.js

@@ -0,0 +1,187 @@
+/**
+ * Contract snapshot + validation tests for the promoted gateway contract
+ * (`@cleocode/contracts/gateway`).
+ *
+ * The gateway contract is the transport-agnostic CQRS dispatch shape that every
+ * adapter (CLI, MCP, RPC, HTTP) shares. These tests pin:
+ *   - the frozen contract version + the four canonical transport sources,
+ *   - the zod schemas' accepted/rejected inputs at the (untrusted) transport
+ *     boundary (AC8 — the reason the contract is zod-typed),
+ *   - the public field shape of each schema as a snapshot, so an accidental
+ *     add/remove/rename of a request/response field fails loudly.
+ *
+ * @epic T4820
+ * @task T11446
+ * @saga T11243
+ */
+import { describe, expect, it } from 'vitest';
+import { dispatchErrorSchema, dispatchRequestSchema, dispatchResponseMetaSchema, dispatchResponseSchema, GATEWAY_CONTRACT_VERSION, GATEWAY_SOURCES, gatewaySourceSchema, gatewayStreamEventSchema, } from '../gateway.js';
+describe('gateway contract — version + sources', () => {
+    it('pins the frozen contract version', () => {
+        expect(GATEWAY_CONTRACT_VERSION).toBe('1.0.0');
+    });
+    it('declares exactly the four canonical transports', () => {
+        expect([...GATEWAY_SOURCES]).toEqual(['cli', 'mcp', 'rpc', 'http']);
+    });
+    it('accepts every canonical transport and rejects unknown ones', () => {
+        for (const s of GATEWAY_SOURCES) {
+            expect(gatewaySourceSchema.safeParse(s).success).toBe(true);
+        }
+        expect(gatewaySourceSchema.safeParse('telepathy').success).toBe(false);
+        expect(gatewaySourceSchema.safeParse('dispatch').success).toBe(false);
+    });
+});
+describe('gateway contract — request validation (transport boundary)', () => {
+    const minimal = {
+        gateway: 'query',
+        domain: 'tasks',
+        operation: 'list',
+        source: 'mcp',
+        requestId: 'req_1',
+    };
+    it('validates a minimal well-formed request', () => {
+        expect(dispatchRequestSchema.safeParse(minimal).success).toBe(true);
+    });
+    it('validates a fully-populated request', () => {
+        const full = {
+            ...minimal,
+            params: { parent: 'T1' },
+            sessionId: 'ses_1',
+            originSessionId: 'ses_0',
+            executionSessionId: 'exe_1',
+            _fields: ['/data/id'],
+            _mvi: 'standard',
+        };
+        expect(dispatchRequestSchema.safeParse(full).success).toBe(true);
+    });
+    it('rejects a request missing required fields', () => {
+        expect(dispatchRequestSchema.safeParse({ domain: 'tasks' }).success).toBe(false);
+    });
+    it('rejects an out-of-range _mvi level', () => {
+        expect(dispatchRequestSchema.safeParse({ ...minimal, _mvi: 'verbose' }).success).toBe(false);
+    });
+    it('rejects an unknown transport source', () => {
+        expect(dispatchRequestSchema.safeParse({ ...minimal, source: 'ftp' }).success).toBe(false);
+    });
+});
+describe('gateway contract — response + error + stream shapes', () => {
+    it('validates a success response (meta passthrough preserved)', () => {
+        const res = {
+            meta: {
+                gateway: 'query',
+                domain: 'tasks',
+                operation: 'list',
+                timestamp: '2026-05-30T00:00:00.000Z',
+                duration_ms: 1,
+                source: 'cli',
+                requestId: 'req_1',
+                // extensible metadata via catchall:
+                gateInfo: { passed: true },
+            },
+            success: true,
+            data: { tasks: [] },
+        };
+        expect(dispatchResponseSchema.safeParse(res).success).toBe(true);
+    });
+    it('validates a structured error', () => {
+        const err = {
+            code: 'E_NOT_FOUND',
+            message: 'no such task',
+            exitCode: 4,
+            alternatives: [{ action: 'search', command: 'cleo find' }],
+        };
+        expect(dispatchErrorSchema.safeParse(err).success).toBe(true);
+    });
+    it('validates a stream event', () => {
+        expect(gatewayStreamEventSchema.safeParse({ kind: 'data', seq: 0, data: {}, requestId: 'req_1' })
+            .success).toBe(true);
+        expect(gatewayStreamEventSchema.safeParse({ kind: 'flush', seq: 0, requestId: 'r' }).success).toBe(false);
+    });
+});
+describe('gateway contract — field-shape snapshot (drift guard)', () => {
+    it('request fields are stable', () => {
+        expect(Object.keys(dispatchRequestSchema.shape).sort()).toMatchInlineSnapshot(`
+      [
+        "_fields",
+        "_mvi",
+        "domain",
+        "executionSessionId",
+        "gateway",
+        "operation",
+        "originSessionId",
+        "params",
+        "requestId",
+        "sessionId",
+        "source",
+      ]
+    `);
+    });
+    it('response fields are stable', () => {
+        expect(Object.keys(dispatchResponseSchema.shape).sort()).toMatchInlineSnapshot(`
+      [
+        "data",
+        "error",
+        "meta",
+        "page",
+        "partial",
+        "success",
+      ]
+    `);
+    });
+});
+// ─── gateway-contract v1.0 FREEZE (R3-T8 · T11452) ──────────────────────────
+// Locks the COMPLETE v1.0 contract surface (version + 4 transports + every
+// frozen shape's field set). Any change here is a breaking contract change and
+// REQUIRES a GATEWAY_CONTRACT_VERSION bump — mirrors the supervisor-ipc v1.0
+// freeze. The spec doc (slug `gateway-contract-v1`) is the human-readable SoT.
+describe('gateway-contract v1.0 FREEZE', () => {
+    it('version is pinned at 1.0.0', () => {
+        expect(GATEWAY_CONTRACT_VERSION).toBe('1.0.0');
+    });
+    it('the four transports are frozen', () => {
+        expect([...GATEWAY_SOURCES]).toEqual(['cli', 'mcp', 'rpc', 'http']);
+    });
+    it('error fields are frozen', () => {
+        expect(Object.keys(dispatchErrorSchema.shape).sort()).toMatchInlineSnapshot(`
+      [
+        "alternatives",
+        "code",
+        "details",
+        "exitCode",
+        "fix",
+        "message",
+        "problemDetails",
+      ]
+    `);
+    });
+    it('response meta fields are frozen (catchall preserves extensibility)', () => {
+        expect(Object.keys(dispatchResponseMetaSchema.shape).sort()).toMatchInlineSnapshot(`
+      [
+        "domain",
+        "duration_ms",
+        "executionSessionId",
+        "gateway",
+        "operation",
+        "originSessionId",
+        "rateLimit",
+        "requestId",
+        "sessionId",
+        "source",
+        "timestamp",
+        "version",
+      ]
+    `);
+    });
+    it('stream-event fields are frozen', () => {
+        expect(Object.keys(gatewayStreamEventSchema.shape).sort()).toMatchInlineSnapshot(`
+      [
+        "data",
+        "error",
+        "kind",
+        "requestId",
+        "seq",
+      ]
+    `);
+    });
+});
+//# sourceMappingURL=gateway-contract.test.js.map

package/dist/__tests__/gateway-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-contract.test.js","sourceRoot":"","sources":["../../src/__tests__/gateway-contract.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/mvi.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Type-shape + runtime contract test for the MVI progressive-disclosure
+ * primitive {@link MviDigest} (T11349 · Epic T11285 · Saga T11283).
+ *
+ * Asserts that the single `MviDigest<T>` shape unifies CLEO's three historical
+ * expansion-hint conventions (`_next`, `meta.suggestedNext`,
+ * `_nexus.suggestedNext`) and that each legacy producer can emit — and any
+ * consumer can read — a digest *without any `any` casts*. The `expectTypeOf`
+ * assertions are the tsd-style proof: if the discriminated union ever widens
+ * to `any`/`unknown` or loses a variant, these fail at type-check time.
+ *
+ * @epic T11285
+ * @task T11349
+ * @saga T11283
+ */
+export {};
+//# sourceMappingURL=mvi.test.d.ts.map

package/dist/__tests__/mvi.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvi.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mvi.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/__tests__/mvi.test.js

@@ -0,0 +1,147 @@
+/**
+ * Type-shape + runtime contract test for the MVI progressive-disclosure
+ * primitive {@link MviDigest} (T11349 · Epic T11285 · Saga T11283).
+ *
+ * Asserts that the single `MviDigest<T>` shape unifies CLEO's three historical
+ * expansion-hint conventions (`_next`, `meta.suggestedNext`,
+ * `_nexus.suggestedNext`) and that each legacy producer can emit — and any
+ * consumer can read — a digest *without any `any` casts*. The `expectTypeOf`
+ * assertions are the tsd-style proof: if the discriminated union ever widens
+ * to `any`/`unknown` or loses a variant, these fail at type-check time.
+ *
+ * @epic T11285
+ * @task T11349
+ * @saga T11283
+ */
+import { describe, expect, expectTypeOf, it } from 'vitest';
+import { expansionFromNextDirectives, expansionFromStructuredOps, expansionFromSuggestedCommands, isNextDirectivesHint, isStructuredOpsHint, isSuggestedCommandsHint, } from '../mvi.js';
+describe('MviDigest<T> shape (T11349)', () => {
+    it('has the canonical {summary, count, preview?, expand} fields', () => {
+        const digest = {
+            summary: '12 child tasks (3 done, 9 pending)',
+            count: 12,
+            preview: [{ id: 'T1' }, { id: 'T2' }],
+            expand: { kind: 'next-directives', directives: { all: 'cleo list --parent T0' } },
+        };
+        expect(digest.count).toBe(12);
+        expect(digest.preview).toHaveLength(2);
+        expect(digest.summary).toContain('child tasks');
+    });
+    it('preview is optional — a digest can describe an unsampled collection', () => {
+        const digest = {
+            summary: '40 memory entries',
+            count: 40,
+            expand: { kind: 'suggested-commands', commands: ['cleo memory find "x"'] },
+        };
+        expect(digest.preview).toBeUndefined();
+    });
+    it('summary/count/expand are required; preview is the only optional field', () => {
+        expectTypeOf().toHaveProperty('summary');
+        expectTypeOf().toHaveProperty('count');
+        expectTypeOf().toHaveProperty('expand');
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+});
+describe('ExpansionHint unifies the 3 legacy conventions (T11349)', () => {
+    it('reconciles `_next` (NextDirectives — Record<string,string>) without a cast', () => {
+        // The exact shape produced by core/src/mvi-helpers.ts taskShowNext().
+        const legacyNext = {
+            full: 'cleo show T042 --mvi full',
+            children: 'cleo find --parent T042',
+            deps: 'cleo deps T042',
+        };
+        const hint = expansionFromNextDirectives(legacyNext);
+        expectTypeOf(hint).toEqualTypeOf();
+        expect(hint.kind).toBe('next-directives');
+        expect(hint.directives.full).toBe('cleo show T042 --mvi full');
+    });
+    it('reconciles `meta.suggestedNext` (ReadonlyArray<string>) without a cast', () => {
+        // The exact shape produced by core/src/dispatch/suggested-next.ts builders.
+        const legacySuggested = ['cleo show T1', 'cleo focus T1'];
+        const hint = expansionFromSuggestedCommands(legacySuggested);
+        expectTypeOf(hint).toEqualTypeOf();
+        expect(hint.kind).toBe('suggested-commands');
+        expect(hint.commands).toEqual(['cleo show T1', 'cleo focus T1']);
+    });
+    it('reconciles `_nexus.suggestedNext` (ReadonlyArray<SuggestedNextOp>) without a cast', () => {
+        // The exact shape from contracts/operations/nexus-scope.ts NexusScopeMeta.
+        const legacyNexus = [
+            {
+                op: 'nexus.context',
+                args: { name: 'validateUser' },
+                scope: 'project',
+                effect: 'read',
+                requiresConfirmation: false,
+                reason: 'inspect callers before editing',
+            },
+        ];
+        const hint = expansionFromStructuredOps(legacyNexus);
+        expectTypeOf(hint).toEqualTypeOf();
+        expect(hint.kind).toBe('structured-ops');
+        expect(hint.ops[0]?.op).toBe('nexus.context');
+    });
+    it('is a discriminated union — `kind` narrows to each variant', () => {
+        const hints = [
+            expansionFromNextDirectives({ all: 'cleo list' }),
+            expansionFromSuggestedCommands(['cleo next']),
+            expansionFromStructuredOps([]),
+        ];
+        for (const hint of hints) {
+            if (isNextDirectivesHint(hint)) {
+                expectTypeOf(hint).toEqualTypeOf();
+                expect(typeof hint.directives).toBe('object');
+            }
+            else if (isSuggestedCommandsHint(hint)) {
+                expectTypeOf(hint).toEqualTypeOf();
+                expect(Array.isArray(hint.commands)).toBe(true);
+            }
+            else if (isStructuredOpsHint(hint)) {
+                expectTypeOf(hint).toEqualTypeOf();
+                expect(Array.isArray(hint.ops)).toBe(true);
+            }
+        }
+    });
+    it('the union has exactly three variants and never widens to `any`', () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+});
+describe('MviDigest carries any legacy hint as its expand field (T11349)', () => {
+    it('a tasks-list digest expands via NextDirectives', () => {
+        const digest = {
+            summary: '3 ready tasks',
+            count: 3,
+            preview: [{ id: 'T1' }],
+            expand: expansionFromNextDirectives({ all: 'cleo orchestrate ready --epic T0' }),
+        };
+        expect(isNextDirectivesHint(digest.expand)).toBe(true);
+    });
+    it('a mutate-op digest expands via suggested commands', () => {
+        const digest = {
+            summary: 'task created',
+            count: 1,
+            expand: expansionFromSuggestedCommands(['cleo show T9', 'cleo focus T9']),
+        };
+        expect(isSuggestedCommandsHint(digest.expand)).toBe(true);
+    });
+    it('a nexus digest expands via structured ops', () => {
+        const digest = {
+            summary: '5 affected symbols',
+            count: 5,
+            expand: expansionFromStructuredOps([
+                {
+                    op: 'nexus.impact',
+                    args: { target: 'x' },
+                    scope: 'project',
+                    effect: 'read',
+                    requiresConfirmation: false,
+                    reason: 'assess blast radius',
+                },
+            ]),
+        };
+        expect(isStructuredOpsHint(digest.expand)).toBe(true);
+    });
+});
+//# sourceMappingURL=mvi.test.js.map

package/dist/__tests__/mvi.test.js.map

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

package/dist/__tests__/operation-def.test.js

@@ -32,7 +32,7 @@ describe('dispatch/operation-def contracts', () => {
         expect(CANONICAL_DOMAINS.length).toBeGreaterThan(0);
         // T9954 — snapshot the current count so accidental additions/removals
         // trip this test and force an explicit human review.
-        expect(CANONICAL_DOMAINS.length).toBe(22);
+        expect(CANONICAL_DOMAINS.length).toBe(23);
     });
     it('CANONICAL_DOMAINS contains the four sentinel newly-promoted domains', () => {
         // Spot-check the canonical surface: T964 conduit, T1726 sentient/release,

package/dist/__tests__/operation-def.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"operation-def.test.js","sourceRoot":"","sources":["../../src/__tests__/operation-def.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operation-def.test.js","sourceRoot":"","sources":["../../src/__tests__/operation-def.test.ts"],"names":[],"mappings":"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"}

package/dist/boundary.d.ts

@@ -163,4 +163,30 @@ export interface BoundaryEntry {
  * @see ADR-078 — Boundary Registry as SSoT for Rust/TS layering
  */
 export declare const BOUNDARY_REGISTRY: readonly BoundaryEntry[];
+/**
+ * The canonical home-and-consumption boundary for the CORE-SDK tool layer.
+ *
+ * Atomic **tool primitives** (the smallest stateless side-effect units — see
+ * `@cleocode/contracts/tools/atomic` + `core/src/tools/*`) and their contracts
+ * have exactly the two homes in {@link AtomicToolBoundary.primitiveHomes}.
+ * **Composite skills** (multi-step capabilities that COMPOSE primitives) live
+ * in {@link AtomicToolBoundary.skillsHome}. The harness/provider packages in
+ * {@link AtomicToolBoundary.consumersNoRedefine} CONSUME the primitives via
+ * import and MUST NOT redefine them.
+ *
+ * Enforced (baseline mode) by `scripts/lint-tools-vs-skills-boundary.mjs`.
+ *
+ * @see ADR-078 — Boundary Registry
+ * @task T11409
+ */
+export interface AtomicToolBoundary {
+    /** The only packages that may DEFINE atomic-tool primitives + contracts. */
+    readonly primitiveHomes: readonly string[];
+    /** Composite, multi-step capabilities (compose primitives) live here. */
+    readonly skillsHome: string;
+    /** Consume primitives via import — MUST NOT redefine them. */
+    readonly consumersNoRedefine: readonly string[];
+}
+/** {@inheritDoc AtomicToolBoundary} */
+export declare const ATOMIC_TOOL_BOUNDARY: AtomicToolBoundary;
 //# sourceMappingURL=boundary.d.ts.map

package/dist/boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../src/boundary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,iBAAiB,GACjB,aAAa,GACb,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GACjB,UAAU,GACV,2BAA2B,GAC3B,mBAAmB,GACnB,cAAc,CAAC;AAMnB;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,uBAAuB,CAAC;IACrD;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,4BAA4B,CAAC;IACzD;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,GAAG,kBAAkB,CAAC;IAChD;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClD;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,qBAAqB,GACrB,yBAAyB,GACzB,UAAU,GACV;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAMzB;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,EAAE,cAAc,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,aAAa,EAAE,aAAa,CAAC;IAC7B,6DAA6D;IAC7D,UAAU,EAAE,UAAU,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,YAAY,CAAC;IAC3B,gHAAgH;IAChH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kGAAkG;IAClG,SAAS,EAAE,MAAM,CAAC;IAClB,wGAAwG;IACxG,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,aAAa,EA0pB5C,CAAC"}
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../src/boundary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,iBAAiB,GACjB,aAAa,GACb,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GACjB,UAAU,GACV,2BAA2B,GAC3B,mBAAmB,GACnB,cAAc,CAAC;AAMnB;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,uBAAuB,CAAC;IACrD;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,4BAA4B,CAAC;IACzD;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,GAAG,kBAAkB,CAAC;IAChD;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClD;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,qBAAqB,GACrB,yBAAyB,GACzB,UAAU,GACV;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAMzB;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,EAAE,cAAc,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,aAAa,EAAE,aAAa,CAAC;IAC7B,6DAA6D;IAC7D,UAAU,EAAE,UAAU,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,YAAY,CAAC;IAC3B,gHAAgH;IAChH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kGAAkG;IAClG,SAAS,EAAE,MAAM,CAAC;IAClB,wGAAwG;IACxG,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,aAAa,EA4rB5C,CAAC;AAMX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CACjD;AAED,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,EAAE,kBAIlC,CAAC"}