@gixcopilot/context 0.1.0

package/dist/context-registry.d.ts

@@ -0,0 +1,47 @@
+import type { ContextScope } from './context-scope.js';
+import type { ContextItemInput, ContextItemPatch, CopilotContextItem } from './context-item.js';
+/**
+ * A live handle returned by `register()` (Section 17). Prefer this over calling
+ * `registry.update(id, ...)`/`registry.remove(id)` directly - it is what a React hook's
+ * effect cleanup calls on unmount, and it fails loudly (not silently) once disposed.
+ */
+export interface ContextRegistration<T = unknown> {
+    readonly id: string;
+    /** Replace this item's value only, keeping every other field unchanged. */
+    update(value: T): void;
+    /** Merge a partial patch (value and/or metadata fields) into this item. */
+    patch(next: ContextItemPatch<T>): void;
+    /** Idempotent. Removes the item from the registry; safe to call more than once. */
+    dispose(): void;
+}
+export interface ContextFilter {
+    readonly scope?: ContextScope | readonly ContextScope[];
+    /** Defaults to `false` - `list()` returns disabled items too unless this is `true`. */
+    readonly enabledOnly?: boolean;
+}
+/**
+ * The central, framework-independent context registry (Section 16). One registry is one
+ * isolated universe of context items - a host application creates one per independent
+ * Copilot instance (Section 65); nothing here requires a global singleton.
+ */
+export interface ContextRegistry {
+    register<T>(input: ContextItemInput<T>): ContextRegistration<T>;
+    update<T>(id: string, value: T): void;
+    patch<T>(id: string, next: ContextItemPatch<T>): void;
+    remove(id: string): void;
+    get(id: string): CopilotContextItem | undefined;
+    list(filter?: ContextFilter): readonly CopilotContextItem[];
+    subscribe(listener: () => void): () => void;
+    /** Removes every item. Primarily for provider teardown/tests. */
+    clear(): void;
+}
+/**
+ * Identity/deduplication rule (Section 18), chosen and documented deterministically: an
+ * explicit `id` is an update-in-place key - registering the same `id` twice replaces the
+ * existing item rather than creating a second one. Omitting `id` always creates a new item
+ * with a generated id, even if `name` collides with an existing item - registration never
+ * merges by name alone, which would be a fuzzy/implicit rule (Section 24 makes the same
+ * choice for near-duplicate *values* found later, at resolve time).
+ */
+export declare function createContextRegistry(): ContextRegistry;
+//# sourceMappingURL=context-registry.d.ts.map

package/dist/context-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-registry.d.ts","sourceRoot":"","sources":["../src/context-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAE3B;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACvC,mFAAmF;IACnF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,CAAC;IACxD,uFAAuF;IACvF,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,kBAAkB,EAAE,CAAC;IAC5D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,iEAAiE;IACjE,KAAK,IAAI,IAAI,CAAC;CACf;AAQD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAgHvD"}

package/dist/context-registry.js

@@ -0,0 +1,130 @@
+import { CopilotError } from '@gixcopilot/protocol';
+import { DEFAULT_CONTEXT_PRIORITY } from './context-priority.js';
+import { DEFAULT_CONTEXT_SENSITIVITY } from './context-sensitivity.js';
+function matchesScope(item, filter) {
+    if (!filter?.scope)
+        return true;
+    const scopes = Array.isArray(filter.scope) ? filter.scope : [filter.scope];
+    return scopes.includes(item.scope);
+}
+/**
+ * Identity/deduplication rule (Section 18), chosen and documented deterministically: an
+ * explicit `id` is an update-in-place key - registering the same `id` twice replaces the
+ * existing item rather than creating a second one. Omitting `id` always creates a new item
+ * with a generated id, even if `name` collides with an existing item - registration never
+ * merges by name alone, which would be a fuzzy/implicit rule (Section 24 makes the same
+ * choice for near-duplicate *values* found later, at resolve time).
+ */
+export function createContextRegistry() {
+    const items = new Map();
+    const listeners = new Set();
+    function notify() {
+        for (const listener of listeners)
+            listener();
+    }
+    function requireName(name) {
+        if (!name.trim()) {
+            throw CopilotError.validation('A context item requires a non-empty name.');
+        }
+    }
+    function store(id, input) {
+        requireName(input.name);
+        const item = {
+            id,
+            name: input.name,
+            description: input.description,
+            scope: input.scope,
+            value: input.value,
+            priority: input.priority ?? DEFAULT_CONTEXT_PRIORITY,
+            sensitivity: input.sensitivity ?? DEFAULT_CONTEXT_SENSITIVITY,
+            enabled: input.enabled ?? true,
+            owner: input.owner,
+            metadata: input.metadata,
+        };
+        items.set(id, item);
+        return item;
+    }
+    function registerInternal(input) {
+        const id = input.id ?? crypto.randomUUID();
+        store(id, input);
+        notify();
+        let disposed = false;
+        return {
+            id,
+            update(value) {
+                if (disposed)
+                    return;
+                registryUpdate(id, value);
+            },
+            patch(next) {
+                if (disposed)
+                    return;
+                registryPatch(id, next);
+            },
+            dispose() {
+                if (disposed)
+                    return;
+                disposed = true;
+                registryRemove(id);
+            },
+        };
+    }
+    function registryUpdate(id, value) {
+        const existing = items.get(id);
+        if (!existing) {
+            throw CopilotError.validation('No context item registered with that id.', { id });
+        }
+        items.set(id, { ...existing, value });
+        notify();
+    }
+    function registryPatch(id, next) {
+        const existing = items.get(id);
+        if (!existing) {
+            throw CopilotError.validation('No context item registered with that id.', { id });
+        }
+        if (next.name !== undefined)
+            requireName(next.name);
+        items.set(id, {
+            ...existing,
+            ...(next.name !== undefined ? { name: next.name } : {}),
+            ...(next.description !== undefined ? { description: next.description } : {}),
+            ...(next.scope !== undefined ? { scope: next.scope } : {}),
+            ...(next.value !== undefined ? { value: next.value } : {}),
+            ...(next.priority !== undefined ? { priority: next.priority } : {}),
+            ...(next.sensitivity !== undefined ? { sensitivity: next.sensitivity } : {}),
+            ...(next.enabled !== undefined ? { enabled: next.enabled } : {}),
+            ...(next.owner !== undefined ? { owner: next.owner } : {}),
+            ...(next.metadata !== undefined ? { metadata: next.metadata } : {}),
+        });
+        notify();
+    }
+    function registryRemove(id) {
+        if (items.delete(id))
+            notify();
+    }
+    return {
+        register: registerInternal,
+        update: registryUpdate,
+        patch: registryPatch,
+        remove: registryRemove,
+        get: (id) => items.get(id),
+        list: (filter) => Array.from(items.values()).filter((item) => {
+            if (filter?.enabledOnly && !item.enabled)
+                return false;
+            return matchesScope(item, filter);
+        }),
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        clear() {
+            if (items.size === 0)
+                return;
+            items.clear();
+            notify();
+        },
+    };
+}
+//# sourceMappingURL=context-registry.js.map

package/dist/context-registry.js.map

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

package/dist/context-scope.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The lifetime/origin classification of a context item. Each scope carries its own
+ * semantics (Sections 8-15) rather than being an implicit convention:
+ *
+ *  - `global`      - company/product-wide terminology or instructions. Rare; not a dumping
+ *                    ground for everything an application knows.
+ *  - `user`        - the current authenticated user (id, locale, role names, preferences).
+ *                    Treat as untrusted-for-authorization, not just untrusted-for-injection.
+ *  - `application` - the hosting application/module/workspace/business domain.
+ *  - `page`        - the current route, page type, current entity, visible filters/dataset.
+ *  - `component`   - focused information a single mounted component chooses to expose.
+ *  - `session`     - short-lived workflow state (current wizard step, current search) - not
+ *                    durable AI memory (that is a later phase's concern).
+ *  - `temporary`   - very short-lived transient state (open modal, hovered/selected object).
+ */
+export type ContextScope = 'global' | 'user' | 'application' | 'page' | 'component' | 'session' | 'temporary';
+export declare const CONTEXT_SCOPES: readonly ContextScope[];
+export declare function isContextScope(value: unknown): value is ContextScope;
+//# sourceMappingURL=context-scope.d.ts.map

package/dist/context-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-scope.d.ts","sourceRoot":"","sources":["../src/context-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,MAAM,GACN,aAAa,GACb,MAAM,GACN,WAAW,GACX,SAAS,GACT,WAAW,CAAC;AAEhB,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAQjD,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/context-scope.js

@@ -0,0 +1,13 @@
+export const CONTEXT_SCOPES = [
+    'global',
+    'user',
+    'application',
+    'page',
+    'component',
+    'session',
+    'temporary',
+];
+export function isContextScope(value) {
+    return typeof value === 'string' && CONTEXT_SCOPES.includes(value);
+}
+//# sourceMappingURL=context-scope.js.map

package/dist/context-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-scope.js","sourceRoot":"","sources":["../src/context-scope.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,QAAQ;IACR,MAAM;IACN,aAAa;IACb,MAAM;IACN,WAAW;IACX,SAAS;IACT,WAAW;CACZ,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5F,CAAC"}

package/dist/context-sensitivity.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Context sensitivity metadata (Section 30). This is metadata/foundation only - Phase 7
+ * owns the full enterprise security/PII policy system (see the security skill). The default
+ * engine policy (Section 27, `context-engine.ts`) uses this only to exclude `restricted`
+ * items by default; it is not an authorization mechanism and must never be treated as one.
+ */
+export type ContextSensitivity = 'public' | 'internal' | 'sensitive' | 'restricted';
+export declare const CONTEXT_SENSITIVITIES: readonly ContextSensitivity[];
+export declare const DEFAULT_CONTEXT_SENSITIVITY: ContextSensitivity;
+export declare function isContextSensitivity(value: unknown): value is ContextSensitivity;
+//# sourceMappingURL=context-sensitivity.d.ts.map

package/dist/context-sensitivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-sensitivity.d.ts","sourceRoot":"","sources":["../src/context-sensitivity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;AAEpF,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAK9D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,kBAA+B,CAAC;AAE1E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF"}

package/dist/context-sensitivity.js

@@ -0,0 +1,11 @@
+export const CONTEXT_SENSITIVITIES = [
+    'public',
+    'internal',
+    'sensitive',
+    'restricted',
+];
+export const DEFAULT_CONTEXT_SENSITIVITY = 'internal';
+export function isContextSensitivity(value) {
+    return typeof value === 'string' && CONTEXT_SENSITIVITIES.includes(value);
+}
+//# sourceMappingURL=context-sensitivity.js.map

package/dist/context-sensitivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-sensitivity.js","sourceRoot":"","sources":["../src/context-sensitivity.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,qBAAqB,GAAkC;IAClE,QAAQ;IACR,UAAU;IACV,WAAW;IACX,YAAY;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAuB,UAAU,CAAC;AAE1E,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,qBAA2C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnG,CAAC"}

package/dist/context-serializer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The controlled serialization boundary application objects must pass through before
+ * reaching a model (Section 21). Never `JSON.stringify` an arbitrary application object
+ * directly - this module is the single place that decides what is safe to include and what
+ * gets normalized/omitted, with every decision recorded as a warning rather than silently
+ * dropped (Section 60, 69).
+ */
+export interface ContextSerializerOptions {
+    /** Longest a single string value may be before truncation. Default 2000. */
+    readonly maxStringLength?: number;
+    /** Longest an array may be before truncation. Default 50. */
+    readonly maxArrayLength?: number;
+    /** Deepest an object/array may nest before being cut off. Default 6. */
+    readonly maxDepth?: number;
+}
+export interface SerializedValue {
+    /** Stable, pretty-printed JSON text - the model-facing representation of the value. */
+    readonly text: string;
+    /** True if any string/array/depth limit was applied while producing `text`. */
+    readonly truncated: boolean;
+    /** Human-readable notes on what was normalized or omitted, e.g. `'function-omitted'`. */
+    readonly warnings: readonly string[];
+}
+export interface ContextSerializer {
+    serialize(value: unknown): SerializedValue;
+}
+/**
+ * The default, dependency-free serializer. Handles `undefined`, `Date`, `bigint`, circular
+ * references, functions, DOM-like nodes, class instances, and oversized strings/arrays
+ * deterministically (Section 21, 69) rather than throwing or producing invalid JSON.
+ */
+export declare function createDefaultContextSerializer(options?: ContextSerializerOptions): ContextSerializer;
+//# sourceMappingURL=context-serializer.d.ts.map

package/dist/context-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-serializer.d.ts","sourceRoot":"","sources":["../src/context-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAAC;CAC5C;AAuGD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAoBnB"}

package/dist/context-serializer.js

@@ -0,0 +1,112 @@
+const TRUNCATION_MARKER = '…(truncated)';
+function isPlainObject(value) {
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+function looksLikeDomNode(value) {
+    return 'nodeType' in value && typeof value.nodeType === 'number';
+}
+function truncateString(value, state) {
+    if (value.length <= state.maxStringLength)
+        return value;
+    state.truncated = true;
+    state.warnings.push('string-truncated');
+    return value.slice(0, state.maxStringLength) + TRUNCATION_MARKER;
+}
+function toSafe(value, depth, state) {
+    if (value === undefined)
+        return undefined;
+    if (value === null)
+        return null;
+    const type = typeof value;
+    if (type === 'string')
+        return truncateString(value, state);
+    if (type === 'number' || type === 'boolean')
+        return value;
+    if (type === 'bigint')
+        return `${value.toString()}n`;
+    if (type === 'function') {
+        state.warnings.push('function-omitted');
+        return '[Function omitted]';
+    }
+    if (type === 'symbol') {
+        state.warnings.push('symbol-omitted');
+        return '[Symbol omitted]';
+    }
+    // type === 'object' from here on - TS narrows `value` via the `type` alias above.
+    const obj = value;
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (value instanceof RegExp) {
+        return value.toString();
+    }
+    if (looksLikeDomNode(obj)) {
+        state.warnings.push('dom-node-omitted');
+        return '[DOM node omitted]';
+    }
+    if (state.ancestors.includes(value)) {
+        state.warnings.push('circular-reference');
+        return '[Circular]';
+    }
+    if (depth >= state.maxDepth) {
+        state.truncated = true;
+        state.warnings.push('max-depth-exceeded');
+        return '[MaxDepthExceeded]';
+    }
+    state.ancestors.push(value);
+    try {
+        if (Array.isArray(value)) {
+            const limited = value.length > state.maxArrayLength;
+            if (limited) {
+                state.truncated = true;
+                state.warnings.push('array-truncated');
+            }
+            const items = limited ? value.slice(0, state.maxArrayLength) : value;
+            return items.map((item) => toSafe(item, depth + 1, state));
+        }
+        if (typeof obj.toJSON === 'function') {
+            const toJSON = obj.toJSON.bind(obj);
+            return toSafe(toJSON(), depth + 1, state);
+        }
+        if (!isPlainObject(obj)) {
+            state.warnings.push('class-instance-normalized');
+        }
+        const result = {};
+        for (const [key, entryValue] of Object.entries(obj)) {
+            const safeEntry = toSafe(entryValue, depth + 1, state);
+            if (safeEntry !== undefined)
+                result[key] = safeEntry;
+        }
+        return result;
+    }
+    finally {
+        state.ancestors.pop();
+    }
+}
+/**
+ * The default, dependency-free serializer. Handles `undefined`, `Date`, `bigint`, circular
+ * references, functions, DOM-like nodes, class instances, and oversized strings/arrays
+ * deterministically (Section 21, 69) rather than throwing or producing invalid JSON.
+ */
+export function createDefaultContextSerializer(options = {}) {
+    const maxStringLength = options.maxStringLength ?? 2000;
+    const maxArrayLength = options.maxArrayLength ?? 50;
+    const maxDepth = options.maxDepth ?? 6;
+    return {
+        serialize(value) {
+            const state = {
+                maxStringLength,
+                maxArrayLength,
+                maxDepth,
+                warnings: [],
+                truncated: false,
+                ancestors: [],
+            };
+            const safe = toSafe(value, 0, state);
+            const text = safe === undefined ? 'null' : JSON.stringify(safe, null, 2);
+            return { text, truncated: state.truncated, warnings: state.warnings };
+        },
+    };
+}
+//# sourceMappingURL=context-serializer.js.map

package/dist/context-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-serializer.js","sourceRoot":"","sources":["../src/context-serializer.ts"],"names":[],"mappings":"AA6BA,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAkB,CAAC;IAC5D,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,UAAU,IAAI,KAAK,IAAI,OAAQ,KAAgC,CAAC,QAAQ,KAAK,QAAQ,CAAC;AAC/F,CAAC;AAWD,SAAS,cAAc,CAAC,KAAa,EAAE,KAAqB;IAC1D,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IACxD,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,iBAAiB,CAAC;AACnE,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,KAAa,EAAE,KAAqB;IAClE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;IAC1B,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC,KAAe,EAAE,KAAK,CAAC,CAAC;IACrE,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAI,KAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC;IACjE,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACxC,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACtC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,kFAAkF;IAClF,MAAM,GAAG,GAAG,KAAK,CAAC;IAElB,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACxC,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC1C,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC1C,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC;YACpD,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;gBACvB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACrE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,OAAQ,GAA4B,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/D,MAAM,MAAM,GAAI,GAAiC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnE,OAAO,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,SAAS,KAAK,SAAS;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;QACvD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC5C,UAAoC,EAAE;IAEtC,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IACxD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IAEvC,OAAO;QACL,SAAS,CAAC,KAAc;YACtB,MAAM,KAAK,GAAmB;gBAC5B,eAAe;gBACf,cAAc;gBACd,QAAQ;gBACR,QAAQ,EAAE,EAAE;gBACZ,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,EAAE;aACd,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACzE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACxE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export type { ContextScope } from './context-scope.js';
+export { CONTEXT_SCOPES, isContextScope } from './context-scope.js';
+export type { ContextPriority } from './context-priority.js';
+export { CONTEXT_PRIORITIES, DEFAULT_CONTEXT_PRIORITY, isContextPriority, priorityWeight, } from './context-priority.js';
+export type { ContextSensitivity } from './context-sensitivity.js';
+export { CONTEXT_SENSITIVITIES, DEFAULT_CONTEXT_SENSITIVITY, isContextSensitivity, } from './context-sensitivity.js';
+export type { ContextItemInput, ContextItemMetadata, ContextItemPatch, CopilotContextItem, } from './context-item.js';
+export type { ContextFilter, ContextRegistration, ContextRegistry } from './context-registry.js';
+export { createContextRegistry } from './context-registry.js';
+export type { ContextSerializer, ContextSerializerOptions, SerializedValue } from './context-serializer.js';
+export { createDefaultContextSerializer } from './context-serializer.js';
+export type { TokenEstimator } from './token-estimator.js';
+export { createDefaultTokenEstimator } from './token-estimator.js';
+export type { CompressibleText, ContextCompressor } from './context-compressor.js';
+export { createTruncatingCompressor } from './context-compressor.js';
+export { formatContextItemBlock, joinContextBlocks } from './context-format.js';
+export type { ContextDiagnostics, ContextExclusion, ContextExclusionReason, ContextInspection, ResolvedContext, ResolvedContextItem, } from './resolved-context.js';
+export type { ContextEngine, ContextEngineOptions } from './context-engine.js';
+export { createContextEngine } from './context-engine.js';
+export type { CopilotStateDefinition, CopilotStateStore, StateScope, StateValidationResult, StateValidator, } from './state-store.js';
+export { createCopilotStateStore } from './state-store.js';
+export type { StatePatch, StatePatchOp, StatePatchRejectionReason, StatePatchResult, } from './state-patch.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,YAAY,EACV,UAAU,EACV,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { CONTEXT_SCOPES, isContextScope } from './context-scope.js';
+export { CONTEXT_PRIORITIES, DEFAULT_CONTEXT_PRIORITY, isContextPriority, priorityWeight, } from './context-priority.js';
+export { CONTEXT_SENSITIVITIES, DEFAULT_CONTEXT_SENSITIVITY, isContextSensitivity, } from './context-sensitivity.js';
+export { createContextRegistry } from './context-registry.js';
+export { createDefaultContextSerializer } from './context-serializer.js';
+export { createDefaultTokenEstimator } from './token-estimator.js';
+export { createTruncatingCompressor } from './context-compressor.js';
+export { formatContextItemBlock, joinContextBlocks } from './context-format.js';
+export { createContextEngine } from './context-engine.js';
+export { createCopilotStateStore } from './state-store.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAGzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAYhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAS1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/resolved-context.d.ts

@@ -0,0 +1,64 @@
+import type { ContextPriority } from './context-priority.js';
+import type { ContextScope } from './context-scope.js';
+import type { ContextSensitivity } from './context-sensitivity.js';
+/**
+ * Why an otherwise-registered item did not make it into the resolved context (Section 35).
+ * Phase 4 does not implement every policy type this closed set anticipates (e.g. a real
+ * `sensitivity-policy` engine is Phase 7's), but the shape is stable so later phases add
+ * reasons additively rather than repurposing an existing one.
+ */
+export type ContextExclusionReason = 'disabled' | 'budget' | 'duplicate' | 'invalid' | 'sensitivity-policy' | 'serialization-failure';
+export interface ContextExclusion {
+    readonly id: string;
+    readonly name: string;
+    readonly scope: ContextScope;
+    readonly reason: ContextExclusionReason;
+    readonly detail?: string;
+}
+/** One included item, formatted and budgeted (Section 22, 34). */
+export interface ResolvedContextItem {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly scope: ContextScope;
+    readonly priority: ContextPriority;
+    readonly sensitivity: ContextSensitivity;
+    readonly estimatedTokens: number;
+    readonly truncated: boolean;
+    /** The formatted `[Context: name] ...` block for this item alone (Section 22). */
+    readonly text: string;
+}
+/** Lightweight observability counters for one resolution pass (Section 62). */
+export interface ContextDiagnostics {
+    readonly itemsRegistered: number;
+    readonly itemsIncluded: number;
+    readonly itemsExcluded: number;
+    readonly resolutionMs: number;
+}
+/** The output of `ContextEngine.resolve()` - everything needed to build a model request. */
+export interface ResolvedContext {
+    readonly items: readonly ResolvedContextItem[];
+    /** All included items' `text`, joined - ready to place into a model request (Section 33). */
+    readonly content: string;
+    readonly estimatedTokens: number;
+    readonly excluded: readonly ContextExclusion[];
+    readonly diagnostics: ContextDiagnostics;
+}
+/** The debug-friendly projection `ContextEngine.inspect()` returns (Section 57, 90). */
+export interface ContextInspection {
+    readonly estimatedTokens: number;
+    readonly included: readonly {
+        readonly name: string;
+        readonly scope: ContextScope;
+        readonly priority: ContextPriority;
+        readonly estimatedTokens: number;
+        readonly truncated: boolean;
+    }[];
+    readonly excluded: readonly {
+        readonly name: string;
+        readonly scope: ContextScope;
+        readonly reason: ContextExclusionReason;
+    }[];
+    readonly diagnostics: ContextDiagnostics;
+}
+//# sourceMappingURL=resolved-context.d.ts.map

package/dist/resolved-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-context.d.ts","sourceRoot":"","sources":["../src/resolved-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,QAAQ,GACR,WAAW,GACX,SAAS,GACT,oBAAoB,GACpB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAC1C;AAED,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;QACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;KAC7B,EAAE,CAAC;IACJ,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;QAC7B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;KACzC,EAAE,CAAC;IACJ,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAC1C"}

package/dist/resolved-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolved-context.js.map

package/dist/resolved-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-context.js","sourceRoot":"","sources":["../src/resolved-context.ts"],"names":[],"mappings":""}

package/dist/state-patch.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The provider-neutral shared-state patch contract (Section 41-42 of the Phase 6 brief).
+ * Deliberately smaller than the brief's own illustrative RFC 6902-flavored sample
+ * (`{ op: 'replace', path: '/status', value: ... }`): a state slot already holds one typed
+ * value, so "replace one field" only ever needs two operations - `'set'` (replace the whole
+ * value) and `'merge'` (shallow-merge a partial object into the current value) - not a
+ * general JSON-Pointer path language, which Section 42 explicitly warns against
+ * ("avoid an excessively powerful expression language"). See
+ * `docs/adr/0011-generative-ui-and-state-patch-architecture.md`.
+ */
+export type StatePatchOp = 'set' | 'merge';
+export interface StatePatch {
+    readonly op: StatePatchOp;
+    readonly value: unknown;
+}
+export type StatePatchRejectionReason = 'unknown-state' | 'not-writable' | 'invalid-value' | 'invalid-patch';
+/**
+ * The outcome of `CopilotStateStore.applyPatch()` (Section 43, 45-46). A discriminated
+ * union so a caller (typically the reserved state-patch tool a writable state slot
+ * auto-registers - see `@gixcopilot/generative-ui`) can distinguish "stale revision, safe to
+ * retry with the current value" from "rejected outright" without parsing a message string.
+ */
+export type StatePatchResult = {
+    readonly status: 'applied';
+    readonly revision: number;
+    readonly value: unknown;
+} | {
+    readonly status: 'conflict';
+    readonly currentRevision: number;
+} | {
+    readonly status: 'rejected';
+    readonly reason: StatePatchRejectionReason;
+    readonly detail?: string;
+};
+//# sourceMappingURL=state-patch.d.ts.map

package/dist/state-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-patch.d.ts","sourceRoot":"","sources":["../src/state-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,yBAAyB,GACjC,eAAe,GACf,cAAc,GACd,eAAe,GACf,eAAe,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/state-patch.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state-patch.js.map

package/dist/state-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-patch.js","sourceRoot":"","sources":["../src/state-patch.ts"],"names":[],"mappings":""}