@dev-sergeev/datalab-kit 0.1.2 → 0.1.3

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

@@ -0,0 +1,159 @@
+import type { Static, StaticDecode, StaticEncode, TObject } from "typebox";
+import { type JsonObject } from "./json-value.ts";
+import { extensionSettingsDefinitionMarker as definitionMarker } from "./definition-marker.ts";
+export declare const ExtensionSettingsDefinitionCandidateSchema: TObject<{
+    id: import("typebox").TOptional<import("typebox").TUnknown>;
+    title: import("typebox").TOptional<import("typebox").TUnknown>;
+    description: import("typebox").TOptional<import("typebox").TUnknown>;
+    schemaId: import("typebox").TOptional<import("typebox").TUnknown>;
+    schema: import("typebox").TOptional<import("typebox").TUnknown>;
+    defaultSettings: import("typebox").TOptional<import("typebox").TUnknown>;
+    exampleSettings: import("typebox").TOptional<import("typebox").TUnknown>;
+}>;
+export type ExtensionSettingsDefinitionCandidate = Static<typeof ExtensionSettingsDefinitionCandidateSchema> & {
+    readonly [definitionMarker]?: unknown;
+};
+export declare class InvalidSettingsDefinition extends Error {
+    readonly name = "InvalidSettingsDefinition";
+    readonly reason: string;
+    constructor(reason: string);
+}
+/**
+ * An immutable settings contract created by {@link defineExtensionSettings}.
+ *
+ * The schema and derived defaults are cloned and recursively frozen. Resolved runtime values retain
+ * the schema's decoded TypeBox type, while `defaultSettings` remains JSON data suitable for writing
+ * to disk.
+ *
+ * @template Schema The TypeBox object schema that defines persisted and resolved settings.
+ */
+export type ExtensionSettingsDefinition<Schema extends TObject = TObject> = {
+    readonly [definitionMarker]: true;
+    /** The stable identifier used in settings and schema filenames. */
+    readonly id: string;
+    /** The display name used in generated schema and README content. */
+    readonly title: string;
+    /** The summary used in generated schema and README content. */
+    readonly description: string;
+    /** The absolute URI written to the generated JSON Schema `$id` field. */
+    readonly schemaId: string;
+    /** A validated, recursively frozen clone of the supplied TypeBox schema. */
+    readonly schema: Schema;
+    /** The schema defaults as recursively frozen JSON data, before TypeBox decoding. */
+    readonly defaultSettings: JsonObject;
+    /** An optional validated example settings layer rendered in generated documentation. */
+    readonly exampleSettings: JsonObject | undefined;
+};
+/** Deeply optional object properties with replacement arrays, matching settings-layer merging. */
+type SettingsLayerValue<Value> = Value extends readonly unknown[] ? Value : Value extends object ? string extends keyof Value ? Value : {
+    [Key in keyof Value]?: SettingsLayerValue<Value[Key]>;
+} : Value;
+/**
+ * Encoded JSON layer persisted for an extension's global or project settings.
+ *
+ * Object properties are recursively optional because layers merge over schema defaults. Arrays and
+ * scalar values remain complete replacements. Values use the schema's encoded representation, not
+ * the decoded runtime representation returned by `loadPiExtensionSettings`.
+ *
+ * @template Schema The TypeBox object schema from an extension settings definition.
+ */
+export type ExtensionSettingsLayer<Schema extends TObject> = SettingsLayerValue<StaticEncode<Schema>>;
+/**
+ * Input accepted by {@link defineExtensionSettings}.
+ *
+ * @template Schema The TypeBox object schema that determines the returned settings type.
+ */
+export type ExtensionSettingsDefinitionInput<Schema extends TObject> = {
+    /**
+     * Stable identity used in settings filenames.
+     *
+     * Must contain 1–128 lowercase letters, digits, dots, underscores, or hyphens; the first and
+     * last characters must be alphanumeric. Changing this value moves the extension to different
+     * settings files.
+     */
+    readonly id: string;
+    /** Non-blank display name for generated documentation and JSON Schema metadata. */
+    readonly title: string;
+    /** Non-blank summary for generated documentation and JSON Schema metadata. */
+    readonly description: string;
+    /**
+     * Absolute URI for the generated JSON Schema `$id`.
+     *
+     * Defaults to `urn:pi-extension-settings:<id>`.
+     */
+    readonly schemaId?: string;
+    /**
+     * TypeBox object schema for resolved settings.
+     *
+     * Every object must set `additionalProperties: false`, every user-facing leaf must have a
+     * non-blank description, and every required property must resolve to a valid JSON default.
+     * `$schema` is reserved for editor metadata and cannot be declared as a setting.
+     */
+    readonly schema: Schema;
+    /**
+     * A realistic, non-default settings layer rendered after the default configuration.
+     *
+     * Use this only when complex settings—such as structured arrays, nested objects, maps, or
+     * unions—benefit from a realistic advanced setup. The value must be valid JSON, must match the
+     * generated settings-file schema, and must resolve to valid settings when merged over the
+     * defaults. Nested object properties may be partial; arrays remain complete replacement values.
+     * Omit it for simple or self-explanatory settings.
+     */
+    readonly exampleSettings?: ExtensionSettingsLayer<Schema>;
+};
+/**
+ * Defines and validates an extension's settings contract.
+ *
+ * Validation is eager so invalid schemas fail while the extension is loading, before any settings
+ * files are read or written. The input schema is cloned; this function does not mutate caller-owned
+ * data.
+ *
+ * @template Schema The TypeBox object schema used to infer resolved settings.
+ * @param input Identity, documentation metadata, and the TypeBox settings schema.
+ * @returns An immutable definition with validated JSON defaults.
+ * @throws {InvalidSettingsDefinition} If metadata, schema structure, descriptions, or defaults do
+ * not satisfy the settings contract.
+ *
+ * @example
+ * ```ts
+ * import { defineExtensionSettings } from "@zigai/pi-extension-settings";
+ * import { Type } from "typebox";
+ *
+ * export default defineExtensionSettings({
+ *   id: "pi-example",
+ *   title: "Pi Example",
+ *   description: "Settings for Pi Example.",
+ *   schema: Type.Object(
+ *     {
+ *       enabled: Type.Boolean({
+ *         default: true,
+ *         description: "Enable the extension.",
+ *       }),
+ *     },
+ *     { additionalProperties: false },
+ *   ),
+ * });
+ * ```
+ */
+export declare function defineExtensionSettings<const Schema extends TObject>(input: ExtensionSettingsDefinitionInput<Schema>): ExtensionSettingsDefinition<Schema>;
+export declare function defineExtensionSettings(input: ExtensionSettingsDefinitionCandidate): ExtensionSettingsDefinition;
+export declare function isExtensionSettingsDefinition(value: ExtensionSettingsDefinitionCandidate): value is ExtensionSettingsDefinition;
+/**
+ * The decoded runtime settings type produced by an extension definition.
+ *
+ * This preserves TypeBox transforms: it represents values after decoding, not the JSON shape stored
+ * in settings files.
+ *
+ * @template Definition A definition returned by {@link defineExtensionSettings}.
+ *
+ * @example
+ * ```ts
+ * import type { ResolvedSettings } from "@zigai/pi-extension-settings";
+ * import settingsDefinition from "./settings.ts";
+ *
+ * export type Settings = ResolvedSettings<typeof settingsDefinition>;
+ * ```
+ */
+export type ResolvedSettings<Definition extends ExtensionSettingsDefinition> = StaticDecode<Definition["schema"]>;
+export {};
+//# sourceMappingURL=definition.d.ts.map

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

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

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

@@ -0,0 +1,248 @@
+import { isDeepStrictEqual } from "node:util";
+import { IsSchema, Type, Value } from "./typebox-runtime.js";
+import { cloneJson, isJsonObject, JsonValueSchema, parseJson, } from "./json-value.js";
+import { extensionSettingsDefinitionMarker as definitionMarker } from "./definition-marker.js";
+import { createSettingsFileSchema, findNonStrictObjectSchemas, findUndocumentedSettings, hasReservedSchemaProperty, } from "./schema-document.js";
+import { mergeSettings } from "./settings-merge.js";
+const SETTINGS_ID_PATTERN = /^[a-z0-9](?:[a-z0-9._-]{0,126}[a-z0-9])?$/;
+const StringValueSchema = Type.String();
+export const ExtensionSettingsDefinitionCandidateSchema = Type.Object({
+    id: Type.Optional(Type.Unknown()),
+    title: Type.Optional(Type.Unknown()),
+    description: Type.Optional(Type.Unknown()),
+    schemaId: Type.Optional(Type.Unknown()),
+    schema: Type.Optional(Type.Unknown()),
+    defaultSettings: Type.Optional(Type.Unknown()),
+    exampleSettings: Type.Optional(Type.Unknown()),
+}, { additionalProperties: true });
+function isSettingsSchema(value) {
+    if (!IsSchema(value))
+        return false;
+    let serialized;
+    try {
+        serialized = JSON.stringify(value);
+    }
+    catch {
+        return false;
+    }
+    if (serialized === undefined)
+        return false;
+    const parsed = parseJson(serialized);
+    return isJsonObject(parsed) && parsed.type === "object" && isJsonObject(parsed.properties);
+}
+function freezeRecursively(value) {
+    if (Object.isFrozen(value))
+        return;
+    for (const child of Object.values(value)) {
+        if (Value.Check(JsonValueSchema, child)) {
+            if (Array.isArray(child) || isJsonObject(child))
+                freezeRecursively(child);
+        }
+        else if (IsSchema(child)) {
+            freezeRecursively(child);
+        }
+    }
+    Object.freeze(value);
+}
+export class InvalidSettingsDefinition extends Error {
+    name = "InvalidSettingsDefinition";
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+    }
+}
+export function defineExtensionSettings(input) {
+    let id;
+    try {
+        id = Value.Parse(StringValueSchema, input.id);
+    }
+    catch {
+        throw new InvalidSettingsDefinition("id must be 1-128 lowercase filename-safe characters and cannot end with punctuation");
+    }
+    if (!SETTINGS_ID_PATTERN.test(id)) {
+        throw new InvalidSettingsDefinition("id must be 1-128 lowercase filename-safe characters and cannot end with punctuation");
+    }
+    let title;
+    try {
+        title = Value.Parse(StringValueSchema, input.title);
+    }
+    catch {
+        throw new InvalidSettingsDefinition("title must not be blank");
+    }
+    if (title.trim() === "")
+        throw new InvalidSettingsDefinition("title must not be blank");
+    let description;
+    try {
+        description = Value.Parse(StringValueSchema, input.description);
+    }
+    catch {
+        throw new InvalidSettingsDefinition("description must not be blank");
+    }
+    if (description.trim() === "") {
+        throw new InvalidSettingsDefinition("description must not be blank");
+    }
+    let schemaId = `urn:pi-extension-settings:${id}`;
+    if (input.schemaId !== undefined) {
+        try {
+            schemaId = Value.Parse(StringValueSchema, input.schemaId);
+        }
+        catch {
+            throw new InvalidSettingsDefinition("schemaId must be an absolute URI");
+        }
+    }
+    try {
+        new URL(schemaId);
+    }
+    catch {
+        throw new InvalidSettingsDefinition("schemaId must be an absolute URI");
+    }
+    if (!IsSchema(input.schema) || !isSettingsSchema(input.schema)) {
+        throw new InvalidSettingsDefinition("schema must be a TypeBox object schema");
+    }
+    const schema = Value.Clone(input.schema);
+    if (hasReservedSchemaProperty(schema)) {
+        throw new InvalidSettingsDefinition("$schema is reserved for editor metadata");
+    }
+    const nonStrictObjects = findNonStrictObjectSchemas(schema);
+    if (nonStrictObjects.length > 0) {
+        throw new InvalidSettingsDefinition(`object schemas must set additionalProperties to false: ${nonStrictObjects.join(", ")}`);
+    }
+    const undocumentedSettings = findUndocumentedSettings(schema);
+    if (undocumentedSettings.length > 0) {
+        throw new InvalidSettingsDefinition(`user-facing settings must have descriptions: ${undocumentedSettings.join(", ")}`);
+    }
+    const rawDefaults = Value.Default(schema, {});
+    if (!Value.Check(schema, rawDefaults)) {
+        const issues = [...Value.Errors(schema, rawDefaults)]
+            .map((issue) => `${issue.instancePath || "/"}: ${issue.message}`)
+            .join("; ");
+        throw new InvalidSettingsDefinition(`required settings must have valid defaults${issues === "" ? "" : `: ${issues}`}`);
+    }
+    let serializedDefaults;
+    try {
+        serializedDefaults = JSON.stringify(rawDefaults);
+    }
+    catch {
+        throw new InvalidSettingsDefinition("schema defaults must produce a JSON object");
+    }
+    const parsedDefaults = parseJson(serializedDefaults);
+    if (!isJsonObject(parsedDefaults) || !isDeepStrictEqual(rawDefaults, parsedDefaults)) {
+        throw new InvalidSettingsDefinition("schema defaults must produce a JSON object");
+    }
+    try {
+        Value.Decode(schema, rawDefaults);
+    }
+    catch {
+        throw new InvalidSettingsDefinition("schema defaults could not be decoded");
+    }
+    const defaultSettings = cloneJson(parsedDefaults);
+    let exampleSettings;
+    if (input.exampleSettings !== undefined) {
+        let serializedExample;
+        try {
+            serializedExample = JSON.stringify(input.exampleSettings);
+        }
+        catch {
+            throw new InvalidSettingsDefinition("exampleSettings must be a JSON object");
+        }
+        const parsedExample = parseJson(serializedExample);
+        if (!isJsonObject(parsedExample) ||
+            !isDeepStrictEqual(input.exampleSettings, parsedExample)) {
+            throw new InvalidSettingsDefinition("exampleSettings must be a JSON object");
+        }
+        const fileSchema = createSettingsFileSchema({
+            id,
+            title,
+            description,
+            schemaId,
+            schema,
+        });
+        if (!Value.Check(fileSchema, parsedExample)) {
+            const issues = [...Value.Errors(fileSchema, parsedExample)]
+                .map((issue) => `${issue.instancePath || "/"}: ${issue.message}`)
+                .join("; ");
+            throw new InvalidSettingsDefinition(`exampleSettings must match the settings-file schema${issues === "" ? "" : `: ${issues}`}`);
+        }
+        const mergedExample = mergeSettings(defaultSettings, parsedExample);
+        if (!Value.Check(schema, mergedExample)) {
+            throw new InvalidSettingsDefinition("exampleSettings must resolve to valid settings when merged with defaults");
+        }
+        try {
+            Value.Decode(schema, mergedExample);
+        }
+        catch {
+            throw new InvalidSettingsDefinition("exampleSettings could not be decoded");
+        }
+        if (isDeepStrictEqual(mergedExample, defaultSettings)) {
+            throw new InvalidSettingsDefinition("exampleSettings must demonstrate configuration that differs from the defaults");
+        }
+        exampleSettings = cloneJson(parsedExample);
+    }
+    freezeRecursively(schema);
+    freezeRecursively(defaultSettings);
+    if (exampleSettings !== undefined)
+        freezeRecursively(exampleSettings);
+    const definition = Object.freeze({
+        [definitionMarker]: true,
+        id,
+        title,
+        description,
+        schemaId,
+        schema,
+        defaultSettings,
+        exampleSettings,
+    });
+    // Build once during definition so malformed schema structures fail at startup.
+    createSettingsFileSchema(definition);
+    return definition;
+}
+export function isExtensionSettingsDefinition(value) {
+    if (!(definitionMarker in value) || value[definitionMarker] !== true)
+        return false;
+    if (!("id" in value) ||
+        !Value.Check(StringValueSchema, value.id) ||
+        !SETTINGS_ID_PATTERN.test(value.id)) {
+        return false;
+    }
+    if (!("title" in value) || !Value.Check(StringValueSchema, value.title))
+        return false;
+    if (!("description" in value) || !Value.Check(StringValueSchema, value.description)) {
+        return false;
+    }
+    if (!("schemaId" in value) || !Value.Check(StringValueSchema, value.schemaId))
+        return false;
+    if (!("schema" in value) || !IsSchema(value.schema) || !isSettingsSchema(value.schema)) {
+        return false;
+    }
+    if (!("defaultSettings" in value))
+        return false;
+    const exampleSettings = "exampleSettings" in value ? value.exampleSettings : undefined;
+    let serializedDefaults;
+    try {
+        serializedDefaults = JSON.stringify(value.defaultSettings);
+    }
+    catch {
+        return false;
+    }
+    const parsedDefaults = parseJson(serializedDefaults);
+    if (!isJsonObject(parsedDefaults) ||
+        !isDeepStrictEqual(value.defaultSettings, parsedDefaults)) {
+        return false;
+    }
+    if (exampleSettings !== undefined) {
+        let serializedExample;
+        try {
+            serializedExample = JSON.stringify(exampleSettings);
+        }
+        catch {
+            return false;
+        }
+        const parsedExample = parseJson(serializedExample);
+        if (!isJsonObject(parsedExample) || !isDeepStrictEqual(exampleSettings, parsedExample)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=definition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"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","sourcesContent":["import { isDeepStrictEqual } from \"node:util\";\n\nimport type { Static, StaticDecode, StaticEncode, TObject, TSchema } from \"typebox\";\n\nimport { IsSchema, Type, Value } from \"./typebox-runtime.ts\";\n\nimport {\n    cloneJson,\n    isJsonObject,\n    JsonValueSchema,\n    type JsonArray,\n    type JsonObject,\n    parseJson,\n} from \"./json-value.ts\";\nimport { extensionSettingsDefinitionMarker as definitionMarker } from \"./definition-marker.ts\";\nimport {\n    createSettingsFileSchema,\n    findNonStrictObjectSchemas,\n    findUndocumentedSettings,\n    hasReservedSchemaProperty,\n} from \"./schema-document.ts\";\nimport { mergeSettings } from \"./settings-merge.ts\";\n\nconst SETTINGS_ID_PATTERN = /^[a-z0-9](?:[a-z0-9._-]{0,126}[a-z0-9])?$/;\nconst StringValueSchema = Type.String();\n\nexport const ExtensionSettingsDefinitionCandidateSchema = Type.Object(\n    {\n        id: Type.Optional(Type.Unknown()),\n        title: Type.Optional(Type.Unknown()),\n        description: Type.Optional(Type.Unknown()),\n        schemaId: Type.Optional(Type.Unknown()),\n        schema: Type.Optional(Type.Unknown()),\n        defaultSettings: Type.Optional(Type.Unknown()),\n        exampleSettings: Type.Optional(Type.Unknown()),\n    },\n    { additionalProperties: true },\n);\n\nexport type ExtensionSettingsDefinitionCandidate = Static<\n    typeof ExtensionSettingsDefinitionCandidateSchema\n> & {\n    readonly [definitionMarker]?: unknown;\n};\n\nfunction isSettingsSchema(value: TSchema): value is TObject {\n    if (!IsSchema(value)) return false;\n    let serialized: string | undefined;\n    try {\n        serialized = JSON.stringify(value);\n    } catch {\n        return false;\n    }\n    if (serialized === undefined) return false;\n    const parsed = parseJson(serialized);\n    return isJsonObject(parsed) && parsed.type === \"object\" && isJsonObject(parsed.properties);\n}\n\nfunction freezeRecursively(value: JsonArray | JsonObject | TSchema): void {\n    if (Object.isFrozen(value)) return;\n    for (const child of Object.values(value)) {\n        if (Value.Check(JsonValueSchema, child)) {\n            if (Array.isArray(child) || isJsonObject(child)) freezeRecursively(child);\n        } else if (IsSchema(child)) {\n            freezeRecursively(child);\n        }\n    }\n    Object.freeze(value);\n}\n\nexport class InvalidSettingsDefinition extends Error {\n    override readonly name = \"InvalidSettingsDefinition\";\n    readonly reason: string;\n\n    constructor(reason: string) {\n        super(reason);\n        this.reason = reason;\n    }\n}\n\n/**\n * An immutable settings contract created by {@link defineExtensionSettings}.\n *\n * The schema and derived defaults are cloned and recursively frozen. Resolved runtime values retain\n * the schema's decoded TypeBox type, while `defaultSettings` remains JSON data suitable for writing\n * to disk.\n *\n * @template Schema The TypeBox object schema that defines persisted and resolved settings.\n */\nexport type ExtensionSettingsDefinition<Schema extends TObject = TObject> = {\n    readonly [definitionMarker]: true;\n    /** The stable identifier used in settings and schema filenames. */\n    readonly id: string;\n    /** The display name used in generated schema and README content. */\n    readonly title: string;\n    /** The summary used in generated schema and README content. */\n    readonly description: string;\n    /** The absolute URI written to the generated JSON Schema `$id` field. */\n    readonly schemaId: string;\n    /** A validated, recursively frozen clone of the supplied TypeBox schema. */\n    readonly schema: Schema;\n    /** The schema defaults as recursively frozen JSON data, before TypeBox decoding. */\n    readonly defaultSettings: JsonObject;\n    /** An optional validated example settings layer rendered in generated documentation. */\n    readonly exampleSettings: JsonObject | undefined;\n};\n\n/** Deeply optional object properties with replacement arrays, matching settings-layer merging. */\ntype SettingsLayerValue<Value> = Value extends readonly unknown[]\n    ? Value\n    : Value extends object\n      ? string extends keyof Value\n          ? Value\n          : { [Key in keyof Value]?: SettingsLayerValue<Value[Key]> }\n      : Value;\n\n/**\n * Encoded JSON layer persisted for an extension's global or project settings.\n *\n * Object properties are recursively optional because layers merge over schema defaults. Arrays and\n * scalar values remain complete replacements. Values use the schema's encoded representation, not\n * the decoded runtime representation returned by `loadPiExtensionSettings`.\n *\n * @template Schema The TypeBox object schema from an extension settings definition.\n */\nexport type ExtensionSettingsLayer<Schema extends TObject> = SettingsLayerValue<\n    StaticEncode<Schema>\n>;\n\n/**\n * Input accepted by {@link defineExtensionSettings}.\n *\n * @template Schema The TypeBox object schema that determines the returned settings type.\n */\nexport type ExtensionSettingsDefinitionInput<Schema extends TObject> = {\n    /**\n     * Stable identity used in settings filenames.\n     *\n     * Must contain 1–128 lowercase letters, digits, dots, underscores, or hyphens; the first and\n     * last characters must be alphanumeric. Changing this value moves the extension to different\n     * settings files.\n     */\n    readonly id: string;\n    /** Non-blank display name for generated documentation and JSON Schema metadata. */\n    readonly title: string;\n    /** Non-blank summary for generated documentation and JSON Schema metadata. */\n    readonly description: string;\n    /**\n     * Absolute URI for the generated JSON Schema `$id`.\n     *\n     * Defaults to `urn:pi-extension-settings:<id>`.\n     */\n    readonly schemaId?: string;\n    /**\n     * TypeBox object schema for resolved settings.\n     *\n     * Every object must set `additionalProperties: false`, every user-facing leaf must have a\n     * non-blank description, and every required property must resolve to a valid JSON default.\n     * `$schema` is reserved for editor metadata and cannot be declared as a setting.\n     */\n    readonly schema: Schema;\n    /**\n     * A realistic, non-default settings layer rendered after the default configuration.\n     *\n     * Use this only when complex settings—such as structured arrays, nested objects, maps, or\n     * unions—benefit from a realistic advanced setup. The value must be valid JSON, must match the\n     * generated settings-file schema, and must resolve to valid settings when merged over the\n     * defaults. Nested object properties may be partial; arrays remain complete replacement values.\n     * Omit it for simple or self-explanatory settings.\n     */\n    readonly exampleSettings?: ExtensionSettingsLayer<Schema>;\n};\n\n/**\n * Defines and validates an extension's settings contract.\n *\n * Validation is eager so invalid schemas fail while the extension is loading, before any settings\n * files are read or written. The input schema is cloned; this function does not mutate caller-owned\n * data.\n *\n * @template Schema The TypeBox object schema used to infer resolved settings.\n * @param input Identity, documentation metadata, and the TypeBox settings schema.\n * @returns An immutable definition with validated JSON defaults.\n * @throws {InvalidSettingsDefinition} If metadata, schema structure, descriptions, or defaults do\n * not satisfy the settings contract.\n *\n * @example\n * ```ts\n * import { defineExtensionSettings } from \"@zigai/pi-extension-settings\";\n * import { Type } from \"typebox\";\n *\n * export default defineExtensionSettings({\n *   id: \"pi-example\",\n *   title: \"Pi Example\",\n *   description: \"Settings for Pi Example.\",\n *   schema: Type.Object(\n *     {\n *       enabled: Type.Boolean({\n *         default: true,\n *         description: \"Enable the extension.\",\n *       }),\n *     },\n *     { additionalProperties: false },\n *   ),\n * });\n * ```\n */\nexport function defineExtensionSettings<const Schema extends TObject>(\n    input: ExtensionSettingsDefinitionInput<Schema>,\n): ExtensionSettingsDefinition<Schema>;\nexport function defineExtensionSettings(\n    input: ExtensionSettingsDefinitionCandidate,\n): ExtensionSettingsDefinition;\nexport function defineExtensionSettings(\n    input: ExtensionSettingsDefinitionCandidate,\n): ExtensionSettingsDefinition {\n    let id: string;\n    try {\n        id = Value.Parse(StringValueSchema, input.id);\n    } catch {\n        throw new InvalidSettingsDefinition(\n            \"id must be 1-128 lowercase filename-safe characters and cannot end with punctuation\",\n        );\n    }\n    if (!SETTINGS_ID_PATTERN.test(id)) {\n        throw new InvalidSettingsDefinition(\n            \"id must be 1-128 lowercase filename-safe characters and cannot end with punctuation\",\n        );\n    }\n\n    let title: string;\n    try {\n        title = Value.Parse(StringValueSchema, input.title);\n    } catch {\n        throw new InvalidSettingsDefinition(\"title must not be blank\");\n    }\n    if (title.trim() === \"\") throw new InvalidSettingsDefinition(\"title must not be blank\");\n\n    let description: string;\n    try {\n        description = Value.Parse(StringValueSchema, input.description);\n    } catch {\n        throw new InvalidSettingsDefinition(\"description must not be blank\");\n    }\n    if (description.trim() === \"\") {\n        throw new InvalidSettingsDefinition(\"description must not be blank\");\n    }\n\n    let schemaId = `urn:pi-extension-settings:${id}`;\n    if (input.schemaId !== undefined) {\n        try {\n            schemaId = Value.Parse(StringValueSchema, input.schemaId);\n        } catch {\n            throw new InvalidSettingsDefinition(\"schemaId must be an absolute URI\");\n        }\n    }\n    try {\n        new URL(schemaId);\n    } catch {\n        throw new InvalidSettingsDefinition(\"schemaId must be an absolute URI\");\n    }\n\n    if (!IsSchema(input.schema) || !isSettingsSchema(input.schema)) {\n        throw new InvalidSettingsDefinition(\"schema must be a TypeBox object schema\");\n    }\n    const schema = Value.Clone(input.schema);\n    if (hasReservedSchemaProperty(schema)) {\n        throw new InvalidSettingsDefinition(\"$schema is reserved for editor metadata\");\n    }\n\n    const nonStrictObjects = findNonStrictObjectSchemas(schema);\n    if (nonStrictObjects.length > 0) {\n        throw new InvalidSettingsDefinition(\n            `object schemas must set additionalProperties to false: ${nonStrictObjects.join(\", \")}`,\n        );\n    }\n    const undocumentedSettings = findUndocumentedSettings(schema);\n    if (undocumentedSettings.length > 0) {\n        throw new InvalidSettingsDefinition(\n            `user-facing settings must have descriptions: ${undocumentedSettings.join(\", \")}`,\n        );\n    }\n\n    const rawDefaults: unknown = Value.Default(schema, {});\n    if (!Value.Check(schema, rawDefaults)) {\n        const issues = [...Value.Errors(schema, rawDefaults)]\n            .map((issue) => `${issue.instancePath || \"/\"}: ${issue.message}`)\n            .join(\"; \");\n        throw new InvalidSettingsDefinition(\n            `required settings must have valid defaults${issues === \"\" ? \"\" : `: ${issues}`}`,\n        );\n    }\n    let serializedDefaults: string;\n    try {\n        serializedDefaults = JSON.stringify(rawDefaults);\n    } catch {\n        throw new InvalidSettingsDefinition(\"schema defaults must produce a JSON object\");\n    }\n    const parsedDefaults = parseJson(serializedDefaults);\n    if (!isJsonObject(parsedDefaults) || !isDeepStrictEqual(rawDefaults, parsedDefaults)) {\n        throw new InvalidSettingsDefinition(\"schema defaults must produce a JSON object\");\n    }\n\n    try {\n        Value.Decode(schema, rawDefaults);\n    } catch {\n        throw new InvalidSettingsDefinition(\"schema defaults could not be decoded\");\n    }\n\n    const defaultSettings = cloneJson(parsedDefaults);\n    let exampleSettings: JsonObject | undefined;\n    if (input.exampleSettings !== undefined) {\n        let serializedExample: string;\n        try {\n            serializedExample = JSON.stringify(input.exampleSettings);\n        } catch {\n            throw new InvalidSettingsDefinition(\"exampleSettings must be a JSON object\");\n        }\n        const parsedExample = parseJson(serializedExample);\n        if (\n            !isJsonObject(parsedExample) ||\n            !isDeepStrictEqual(input.exampleSettings, parsedExample)\n        ) {\n            throw new InvalidSettingsDefinition(\"exampleSettings must be a JSON object\");\n        }\n\n        const fileSchema = createSettingsFileSchema({\n            id,\n            title,\n            description,\n            schemaId,\n            schema,\n        });\n        if (!Value.Check(fileSchema, parsedExample)) {\n            const issues = [...Value.Errors(fileSchema, parsedExample)]\n                .map((issue) => `${issue.instancePath || \"/\"}: ${issue.message}`)\n                .join(\"; \");\n            throw new InvalidSettingsDefinition(\n                `exampleSettings must match the settings-file schema${issues === \"\" ? \"\" : `: ${issues}`}`,\n            );\n        }\n\n        const mergedExample = mergeSettings(defaultSettings, parsedExample);\n        if (!Value.Check(schema, mergedExample)) {\n            throw new InvalidSettingsDefinition(\n                \"exampleSettings must resolve to valid settings when merged with defaults\",\n            );\n        }\n        try {\n            Value.Decode(schema, mergedExample);\n        } catch {\n            throw new InvalidSettingsDefinition(\"exampleSettings could not be decoded\");\n        }\n        if (isDeepStrictEqual(mergedExample, defaultSettings)) {\n            throw new InvalidSettingsDefinition(\n                \"exampleSettings must demonstrate configuration that differs from the defaults\",\n            );\n        }\n        exampleSettings = cloneJson(parsedExample);\n    }\n\n    freezeRecursively(schema);\n    freezeRecursively(defaultSettings);\n    if (exampleSettings !== undefined) freezeRecursively(exampleSettings);\n\n    const definition: ExtensionSettingsDefinition = Object.freeze({\n        [definitionMarker]: true as const,\n        id,\n        title,\n        description,\n        schemaId,\n        schema,\n        defaultSettings,\n        exampleSettings,\n    });\n\n    // Build once during definition so malformed schema structures fail at startup.\n    createSettingsFileSchema(definition);\n    return definition;\n}\n\nexport function isExtensionSettingsDefinition(\n    value: ExtensionSettingsDefinitionCandidate,\n): value is ExtensionSettingsDefinition {\n    if (!(definitionMarker in value) || value[definitionMarker] !== true) return false;\n    if (\n        !(\"id\" in value) ||\n        !Value.Check(StringValueSchema, value.id) ||\n        !SETTINGS_ID_PATTERN.test(value.id)\n    ) {\n        return false;\n    }\n    if (!(\"title\" in value) || !Value.Check(StringValueSchema, value.title)) return false;\n    if (!(\"description\" in value) || !Value.Check(StringValueSchema, value.description)) {\n        return false;\n    }\n    if (!(\"schemaId\" in value) || !Value.Check(StringValueSchema, value.schemaId)) return false;\n    if (!(\"schema\" in value) || !IsSchema(value.schema) || !isSettingsSchema(value.schema)) {\n        return false;\n    }\n    if (!(\"defaultSettings\" in value)) return false;\n    const exampleSettings = \"exampleSettings\" in value ? value.exampleSettings : undefined;\n    let serializedDefaults: string;\n    try {\n        serializedDefaults = JSON.stringify(value.defaultSettings);\n    } catch {\n        return false;\n    }\n    const parsedDefaults = parseJson(serializedDefaults);\n    if (\n        !isJsonObject(parsedDefaults) ||\n        !isDeepStrictEqual(value.defaultSettings, parsedDefaults)\n    ) {\n        return false;\n    }\n    if (exampleSettings !== undefined) {\n        let serializedExample: string;\n        try {\n            serializedExample = JSON.stringify(exampleSettings);\n        } catch {\n            return false;\n        }\n        const parsedExample = parseJson(serializedExample);\n        if (!isJsonObject(parsedExample) || !isDeepStrictEqual(exampleSettings, parsedExample)) {\n            return false;\n        }\n    }\n    return true;\n}\n\n/**\n * The decoded runtime settings type produced by an extension definition.\n *\n * This preserves TypeBox transforms: it represents values after decoding, not the JSON shape stored\n * in settings files.\n *\n * @template Definition A definition returned by {@link defineExtensionSettings}.\n *\n * @example\n * ```ts\n * import type { ResolvedSettings } from \"@zigai/pi-extension-settings\";\n * import settingsDefinition from \"./settings.ts\";\n *\n * export type Settings = ResolvedSettings<typeof settingsDefinition>;\n * ```\n */\nexport type ResolvedSettings<Definition extends ExtensionSettingsDefinition> = StaticDecode<\n    Definition[\"schema\"]\n>;\n"]}

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

@@ -0,0 +1,10 @@
+type WriteStatus = "created" | "unchanged" | "updated";
+export declare function readTextIfPresent(path: string): string | undefined;
+export declare function readTextIfPresentAsync(path: string): Promise<string | undefined>;
+/** Produce content only for a missing destination, then atomically publish without clobbering. */
+export declare function writeTextIfMissing(path: string, produceContent: () => string, mode?: number): WriteStatus;
+export declare function writeTextAtomically(path: string, content: string, mode?: number): WriteStatus;
+/** Atomically replace complete content while preserving an existing file's permission mode. */
+export declare function writeTextAtomicallyAsync(path: string, content: string, defaultMode?: number): Promise<void>;
+export {};
+//# sourceMappingURL=file-system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAeA,KAAK,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAQvD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOlE;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAOtF;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,MAAM,EAC5B,IAAI,SAAQ,GACb,WAAW,CAyBb;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,SAAQ,GAAG,WAAW,CAkB5F;AAED,+FAA+F;AAC/F,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,SAAQ,GACpB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

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

@@ -0,0 +1,115 @@
+import { randomUUID } from "node:crypto";
+import { linkSync, lstatSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { chmod, mkdir, open, readFile, rename, rm, stat } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { Type, Value } from "./typebox-runtime.js";
+const CodedErrorSchema = Type.Object({ code: Type.String() });
+function errorCode(cause) {
+    return Value.Check(CodedErrorSchema, cause) ? cause.code : undefined;
+}
+export function readTextIfPresent(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch (cause) {
+        if (cause instanceof Error && errorCode(cause) === "ENOENT")
+            return undefined;
+        throw cause;
+    }
+}
+export async function readTextIfPresentAsync(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (cause) {
+        if (cause instanceof Error && errorCode(cause) === "ENOENT")
+            return undefined;
+        throw cause;
+    }
+}
+/** Produce content only for a missing destination, then atomically publish without clobbering. */
+export function writeTextIfMissing(path, produceContent, mode = 0o600) {
+    // Avoid directory writes for existing entries, including dangling symlinks. The hard link
+    // below still provides no-clobber publication if another writer wins after this check.
+    if (lstatSync(path, { throwIfNoEntry: false }) !== undefined)
+        return "unchanged";
+    const directory = dirname(path);
+    const temporaryPath = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);
+    try {
+        mkdirSync(directory, { recursive: true });
+        writeFileSync(temporaryPath, produceContent(), { encoding: "utf8", flag: "wx", mode });
+        try {
+            linkSync(temporaryPath, path);
+            return "created";
+        }
+        catch (cause) {
+            if (cause instanceof Error && errorCode(cause) === "EEXIST")
+                return "unchanged";
+            throw cause;
+        }
+    }
+    finally {
+        try {
+            rmSync(temporaryPath, { force: true });
+        }
+        catch {
+            // Cleanup must not mask the write result.
+        }
+    }
+}
+export function writeTextAtomically(path, content, mode = 0o644) {
+    const current = readTextIfPresent(path);
+    if (current === content)
+        return "unchanged";
+    const directory = dirname(path);
+    const temporaryPath = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);
+    try {
+        mkdirSync(directory, { recursive: true });
+        writeFileSync(temporaryPath, content, { encoding: "utf8", flag: "wx", mode });
+        renameSync(temporaryPath, path);
+        return current === undefined ? "created" : "updated";
+    }
+    finally {
+        try {
+            rmSync(temporaryPath, { force: true });
+        }
+        catch {
+            // Cleanup must not mask the write result.
+        }
+    }
+}
+/** Atomically replace complete content while preserving an existing file's permission mode. */
+export async function writeTextAtomicallyAsync(path, content, defaultMode = 0o600) {
+    let mode = defaultMode;
+    try {
+        mode = (await stat(path)).mode & 0o777;
+    }
+    catch (cause) {
+        if (!(cause instanceof Error) || errorCode(cause) !== "ENOENT")
+            throw cause;
+    }
+    const directory = dirname(path);
+    const temporaryPath = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);
+    await mkdir(directory, { recursive: true });
+    try {
+        const handle = await open(temporaryPath, "wx", mode);
+        try {
+            await handle.writeFile(content, { encoding: "utf8" });
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        await chmod(temporaryPath, mode);
+        await rename(temporaryPath, path);
+    }
+    finally {
+        try {
+            await rm(temporaryPath, { force: true });
+        }
+        catch {
+            // Cleanup must not mask the write result.
+        }
+    }
+}
+//# sourceMappingURL=file-system.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.js","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport {\n    linkSync,\n    lstatSync,\n    mkdirSync,\n    readFileSync,\n    renameSync,\n    rmSync,\n    writeFileSync,\n} from \"node:fs\";\nimport { chmod, mkdir, open, readFile, rename, rm, stat } from \"node:fs/promises\";\nimport { basename, dirname, join } from \"node:path\";\n\nimport { Type, Value } from \"./typebox-runtime.ts\";\n\ntype WriteStatus = \"created\" | \"unchanged\" | \"updated\";\n\nconst CodedErrorSchema = Type.Object({ code: Type.String() });\n\nfunction errorCode(cause: Error): string | undefined {\n    return Value.Check(CodedErrorSchema, cause) ? cause.code : undefined;\n}\n\nexport function readTextIfPresent(path: string): string | undefined {\n    try {\n        return readFileSync(path, \"utf8\");\n    } catch (cause: unknown) {\n        if (cause instanceof Error && errorCode(cause) === \"ENOENT\") return undefined;\n        throw cause;\n    }\n}\n\nexport async function readTextIfPresentAsync(path: string): Promise<string | undefined> {\n    try {\n        return await readFile(path, \"utf8\");\n    } catch (cause: unknown) {\n        if (cause instanceof Error && errorCode(cause) === \"ENOENT\") return undefined;\n        throw cause;\n    }\n}\n\n/** Produce content only for a missing destination, then atomically publish without clobbering. */\nexport function writeTextIfMissing(\n    path: string,\n    produceContent: () => string,\n    mode = 0o600,\n): WriteStatus {\n    // Avoid directory writes for existing entries, including dangling symlinks. The hard link\n    // below still provides no-clobber publication if another writer wins after this check.\n    if (lstatSync(path, { throwIfNoEntry: false }) !== undefined) return \"unchanged\";\n\n    const directory = dirname(path);\n    const temporaryPath = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);\n\n    try {\n        mkdirSync(directory, { recursive: true });\n        writeFileSync(temporaryPath, produceContent(), { encoding: \"utf8\", flag: \"wx\", mode });\n        try {\n            linkSync(temporaryPath, path);\n            return \"created\";\n        } catch (cause: unknown) {\n            if (cause instanceof Error && errorCode(cause) === \"EEXIST\") return \"unchanged\";\n            throw cause;\n        }\n    } finally {\n        try {\n            rmSync(temporaryPath, { force: true });\n        } catch {\n            // Cleanup must not mask the write result.\n        }\n    }\n}\n\nexport function writeTextAtomically(path: string, content: string, mode = 0o644): WriteStatus {\n    const current = readTextIfPresent(path);\n    if (current === content) return \"unchanged\";\n\n    const directory = dirname(path);\n    const temporaryPath = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);\n    try {\n        mkdirSync(directory, { recursive: true });\n        writeFileSync(temporaryPath, content, { encoding: \"utf8\", flag: \"wx\", mode });\n        renameSync(temporaryPath, path);\n        return current === undefined ? \"created\" : \"updated\";\n    } finally {\n        try {\n            rmSync(temporaryPath, { force: true });\n        } catch {\n            // Cleanup must not mask the write result.\n        }\n    }\n}\n\n/** Atomically replace complete content while preserving an existing file's permission mode. */\nexport async function writeTextAtomicallyAsync(\n    path: string,\n    content: string,\n    defaultMode = 0o600,\n): Promise<void> {\n    let mode = defaultMode;\n    try {\n        mode = (await stat(path)).mode & 0o777;\n    } catch (cause: unknown) {\n        if (!(cause instanceof Error) || errorCode(cause) !== \"ENOENT\") throw cause;\n    }\n\n    const directory = dirname(path);\n    const temporaryPath = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);\n    await mkdir(directory, { recursive: true });\n    try {\n        const handle = await open(temporaryPath, \"wx\", mode);\n        try {\n            await handle.writeFile(content, { encoding: \"utf8\" });\n            await handle.sync();\n        } finally {\n            await handle.close();\n        }\n        await chmod(temporaryPath, mode);\n        await rename(temporaryPath, path);\n    } finally {\n        try {\n            await rm(temporaryPath, { force: true });\n        } catch {\n            // Cleanup must not mask the write result.\n        }\n    }\n}\n"]}

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

@@ -0,0 +1,2 @@
+export { defineExtensionSettings, type ExtensionSettingsLayer, type ExtensionSettingsDefinition, type ExtensionSettingsDefinitionInput, type ResolvedSettings, } from "./definition.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,gBAAgB,GACxB,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { defineExtensionSettings, } from "./definition.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,uBAAuB,GAK1B,MAAM,iBAAiB,CAAC","sourcesContent":["export {\n    defineExtensionSettings,\n    type ExtensionSettingsLayer,\n    type ExtensionSettingsDefinition,\n    type ExtensionSettingsDefinitionInput,\n    type ResolvedSettings,\n} from \"./definition.ts\";\n"]}