@dev-sergeev/datalab-kit 0.1.2 → 0.1.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"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","sourcesContent":["import { glob } from \"node:fs/promises\";\nimport { dirname, isAbsolute, relative, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nimport type { SettingsArtifactTargets } from \"./artifacts.ts\";\nimport {\n    defineExtensionSettings,\n    ExtensionSettingsDefinitionCandidateSchema,\n    type ExtensionSettingsDefinition,\n} from \"./definition.ts\";\nimport { readTextIfPresent } from \"./file-system.ts\";\nimport { isJsonObject, isJsonString, parseJson, type JsonObject } from \"./json-value.ts\";\nimport { Type, Value } from \"./typebox-runtime.ts\";\n\nexport const PACKAGE_MANIFEST_KEY = \"piExtensionSettings\";\n\nconst ImportedDefinitionModuleSchema = Type.Object({\n    default: ExtensionSettingsDefinitionCandidateSchema,\n});\n\ntype SettingsProjectManifest = {\n    readonly definition: string;\n    readonly schema: string;\n    readonly readme: string;\n    readonly prevalidation?: string;\n    readonly globalPath?: string;\n};\n\nexport type SettingsArtifactProject = {\n    readonly packageRoot: string;\n    readonly definition: ExtensionSettingsDefinition;\n    readonly targets: SettingsArtifactTargets;\n};\n\nfunction manifestError(path: string, reason: string): Error {\n    return new Error(`Invalid Pi extension settings manifest in ${path}: ${reason}`);\n}\n\nfunction stringProperty(object: JsonObject, key: string): string | undefined {\n    const value = object[key];\n    return isJsonString(value) && value.trim() !== \"\" ? value : undefined;\n}\n\nfunction parseSettingsManifest(\n    packagePath: string,\n    packageJson: JsonObject,\n): SettingsProjectManifest | undefined {\n    const raw = packageJson[PACKAGE_MANIFEST_KEY];\n    if (raw === undefined) return undefined;\n    if (!isJsonObject(raw)) {\n        throw manifestError(packagePath, `${PACKAGE_MANIFEST_KEY} must be an object`);\n    }\n\n    const supported = new Set([\"definition\", \"schema\", \"readme\", \"prevalidation\", \"globalPath\"]);\n    const unknownKeys = Object.keys(raw).filter((key) => !supported.has(key));\n    if (unknownKeys.length > 0) {\n        throw manifestError(packagePath, `unknown keys: ${unknownKeys.join(\", \")}`);\n    }\n\n    const definition = stringProperty(raw, \"definition\");\n    if (definition === undefined) {\n        throw manifestError(packagePath, \"definition must be a non-empty relative path\");\n    }\n\n    const schema = stringProperty(raw, \"schema\") ?? \"config.schema.json\";\n    const readme = stringProperty(raw, \"readme\") ?? \"README.md\";\n    const prevalidation = stringProperty(raw, \"prevalidation\");\n    const globalPath = stringProperty(raw, \"globalPath\");\n    if (prevalidation === undefined) {\n        return globalPath === undefined\n            ? { definition, schema, readme }\n            : { definition, schema, readme, globalPath };\n    }\n    return globalPath === undefined\n        ? { definition, schema, readme, prevalidation }\n        : { definition, schema, readme, prevalidation, globalPath };\n}\n\nfunction resolveInside(packageRoot: string, configuredPath: string): string | undefined {\n    if (isAbsolute(configuredPath)) return undefined;\n    const resolved = resolve(packageRoot, configuredPath);\n    const relativePath = relative(packageRoot, resolved);\n    if (relativePath === \"\" || (!relativePath.startsWith(\"..\") && !isAbsolute(relativePath))) {\n        return resolved;\n    }\n    return undefined;\n}\n\nfunction workspacePatterns(packageJson: JsonObject): readonly string[] {\n    const workspaces = packageJson.workspaces;\n    if (Array.isArray(workspaces)) {\n        return workspaces.filter(isJsonString);\n    }\n    if (!isJsonObject(workspaces) || !Array.isArray(workspaces.packages)) return [];\n    return workspaces.packages.filter(isJsonString);\n}\n\nfunction readPackageJson(path: string): JsonObject {\n    const content = readTextIfPresent(path);\n    if (content === undefined) throw manifestError(path, \"file does not exist\");\n\n    const parsed = parseJson(content);\n    if (!isJsonObject(parsed)) throw manifestError(path, \"file is not valid JSON\");\n    return parsed;\n}\n\nasync function packageJsonPaths(root: string): Promise<readonly string[]> {\n    const rootPackagePath = resolve(root, \"package.json\");\n    const rootPackage = readPackageJson(rootPackagePath);\n\n    const paths = new Set<string>([rootPackagePath]);\n    for (const pattern of workspacePatterns(rootPackage)) {\n        const packagePattern = pattern.endsWith(\"package.json\")\n            ? pattern\n            : `${pattern.replace(/\\/$/, \"\")}/package.json`;\n        for await (const match of glob(packagePattern, {\n            cwd: root,\n            exclude: [\"**/node_modules/**\"],\n        })) {\n            paths.add(resolve(root, match));\n        }\n    }\n    return [...paths].sort();\n}\n\nasync function importDefinition(path: string): Promise<ExtensionSettingsDefinition> {\n    let imported: unknown;\n    try {\n        imported = await import(pathToFileURL(path).href);\n    } catch (cause: unknown) {\n        throw new Error(\n            `Invalid settings definition module ${path}: module could not be imported`,\n            {\n                cause,\n            },\n        );\n    }\n\n    const invalidDefaultMessage = `Invalid settings definition module ${path}: default export must be created by defineExtensionSettings or be a valid definition input`;\n    let candidateModule;\n    try {\n        candidateModule = Value.Parse(ImportedDefinitionModuleSchema, imported);\n    } catch (cause: unknown) {\n        throw new Error(invalidDefaultMessage, { cause });\n    }\n    try {\n        // Always execute exhaustive authoring validation, including when the module exported a\n        // pre-existing definition created through a runtime fast path.\n        return defineExtensionSettings(candidateModule.default);\n    } catch (cause: unknown) {\n        throw new Error(invalidDefaultMessage, { cause });\n    }\n}\n\nasync function loadProject(packagePath: string): Promise<SettingsArtifactProject | undefined> {\n    const packageJson = readPackageJson(packagePath);\n    const manifest = parseSettingsManifest(packagePath, packageJson);\n    if (manifest === undefined) return undefined;\n\n    const packageRoot = dirname(packagePath);\n    const definitionPath = resolveInside(packageRoot, manifest.definition);\n    const schemaPath = resolveInside(packageRoot, manifest.schema);\n    const readmePath = resolveInside(packageRoot, manifest.readme);\n    const prevalidationPath =\n        manifest.prevalidation === undefined\n            ? undefined\n            : resolveInside(packageRoot, manifest.prevalidation);\n    if (\n        definitionPath === undefined ||\n        schemaPath === undefined ||\n        readmePath === undefined ||\n        (manifest.prevalidation !== undefined && prevalidationPath === undefined)\n    ) {\n        throw manifestError(\n            packagePath,\n            \"definition, schema, readme, and prevalidation paths must stay inside the package\",\n        );\n    }\n\n    const definition = await importDefinition(definitionPath);\n    let targets: SettingsArtifactTargets;\n    if (prevalidationPath === undefined) {\n        targets =\n            manifest.globalPath === undefined\n                ? { schemaPath, readmePath }\n                : { schemaPath, readmePath, globalPath: manifest.globalPath };\n    } else {\n        targets =\n            manifest.globalPath === undefined\n                ? { schemaPath, readmePath, prevalidationPath }\n                : {\n                      schemaPath,\n                      readmePath,\n                      prevalidationPath,\n                      globalPath: manifest.globalPath,\n                  };\n    }\n    return { packageRoot, definition, targets };\n}\n\nexport async function discoverSettingsProjects(\n    root: string,\n): Promise<readonly SettingsArtifactProject[]> {\n    const paths = await packageJsonPaths(root);\n    const projects: SettingsArtifactProject[] = [];\n    for (const path of paths) {\n        const project = await loadProject(path);\n        if (project !== undefined) projects.push(project);\n    }\n    return projects;\n}\n"]}

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

@@ -0,0 +1,40 @@
+import type { TObject } from "typebox";
+import type { ExtensionSettingsDefinition, ExtensionSettingsDefinitionInput } from "./definition.ts";
+import type { JsonObject } from "./json-value.ts";
+declare const PREVALIDATION_FORMAT_VERSION: 1;
+type SettingsDefinitionFingerprintInput = {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly schemaId?: string;
+    readonly schema: TObject;
+    readonly exampleSettings?: unknown;
+};
+/** Generated, authoring-validated values used by the startup-only definition fast path. */
+export type PrevalidatedExtensionSettingsArtifact = {
+    readonly formatVersion: typeof PREVALIDATION_FORMAT_VERSION;
+    /** Fast runtime proof over the complete JSON-visible definition contract. */
+    readonly fingerprint: string;
+    /** Authoring-only fingerprint checked by `check`; codec function text can change in Pi. */
+    readonly semanticFingerprint: string;
+    readonly defaultSettings: JsonObject;
+    readonly exampleSettings?: JsonObject;
+};
+export declare class InvalidPrevalidatedSettingsArtifact extends Error {
+    readonly name = "InvalidPrevalidatedSettingsArtifact";
+}
+/** Computes the inexpensive runtime proof stored beside a prevalidated definition. */
+export declare function prevalidatedExtensionSettingsFingerprint(input: SettingsDefinitionFingerprintInput, defaultSettings: JsonObject, exampleSettings: JsonObject | undefined): string;
+/** Creates the generated artifact payload from a fully authoring-validated definition. */
+export declare function createPrevalidatedExtensionSettingsArtifact<Schema extends TObject>(definition: ExtensionSettingsDefinition<Schema>): PrevalidatedExtensionSettingsArtifact;
+/**
+ * Hydrates a settings definition from a checked-in authoring-validated artifact.
+ *
+ * This startup path deliberately omits schema documentation/default/example validation. Generation
+ * performs those exhaustive checks. Runtime fingerprints reject JSON-visible drift before any
+ * settings files are loaded. Codec function text is checked only by the authoring `check` command:
+ * Pi and bundlers transform functions without changing their behavior.
+ */
+export declare function definePrevalidatedExtensionSettings<const Schema extends TObject>(input: ExtensionSettingsDefinitionInput<Schema>, artifact: PrevalidatedExtensionSettingsArtifact): ExtensionSettingsDefinition<Schema>;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,KAAK,EACR,2BAA2B,EAC3B,gCAAgC,EACnC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,QAAA,MAAM,4BAA4B,EAAG,CAAU,CAAC;AAEhD,KAAK,kCAAkC,GAAG;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC;AAaF,2FAA2F;AAC3F,MAAM,MAAM,qCAAqC,GAAG;IAChD,QAAQ,CAAC,aAAa,EAAE,OAAO,4BAA4B,CAAC;IAC5D,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;CACzC,CAAC;AAEF,qBAAa,mCAAoC,SAAQ,KAAK;IAC1D,SAAkB,IAAI,yCAAyC;CAClE;AA4DD,sFAAsF;AACtF,wBAAgB,wCAAwC,CACpD,KAAK,EAAE,kCAAkC,EACzC,eAAe,EAAE,UAAU,EAC3B,eAAe,EAAE,UAAU,GAAG,SAAS,GACxC,MAAM,CAGR;AAYD,0FAA0F;AAC1F,wBAAgB,2CAA2C,CAAC,MAAM,SAAS,OAAO,EAC9E,UAAU,EAAE,2BAA2B,CAAC,MAAM,CAAC,GAChD,qCAAqC,CA2CvC;AAWD;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,CAAC,MAAM,SAAS,OAAO,EAC5E,KAAK,EAAE,gCAAgC,CAAC,MAAM,CAAC,EAC/C,QAAQ,EAAE,qCAAqC,GAChD,2BAA2B,CAAC,MAAM,CAAC,CAmDrC"}

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

@@ -0,0 +1,158 @@
+import { createHash } from "node:crypto";
+import { Value } from "typebox/value";
+import { extensionSettingsDefinitionMarker as definitionMarker } from "./definition-marker.js";
+const PREVALIDATION_FORMAT_VERSION = 1;
+export class InvalidPrevalidatedSettingsArtifact extends Error {
+    name = "InvalidPrevalidatedSettingsArtifact";
+}
+function cloneJson(value) {
+    return structuredClone(value);
+}
+function freezeRecursively(value, original) {
+    const pending = [original, value];
+    while (pending.length > 0) {
+        const current = pending.pop();
+        const source = pending.pop();
+        if (current === undefined ||
+            source === undefined ||
+            current === source ||
+            Object.isFrozen(current))
+            continue;
+        for (const key of Reflect.ownKeys(current)) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(current, key);
+            if (descriptor === undefined || !("value" in descriptor))
+                continue;
+            const child = descriptor.value;
+            if (Object.isFrozen(child))
+                continue;
+            const sourceDescriptor = Reflect.getOwnPropertyDescriptor(source, key);
+            if (sourceDescriptor === undefined || !("value" in sourceDescriptor))
+                continue;
+            const originalChild = sourceDescriptor.value;
+            // TypeBox retains codec functions and other atomic values by identity. Only descend
+            // into values that were copied; never mutate those caller-owned references.
+            if (child === originalChild)
+                continue;
+            // SAFETY: Object.isFrozen false proves child is an object/function. Both clone
+            // operations preserve primitives, so its distinct data-property source is an object
+            // too. Ownership, codec, array and shared-reference tests cover this correspondence.
+            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- SAFETY: the clone/source correspondence proves both worklist values are objects.
+            pending.push(...[originalChild, child]);
+        }
+        Object.freeze(current);
+    }
+}
+function normalizedSchemaId(input) {
+    return input.schemaId ?? `urn:pi-extension-settings:${input.id}`;
+}
+function fingerprintPayload(input, defaultSettings, exampleSettings) {
+    return {
+        id: input.id,
+        title: input.title,
+        description: input.description,
+        schemaId: normalizedSchemaId(input),
+        schema: input.schema,
+        inputExampleSettings: input.exampleSettings,
+        defaultSettings,
+        exampleSettings,
+    };
+}
+/** Computes the inexpensive runtime proof stored beside a prevalidated definition. */
+export function prevalidatedExtensionSettingsFingerprint(input, defaultSettings, exampleSettings) {
+    const serialized = JSON.stringify(fingerprintPayload(input, defaultSettings, exampleSettings));
+    return `json-sha256-v1:${createHash("sha256").update(serialized).digest("hex")}`;
+}
+function semanticFingerprint(input, defaultSettings, exampleSettings) {
+    return `typebox-value-hash-v1:${Value.Hash(fingerprintPayload(input, defaultSettings, exampleSettings))}`;
+}
+/** Creates the generated artifact payload from a fully authoring-validated definition. */
+export function createPrevalidatedExtensionSettingsArtifact(definition) {
+    const input = definition.exampleSettings === undefined
+        ? {
+            id: definition.id,
+            title: definition.title,
+            description: definition.description,
+            schemaId: definition.schemaId,
+            schema: definition.schema,
+        }
+        : {
+            id: definition.id,
+            title: definition.title,
+            description: definition.description,
+            schemaId: definition.schemaId,
+            schema: definition.schema,
+            exampleSettings: definition.exampleSettings,
+        };
+    const defaultSettings = cloneJson(definition.defaultSettings);
+    const exampleSettings = definition.exampleSettings === undefined
+        ? undefined
+        : cloneJson(definition.exampleSettings);
+    const fingerprint = prevalidatedExtensionSettingsFingerprint(input, defaultSettings, exampleSettings);
+    const semantic = semanticFingerprint(input, defaultSettings, exampleSettings);
+    return exampleSettings === undefined
+        ? {
+            formatVersion: PREVALIDATION_FORMAT_VERSION,
+            fingerprint,
+            semanticFingerprint: semantic,
+            defaultSettings,
+        }
+        : {
+            formatVersion: PREVALIDATION_FORMAT_VERSION,
+            fingerprint,
+            semanticFingerprint: semantic,
+            defaultSettings,
+            exampleSettings,
+        };
+}
+function hasPlainObjectPrototype(value) {
+    try {
+        const prototype = Reflect.getPrototypeOf(value);
+        return prototype === Object.prototype || prototype === null;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Hydrates a settings definition from a checked-in authoring-validated artifact.
+ *
+ * This startup path deliberately omits schema documentation/default/example validation. Generation
+ * performs those exhaustive checks. Runtime fingerprints reject JSON-visible drift before any
+ * settings files are loaded. Codec function text is checked only by the authoring `check` command:
+ * Pi and bundlers transform functions without changing their behavior.
+ */
+export function definePrevalidatedExtensionSettings(input, artifact) {
+    if (artifact.formatVersion !== PREVALIDATION_FORMAT_VERSION) {
+        throw new InvalidPrevalidatedSettingsArtifact(`unsupported prevalidation format version: ${String(artifact.formatVersion)}`);
+    }
+    if (!hasPlainObjectPrototype(artifact.defaultSettings)) {
+        throw new InvalidPrevalidatedSettingsArtifact("prevalidated defaultSettings must be a JSON object");
+    }
+    if (artifact.exampleSettings !== undefined &&
+        !hasPlainObjectPrototype(artifact.exampleSettings)) {
+        throw new InvalidPrevalidatedSettingsArtifact("prevalidated exampleSettings must be a JSON object");
+    }
+    const expectedFingerprint = prevalidatedExtensionSettingsFingerprint(input, artifact.defaultSettings, artifact.exampleSettings);
+    if (artifact.fingerprint !== expectedFingerprint) {
+        throw new InvalidPrevalidatedSettingsArtifact("prevalidated settings artifact is stale; run pi-extension-settings generate");
+    }
+    const schema = Value.Clone(input.schema);
+    const defaultSettings = cloneJson(artifact.defaultSettings);
+    const exampleSettings = artifact.exampleSettings === undefined ? undefined : cloneJson(artifact.exampleSettings);
+    freezeRecursively(schema, input.schema);
+    freezeRecursively(defaultSettings, artifact.defaultSettings);
+    if (exampleSettings !== undefined && artifact.exampleSettings !== undefined) {
+        freezeRecursively(exampleSettings, artifact.exampleSettings);
+    }
+    return Object.freeze({
+        [definitionMarker]: true,
+        id: input.id,
+        title: input.title,
+        description: input.description,
+        schemaId: normalizedSchemaId(input),
+        schema,
+        defaultSettings,
+        exampleSettings,
+    });
+}
+//# sourceMappingURL=runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport type { TObject } from \"typebox\";\nimport { Value } from \"typebox/value\";\n\nimport type {\n    ExtensionSettingsDefinition,\n    ExtensionSettingsDefinitionInput,\n} from \"./definition.ts\";\nimport { extensionSettingsDefinitionMarker as definitionMarker } from \"./definition-marker.ts\";\nimport type { JsonObject } from \"./json-value.ts\";\n\nconst PREVALIDATION_FORMAT_VERSION = 1 as const;\n\ntype SettingsDefinitionFingerprintInput = {\n    readonly id: string;\n    readonly title: string;\n    readonly description: string;\n    readonly schemaId?: string;\n    readonly schema: TObject;\n    readonly exampleSettings?: unknown;\n};\n\ntype SettingsFingerprintPayload = {\n    readonly id: string;\n    readonly title: string;\n    readonly description: string;\n    readonly schemaId: string;\n    readonly schema: TObject;\n    readonly inputExampleSettings: unknown;\n    readonly defaultSettings: JsonObject;\n    readonly exampleSettings: JsonObject | undefined;\n};\n\n/** Generated, authoring-validated values used by the startup-only definition fast path. */\nexport type PrevalidatedExtensionSettingsArtifact = {\n    readonly formatVersion: typeof PREVALIDATION_FORMAT_VERSION;\n    /** Fast runtime proof over the complete JSON-visible definition contract. */\n    readonly fingerprint: string;\n    /** Authoring-only fingerprint checked by `check`; codec function text can change in Pi. */\n    readonly semanticFingerprint: string;\n    readonly defaultSettings: JsonObject;\n    readonly exampleSettings?: JsonObject;\n};\n\nexport class InvalidPrevalidatedSettingsArtifact extends Error {\n    override readonly name = \"InvalidPrevalidatedSettingsArtifact\";\n}\n\nfunction cloneJson<Value extends JsonObject>(value: Value): Value {\n    return structuredClone(value);\n}\n\nfunction freezeRecursively<Value extends object>(value: Value, original: Value): void {\n    const pending: object[] = [original, value];\n    while (pending.length > 0) {\n        const current = pending.pop();\n        const source = pending.pop();\n        if (\n            current === undefined ||\n            source === undefined ||\n            current === source ||\n            Object.isFrozen(current)\n        )\n            continue;\n        for (const key of Reflect.ownKeys(current)) {\n            const descriptor = Reflect.getOwnPropertyDescriptor(current, key);\n            if (descriptor === undefined || !(\"value\" in descriptor)) continue;\n            const child: unknown = descriptor.value;\n            if (Object.isFrozen(child)) continue;\n            const sourceDescriptor = Reflect.getOwnPropertyDescriptor(source, key);\n            if (sourceDescriptor === undefined || !(\"value\" in sourceDescriptor)) continue;\n            const originalChild: unknown = sourceDescriptor.value;\n            // TypeBox retains codec functions and other atomic values by identity. Only descend\n            // into values that were copied; never mutate those caller-owned references.\n            if (child === originalChild) continue;\n            // SAFETY: Object.isFrozen false proves child is an object/function. Both clone\n            // operations preserve primitives, so its distinct data-property source is an object\n            // too. Ownership, codec, array and shared-reference tests cover this correspondence.\n            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- SAFETY: the clone/source correspondence proves both worklist values are objects.\n            pending.push(...([originalChild, child] as [object, object]));\n        }\n        Object.freeze(current);\n    }\n}\n\nfunction normalizedSchemaId(input: SettingsDefinitionFingerprintInput): string {\n    return input.schemaId ?? `urn:pi-extension-settings:${input.id}`;\n}\n\nfunction fingerprintPayload(\n    input: SettingsDefinitionFingerprintInput,\n    defaultSettings: JsonObject,\n    exampleSettings: JsonObject | undefined,\n): SettingsFingerprintPayload {\n    return {\n        id: input.id,\n        title: input.title,\n        description: input.description,\n        schemaId: normalizedSchemaId(input),\n        schema: input.schema,\n        inputExampleSettings: input.exampleSettings,\n        defaultSettings,\n        exampleSettings,\n    };\n}\n\n/** Computes the inexpensive runtime proof stored beside a prevalidated definition. */\nexport function prevalidatedExtensionSettingsFingerprint(\n    input: SettingsDefinitionFingerprintInput,\n    defaultSettings: JsonObject,\n    exampleSettings: JsonObject | undefined,\n): string {\n    const serialized = JSON.stringify(fingerprintPayload(input, defaultSettings, exampleSettings));\n    return `json-sha256-v1:${createHash(\"sha256\").update(serialized).digest(\"hex\")}`;\n}\n\nfunction semanticFingerprint(\n    input: SettingsDefinitionFingerprintInput,\n    defaultSettings: JsonObject,\n    exampleSettings: JsonObject | undefined,\n): string {\n    return `typebox-value-hash-v1:${Value.Hash(\n        fingerprintPayload(input, defaultSettings, exampleSettings),\n    )}`;\n}\n\n/** Creates the generated artifact payload from a fully authoring-validated definition. */\nexport function createPrevalidatedExtensionSettingsArtifact<Schema extends TObject>(\n    definition: ExtensionSettingsDefinition<Schema>,\n): PrevalidatedExtensionSettingsArtifact {\n    const input: SettingsDefinitionFingerprintInput =\n        definition.exampleSettings === undefined\n            ? {\n                  id: definition.id,\n                  title: definition.title,\n                  description: definition.description,\n                  schemaId: definition.schemaId,\n                  schema: definition.schema,\n              }\n            : {\n                  id: definition.id,\n                  title: definition.title,\n                  description: definition.description,\n                  schemaId: definition.schemaId,\n                  schema: definition.schema,\n                  exampleSettings: definition.exampleSettings,\n              };\n    const defaultSettings = cloneJson(definition.defaultSettings);\n    const exampleSettings =\n        definition.exampleSettings === undefined\n            ? undefined\n            : cloneJson(definition.exampleSettings);\n    const fingerprint = prevalidatedExtensionSettingsFingerprint(\n        input,\n        defaultSettings,\n        exampleSettings,\n    );\n    const semantic = semanticFingerprint(input, defaultSettings, exampleSettings);\n    return exampleSettings === undefined\n        ? {\n              formatVersion: PREVALIDATION_FORMAT_VERSION,\n              fingerprint,\n              semanticFingerprint: semantic,\n              defaultSettings,\n          }\n        : {\n              formatVersion: PREVALIDATION_FORMAT_VERSION,\n              fingerprint,\n              semanticFingerprint: semantic,\n              defaultSettings,\n              exampleSettings,\n          };\n}\n\nfunction hasPlainObjectPrototype(value: JsonObject): boolean {\n    try {\n        const prototype = Reflect.getPrototypeOf(value);\n        return prototype === Object.prototype || prototype === null;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Hydrates a settings definition from a checked-in authoring-validated artifact.\n *\n * This startup path deliberately omits schema documentation/default/example validation. Generation\n * performs those exhaustive checks. Runtime fingerprints reject JSON-visible drift before any\n * settings files are loaded. Codec function text is checked only by the authoring `check` command:\n * Pi and bundlers transform functions without changing their behavior.\n */\nexport function definePrevalidatedExtensionSettings<const Schema extends TObject>(\n    input: ExtensionSettingsDefinitionInput<Schema>,\n    artifact: PrevalidatedExtensionSettingsArtifact,\n): ExtensionSettingsDefinition<Schema> {\n    if (artifact.formatVersion !== PREVALIDATION_FORMAT_VERSION) {\n        throw new InvalidPrevalidatedSettingsArtifact(\n            `unsupported prevalidation format version: ${String(artifact.formatVersion)}`,\n        );\n    }\n    if (!hasPlainObjectPrototype(artifact.defaultSettings)) {\n        throw new InvalidPrevalidatedSettingsArtifact(\n            \"prevalidated defaultSettings must be a JSON object\",\n        );\n    }\n    if (\n        artifact.exampleSettings !== undefined &&\n        !hasPlainObjectPrototype(artifact.exampleSettings)\n    ) {\n        throw new InvalidPrevalidatedSettingsArtifact(\n            \"prevalidated exampleSettings must be a JSON object\",\n        );\n    }\n\n    const expectedFingerprint = prevalidatedExtensionSettingsFingerprint(\n        input,\n        artifact.defaultSettings,\n        artifact.exampleSettings,\n    );\n    if (artifact.fingerprint !== expectedFingerprint) {\n        throw new InvalidPrevalidatedSettingsArtifact(\n            \"prevalidated settings artifact is stale; run pi-extension-settings generate\",\n        );\n    }\n\n    const schema = Value.Clone(input.schema);\n    const defaultSettings = cloneJson(artifact.defaultSettings);\n    const exampleSettings =\n        artifact.exampleSettings === undefined ? undefined : cloneJson(artifact.exampleSettings);\n    freezeRecursively(schema, input.schema);\n    freezeRecursively(defaultSettings, artifact.defaultSettings);\n    if (exampleSettings !== undefined && artifact.exampleSettings !== undefined) {\n        freezeRecursively(exampleSettings, artifact.exampleSettings);\n    }\n\n    return Object.freeze({\n        [definitionMarker]: true as const,\n        id: input.id,\n        title: input.title,\n        description: input.description,\n        schemaId: normalizedSchemaId(input),\n        schema,\n        defaultSettings,\n        exampleSettings,\n    });\n}\n"]}

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

@@ -0,0 +1,158 @@
+// src/runtime.ts
+import { createHash } from "node:crypto";
+import { Value } from "typebox/value";
+
+// src/definition-marker.ts
+var extensionSettingsDefinitionMarker = /* @__PURE__ */ Symbol.for(
+  "@zigai/pi-extension-settings/definition"
+);
+
+// src/runtime.ts
+var PREVALIDATION_FORMAT_VERSION = 1;
+var InvalidPrevalidatedSettingsArtifact = class extends Error {
+  name = "InvalidPrevalidatedSettingsArtifact";
+};
+function cloneJson(value) {
+  return structuredClone(value);
+}
+function freezeRecursively(value, original) {
+  const pending = [original, value];
+  while (pending.length > 0) {
+    const current = pending.pop();
+    const source = pending.pop();
+    if (current === void 0 || source === void 0 || current === source || Object.isFrozen(current))
+      continue;
+    for (const key of Reflect.ownKeys(current)) {
+      const descriptor = Reflect.getOwnPropertyDescriptor(current, key);
+      if (descriptor === void 0 || !("value" in descriptor)) continue;
+      const child = descriptor.value;
+      if (Object.isFrozen(child)) continue;
+      const sourceDescriptor = Reflect.getOwnPropertyDescriptor(source, key);
+      if (sourceDescriptor === void 0 || !("value" in sourceDescriptor)) continue;
+      const originalChild = sourceDescriptor.value;
+      if (child === originalChild) continue;
+      pending.push(...[originalChild, child]);
+    }
+    Object.freeze(current);
+  }
+}
+function normalizedSchemaId(input) {
+  return input.schemaId ?? `urn:pi-extension-settings:${input.id}`;
+}
+function fingerprintPayload(input, defaultSettings, exampleSettings) {
+  return {
+    id: input.id,
+    title: input.title,
+    description: input.description,
+    schemaId: normalizedSchemaId(input),
+    schema: input.schema,
+    inputExampleSettings: input.exampleSettings,
+    defaultSettings,
+    exampleSettings
+  };
+}
+function prevalidatedExtensionSettingsFingerprint(input, defaultSettings, exampleSettings) {
+  const serialized = JSON.stringify(fingerprintPayload(input, defaultSettings, exampleSettings));
+  return `json-sha256-v1:${createHash("sha256").update(serialized).digest("hex")}`;
+}
+function semanticFingerprint(input, defaultSettings, exampleSettings) {
+  return `typebox-value-hash-v1:${Value.Hash(
+    fingerprintPayload(input, defaultSettings, exampleSettings)
+  )}`;
+}
+function createPrevalidatedExtensionSettingsArtifact(definition) {
+  const input = definition.exampleSettings === void 0 ? {
+    id: definition.id,
+    title: definition.title,
+    description: definition.description,
+    schemaId: definition.schemaId,
+    schema: definition.schema
+  } : {
+    id: definition.id,
+    title: definition.title,
+    description: definition.description,
+    schemaId: definition.schemaId,
+    schema: definition.schema,
+    exampleSettings: definition.exampleSettings
+  };
+  const defaultSettings = cloneJson(definition.defaultSettings);
+  const exampleSettings = definition.exampleSettings === void 0 ? void 0 : cloneJson(definition.exampleSettings);
+  const fingerprint = prevalidatedExtensionSettingsFingerprint(
+    input,
+    defaultSettings,
+    exampleSettings
+  );
+  const semantic = semanticFingerprint(input, defaultSettings, exampleSettings);
+  return exampleSettings === void 0 ? {
+    formatVersion: PREVALIDATION_FORMAT_VERSION,
+    fingerprint,
+    semanticFingerprint: semantic,
+    defaultSettings
+  } : {
+    formatVersion: PREVALIDATION_FORMAT_VERSION,
+    fingerprint,
+    semanticFingerprint: semantic,
+    defaultSettings,
+    exampleSettings
+  };
+}
+function hasPlainObjectPrototype(value) {
+  try {
+    const prototype = Reflect.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  } catch {
+    return false;
+  }
+}
+function definePrevalidatedExtensionSettings(input, artifact) {
+  if (artifact.formatVersion !== PREVALIDATION_FORMAT_VERSION) {
+    throw new InvalidPrevalidatedSettingsArtifact(
+      `unsupported prevalidation format version: ${String(artifact.formatVersion)}`
+    );
+  }
+  if (!hasPlainObjectPrototype(artifact.defaultSettings)) {
+    throw new InvalidPrevalidatedSettingsArtifact(
+      "prevalidated defaultSettings must be a JSON object"
+    );
+  }
+  if (artifact.exampleSettings !== void 0 && !hasPlainObjectPrototype(artifact.exampleSettings)) {
+    throw new InvalidPrevalidatedSettingsArtifact(
+      "prevalidated exampleSettings must be a JSON object"
+    );
+  }
+  const expectedFingerprint = prevalidatedExtensionSettingsFingerprint(
+    input,
+    artifact.defaultSettings,
+    artifact.exampleSettings
+  );
+  if (artifact.fingerprint !== expectedFingerprint) {
+    throw new InvalidPrevalidatedSettingsArtifact(
+      "prevalidated settings artifact is stale; run pi-extension-settings generate"
+    );
+  }
+  const schema = Value.Clone(input.schema);
+  const defaultSettings = cloneJson(artifact.defaultSettings);
+  const exampleSettings = artifact.exampleSettings === void 0 ? void 0 : cloneJson(artifact.exampleSettings);
+  freezeRecursively(schema, input.schema);
+  freezeRecursively(defaultSettings, artifact.defaultSettings);
+  if (exampleSettings !== void 0 && artifact.exampleSettings !== void 0) {
+    freezeRecursively(exampleSettings, artifact.exampleSettings);
+  }
+  return Object.freeze({
+    [extensionSettingsDefinitionMarker]: true,
+    id: input.id,
+    title: input.title,
+    description: input.description,
+    schemaId: normalizedSchemaId(input),
+    schema,
+    defaultSettings,
+    exampleSettings
+  });
+}
+export {
+  InvalidPrevalidatedSettingsArtifact,
+  createPrevalidatedExtensionSettingsArtifact,
+  definePrevalidatedExtensionSettings,
+  prevalidatedExtensionSettingsFingerprint
+};
+//# sourceMappingURL=runtime.ts.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/runtime.ts", "../src/definition-marker.ts"],
+  "sourcesContent": ["import { createHash } from \"node:crypto\";\n\nimport type { TObject } from \"typebox\";\nimport { Value } from \"typebox/value\";\n\nimport type {\n    ExtensionSettingsDefinition,\n    ExtensionSettingsDefinitionInput,\n} from \"./definition.ts\";\nimport { extensionSettingsDefinitionMarker as definitionMarker } from \"./definition-marker.ts\";\nimport type { JsonObject } from \"./json-value.ts\";\n\nconst PREVALIDATION_FORMAT_VERSION = 1 as const;\n\ntype SettingsDefinitionFingerprintInput = {\n    readonly id: string;\n    readonly title: string;\n    readonly description: string;\n    readonly schemaId?: string;\n    readonly schema: TObject;\n    readonly exampleSettings?: unknown;\n};\n\ntype SettingsFingerprintPayload = {\n    readonly id: string;\n    readonly title: string;\n    readonly description: string;\n    readonly schemaId: string;\n    readonly schema: TObject;\n    readonly inputExampleSettings: unknown;\n    readonly defaultSettings: JsonObject;\n    readonly exampleSettings: JsonObject | undefined;\n};\n\n/** Generated, authoring-validated values used by the startup-only definition fast path. */\nexport type PrevalidatedExtensionSettingsArtifact = {\n    readonly formatVersion: typeof PREVALIDATION_FORMAT_VERSION;\n    /** Fast runtime proof over the complete JSON-visible definition contract. */\n    readonly fingerprint: string;\n    /** Authoring-only fingerprint checked by `check`; codec function text can change in Pi. */\n    readonly semanticFingerprint: string;\n    readonly defaultSettings: JsonObject;\n    readonly exampleSettings?: JsonObject;\n};\n\nexport class InvalidPrevalidatedSettingsArtifact extends Error {\n    override readonly name = \"InvalidPrevalidatedSettingsArtifact\";\n}\n\nfunction cloneJson<Value extends JsonObject>(value: Value): Value {\n    return structuredClone(value);\n}\n\nfunction freezeRecursively<Value extends object>(value: Value, original: Value): void {\n    const pending: object[] = [original, value];\n    while (pending.length > 0) {\n        const current = pending.pop();\n        const source = pending.pop();\n        if (\n            current === undefined ||\n            source === undefined ||\n            current === source ||\n            Object.isFrozen(current)\n        )\n            continue;\n        for (const key of Reflect.ownKeys(current)) {\n            const descriptor = Reflect.getOwnPropertyDescriptor(current, key);\n            if (descriptor === undefined || !(\"value\" in descriptor)) continue;\n            const child: unknown = descriptor.value;\n            if (Object.isFrozen(child)) continue;\n            const sourceDescriptor = Reflect.getOwnPropertyDescriptor(source, key);\n            if (sourceDescriptor === undefined || !(\"value\" in sourceDescriptor)) continue;\n            const originalChild: unknown = sourceDescriptor.value;\n            // TypeBox retains codec functions and other atomic values by identity. Only descend\n            // into values that were copied; never mutate those caller-owned references.\n            if (child === originalChild) continue;\n            // SAFETY: Object.isFrozen false proves child is an object/function. Both clone\n            // operations preserve primitives, so its distinct data-property source is an object\n            // too. Ownership, codec, array and shared-reference tests cover this correspondence.\n            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- SAFETY: the clone/source correspondence proves both worklist values are objects.\n            pending.push(...([originalChild, child] as [object, object]));\n        }\n        Object.freeze(current);\n    }\n}\n\nfunction normalizedSchemaId(input: SettingsDefinitionFingerprintInput): string {\n    return input.schemaId ?? `urn:pi-extension-settings:${input.id}`;\n}\n\nfunction fingerprintPayload(\n    input: SettingsDefinitionFingerprintInput,\n    defaultSettings: JsonObject,\n    exampleSettings: JsonObject | undefined,\n): SettingsFingerprintPayload {\n    return {\n        id: input.id,\n        title: input.title,\n        description: input.description,\n        schemaId: normalizedSchemaId(input),\n        schema: input.schema,\n        inputExampleSettings: input.exampleSettings,\n        defaultSettings,\n        exampleSettings,\n    };\n}\n\n/** Computes the inexpensive runtime proof stored beside a prevalidated definition. */\nexport function prevalidatedExtensionSettingsFingerprint(\n    input: SettingsDefinitionFingerprintInput,\n    defaultSettings: JsonObject,\n    exampleSettings: JsonObject | undefined,\n): string {\n    const serialized = JSON.stringify(fingerprintPayload(input, defaultSettings, exampleSettings));\n    return `json-sha256-v1:${createHash(\"sha256\").update(serialized).digest(\"hex\")}`;\n}\n\nfunction semanticFingerprint(\n    input: SettingsDefinitionFingerprintInput,\n    defaultSettings: JsonObject,\n    exampleSettings: JsonObject | undefined,\n): string {\n    return `typebox-value-hash-v1:${Value.Hash(\n        fingerprintPayload(input, defaultSettings, exampleSettings),\n    )}`;\n}\n\n/** Creates the generated artifact payload from a fully authoring-validated definition. */\nexport function createPrevalidatedExtensionSettingsArtifact<Schema extends TObject>(\n    definition: ExtensionSettingsDefinition<Schema>,\n): PrevalidatedExtensionSettingsArtifact {\n    const input: SettingsDefinitionFingerprintInput =\n        definition.exampleSettings === undefined\n            ? {\n                  id: definition.id,\n                  title: definition.title,\n                  description: definition.description,\n                  schemaId: definition.schemaId,\n                  schema: definition.schema,\n              }\n            : {\n                  id: definition.id,\n                  title: definition.title,\n                  description: definition.description,\n                  schemaId: definition.schemaId,\n                  schema: definition.schema,\n                  exampleSettings: definition.exampleSettings,\n              };\n    const defaultSettings = cloneJson(definition.defaultSettings);\n    const exampleSettings =\n        definition.exampleSettings === undefined\n            ? undefined\n            : cloneJson(definition.exampleSettings);\n    const fingerprint = prevalidatedExtensionSettingsFingerprint(\n        input,\n        defaultSettings,\n        exampleSettings,\n    );\n    const semantic = semanticFingerprint(input, defaultSettings, exampleSettings);\n    return exampleSettings === undefined\n        ? {\n              formatVersion: PREVALIDATION_FORMAT_VERSION,\n              fingerprint,\n              semanticFingerprint: semantic,\n              defaultSettings,\n          }\n        : {\n              formatVersion: PREVALIDATION_FORMAT_VERSION,\n              fingerprint,\n              semanticFingerprint: semantic,\n              defaultSettings,\n              exampleSettings,\n          };\n}\n\nfunction hasPlainObjectPrototype(value: JsonObject): boolean {\n    try {\n        const prototype = Reflect.getPrototypeOf(value);\n        return prototype === Object.prototype || prototype === null;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Hydrates a settings definition from a checked-in authoring-validated artifact.\n *\n * This startup path deliberately omits schema documentation/default/example validation. Generation\n * performs those exhaustive checks. Runtime fingerprints reject JSON-visible drift before any\n * settings files are loaded. Codec function text is checked only by the authoring `check` command:\n * Pi and bundlers transform functions without changing their behavior.\n */\nexport function definePrevalidatedExtensionSettings<const Schema extends TObject>(\n    input: ExtensionSettingsDefinitionInput<Schema>,\n    artifact: PrevalidatedExtensionSettingsArtifact,\n): ExtensionSettingsDefinition<Schema> {\n    if (artifact.formatVersion !== PREVALIDATION_FORMAT_VERSION) {\n        throw new InvalidPrevalidatedSettingsArtifact(\n            `unsupported prevalidation format version: ${String(artifact.formatVersion)}`,\n        );\n    }\n    if (!hasPlainObjectPrototype(artifact.defaultSettings)) {\n        throw new InvalidPrevalidatedSettingsArtifact(\n            \"prevalidated defaultSettings must be a JSON object\",\n        );\n    }\n    if (\n        artifact.exampleSettings !== undefined &&\n        !hasPlainObjectPrototype(artifact.exampleSettings)\n    ) {\n        throw new InvalidPrevalidatedSettingsArtifact(\n            \"prevalidated exampleSettings must be a JSON object\",\n        );\n    }\n\n    const expectedFingerprint = prevalidatedExtensionSettingsFingerprint(\n        input,\n        artifact.defaultSettings,\n        artifact.exampleSettings,\n    );\n    if (artifact.fingerprint !== expectedFingerprint) {\n        throw new InvalidPrevalidatedSettingsArtifact(\n            \"prevalidated settings artifact is stale; run pi-extension-settings generate\",\n        );\n    }\n\n    const schema = Value.Clone(input.schema);\n    const defaultSettings = cloneJson(artifact.defaultSettings);\n    const exampleSettings =\n        artifact.exampleSettings === undefined ? undefined : cloneJson(artifact.exampleSettings);\n    freezeRecursively(schema, input.schema);\n    freezeRecursively(defaultSettings, artifact.defaultSettings);\n    if (exampleSettings !== undefined && artifact.exampleSettings !== undefined) {\n        freezeRecursively(exampleSettings, artifact.exampleSettings);\n    }\n\n    return Object.freeze({\n        [definitionMarker]: true as const,\n        id: input.id,\n        title: input.title,\n        description: input.description,\n        schemaId: normalizedSchemaId(input),\n        schema,\n        defaultSettings,\n        exampleSettings,\n    });\n}\n", "export const extensionSettingsDefinitionMarker = Symbol.for(\n    \"@zigai/pi-extension-settings/definition\",\n);\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,19 @@
+import type { TSchema } from "typebox";
+import { type JsonObject } from "./json-value.ts";
+export declare const JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+export type SchemaDocumentInput = {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly schemaId: string;
+    readonly schema: TSchema;
+};
+export declare function hasReservedSchemaProperty(schema: TSchema): boolean;
+export declare function findUndocumentedSettings(schema: TSchema): readonly string[];
+export declare function findNonStrictObjectSchemas(schema: TSchema): readonly string[];
+export declare function createSettingsFileSchema(input: SchemaDocumentInput): JsonObject;
+export declare function createSettingsDocument(id: string, settings: JsonObject, schemaReference?: string): JsonObject;
+export declare function createDefaultSettingsDocument(input: SchemaDocumentInput & {
+    readonly defaultSettings: JsonObject;
+}): JsonObject;
+//# sourceMappingURL=schema-document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-document.d.ts","sourceRoot":"","sources":["../src/schema-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAKH,KAAK,UAAU,EAGlB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,mBAAmB,iDAAiD,CAAC;AAElF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B,CAAC;AA8FF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAGlE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAwB3E;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAY7E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,UAAU,CAkC/E;AAED,wBAAgB,sBAAsB,CAClC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,UAAU,EACpB,eAAe,SAAgC,GAChD,UAAU,CAQZ;AAED,wBAAgB,6BAA6B,CACzC,KAAK,EAAE,mBAAmB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAA;CAAE,GACtE,UAAU,CAEZ"}