@dev-sergeev/datalab-kit 0.1.2 → 0.1.4

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

@@ -0,0 +1,168 @@
+import { cloneJson, isJsonArray, isJsonObject, isJsonString, parseJson, } from "./json-value.js";
+export const JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+const SCHEMA_MAP_KEYWORDS = new Set([
+    "$defs",
+    "definitions",
+    "dependentSchemas",
+    "patternProperties",
+    "properties",
+]);
+const SCHEMA_ARRAY_KEYWORDS = new Set(["allOf", "anyOf", "oneOf", "prefixItems"]);
+const SCHEMA_VALUE_KEYWORDS = new Set([
+    "additionalProperties",
+    "contains",
+    "else",
+    "if",
+    "items",
+    "not",
+    "propertyNames",
+    "then",
+    "unevaluatedItems",
+    "unevaluatedProperties",
+]);
+function makeSettingsObjectPartial(schema) {
+    const transformed = {};
+    for (const [key, value] of Object.entries(schema)) {
+        if (key === "required")
+            continue;
+        if (key === "properties" && isJsonObject(value)) {
+            const properties = {};
+            for (const [name, child] of Object.entries(value)) {
+                properties[name] =
+                    isJsonObject(child) && child.type === "object" && isJsonObject(child.properties)
+                        ? makeSettingsObjectPartial(child)
+                        : cloneJson(child);
+            }
+            transformed[key] = properties;
+            continue;
+        }
+        transformed[key] = cloneJson(value);
+    }
+    return transformed;
+}
+function stripTypeBoxMetadata(value) {
+    if (Array.isArray(value))
+        return value.map(stripTypeBoxMetadata);
+    if (!isJsonObject(value))
+        return value;
+    const sanitized = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (key.startsWith("~"))
+            continue;
+        sanitized[key] = stripTypeBoxMetadata(child);
+    }
+    return sanitized;
+}
+function schemaRecord(schema) {
+    const serialized = JSON.stringify(schema);
+    if (serialized === undefined) {
+        throw new TypeError("The TypeBox schema is not JSON serializable.");
+    }
+    const parsed = parseJson(serialized);
+    if (!isJsonObject(parsed)) {
+        throw new TypeError("The TypeBox settings schema must serialize to a JSON object.");
+    }
+    return stripTypeBoxMetadata(parsed);
+}
+function visitChildSchemas(schema, path, visit) {
+    for (const [key, value] of Object.entries(schema)) {
+        if (SCHEMA_MAP_KEYWORDS.has(key) && isJsonObject(value)) {
+            for (const [name, child] of Object.entries(value)) {
+                if (isJsonObject(child))
+                    visit(child, `${path}/${key}/${name}`);
+            }
+            continue;
+        }
+        if (SCHEMA_ARRAY_KEYWORDS.has(key) && isJsonArray(value)) {
+            for (const [index, child] of value.entries()) {
+                if (isJsonObject(child))
+                    visit(child, `${path}/${key}/${index}`);
+            }
+            continue;
+        }
+        if (SCHEMA_VALUE_KEYWORDS.has(key) && isJsonObject(value)) {
+            visit(value, `${path}/${key}`);
+        }
+    }
+}
+export function hasReservedSchemaProperty(schema) {
+    const root = schemaRecord(schema);
+    return isJsonObject(root.properties) && "$schema" in root.properties;
+}
+export function findUndocumentedSettings(schema) {
+    const root = schemaRecord(schema);
+    if (!isJsonObject(root.properties))
+        return ["<root>"];
+    const issues = [];
+    function visit(properties, prefix) {
+        for (const [key, value] of Object.entries(properties)) {
+            const path = prefix === "" ? key : `${prefix}.${key}`;
+            if (isJsonObject(value) && value.type === "object" && isJsonObject(value.properties)) {
+                visit(value.properties, path);
+                continue;
+            }
+            if (!isJsonObject(value) ||
+                !isJsonString(value.description) ||
+                value.description.trim() === "") {
+                issues.push(path);
+            }
+        }
+    }
+    visit(root.properties, "");
+    return issues;
+}
+export function findNonStrictObjectSchemas(schema) {
+    const issues = [];
+    function visit(value, path) {
+        if (value.type === "object" && isJsonObject(value.properties)) {
+            if (value.additionalProperties !== false)
+                issues.push(path);
+        }
+        visitChildSchemas(value, path, visit);
+    }
+    visit(schemaRecord(schema), "#");
+    return issues;
+}
+export function createSettingsFileSchema(input) {
+    const partial = makeSettingsObjectPartial(schemaRecord(input.schema));
+    if (!isJsonObject(partial.properties)) {
+        throw new TypeError("The TypeBox settings schema must be an object with properties.");
+    }
+    const properties = {};
+    properties.$schema = {
+        type: "string",
+        default: `./schemas/${input.id}.schema.json`,
+        description: "JSON Schema used by editors for this settings file.",
+    };
+    for (const [key, value] of Object.entries(partial.properties)) {
+        properties[key] = cloneJson(value);
+    }
+    const schemaKeywords = {};
+    for (const [key, value] of Object.entries(partial)) {
+        if (["$schema", "$id", "title", "description", "properties", "required"].includes(key)) {
+            continue;
+        }
+        schemaKeywords[key] = cloneJson(value);
+    }
+    return {
+        $schema: JSON_SCHEMA_DIALECT,
+        $id: input.schemaId,
+        title: `${input.title} settings`,
+        description: input.description,
+        ...schemaKeywords,
+        type: "object",
+        properties,
+        additionalProperties: false,
+    };
+}
+export function createSettingsDocument(id, settings, schemaReference = `./schemas/${id}.schema.json`) {
+    const settingsEntries = Object.entries(settings).map(([key, value]) => [key, cloneJson(value)]);
+    return {
+        $schema: schemaReference,
+        ...Object.fromEntries(settingsEntries),
+    };
+}
+export function createDefaultSettingsDocument(input) {
+    return createSettingsDocument(input.id, input.defaultSettings);
+}
+//# sourceMappingURL=schema-document.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-document.js","sourceRoot":"","sources":["../src/schema-document.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TSchema } from \"typebox\";\n\nimport {\n    cloneJson,\n    isJsonArray,\n    isJsonObject,\n    isJsonString,\n    type JsonObject,\n    type JsonValue,\n    parseJson,\n} from \"./json-value.ts\";\n\nexport const JSON_SCHEMA_DIALECT = \"https://json-schema.org/draft/2020-12/schema\";\n\nexport type SchemaDocumentInput = {\n    readonly id: string;\n    readonly title: string;\n    readonly description: string;\n    readonly schemaId: string;\n    readonly schema: TSchema;\n};\n\nconst SCHEMA_MAP_KEYWORDS = new Set([\n    \"$defs\",\n    \"definitions\",\n    \"dependentSchemas\",\n    \"patternProperties\",\n    \"properties\",\n]);\nconst SCHEMA_ARRAY_KEYWORDS = new Set([\"allOf\", \"anyOf\", \"oneOf\", \"prefixItems\"]);\nconst SCHEMA_VALUE_KEYWORDS = new Set([\n    \"additionalProperties\",\n    \"contains\",\n    \"else\",\n    \"if\",\n    \"items\",\n    \"not\",\n    \"propertyNames\",\n    \"then\",\n    \"unevaluatedItems\",\n    \"unevaluatedProperties\",\n]);\n\nfunction makeSettingsObjectPartial(schema: JsonObject): JsonObject {\n    const transformed: Record<string, JsonValue> = {};\n    for (const [key, value] of Object.entries(schema)) {\n        if (key === \"required\") continue;\n        if (key === \"properties\" && isJsonObject(value)) {\n            const properties: Record<string, JsonValue> = {};\n            for (const [name, child] of Object.entries(value)) {\n                properties[name] =\n                    isJsonObject(child) && child.type === \"object\" && isJsonObject(child.properties)\n                        ? makeSettingsObjectPartial(child)\n                        : cloneJson(child);\n            }\n            transformed[key] = properties;\n            continue;\n        }\n        transformed[key] = cloneJson(value);\n    }\n    return transformed;\n}\n\nfunction stripTypeBoxMetadata(value: JsonObject): JsonObject;\nfunction stripTypeBoxMetadata(value: JsonValue): JsonValue;\nfunction stripTypeBoxMetadata(value: JsonValue): JsonValue {\n    if (Array.isArray(value)) return value.map(stripTypeBoxMetadata);\n    if (!isJsonObject(value)) return value;\n\n    const sanitized: Record<string, JsonValue> = {};\n    for (const [key, child] of Object.entries(value)) {\n        if (key.startsWith(\"~\")) continue;\n        sanitized[key] = stripTypeBoxMetadata(child);\n    }\n    return sanitized;\n}\n\nfunction schemaRecord(schema: TSchema): JsonObject {\n    const serialized = JSON.stringify(schema);\n    if (serialized === undefined) {\n        throw new TypeError(\"The TypeBox schema is not JSON serializable.\");\n    }\n\n    const parsed = parseJson(serialized);\n    if (!isJsonObject(parsed)) {\n        throw new TypeError(\"The TypeBox settings schema must serialize to a JSON object.\");\n    }\n    return stripTypeBoxMetadata(parsed);\n}\n\nfunction visitChildSchemas(\n    schema: JsonObject,\n    path: string,\n    visit: (schema: JsonObject, path: string) => void,\n): void {\n    for (const [key, value] of Object.entries(schema)) {\n        if (SCHEMA_MAP_KEYWORDS.has(key) && isJsonObject(value)) {\n            for (const [name, child] of Object.entries(value)) {\n                if (isJsonObject(child)) visit(child, `${path}/${key}/${name}`);\n            }\n            continue;\n        }\n        if (SCHEMA_ARRAY_KEYWORDS.has(key) && isJsonArray(value)) {\n            for (const [index, child] of value.entries()) {\n                if (isJsonObject(child)) visit(child, `${path}/${key}/${index}`);\n            }\n            continue;\n        }\n        if (SCHEMA_VALUE_KEYWORDS.has(key) && isJsonObject(value)) {\n            visit(value, `${path}/${key}`);\n        }\n    }\n}\n\nexport function hasReservedSchemaProperty(schema: TSchema): boolean {\n    const root = schemaRecord(schema);\n    return isJsonObject(root.properties) && \"$schema\" in root.properties;\n}\n\nexport function findUndocumentedSettings(schema: TSchema): readonly string[] {\n    const root = schemaRecord(schema);\n    if (!isJsonObject(root.properties)) return [\"<root>\"];\n\n    const issues: string[] = [];\n    function visit(properties: JsonObject, prefix: string): void {\n        for (const [key, value] of Object.entries(properties)) {\n            const path = prefix === \"\" ? key : `${prefix}.${key}`;\n            if (isJsonObject(value) && value.type === \"object\" && isJsonObject(value.properties)) {\n                visit(value.properties, path);\n                continue;\n            }\n            if (\n                !isJsonObject(value) ||\n                !isJsonString(value.description) ||\n                value.description.trim() === \"\"\n            ) {\n                issues.push(path);\n            }\n        }\n    }\n\n    visit(root.properties, \"\");\n    return issues;\n}\n\nexport function findNonStrictObjectSchemas(schema: TSchema): readonly string[] {\n    const issues: string[] = [];\n\n    function visit(value: JsonObject, path: string): void {\n        if (value.type === \"object\" && isJsonObject(value.properties)) {\n            if (value.additionalProperties !== false) issues.push(path);\n        }\n        visitChildSchemas(value, path, visit);\n    }\n\n    visit(schemaRecord(schema), \"#\");\n    return issues;\n}\n\nexport function createSettingsFileSchema(input: SchemaDocumentInput): JsonObject {\n    const partial = makeSettingsObjectPartial(schemaRecord(input.schema));\n    if (!isJsonObject(partial.properties)) {\n        throw new TypeError(\"The TypeBox settings schema must be an object with properties.\");\n    }\n\n    const properties: Record<string, JsonValue> = {};\n    properties.$schema = {\n        type: \"string\",\n        default: `./schemas/${input.id}.schema.json`,\n        description: \"JSON Schema used by editors for this settings file.\",\n    };\n    for (const [key, value] of Object.entries(partial.properties)) {\n        properties[key] = cloneJson(value);\n    }\n\n    const schemaKeywords: Record<string, JsonValue> = {};\n    for (const [key, value] of Object.entries(partial)) {\n        if ([\"$schema\", \"$id\", \"title\", \"description\", \"properties\", \"required\"].includes(key)) {\n            continue;\n        }\n        schemaKeywords[key] = cloneJson(value);\n    }\n\n    return {\n        $schema: JSON_SCHEMA_DIALECT,\n        $id: input.schemaId,\n        title: `${input.title} settings`,\n        description: input.description,\n        ...schemaKeywords,\n        type: \"object\",\n        properties,\n        additionalProperties: false,\n    } satisfies JsonObject;\n}\n\nexport function createSettingsDocument(\n    id: string,\n    settings: JsonObject,\n    schemaReference = `./schemas/${id}.schema.json`,\n): JsonObject {\n    const settingsEntries = Object.entries(settings).map(\n        ([key, value]) => [key, cloneJson(value)] as const,\n    );\n    return {\n        $schema: schemaReference,\n        ...Object.fromEntries(settingsEntries),\n    } satisfies JsonObject;\n}\n\nexport function createDefaultSettingsDocument(\n    input: SchemaDocumentInput & { readonly defaultSettings: JsonObject },\n): JsonObject {\n    return createSettingsDocument(input.id, input.defaultSettings);\n}\n"]}

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

@@ -0,0 +1,9 @@
+import type { ExtensionSettingsDefinition } from "./definition.ts";
+export declare const README_GENERATED_START = "<!-- pi-extension-settings:start -->";
+export declare const README_GENERATED_END = "<!-- pi-extension-settings:end -->";
+export type RenderReadmeOptions = {
+    readonly globalPath?: string;
+};
+export declare function renderReadmeSettingsSection(definition: ExtensionSettingsDefinition, options?: RenderReadmeOptions): string;
+export declare function replaceGeneratedReadmeSection(readme: string, generatedSection: string): string | undefined;
+//# sourceMappingURL=settings-documentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-documentation.d.ts","sourceRoot":"","sources":["../src/settings-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAiBnE,eAAO,MAAM,sBAAsB,yCAAyC,CAAC;AAC7E,eAAO,MAAM,oBAAoB,uCAAuC,CAAC;AAmNzE,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,2BAA2B,EACvC,OAAO,GAAE,mBAAwB,GAClC,MAAM,CA2CR;AAED,wBAAgB,6BAA6B,CACzC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACzB,MAAM,GAAG,SAAS,CAapB"}

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

@@ -0,0 +1,242 @@
+import { isJsonArray, isJsonBoolean, isJsonNumber, isJsonObject, isJsonString, } from "./json-value.js";
+import { defaultGlobalSettingsDisplayPath } from "./paths.js";
+import { createDefaultSettingsDocument, createSettingsDocument, createSettingsFileSchema, } from "./schema-document.js";
+export const README_GENERATED_START = "<!-- pi-extension-settings:start -->";
+export const README_GENERATED_END = "<!-- pi-extension-settings:end -->";
+const MAX_INLINE_DEFAULT_CHARACTERS = 48;
+const MAX_INLINE_TYPE_CHARACTERS = 120;
+const TYPE_NAME_PATTERN = /^[A-Z][A-Za-z0-9]{0,39}$/;
+function valueAtPath(root, path) {
+    let current = root;
+    for (const segment of path) {
+        if (!isJsonObject(current))
+            return undefined;
+        const next = current[segment];
+        if (next === undefined)
+            return undefined;
+        current = next;
+    }
+    return current;
+}
+function markdownCode(value) {
+    if (value === "")
+        return "<code></code>";
+    let longestBacktickRun = 0;
+    for (const match of value.matchAll(/`+/g)) {
+        longestBacktickRun = Math.max(longestBacktickRun, match[0].length);
+    }
+    const fence = "`".repeat(longestBacktickRun + 1);
+    const needsPadding = value.startsWith("`") ||
+        value.endsWith("`") ||
+        value.startsWith(" ") ||
+        value.endsWith(" ");
+    const content = needsPadding ? ` ${value} ` : value;
+    return `${fence}${content}${fence}`;
+}
+function literalType(value) {
+    if (isJsonString(value))
+        return markdownCode(value === "" ? '""' : value);
+    return markdownCode(JSON.stringify(value));
+}
+function directPrimitiveType(schema) {
+    if (schema.const !== undefined || isJsonArray(schema.enum))
+        return undefined;
+    if (!isJsonString(schema.type))
+        return undefined;
+    if (["boolean", "integer", "null", "number", "string"].includes(schema.type)) {
+        return schema.type;
+    }
+    return undefined;
+}
+function valueCoveredByPrimitiveTypes(value, types) {
+    if (value === null)
+        return types.has("null");
+    if (isJsonNumber(value)) {
+        if (types.has("number"))
+            return true;
+        return Number.isInteger(value) && types.has("integer");
+    }
+    if (isJsonBoolean(value))
+        return types.has("boolean");
+    if (isJsonString(value))
+        return types.has("string");
+    return false;
+}
+function schemaCoveredByPrimitiveTypes(schema, types) {
+    if (schema.const !== undefined) {
+        return valueCoveredByPrimitiveTypes(schema.const, types);
+    }
+    if (isJsonArray(schema.enum)) {
+        return (schema.enum.length > 0 &&
+            schema.enum.every((value) => valueCoveredByPrimitiveTypes(value, types)));
+    }
+    const alternatives = schema.anyOf ?? schema.oneOf;
+    if (!isJsonArray(alternatives) || alternatives.length === 0)
+        return false;
+    return alternatives.every((alternative) => isJsonObject(alternative) && schemaCoveredByPrimitiveTypes(alternative, types));
+}
+function schemaTypeTitle(schema) {
+    if (!isJsonString(schema.title))
+        return undefined;
+    const title = schema.title.trim();
+    return TYPE_NAME_PATTERN.test(title) ? title : undefined;
+}
+function schemaType(schema) {
+    if (schema.const !== undefined)
+        return literalType(schema.const);
+    if (isJsonArray(schema.enum)) {
+        return schema.enum.map(literalType).join(" | ");
+    }
+    const alternatives = schema.anyOf ?? schema.oneOf;
+    if (isJsonArray(alternatives)) {
+        const schemas = alternatives.filter(isJsonObject);
+        const primitiveTypes = new Set(schemas
+            .map(directPrimitiveType)
+            .filter((value) => value !== undefined));
+        const numberSubsumesInteger = primitiveTypes.has("number");
+        return schemas
+            .filter((alternative) => {
+            const directType = directPrimitiveType(alternative);
+            if (directType !== undefined) {
+                return !(directType === "integer" && numberSubsumesInteger);
+            }
+            return !schemaCoveredByPrimitiveTypes(alternative, primitiveTypes);
+        })
+            .map(schemaType)
+            .filter((value, index, values) => values.indexOf(value) === index)
+            .join(" | ");
+    }
+    if (schema.type === "array") {
+        if (!isJsonObject(schema.items))
+            return "array";
+        const itemType = schemaType(schema.items);
+        if (itemType.includes(" | "))
+            return `(${itemType})[]`;
+        return `${itemType}[]`;
+    }
+    if (schema.type === "object") {
+        const title = schemaTypeTitle(schema);
+        if (title !== undefined)
+            return title;
+        if (isJsonObject(schema.properties)) {
+            const required = new Set(isJsonArray(schema.required) ? schema.required.filter(isJsonString) : []);
+            const fields = Object.entries(schema.properties).map(([key, value]) => {
+                const optional = required.has(key) ? "" : "?";
+                const type = isJsonObject(value) ? schemaType(value) : "JSON value";
+                return `${key}${optional}: ${type}`;
+            });
+            return `{ ${fields.join("; ")} }`;
+        }
+        if (isJsonObject(schema.patternProperties)) {
+            const valueTypes = Object.values(schema.patternProperties)
+                .map((value) => (isJsonObject(value) ? schemaType(value) : "JSON value"))
+                .filter((value, index, values) => values.indexOf(value) === index);
+            if (valueTypes.length > 0)
+                return `Record<string, ${valueTypes.join(" | ")}>`;
+        }
+        return "object";
+    }
+    if (isJsonArray(schema.type)) {
+        return schema.type
+            .filter(isJsonString)
+            .filter((value, index, values) => values.indexOf(value) === index)
+            .join(" | ");
+    }
+    if (isJsonString(schema.type))
+        return schema.type;
+    if (isJsonString(schema.$ref)) {
+        const segments = schema.$ref.split(/[/#]/).filter((segment) => segment !== "");
+        return segments.at(-1) ?? "referenced value";
+    }
+    return "JSON value";
+}
+function collectRows(properties, defaults, prefix = []) {
+    const rows = [];
+    for (const [key, value] of Object.entries(properties)) {
+        if (key === "$schema" || !isJsonObject(value))
+            continue;
+        const path = [...prefix, key];
+        if (value.type === "object" && isJsonObject(value.properties)) {
+            rows.push(...collectRows(value.properties, defaults, path));
+            continue;
+        }
+        const type = schemaType(value);
+        if (type.length > MAX_INLINE_TYPE_CHARACTERS) {
+            throw new TypeError(`Generated README type for "${path.join(".")}" is too long; add a concise PascalCase title to the complex item or record-value schema.`);
+        }
+        rows.push({
+            path: path.join("."),
+            type,
+            defaultValue: valueAtPath(defaults, path),
+            description: isJsonString(value.description) ? value.description : "",
+        });
+    }
+    return rows;
+}
+function markdownCell(value) {
+    return value.replaceAll("|", "\\|").replaceAll("\n", " ");
+}
+function canRenderDefaultInline(value) {
+    if (value === null || isJsonBoolean(value) || isJsonNumber(value))
+        return true;
+    if (isJsonString(value)) {
+        return (!value.includes("\n") && JSON.stringify(value).length <= MAX_INLINE_DEFAULT_CHARACTERS);
+    }
+    if (Array.isArray(value))
+        return value.length === 0;
+    return Object.keys(value).length === 0;
+}
+function formatDefault(value) {
+    if (value === undefined)
+        return "—";
+    if (!canRenderDefaultInline(value))
+        return "*See JSON below*";
+    return markdownCode(markdownCell(JSON.stringify(value)));
+}
+export function renderReadmeSettingsSection(definition, options = {}) {
+    const fileSchema = createSettingsFileSchema(definition);
+    /* v8 ignore next -- createSettingsFileSchema always returns an object properties map */
+    if (!isJsonObject(fileSchema.properties)) {
+        throw new TypeError("Generated settings schema does not contain properties.");
+    }
+    const rows = collectRows(fileSchema.properties, definition.defaultSettings);
+    const tableRows = rows.map((row) => `| ${markdownCell(markdownCode(row.path))} | ${markdownCell(row.type)} | ${formatDefault(row.defaultValue)} | ${markdownCell(row.description)} |`);
+    const globalPath = options.globalPath ?? defaultGlobalSettingsDisplayPath(definition.id);
+    const defaultDocument = createDefaultSettingsDocument(definition);
+    const documentation = [
+        "## Configuration",
+        "",
+        `Global settings are stored in ${markdownCode(globalPath)}.`,
+        "",
+        "| Option | Type | Default | Description |",
+        "| --- | --- | --- | --- |",
+        ...tableRows,
+        "",
+    ];
+    if (definition.exampleSettings !== undefined) {
+        documentation.push("### Defaults", "");
+    }
+    documentation.push("```json", JSON.stringify(defaultDocument, undefined, 2), "```");
+    if (definition.exampleSettings !== undefined) {
+        const exampleDocument = createSettingsDocument(definition.id, definition.exampleSettings);
+        documentation.push("", "### Advanced example", "", "```json", JSON.stringify(exampleDocument, undefined, 2), "```");
+    }
+    return documentation.join("\n");
+}
+export function replaceGeneratedReadmeSection(readme, generatedSection) {
+    const start = readme.indexOf(README_GENERATED_START);
+    const end = readme.indexOf(README_GENERATED_END);
+    if (start < 0 && end < 0) {
+        return `${readme.trimEnd()}\n\n${README_GENERATED_START}\n${generatedSection.trim()}\n${README_GENERATED_END}\n`;
+    }
+    if (start < 0 || end < start)
+        return undefined;
+    if (readme.indexOf(README_GENERATED_START, start + 1) >= 0)
+        return undefined;
+    if (readme.indexOf(README_GENERATED_END, end + 1) >= 0)
+        return undefined;
+    const before = readme.slice(0, start + README_GENERATED_START.length);
+    const after = readme.slice(end);
+    return `${before}\n${generatedSection.trim()}\n${after}`;
+}
+//# sourceMappingURL=settings-documentation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-documentation.js","sourceRoot":"","sources":["../src/settings-documentation.ts"],"names":[],"mappings":"AACA,OAAO,EACH,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,GAGf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EACH,6BAA6B,EAC7B,sBAAsB,EACtB,wBAAwB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,sBAAsB,GAAG,sCAAsC,CAAC;AAC7E,MAAM,CAAC,MAAM,oBAAoB,GAAG,oCAAoC,CAAC;AAEzE,MAAM,6BAA6B,GAAG,EAAE,CAAC;AACzC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AACvC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AASrD,SAAS,WAAW,CAAC,IAAgB,EAAE,IAAuB;IAC1D,IAAI,OAAO,GAAc,IAAI,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC;QAC7C,MAAM,IAAI,GAA0B,OAAO,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzC,OAAO,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IAC/B,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,eAAe,CAAC;IAEzC,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,YAAY,GACd,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IACpD,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB;IACjC,IAAI,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1E,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAkB;IAC3C,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7E,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,OAAO,MAAM,CAAC,IAAI,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAgB,EAAE,KAA0B;IAC9E,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,6BAA6B,CAAC,MAAkB,EAAE,KAA0B;IACjF,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,4BAA4B,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,CACH,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,4BAA4B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAC3E,CAAC;IACN,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;IAClD,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,OAAO,YAAY,CAAC,KAAK,CACrB,CAAC,WAAW,EAAE,EAAE,CACZ,YAAY,CAAC,WAAW,CAAC,IAAI,6BAA6B,CAAC,WAAW,EAAE,KAAK,CAAC,CACrF,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CAAC,MAAkB;IACvC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAClC,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,SAAS,UAAU,CAAC,MAAkB;IAClC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;IAClD,IAAI,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG,IAAI,GAAG,CAC1B,OAAO;aACF,GAAG,CAAC,mBAAmB,CAAC;aACxB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAC/D,CAAC;QACF,MAAM,qBAAqB,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE3D,OAAO,OAAO;aACT,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE;YACpB,MAAM,UAAU,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;YACpD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,qBAAqB,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,CAAC,6BAA6B,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACvE,CAAC,CAAC;aACD,GAAG,CAAC,UAAU,CAAC;aACf,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;aACjE,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,QAAQ,KAAK,CAAC;QACvD,OAAO,GAAG,QAAQ,IAAI,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,CACpB,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAC3E,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAClE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC9C,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;gBACpE,OAAO,GAAG,GAAG,GAAG,QAAQ,KAAK,IAAI,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC;YACH,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,CAAC;QACD,IAAI,YAAY,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;iBACrD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;iBACxE,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;YACvE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,kBAAkB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAClF,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,IAAI;aACb,MAAM,CAAC,YAAY,CAAC;aACpB,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;aACjE,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAClD,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC;IACjD,CAAC;IACD,OAAO,YAAY,CAAC;AACxB,CAAC;AAED,SAAS,WAAW,CAChB,UAAsB,EACtB,QAAoB,EACpB,SAA4B,EAAE;IAE9B,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,SAAS;QACxD,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC5D,SAAS;QACb,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,GAAG,0BAA0B,EAAE,CAAC;YAC3C,MAAM,IAAI,SAAS,CACf,8BAA8B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,2FAA2F,CAC1I,CAAC;QACN,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACN,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YACpB,IAAI;YACJ,YAAY,EAAE,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC;YACzC,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;SACxE,CAAC,CAAC;IACP,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAgB;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CACH,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,6BAA6B,CACzF,CAAC;IACN,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,KAA4B;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACpC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAC9D,OAAO,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAMD,MAAM,UAAU,2BAA2B,CACvC,UAAuC,EACvC,UAA+B,EAAE;IAEjC,MAAM,UAAU,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACxD,wFAAwF;IACxF,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACtB,CAAC,GAAG,EAAE,EAAE,CACJ,KAAK,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CACxJ,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gCAAgC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACzF,MAAM,eAAe,GAAG,6BAA6B,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG;QAClB,kBAAkB;QAClB,EAAE;QACF,iCAAiC,YAAY,CAAC,UAAU,CAAC,GAAG;QAC5D,EAAE;QACF,2CAA2C;QAC3C,2BAA2B;QAC3B,GAAG,SAAS;QACZ,EAAE;KACL,CAAC;IAEF,IAAI,UAAU,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC3C,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEpF,IAAI,UAAU,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,eAAe,GAAG,sBAAsB,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;QAC1F,aAAa,CAAC,IAAI,CACd,EAAE,EACF,sBAAsB,EACtB,EAAE,EACF,SAAS,EACT,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC,EAC7C,KAAK,CACR,CAAC;IACN,CAAC;IAED,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,6BAA6B,CACzC,MAAc,EACd,gBAAwB;IAExB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,sBAAsB,KAAK,gBAAgB,CAAC,IAAI,EAAE,KAAK,oBAAoB,IAAI,CAAC;IACrH,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,KAAK;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7E,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,GAAG,MAAM,KAAK,gBAAgB,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;AAC7D,CAAC","sourcesContent":["import type { ExtensionSettingsDefinition } from \"./definition.ts\";\nimport {\n    isJsonArray,\n    isJsonBoolean,\n    isJsonNumber,\n    isJsonObject,\n    isJsonString,\n    type JsonObject,\n    type JsonValue,\n} from \"./json-value.ts\";\nimport { defaultGlobalSettingsDisplayPath } from \"./paths.ts\";\nimport {\n    createDefaultSettingsDocument,\n    createSettingsDocument,\n    createSettingsFileSchema,\n} from \"./schema-document.ts\";\n\nexport const README_GENERATED_START = \"<!-- pi-extension-settings:start -->\";\nexport const README_GENERATED_END = \"<!-- pi-extension-settings:end -->\";\n\nconst MAX_INLINE_DEFAULT_CHARACTERS = 48;\nconst MAX_INLINE_TYPE_CHARACTERS = 120;\nconst TYPE_NAME_PATTERN = /^[A-Z][A-Za-z0-9]{0,39}$/;\n\ntype SettingsRow = {\n    readonly path: string;\n    readonly type: string;\n    readonly defaultValue: JsonValue | undefined;\n    readonly description: string;\n};\n\nfunction valueAtPath(root: JsonObject, path: readonly string[]): JsonValue | undefined {\n    let current: JsonValue = root;\n    for (const segment of path) {\n        if (!isJsonObject(current)) return undefined;\n        const next: JsonValue | undefined = current[segment];\n        if (next === undefined) return undefined;\n        current = next;\n    }\n    return current;\n}\n\nfunction markdownCode(value: string): string {\n    if (value === \"\") return \"<code></code>\";\n\n    let longestBacktickRun = 0;\n    for (const match of value.matchAll(/`+/g)) {\n        longestBacktickRun = Math.max(longestBacktickRun, match[0].length);\n    }\n    const fence = \"`\".repeat(longestBacktickRun + 1);\n    const needsPadding =\n        value.startsWith(\"`\") ||\n        value.endsWith(\"`\") ||\n        value.startsWith(\" \") ||\n        value.endsWith(\" \");\n    const content = needsPadding ? ` ${value} ` : value;\n    return `${fence}${content}${fence}`;\n}\n\nfunction literalType(value: JsonValue): string {\n    if (isJsonString(value)) return markdownCode(value === \"\" ? '\"\"' : value);\n    return markdownCode(JSON.stringify(value));\n}\n\nfunction directPrimitiveType(schema: JsonObject): string | undefined {\n    if (schema.const !== undefined || isJsonArray(schema.enum)) return undefined;\n    if (!isJsonString(schema.type)) return undefined;\n    if ([\"boolean\", \"integer\", \"null\", \"number\", \"string\"].includes(schema.type)) {\n        return schema.type;\n    }\n    return undefined;\n}\n\nfunction valueCoveredByPrimitiveTypes(value: JsonValue, types: ReadonlySet<string>): boolean {\n    if (value === null) return types.has(\"null\");\n    if (isJsonNumber(value)) {\n        if (types.has(\"number\")) return true;\n        return Number.isInteger(value) && types.has(\"integer\");\n    }\n    if (isJsonBoolean(value)) return types.has(\"boolean\");\n    if (isJsonString(value)) return types.has(\"string\");\n    return false;\n}\n\nfunction schemaCoveredByPrimitiveTypes(schema: JsonObject, types: ReadonlySet<string>): boolean {\n    if (schema.const !== undefined) {\n        return valueCoveredByPrimitiveTypes(schema.const, types);\n    }\n    if (isJsonArray(schema.enum)) {\n        return (\n            schema.enum.length > 0 &&\n            schema.enum.every((value) => valueCoveredByPrimitiveTypes(value, types))\n        );\n    }\n    const alternatives = schema.anyOf ?? schema.oneOf;\n    if (!isJsonArray(alternatives) || alternatives.length === 0) return false;\n    return alternatives.every(\n        (alternative) =>\n            isJsonObject(alternative) && schemaCoveredByPrimitiveTypes(alternative, types),\n    );\n}\n\nfunction schemaTypeTitle(schema: JsonObject): string | undefined {\n    if (!isJsonString(schema.title)) return undefined;\n    const title = schema.title.trim();\n    return TYPE_NAME_PATTERN.test(title) ? title : undefined;\n}\n\nfunction schemaType(schema: JsonObject): string {\n    if (schema.const !== undefined) return literalType(schema.const);\n    if (isJsonArray(schema.enum)) {\n        return schema.enum.map(literalType).join(\" | \");\n    }\n\n    const alternatives = schema.anyOf ?? schema.oneOf;\n    if (isJsonArray(alternatives)) {\n        const schemas = alternatives.filter(isJsonObject);\n        const primitiveTypes = new Set(\n            schemas\n                .map(directPrimitiveType)\n                .filter((value): value is string => value !== undefined),\n        );\n        const numberSubsumesInteger = primitiveTypes.has(\"number\");\n\n        return schemas\n            .filter((alternative) => {\n                const directType = directPrimitiveType(alternative);\n                if (directType !== undefined) {\n                    return !(directType === \"integer\" && numberSubsumesInteger);\n                }\n                return !schemaCoveredByPrimitiveTypes(alternative, primitiveTypes);\n            })\n            .map(schemaType)\n            .filter((value, index, values) => values.indexOf(value) === index)\n            .join(\" | \");\n    }\n\n    if (schema.type === \"array\") {\n        if (!isJsonObject(schema.items)) return \"array\";\n        const itemType = schemaType(schema.items);\n        if (itemType.includes(\" | \")) return `(${itemType})[]`;\n        return `${itemType}[]`;\n    }\n    if (schema.type === \"object\") {\n        const title = schemaTypeTitle(schema);\n        if (title !== undefined) return title;\n        if (isJsonObject(schema.properties)) {\n            const required = new Set(\n                isJsonArray(schema.required) ? schema.required.filter(isJsonString) : [],\n            );\n            const fields = Object.entries(schema.properties).map(([key, value]) => {\n                const optional = required.has(key) ? \"\" : \"?\";\n                const type = isJsonObject(value) ? schemaType(value) : \"JSON value\";\n                return `${key}${optional}: ${type}`;\n            });\n            return `{ ${fields.join(\"; \")} }`;\n        }\n        if (isJsonObject(schema.patternProperties)) {\n            const valueTypes = Object.values(schema.patternProperties)\n                .map((value) => (isJsonObject(value) ? schemaType(value) : \"JSON value\"))\n                .filter((value, index, values) => values.indexOf(value) === index);\n            if (valueTypes.length > 0) return `Record<string, ${valueTypes.join(\" | \")}>`;\n        }\n        return \"object\";\n    }\n    if (isJsonArray(schema.type)) {\n        return schema.type\n            .filter(isJsonString)\n            .filter((value, index, values) => values.indexOf(value) === index)\n            .join(\" | \");\n    }\n    if (isJsonString(schema.type)) return schema.type;\n    if (isJsonString(schema.$ref)) {\n        const segments = schema.$ref.split(/[/#]/).filter((segment) => segment !== \"\");\n        return segments.at(-1) ?? \"referenced value\";\n    }\n    return \"JSON value\";\n}\n\nfunction collectRows(\n    properties: JsonObject,\n    defaults: JsonObject,\n    prefix: readonly string[] = [],\n): readonly SettingsRow[] {\n    const rows: SettingsRow[] = [];\n    for (const [key, value] of Object.entries(properties)) {\n        if (key === \"$schema\" || !isJsonObject(value)) continue;\n        const path = [...prefix, key];\n        if (value.type === \"object\" && isJsonObject(value.properties)) {\n            rows.push(...collectRows(value.properties, defaults, path));\n            continue;\n        }\n        const type = schemaType(value);\n        if (type.length > MAX_INLINE_TYPE_CHARACTERS) {\n            throw new TypeError(\n                `Generated README type for \"${path.join(\".\")}\" is too long; add a concise PascalCase title to the complex item or record-value schema.`,\n            );\n        }\n        rows.push({\n            path: path.join(\".\"),\n            type,\n            defaultValue: valueAtPath(defaults, path),\n            description: isJsonString(value.description) ? value.description : \"\",\n        });\n    }\n    return rows;\n}\n\nfunction markdownCell(value: string): string {\n    return value.replaceAll(\"|\", \"\\\\|\").replaceAll(\"\\n\", \" \");\n}\n\nfunction canRenderDefaultInline(value: JsonValue): boolean {\n    if (value === null || isJsonBoolean(value) || isJsonNumber(value)) return true;\n    if (isJsonString(value)) {\n        return (\n            !value.includes(\"\\n\") && JSON.stringify(value).length <= MAX_INLINE_DEFAULT_CHARACTERS\n        );\n    }\n    if (Array.isArray(value)) return value.length === 0;\n    return Object.keys(value).length === 0;\n}\n\nfunction formatDefault(value: JsonValue | undefined): string {\n    if (value === undefined) return \"—\";\n    if (!canRenderDefaultInline(value)) return \"*See JSON below*\";\n    return markdownCode(markdownCell(JSON.stringify(value)));\n}\n\nexport type RenderReadmeOptions = {\n    readonly globalPath?: string;\n};\n\nexport function renderReadmeSettingsSection(\n    definition: ExtensionSettingsDefinition,\n    options: RenderReadmeOptions = {},\n): string {\n    const fileSchema = createSettingsFileSchema(definition);\n    /* v8 ignore next -- createSettingsFileSchema always returns an object properties map */\n    if (!isJsonObject(fileSchema.properties)) {\n        throw new TypeError(\"Generated settings schema does not contain properties.\");\n    }\n\n    const rows = collectRows(fileSchema.properties, definition.defaultSettings);\n    const tableRows = rows.map(\n        (row) =>\n            `| ${markdownCell(markdownCode(row.path))} | ${markdownCell(row.type)} | ${formatDefault(row.defaultValue)} | ${markdownCell(row.description)} |`,\n    );\n    const globalPath = options.globalPath ?? defaultGlobalSettingsDisplayPath(definition.id);\n    const defaultDocument = createDefaultSettingsDocument(definition);\n    const documentation = [\n        \"## Configuration\",\n        \"\",\n        `Global settings are stored in ${markdownCode(globalPath)}.`,\n        \"\",\n        \"| Option | Type | Default | Description |\",\n        \"| --- | --- | --- | --- |\",\n        ...tableRows,\n        \"\",\n    ];\n\n    if (definition.exampleSettings !== undefined) {\n        documentation.push(\"### Defaults\", \"\");\n    }\n    documentation.push(\"```json\", JSON.stringify(defaultDocument, undefined, 2), \"```\");\n\n    if (definition.exampleSettings !== undefined) {\n        const exampleDocument = createSettingsDocument(definition.id, definition.exampleSettings);\n        documentation.push(\n            \"\",\n            \"### Advanced example\",\n            \"\",\n            \"```json\",\n            JSON.stringify(exampleDocument, undefined, 2),\n            \"```\",\n        );\n    }\n\n    return documentation.join(\"\\n\");\n}\n\nexport function replaceGeneratedReadmeSection(\n    readme: string,\n    generatedSection: string,\n): string | undefined {\n    const start = readme.indexOf(README_GENERATED_START);\n    const end = readme.indexOf(README_GENERATED_END);\n    if (start < 0 && end < 0) {\n        return `${readme.trimEnd()}\\n\\n${README_GENERATED_START}\\n${generatedSection.trim()}\\n${README_GENERATED_END}\\n`;\n    }\n    if (start < 0 || end < start) return undefined;\n    if (readme.indexOf(README_GENERATED_START, start + 1) >= 0) return undefined;\n    if (readme.indexOf(README_GENERATED_END, end + 1) >= 0) return undefined;\n\n    const before = readme.slice(0, start + README_GENERATED_START.length);\n    const after = readme.slice(end);\n    return `${before}\\n${generatedSection.trim()}\\n${after}`;\n}\n"]}

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

@@ -0,0 +1,59 @@
+import type { TObject, TSchema } from "typebox";
+import { type JsonObject, type JsonValue } from "./json-value.ts";
+export type SettingsScope = "global" | "project";
+/**
+ * Stable machine-readable category for a non-fatal settings problem.
+ *
+ * Callers should branch on this value rather than diagnostic text:
+ *
+ * - `bundled-schema-read-failed`: the generated schema could not be read.
+ * - `bundled-schema-stale`: the bundled schema does not match the definition.
+ * - `config-decode-failed`: a validated layer could not be decoded by TypeBox.
+ * - `config-invalid`: a layer failed validation or conflicted with an earlier layer.
+ * - `config-malformed`: a settings file contains malformed JSON.
+ * - `config-read-failed`: a settings file could not be read.
+ * - `config-scaffold-failed`: the initial global settings file could not be created.
+ * - `schema-install-failed`: the editor schema could not be installed.
+ */
+export type SettingsDiagnosticCode = "bundled-schema-read-failed" | "bundled-schema-stale" | "config-decode-failed" | "config-invalid" | "config-malformed" | "config-read-failed" | "config-scaffold-failed" | "schema-install-failed";
+export type SettingsValidationIssue = {
+    /** JSON Pointer to the invalid setting, or `/` for the document root. */
+    readonly path: string;
+    /** TypeBox validation message for this issue. */
+    readonly message: string;
+};
+/**
+ * A non-fatal problem encountered while loading settings.
+ *
+ * The affected schema or settings layer is ignored. Messages and validation issues contain no
+ * settings values, making them suitable for display through Pi's UI.
+ */
+export type SettingsDiagnostic = {
+    /** Stable category intended for programmatic handling. */
+    readonly code: SettingsDiagnosticCode;
+    /** All current diagnostics are errors; the field allows direct use with `ctx.ui.notify`. */
+    readonly severity: "error";
+    /** The settings layer or editor-schema operation that failed. */
+    readonly scope: SettingsScope | "schema";
+    /** Absolute path of the affected settings or schema file. */
+    readonly path: string;
+    /** User-facing summary that does not include settings values. */
+    readonly message: string;
+    /** JSON Pointer paths and validator messages when schema validation failed. */
+    readonly issues?: readonly SettingsValidationIssue[];
+};
+export type ParsedSettingsLayer = {
+    /** Encoded JSON settings after editor-only metadata is removed. */
+    readonly settings: JsonObject | undefined;
+    /** Editor schema reference from the file, when present and valid. */
+    readonly schemaReference: string | undefined;
+    readonly diagnostics: readonly SettingsDiagnostic[];
+};
+export declare function settingsValidationIssues(schema: TSchema, value: JsonValue): readonly SettingsValidationIssue[];
+export declare function parseSettingsLayer(path: string, scope: SettingsScope, text: string, layerSchema: TSchema): ParsedSettingsLayer;
+export type AppliedSettingsLayer = {
+    readonly settings: JsonObject;
+    readonly diagnostic?: SettingsDiagnostic;
+};
+export declare function applySettingsLayer<Schema extends TObject>(schema: Schema, current: JsonObject, layer: Pick<ParsedSettingsLayer, "settings">, path: string, scope: SettingsScope): AppliedSettingsLayer;
+//# sourceMappingURL=settings-layer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-layer.d.ts","sourceRoot":"","sources":["../src/settings-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIhD,OAAO,EAKH,KAAK,UAAU,EACf,KAAK,SAAS,EACjB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,sBAAsB,GAC5B,4BAA4B,GAC5B,sBAAsB,GACtB,sBAAsB,GACtB,gBAAgB,GAChB,kBAAkB,GAClB,oBAAoB,GACpB,wBAAwB,GACxB,uBAAuB,CAAC;AAE9B,MAAM,MAAM,uBAAuB,GAAG;IAClC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACvD,CAAC;AAEF,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,SAAS,GACjB,SAAS,uBAAuB,EAAE,CAKpC;AAED,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,GACrB,mBAAmB,CAuErB;AAED,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC5C,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,OAAO,EACrD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,EAC5C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,GACrB,oBAAoB,CAiBtB"}