@dev-sergeev/datalab-kit 0.1.2 → 0.1.4

package/node_modules/@zigai/pi-extension-settings/dist/settings-layer.js

@@ -0,0 +1,98 @@
+import { Value } from "./typebox-runtime.js";
+import { isJsonObject, isJsonString, JsonValueSchema, parseJson, } from "./json-value.js";
+import { mergeSettings, settingsLayerFromFile } from "./settings-merge.js";
+export function settingsValidationIssues(schema, value) {
+    return [...Value.Errors(schema, value)].map((issue) => ({
+        path: issue.instancePath === "" ? "/" : issue.instancePath,
+        message: issue.message,
+    }));
+}
+export function parseSettingsLayer(path, scope, text, layerSchema) {
+    const parsed = parseJson(text);
+    if (parsed === undefined) {
+        return {
+            settings: undefined,
+            schemaReference: undefined,
+            diagnostics: [
+                {
+                    code: "config-malformed",
+                    severity: "error",
+                    scope,
+                    path,
+                    message: `${scope} settings contain malformed JSON and were ignored`,
+                },
+            ],
+        };
+    }
+    if (!Value.Check(layerSchema, parsed)) {
+        return {
+            settings: undefined,
+            schemaReference: undefined,
+            diagnostics: [
+                {
+                    code: "config-invalid",
+                    severity: "error",
+                    scope,
+                    path,
+                    message: `${scope} settings do not match the extension schema and were ignored`,
+                    issues: settingsValidationIssues(layerSchema, parsed),
+                },
+            ],
+        };
+    }
+    const schemaReference = isJsonObject(parsed) && isJsonString(parsed.$schema) ? parsed.$schema : undefined;
+    try {
+        const decoded = Value.Decode(layerSchema, parsed);
+        const decodedJson = Value.Parse(JsonValueSchema, decoded);
+        if (!isJsonObject(decodedJson)) {
+            return {
+                settings: undefined,
+                schemaReference,
+                diagnostics: [
+                    {
+                        code: "config-decode-failed",
+                        severity: "error",
+                        scope,
+                        path,
+                        message: `${scope} settings did not decode to a JSON object and were ignored`,
+                    },
+                ],
+            };
+        }
+        return { settings: settingsLayerFromFile(decodedJson), schemaReference, diagnostics: [] };
+    }
+    catch {
+        return {
+            settings: undefined,
+            schemaReference,
+            diagnostics: [
+                {
+                    code: "config-decode-failed",
+                    severity: "error",
+                    scope,
+                    path,
+                    message: `${scope} settings could not be decoded and were ignored`,
+                },
+            ],
+        };
+    }
+}
+export function applySettingsLayer(schema, current, layer, path, scope) {
+    if (layer.settings === undefined)
+        return { settings: current };
+    const merged = mergeSettings(current, layer.settings);
+    if (Value.Check(schema, merged))
+        return { settings: merged };
+    return {
+        settings: current,
+        diagnostic: {
+            code: "config-invalid",
+            severity: "error",
+            scope,
+            path,
+            message: `${scope} settings conflict with the resolved configuration and were ignored`,
+            issues: settingsValidationIssues(schema, merged),
+        },
+    };
+}
+//# sourceMappingURL=settings-layer.js.map

package/node_modules/@zigai/pi-extension-settings/dist/settings-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-layer.js","sourceRoot":"","sources":["../src/settings-layer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TObject, TSchema } from \"typebox\";\n\nimport { Value } from \"./typebox-runtime.ts\";\n\nimport {\n    isJsonObject,\n    isJsonString,\n    JsonValueSchema,\n    parseJson,\n    type JsonObject,\n    type JsonValue,\n} from \"./json-value.ts\";\nimport { mergeSettings, settingsLayerFromFile } from \"./settings-merge.ts\";\n\nexport type SettingsScope = \"global\" | \"project\";\n\n/**\n * Stable machine-readable category for a non-fatal settings problem.\n *\n * Callers should branch on this value rather than diagnostic text:\n *\n * - `bundled-schema-read-failed`: the generated schema could not be read.\n * - `bundled-schema-stale`: the bundled schema does not match the definition.\n * - `config-decode-failed`: a validated layer could not be decoded by TypeBox.\n * - `config-invalid`: a layer failed validation or conflicted with an earlier layer.\n * - `config-malformed`: a settings file contains malformed JSON.\n * - `config-read-failed`: a settings file could not be read.\n * - `config-scaffold-failed`: the initial global settings file could not be created.\n * - `schema-install-failed`: the editor schema could not be installed.\n */\nexport type SettingsDiagnosticCode =\n    | \"bundled-schema-read-failed\"\n    | \"bundled-schema-stale\"\n    | \"config-decode-failed\"\n    | \"config-invalid\"\n    | \"config-malformed\"\n    | \"config-read-failed\"\n    | \"config-scaffold-failed\"\n    | \"schema-install-failed\";\n\nexport type SettingsValidationIssue = {\n    /** JSON Pointer to the invalid setting, or `/` for the document root. */\n    readonly path: string;\n    /** TypeBox validation message for this issue. */\n    readonly message: string;\n};\n\n/**\n * A non-fatal problem encountered while loading settings.\n *\n * The affected schema or settings layer is ignored. Messages and validation issues contain no\n * settings values, making them suitable for display through Pi's UI.\n */\nexport type SettingsDiagnostic = {\n    /** Stable category intended for programmatic handling. */\n    readonly code: SettingsDiagnosticCode;\n    /** All current diagnostics are errors; the field allows direct use with `ctx.ui.notify`. */\n    readonly severity: \"error\";\n    /** The settings layer or editor-schema operation that failed. */\n    readonly scope: SettingsScope | \"schema\";\n    /** Absolute path of the affected settings or schema file. */\n    readonly path: string;\n    /** User-facing summary that does not include settings values. */\n    readonly message: string;\n    /** JSON Pointer paths and validator messages when schema validation failed. */\n    readonly issues?: readonly SettingsValidationIssue[];\n};\n\nexport type ParsedSettingsLayer = {\n    /** Encoded JSON settings after editor-only metadata is removed. */\n    readonly settings: JsonObject | undefined;\n    /** Editor schema reference from the file, when present and valid. */\n    readonly schemaReference: string | undefined;\n    readonly diagnostics: readonly SettingsDiagnostic[];\n};\n\nexport function settingsValidationIssues(\n    schema: TSchema,\n    value: JsonValue,\n): readonly SettingsValidationIssue[] {\n    return [...Value.Errors(schema, value)].map((issue) => ({\n        path: issue.instancePath === \"\" ? \"/\" : issue.instancePath,\n        message: issue.message,\n    }));\n}\n\nexport function parseSettingsLayer(\n    path: string,\n    scope: SettingsScope,\n    text: string,\n    layerSchema: TSchema,\n): ParsedSettingsLayer {\n    const parsed = parseJson(text);\n    if (parsed === undefined) {\n        return {\n            settings: undefined,\n            schemaReference: undefined,\n            diagnostics: [\n                {\n                    code: \"config-malformed\",\n                    severity: \"error\",\n                    scope,\n                    path,\n                    message: `${scope} settings contain malformed JSON and were ignored`,\n                },\n            ],\n        };\n    }\n\n    if (!Value.Check(layerSchema, parsed)) {\n        return {\n            settings: undefined,\n            schemaReference: undefined,\n            diagnostics: [\n                {\n                    code: \"config-invalid\",\n                    severity: \"error\",\n                    scope,\n                    path,\n                    message: `${scope} settings do not match the extension schema and were ignored`,\n                    issues: settingsValidationIssues(layerSchema, parsed),\n                },\n            ],\n        };\n    }\n\n    const schemaReference =\n        isJsonObject(parsed) && isJsonString(parsed.$schema) ? parsed.$schema : undefined;\n    try {\n        const decoded: unknown = Value.Decode(layerSchema, parsed);\n        const decodedJson = Value.Parse(JsonValueSchema, decoded);\n        if (!isJsonObject(decodedJson)) {\n            return {\n                settings: undefined,\n                schemaReference,\n                diagnostics: [\n                    {\n                        code: \"config-decode-failed\",\n                        severity: \"error\",\n                        scope,\n                        path,\n                        message: `${scope} settings did not decode to a JSON object and were ignored`,\n                    },\n                ],\n            };\n        }\n        return { settings: settingsLayerFromFile(decodedJson), schemaReference, diagnostics: [] };\n    } catch {\n        return {\n            settings: undefined,\n            schemaReference,\n            diagnostics: [\n                {\n                    code: \"config-decode-failed\",\n                    severity: \"error\",\n                    scope,\n                    path,\n                    message: `${scope} settings could not be decoded and were ignored`,\n                },\n            ],\n        };\n    }\n}\n\nexport type AppliedSettingsLayer = {\n    readonly settings: JsonObject;\n    readonly diagnostic?: SettingsDiagnostic;\n};\n\nexport function applySettingsLayer<Schema extends TObject>(\n    schema: Schema,\n    current: JsonObject,\n    layer: Pick<ParsedSettingsLayer, \"settings\">,\n    path: string,\n    scope: SettingsScope,\n): AppliedSettingsLayer {\n    if (layer.settings === undefined) return { settings: current };\n\n    const merged = mergeSettings(current, layer.settings);\n    if (Value.Check(schema, merged)) return { settings: merged };\n\n    return {\n        settings: current,\n        diagnostic: {\n            code: \"config-invalid\",\n            severity: \"error\",\n            scope,\n            path,\n            message: `${scope} settings conflict with the resolved configuration and were ignored`,\n            issues: settingsValidationIssues(schema, merged),\n        },\n    };\n}\n"]}

package/node_modules/@zigai/pi-extension-settings/dist/settings-loader.d.ts

@@ -0,0 +1,80 @@
+import type { StaticDecode, TObject } from "typebox";
+import type { ExtensionSettingsDefinition } from "./definition.ts";
+import { type JsonObject } from "./json-value.ts";
+import { type SettingsDiagnostic, type SettingsDiagnosticCode } from "./settings-layer.ts";
+import { type PiSettingsRevision } from "./settings-revision.ts";
+/**
+ * Source for the generated `config.schema.json` shipped with an extension.
+ *
+ * The content must exactly match the schema derived from the settings definition. A mismatch is
+ * reported as `bundled-schema-stale`, and neither the editor schema nor the initial global settings
+ * file is installed.
+ */
+export type BundledSchemaSource = {
+    /** Use schema text already loaded by the extension. */
+    readonly kind: "content";
+    /** Complete generated JSON Schema, including its trailing newline. */
+    readonly content: string;
+} | {
+    /** Read the schema synchronously from a bundled file URL. */
+    readonly kind: "url";
+    /** A `file:` URL, usually `new URL("../config.schema.json", import.meta.url)`. */
+    readonly url: URL;
+};
+export type ProjectSettingsLocation = {
+    readonly cwd: string;
+    readonly configDirName: string;
+    readonly trusted: boolean;
+};
+export type LoadSettingsOptions = {
+    readonly agentDir: string;
+    readonly bundledSchema: BundledSchemaSource;
+    readonly project?: ProjectSettingsLocation;
+};
+/**
+ * Result of resolving defaults, global settings, and an optional trusted-project override.
+ *
+ * File and validation failures are represented in {@link SettingsDiagnostic}; a failed layer is
+ * ignored and resolution continues from the last valid value.
+ *
+ * @template Schema The definition's TypeBox schema.
+ */
+export type LoadedSettings<Schema extends TObject> = {
+    /** Fully resolved and TypeBox-decoded settings safe for extension code to consume. */
+    readonly settings: StaticDecode<Schema>;
+    /** Accepted encoded global layer after removal of editor-only metadata. */
+    readonly globalSettingsLayer: JsonObject | undefined;
+    /** Accepted encoded trusted-project layer after removal of editor metadata. */
+    readonly projectSettingsLayer: JsonObject | undefined;
+    /** Non-fatal problems encountered while installing, reading, validating, or decoding settings. */
+    readonly diagnostics: readonly SettingsDiagnostic[];
+    /** Absolute path of the extension's global settings file. */
+    readonly globalConfigPath: string;
+    /** Absolute project settings path, even when the project is untrusted; absent without a project. */
+    readonly projectConfigPath: string | undefined;
+    /** Revision of the exact global settings source read during this load; absent after a read failure. */
+    readonly globalRevision: PiSettingsRevision | undefined;
+    /**
+     * Combined revision of the global and trusted-project sources read during this load.
+     *
+     * Absent when no project was supplied, the project is untrusted, or either source could not be
+     * read. A missing settings file still has a revision and is distinct from an unreadable file.
+     */
+    readonly projectRevision: PiSettingsRevision | undefined;
+    /** Whether a valid global layer contributed to {@link LoadedSettings.settings}. */
+    readonly usedGlobalConfig: boolean;
+    /** Whether a valid trusted-project layer contributed to {@link LoadedSettings.settings}. */
+    readonly usedProjectConfig: boolean;
+    /** Whether this load created the global settings file from schema defaults. */
+    readonly scaffoldedGlobalConfig: boolean;
+    /**
+     * Result of installing the bundled editor schema in Pi's global settings directory.
+     *
+     * `created` and `updated` indicate a write, `unchanged` means the installed file already
+     * matched, and `unavailable` means the bundled schema could not be verified or installed.
+     */
+    readonly schemaStatus: "created" | "unavailable" | "unchanged" | "updated";
+};
+export type { SettingsDiagnostic, SettingsDiagnosticCode };
+export declare function loadSettings<const Schema extends TObject>(definition: ExtensionSettingsDefinition<Schema>, options: LoadSettingsOptions): LoadedSettings<Schema>;
+//# sourceMappingURL=settings-loader.d.ts.map

package/node_modules/@zigai/pi-extension-settings/dist/settings-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-loader.d.ts","sourceRoot":"","sources":["../src/settings-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAW,MAAM,SAAS,CAAC;AAE9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAIH,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGzF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GACzB;IACI,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,GACD;IACI,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CACrB,CAAC;AAER,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CAC9C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,OAAO,IAAI;IACjD,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,mBAAmB,EAAE,UAAU,GAAG,SAAS,CAAC;IACrD,+EAA+E;IAC/E,QAAQ,CAAC,oBAAoB,EAAE,UAAU,GAAG,SAAS,CAAC;IACtD,kGAAkG;IAClG,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,oGAAoG;IACpG,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,uGAAuG;IACvG,QAAQ,CAAC,cAAc,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACxD;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACzD,mFAAmF;IACnF,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;CAC9E,CAAC;AAEF,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;AA4C3D,wBAAgB,YAAY,CAAC,KAAK,CAAC,MAAM,SAAS,OAAO,EACrD,UAAU,EAAE,2BAA2B,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,mBAAmB,GAC7B,cAAc,CAAC,MAAM,CAAC,CA8HxB"}

package/node_modules/@zigai/pi-extension-settings/dist/settings-loader.js

@@ -0,0 +1,144 @@
+import { readFileSync } from "node:fs";
+import { readTextIfPresent, writeTextAtomically, writeTextIfMissing } from "./file-system.js";
+import { formatJson } from "./json-value.js";
+import { resolveGlobalSettingsPaths, resolveProjectSettingsPaths } from "./paths.js";
+import { createDefaultSettingsDocument, createSettingsFileSchema } from "./schema-document.js";
+import { applySettingsLayer, parseSettingsLayer, } from "./settings-layer.js";
+import { createSettingsRevision } from "./settings-revision.js";
+import { Value } from "./typebox-runtime.js";
+function bundledSchemaContent(source) {
+    if (source.kind === "content")
+        return source.content;
+    try {
+        return readFileSync(source.url, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+function readLayer(path, scope, layerSchema) {
+    try {
+        const content = readTextIfPresent(path);
+        const parsed = content === undefined
+            ? { settings: undefined, schemaReference: undefined, diagnostics: [] }
+            : parseSettingsLayer(path, scope, content, layerSchema);
+        return { ...parsed, source: { status: "available", content } };
+    }
+    catch {
+        return {
+            settings: undefined,
+            diagnostics: [
+                {
+                    code: "config-read-failed",
+                    severity: "error",
+                    scope,
+                    path,
+                    message: `${scope} settings could not be read and were ignored`,
+                },
+            ],
+            schemaReference: undefined,
+            source: { status: "unavailable" },
+        };
+    }
+}
+export function loadSettings(definition, options) {
+    const diagnostics = [];
+    const globalPaths = resolveGlobalSettingsPaths(options.agentDir, definition.id);
+    const projectPaths = options.project === undefined
+        ? undefined
+        : resolveProjectSettingsPaths(options.project.cwd, options.project.configDirName, definition.id);
+    const layerSchema = createSettingsFileSchema(definition);
+    const expectedSchema = formatJson(layerSchema);
+    const sourceSchema = bundledSchemaContent(options.bundledSchema);
+    let schemaStatus = "unavailable";
+    let scaffoldedGlobalConfig = false;
+    if (sourceSchema === undefined) {
+        diagnostics.push({
+            code: "bundled-schema-read-failed",
+            severity: "error",
+            scope: "schema",
+            path: globalPaths.schemaPath,
+            message: "The bundled settings schema could not be read",
+        });
+    }
+    else if (sourceSchema !== expectedSchema) {
+        diagnostics.push({
+            code: "bundled-schema-stale",
+            severity: "error",
+            scope: "schema",
+            path: globalPaths.schemaPath,
+            message: "The bundled settings schema is stale; run the artifact generator",
+        });
+    }
+    else {
+        try {
+            schemaStatus = writeTextAtomically(globalPaths.schemaPath, sourceSchema);
+        }
+        catch {
+            diagnostics.push({
+                code: "schema-install-failed",
+                severity: "error",
+                scope: "schema",
+                path: globalPaths.schemaPath,
+                message: "The local editor schema could not be installed",
+            });
+        }
+        if (schemaStatus !== "unavailable") {
+            try {
+                scaffoldedGlobalConfig =
+                    writeTextIfMissing(globalPaths.configPath, () => formatJson(createDefaultSettingsDocument(definition))) === "created";
+            }
+            catch {
+                diagnostics.push({
+                    code: "config-scaffold-failed",
+                    severity: "error",
+                    scope: "global",
+                    path: globalPaths.configPath,
+                    message: "The default global settings file could not be scaffolded",
+                });
+            }
+        }
+    }
+    const globalLayer = readLayer(globalPaths.configPath, "global", layerSchema);
+    diagnostics.push(...globalLayer.diagnostics);
+    const globalApplied = applySettingsLayer(definition.schema, definition.defaultSettings, globalLayer, globalPaths.configPath, "global");
+    if (globalApplied.diagnostic !== undefined)
+        diagnostics.push(globalApplied.diagnostic);
+    let resolved = globalApplied.settings;
+    let projectSettingsLayer;
+    let usedProjectConfig = false;
+    let projectRevision;
+    if (projectPaths !== undefined && options.project?.trusted === true) {
+        const projectLayer = readLayer(projectPaths.configPath, "project", layerSchema);
+        diagnostics.push(...projectLayer.diagnostics);
+        const projectApplied = applySettingsLayer(definition.schema, resolved, projectLayer, projectPaths.configPath, "project");
+        if (projectApplied.diagnostic !== undefined)
+            diagnostics.push(projectApplied.diagnostic);
+        if (projectLayer.settings !== undefined && projectApplied.diagnostic === undefined) {
+            resolved = projectApplied.settings;
+            projectSettingsLayer = projectLayer.settings;
+            usedProjectConfig = true;
+        }
+        if (globalLayer.source.status === "available" &&
+            projectLayer.source.status === "available") {
+            projectRevision = createSettingsRevision(globalLayer.source.content, projectLayer.source.content);
+        }
+    }
+    return {
+        settings: Value.Decode(Value.Clone(definition.schema), resolved),
+        globalSettingsLayer: globalApplied.diagnostic === undefined ? globalLayer.settings : undefined,
+        projectSettingsLayer,
+        diagnostics,
+        globalConfigPath: globalPaths.configPath,
+        projectConfigPath: projectPaths?.configPath,
+        globalRevision: globalLayer.source.status === "available"
+            ? createSettingsRevision(globalLayer.source.content)
+            : undefined,
+        projectRevision,
+        usedGlobalConfig: globalLayer.settings !== undefined && globalApplied.diagnostic === undefined,
+        usedProjectConfig,
+        scaffoldedGlobalConfig,
+        schemaStatus,
+    };
+}
+//# sourceMappingURL=settings-loader.js.map

package/node_modules/@zigai/pi-extension-settings/dist/settings-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-loader.js","sourceRoot":"","sources":["../src/settings-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\n\nimport type { StaticDecode, TObject, TSchema } from \"typebox\";\n\nimport type { ExtensionSettingsDefinition } from \"./definition.ts\";\nimport { readTextIfPresent, writeTextAtomically, writeTextIfMissing } from \"./file-system.ts\";\nimport { formatJson, type JsonObject } from \"./json-value.ts\";\nimport { resolveGlobalSettingsPaths, resolveProjectSettingsPaths } from \"./paths.ts\";\nimport { createDefaultSettingsDocument, createSettingsFileSchema } from \"./schema-document.ts\";\nimport {\n    applySettingsLayer,\n    parseSettingsLayer,\n    type ParsedSettingsLayer,\n    type SettingsDiagnostic,\n    type SettingsDiagnosticCode,\n    type SettingsScope,\n} from \"./settings-layer.ts\";\nimport { createSettingsRevision, type PiSettingsRevision } from \"./settings-revision.ts\";\nimport { Value } from \"./typebox-runtime.ts\";\n\n/**\n * Source for the generated `config.schema.json` shipped with an extension.\n *\n * The content must exactly match the schema derived from the settings definition. A mismatch is\n * reported as `bundled-schema-stale`, and neither the editor schema nor the initial global settings\n * file is installed.\n */\nexport type BundledSchemaSource =\n    | {\n          /** Use schema text already loaded by the extension. */\n          readonly kind: \"content\";\n          /** Complete generated JSON Schema, including its trailing newline. */\n          readonly content: string;\n      }\n    | {\n          /** Read the schema synchronously from a bundled file URL. */\n          readonly kind: \"url\";\n          /** A `file:` URL, usually `new URL(\"../config.schema.json\", import.meta.url)`. */\n          readonly url: URL;\n      };\n\nexport type ProjectSettingsLocation = {\n    readonly cwd: string;\n    readonly configDirName: string;\n    readonly trusted: boolean;\n};\n\nexport type LoadSettingsOptions = {\n    readonly agentDir: string;\n    readonly bundledSchema: BundledSchemaSource;\n    readonly project?: ProjectSettingsLocation;\n};\n\n/**\n * Result of resolving defaults, global settings, and an optional trusted-project override.\n *\n * File and validation failures are represented in {@link SettingsDiagnostic}; a failed layer is\n * ignored and resolution continues from the last valid value.\n *\n * @template Schema The definition's TypeBox schema.\n */\nexport type LoadedSettings<Schema extends TObject> = {\n    /** Fully resolved and TypeBox-decoded settings safe for extension code to consume. */\n    readonly settings: StaticDecode<Schema>;\n    /** Accepted encoded global layer after removal of editor-only metadata. */\n    readonly globalSettingsLayer: JsonObject | undefined;\n    /** Accepted encoded trusted-project layer after removal of editor metadata. */\n    readonly projectSettingsLayer: JsonObject | undefined;\n    /** Non-fatal problems encountered while installing, reading, validating, or decoding settings. */\n    readonly diagnostics: readonly SettingsDiagnostic[];\n    /** Absolute path of the extension's global settings file. */\n    readonly globalConfigPath: string;\n    /** Absolute project settings path, even when the project is untrusted; absent without a project. */\n    readonly projectConfigPath: string | undefined;\n    /** Revision of the exact global settings source read during this load; absent after a read failure. */\n    readonly globalRevision: PiSettingsRevision | undefined;\n    /**\n     * Combined revision of the global and trusted-project sources read during this load.\n     *\n     * Absent when no project was supplied, the project is untrusted, or either source could not be\n     * read. A missing settings file still has a revision and is distinct from an unreadable file.\n     */\n    readonly projectRevision: PiSettingsRevision | undefined;\n    /** Whether a valid global layer contributed to {@link LoadedSettings.settings}. */\n    readonly usedGlobalConfig: boolean;\n    /** Whether a valid trusted-project layer contributed to {@link LoadedSettings.settings}. */\n    readonly usedProjectConfig: boolean;\n    /** Whether this load created the global settings file from schema defaults. */\n    readonly scaffoldedGlobalConfig: boolean;\n    /**\n     * Result of installing the bundled editor schema in Pi's global settings directory.\n     *\n     * `created` and `updated` indicate a write, `unchanged` means the installed file already\n     * matched, and `unavailable` means the bundled schema could not be verified or installed.\n     */\n    readonly schemaStatus: \"created\" | \"unavailable\" | \"unchanged\" | \"updated\";\n};\n\nexport type { SettingsDiagnostic, SettingsDiagnosticCode };\n\nfunction bundledSchemaContent(source: BundledSchemaSource): string | undefined {\n    if (source.kind === \"content\") return source.content;\n\n    try {\n        return readFileSync(source.url, \"utf8\");\n    } catch {\n        return undefined;\n    }\n}\n\ntype LayerSource =\n    | { readonly status: \"available\"; readonly content: string | undefined }\n    | { readonly status: \"unavailable\" };\n\ntype ReadSettingsLayer = ParsedSettingsLayer & { readonly source: LayerSource };\n\nfunction readLayer(path: string, scope: SettingsScope, layerSchema: TSchema): ReadSettingsLayer {\n    try {\n        const content = readTextIfPresent(path);\n        const parsed =\n            content === undefined\n                ? { settings: undefined, schemaReference: undefined, diagnostics: [] }\n                : parseSettingsLayer(path, scope, content, layerSchema);\n        return { ...parsed, source: { status: \"available\", content } };\n    } catch {\n        return {\n            settings: undefined,\n            diagnostics: [\n                {\n                    code: \"config-read-failed\",\n                    severity: \"error\",\n                    scope,\n                    path,\n                    message: `${scope} settings could not be read and were ignored`,\n                },\n            ],\n            schemaReference: undefined,\n            source: { status: \"unavailable\" },\n        };\n    }\n}\n\nexport function loadSettings<const Schema extends TObject>(\n    definition: ExtensionSettingsDefinition<Schema>,\n    options: LoadSettingsOptions,\n): LoadedSettings<Schema> {\n    const diagnostics: SettingsDiagnostic[] = [];\n    const globalPaths = resolveGlobalSettingsPaths(options.agentDir, definition.id);\n    const projectPaths =\n        options.project === undefined\n            ? undefined\n            : resolveProjectSettingsPaths(\n                  options.project.cwd,\n                  options.project.configDirName,\n                  definition.id,\n              );\n\n    const layerSchema = createSettingsFileSchema(definition);\n    const expectedSchema = formatJson(layerSchema);\n    const sourceSchema = bundledSchemaContent(options.bundledSchema);\n\n    let schemaStatus: LoadedSettings<Schema>[\"schemaStatus\"] = \"unavailable\";\n    let scaffoldedGlobalConfig = false;\n    if (sourceSchema === undefined) {\n        diagnostics.push({\n            code: \"bundled-schema-read-failed\",\n            severity: \"error\",\n            scope: \"schema\",\n            path: globalPaths.schemaPath,\n            message: \"The bundled settings schema could not be read\",\n        });\n    } else if (sourceSchema !== expectedSchema) {\n        diagnostics.push({\n            code: \"bundled-schema-stale\",\n            severity: \"error\",\n            scope: \"schema\",\n            path: globalPaths.schemaPath,\n            message: \"The bundled settings schema is stale; run the artifact generator\",\n        });\n    } else {\n        try {\n            schemaStatus = writeTextAtomically(globalPaths.schemaPath, sourceSchema);\n        } catch {\n            diagnostics.push({\n                code: \"schema-install-failed\",\n                severity: \"error\",\n                scope: \"schema\",\n                path: globalPaths.schemaPath,\n                message: \"The local editor schema could not be installed\",\n            });\n        }\n\n        if (schemaStatus !== \"unavailable\") {\n            try {\n                scaffoldedGlobalConfig =\n                    writeTextIfMissing(globalPaths.configPath, () =>\n                        formatJson(createDefaultSettingsDocument(definition)),\n                    ) === \"created\";\n            } catch {\n                diagnostics.push({\n                    code: \"config-scaffold-failed\",\n                    severity: \"error\",\n                    scope: \"global\",\n                    path: globalPaths.configPath,\n                    message: \"The default global settings file could not be scaffolded\",\n                });\n            }\n        }\n    }\n\n    const globalLayer = readLayer(globalPaths.configPath, \"global\", layerSchema);\n    diagnostics.push(...globalLayer.diagnostics);\n    const globalApplied = applySettingsLayer(\n        definition.schema,\n        definition.defaultSettings,\n        globalLayer,\n        globalPaths.configPath,\n        \"global\",\n    );\n    if (globalApplied.diagnostic !== undefined) diagnostics.push(globalApplied.diagnostic);\n\n    let resolved = globalApplied.settings;\n    let projectSettingsLayer: JsonObject | undefined;\n    let usedProjectConfig = false;\n    let projectRevision: PiSettingsRevision | undefined;\n    if (projectPaths !== undefined && options.project?.trusted === true) {\n        const projectLayer = readLayer(projectPaths.configPath, \"project\", layerSchema);\n        diagnostics.push(...projectLayer.diagnostics);\n        const projectApplied = applySettingsLayer(\n            definition.schema,\n            resolved,\n            projectLayer,\n            projectPaths.configPath,\n            \"project\",\n        );\n        if (projectApplied.diagnostic !== undefined) diagnostics.push(projectApplied.diagnostic);\n        if (projectLayer.settings !== undefined && projectApplied.diagnostic === undefined) {\n            resolved = projectApplied.settings;\n            projectSettingsLayer = projectLayer.settings;\n            usedProjectConfig = true;\n        }\n        if (\n            globalLayer.source.status === \"available\" &&\n            projectLayer.source.status === \"available\"\n        ) {\n            projectRevision = createSettingsRevision(\n                globalLayer.source.content,\n                projectLayer.source.content,\n            );\n        }\n    }\n\n    return {\n        settings: Value.Decode(Value.Clone(definition.schema), resolved),\n        globalSettingsLayer:\n            globalApplied.diagnostic === undefined ? globalLayer.settings : undefined,\n        projectSettingsLayer,\n        diagnostics,\n        globalConfigPath: globalPaths.configPath,\n        projectConfigPath: projectPaths?.configPath,\n        globalRevision:\n            globalLayer.source.status === \"available\"\n                ? createSettingsRevision(globalLayer.source.content)\n                : undefined,\n        projectRevision,\n        usedGlobalConfig:\n            globalLayer.settings !== undefined && globalApplied.diagnostic === undefined,\n        usedProjectConfig,\n        scaffoldedGlobalConfig,\n        schemaStatus,\n    };\n}\n"]}

package/node_modules/@zigai/pi-extension-settings/dist/settings-merge.d.ts

@@ -0,0 +1,5 @@
+import { type JsonObject } from "./json-value.ts";
+export declare function settingsLayerFromFile(file: JsonObject): JsonObject;
+/** Deep-merge settings objects. Objects merge recursively; arrays and scalars replace. */
+export declare function mergeSettings(current: JsonObject, next: JsonObject): JsonObject;
+//# sourceMappingURL=settings-merge.d.ts.map

package/node_modules/@zigai/pi-extension-settings/dist/settings-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.d.ts","sourceRoot":"","sources":["../src/settings-merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,UAAU,EAAkB,MAAM,iBAAiB,CAAC;AAa3F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAOlE;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAM/E"}

package/node_modules/@zigai/pi-extension-settings/dist/settings-merge.js

@@ -0,0 +1,30 @@
+import { cloneJson, isJsonObject } from "./json-value.js";
+function mergeValue(current, next) {
+    if (!isJsonObject(current) || !isJsonObject(next))
+        return cloneJson(next);
+    const merged = {};
+    for (const [key, value] of Object.entries(current))
+        merged[key] = cloneJson(value);
+    for (const [key, value] of Object.entries(next)) {
+        merged[key] = mergeValue(merged[key], value);
+    }
+    return merged;
+}
+export function settingsLayerFromFile(file) {
+    const settings = {};
+    for (const [key, value] of Object.entries(file)) {
+        if (key === "$schema")
+            continue;
+        settings[key] = cloneJson(value);
+    }
+    return settings;
+}
+/** Deep-merge settings objects. Objects merge recursively; arrays and scalars replace. */
+export function mergeSettings(current, next) {
+    const merged = mergeValue(current, next);
+    if (!isJsonObject(merged)) {
+        throw new TypeError("Settings merge unexpectedly produced a non-object value.");
+    }
+    return merged;
+}
+//# sourceMappingURL=settings-merge.js.map

package/node_modules/@zigai/pi-extension-settings/dist/settings-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.js","sourceRoot":"","sources":["../src/settings-merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAmC,MAAM,iBAAiB,CAAC;AAE3F,SAAS,UAAU,CAAC,OAA8B,EAAE,IAAe;IAC/D,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IAE1E,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACnF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAgB;IAClD,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,aAAa,CAAC,OAAmB,EAAE,IAAgB;IAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["import { cloneJson, isJsonObject, type JsonObject, type JsonValue } from \"./json-value.ts\";\n\nfunction mergeValue(current: JsonValue | undefined, next: JsonValue): JsonValue {\n    if (!isJsonObject(current) || !isJsonObject(next)) return cloneJson(next);\n\n    const merged: Record<string, JsonValue> = {};\n    for (const [key, value] of Object.entries(current)) merged[key] = cloneJson(value);\n    for (const [key, value] of Object.entries(next)) {\n        merged[key] = mergeValue(merged[key], value);\n    }\n    return merged;\n}\n\nexport function settingsLayerFromFile(file: JsonObject): JsonObject {\n    const settings: Record<string, JsonValue> = {};\n    for (const [key, value] of Object.entries(file)) {\n        if (key === \"$schema\") continue;\n        settings[key] = cloneJson(value);\n    }\n    return settings;\n}\n\n/** Deep-merge settings objects. Objects merge recursively; arrays and scalars replace. */\nexport function mergeSettings(current: JsonObject, next: JsonObject): JsonObject {\n    const merged = mergeValue(current, next);\n    if (!isJsonObject(merged)) {\n        throw new TypeError(\"Settings merge unexpectedly produced a non-object value.\");\n    }\n    return merged;\n}\n"]}

package/node_modules/@zigai/pi-extension-settings/dist/settings-revision.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Opaque revision token for the exact settings sources observed during loading or an update.
+ *
+ * Revisions contain no settings values. Callers should only retain and pass them back through
+ * `expectedRevision`; their string representation is not a stable persistence format.
+ */
+export type PiSettingsRevision = `sha256:${string}`;
+/** Hash length-prefixed sources so missing files and arbitrary contents cannot be ambiguous. */
+export declare function createSettingsRevision(...sources: readonly (string | undefined)[]): PiSettingsRevision;
+//# sourceMappingURL=settings-revision.d.ts.map

package/node_modules/@zigai/pi-extension-settings/dist/settings-revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-revision.d.ts","sourceRoot":"","sources":["../src/settings-revision.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,MAAM,EAAE,CAAC;AAEpD,gGAAgG;AAChG,wBAAgB,sBAAsB,CAClC,GAAG,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAC5C,kBAAkB,CAYpB"}

package/node_modules/@zigai/pi-extension-settings/dist/settings-revision.js

@@ -0,0 +1,16 @@
+import { createHash } from "node:crypto";
+/** Hash length-prefixed sources so missing files and arbitrary contents cannot be ambiguous. */
+export function createSettingsRevision(...sources) {
+    const hash = createHash("sha256");
+    for (const source of sources) {
+        if (source === undefined) {
+            hash.update("missing\0");
+            continue;
+        }
+        const content = Buffer.from(source, "utf8");
+        hash.update(`present:${content.byteLength}\0`);
+        hash.update(content);
+    }
+    return `sha256:${hash.digest("hex")}`;
+}
+//# sourceMappingURL=settings-revision.js.map

package/node_modules/@zigai/pi-extension-settings/dist/settings-revision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-revision.js","sourceRoot":"","sources":["../src/settings-revision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,gGAAgG;AAChG,MAAM,UAAU,sBAAsB,CAClC,GAAG,OAAwC;IAE3C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACzB,SAAS;QACb,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,WAAW,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC1C,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\n\n/**\n * Opaque revision token for the exact settings sources observed during loading or an update.\n *\n * Revisions contain no settings values. Callers should only retain and pass them back through\n * `expectedRevision`; their string representation is not a stable persistence format.\n */\nexport type PiSettingsRevision = `sha256:${string}`;\n\n/** Hash length-prefixed sources so missing files and arbitrary contents cannot be ambiguous. */\nexport function createSettingsRevision(\n    ...sources: readonly (string | undefined)[]\n): PiSettingsRevision {\n    const hash = createHash(\"sha256\");\n    for (const source of sources) {\n        if (source === undefined) {\n            hash.update(\"missing\\0\");\n            continue;\n        }\n        const content = Buffer.from(source, \"utf8\");\n        hash.update(`present:${content.byteLength}\\0`);\n        hash.update(content);\n    }\n    return `sha256:${hash.digest(\"hex\")}`;\n}\n"]}

package/node_modules/@zigai/pi-extension-settings/dist/settings-transaction.d.ts

@@ -0,0 +1,54 @@
+import type { TObject } from "typebox";
+import type { ExtensionSettingsDefinition, ExtensionSettingsLayer } from "./definition.ts";
+import type { ExtensionSettingsPaths } from "./paths.ts";
+import { type SettingsDiagnostic, type SettingsValidationIssue } from "./settings-layer.ts";
+import { type PiSettingsRevision } from "./settings-revision.ts";
+export type PiSettingsUpdateScope = "global" | "project";
+export type PiSettingsUpdateIssue = SettingsValidationIssue;
+export type UpdatePiExtensionSettingsOptions<Schema extends TObject> = {
+    /** Settings layer to update. Project updates require a trusted project. */
+    readonly scope: PiSettingsUpdateScope;
+    /** Reject the update if the relevant sources no longer match this loader revision. */
+    readonly expectedRevision?: PiSettingsRevision;
+    /**
+     * Produce the next encoded settings layer from the latest valid layer.
+     *
+     * The callback is invoked once, synchronously, while the settings transaction is locked. It may
+     * return a copy or mutate and return the supplied clone. Throwing an `Error` aborts the
+     * transaction and rejects `updatePiExtensionSettings` with the same error.
+     */
+    readonly update: (current: ExtensionSettingsLayer<Schema>) => ExtensionSettingsLayer<Schema>;
+};
+export type UpdatePiExtensionSettingsResult = {
+    readonly status: "updated" | "unchanged";
+    readonly revision: PiSettingsRevision;
+} | {
+    readonly status: "conflict";
+    readonly reason: "schema-changed" | "settings-changed";
+    readonly message: string;
+} | {
+    readonly status: "blocked";
+    readonly reason: "project-untrusted";
+    readonly message: string;
+} | {
+    readonly status: "invalid-existing";
+    readonly message: string;
+    readonly diagnostics: readonly SettingsDiagnostic[];
+} | {
+    readonly status: "invalid-update";
+    readonly message: string;
+    readonly issues: readonly PiSettingsUpdateIssue[];
+} | {
+    readonly status: "failed";
+    readonly message: string;
+};
+export type SettingsTransactionPaths = {
+    readonly global: ExtensionSettingsPaths;
+    readonly project: ExtensionSettingsPaths;
+};
+export type SettingsTransactionOptions<Schema extends TObject> = UpdatePiExtensionSettingsOptions<Schema> & {
+    readonly paths: SettingsTransactionPaths;
+    readonly projectTrusted: boolean;
+};
+export declare function updateSettingsTransaction<Schema extends TObject>(definition: ExtensionSettingsDefinition<Schema>, options: SettingsTransactionOptions<Schema>): Promise<UpdatePiExtensionSettingsResult>;
+//# sourceMappingURL=settings-transaction.d.ts.map

package/node_modules/@zigai/pi-extension-settings/dist/settings-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-transaction.d.ts","sourceRoot":"","sources":["../src/settings-transaction.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAW,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAU3F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAIH,KAAK,kBAAkB,EAEvB,KAAK,uBAAuB,EAC/B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEzF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE5D,MAAM,MAAM,gCAAgC,CAAC,MAAM,SAAS,OAAO,IAAI;IACnE,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,sFAAsF;IACtF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;IAC/C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC,MAAM,CAAC,KAAK,sBAAsB,CAAC,MAAM,CAAC,CAAC;CAChG,CAAC;AAEF,MAAM,MAAM,+BAA+B,GACrC;IACI,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CACzC,GACD;IACI,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,GACD;IACI,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,GACD;IACI,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACvD,GACD;IACI,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACrD,GACD;IACI,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,CAAC;AAER,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,MAAM,SAAS,OAAO,IACzD,gCAAgC,CAAC,MAAM,CAAC,GAAG;IACvC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CACpC,CAAC;AAwPN,wBAAsB,yBAAyB,CAAC,MAAM,SAAS,OAAO,EAClE,UAAU,EAAE,2BAA2B,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,0BAA0B,CAAC,MAAM,CAAC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CA2B1C"}