@vicinae/api 0.16.2 → 0.16.3

package/dist/schemas/manifest.d.ts

@@ -38,8 +38,104 @@ declare const _default: z.ZodObject<{
         subtitle: z.ZodOptional<z.ZodString>;
         description: z.ZodString;
         interval: z.ZodOptional<z.ZodString>;
-        preferences: z.ZodOptional<z.ZodAny>;
-        arguments: z.ZodOptional<z.ZodAny>;
+        preferences: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"textfield">;
+            placeholder: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"password">;
+            placeholder: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"checkbox">;
+            label: z.ZodString;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodBoolean>;
+                Windows: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"dropdown">;
+            data: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"appPicker">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"directory">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>], "type">>>;
+        arguments: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            name: z.ZodString;
+            placeholder: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"password">;
+            name: z.ZodString;
+            placeholder: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"dropdown">;
+            data: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>;
+            name: z.ZodString;
+            placeholder: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>], "type">>>;
         disabledByDefault: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$catchall<z.ZodAny>>>;
     tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -52,7 +148,84 @@ declare const _default: z.ZodObject<{
             "AI attachment provider": "AI attachment provider";
             "AI tool": "AI tool";
         }>>>;
-        preferences: z.ZodOptional<z.ZodAny>;
+        preferences: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"textfield">;
+            placeholder: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"password">;
+            placeholder: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"checkbox">;
+            label: z.ZodString;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodBoolean>;
+                Windows: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"dropdown">;
+            data: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"appPicker">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"directory">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                macOS: z.ZodOptional<z.ZodString>;
+                Windows: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+        }, z.core.$strict>], "type">>>;
     }, z.core.$catchall<z.ZodAny>>>>;
     ai: z.ZodOptional<z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
@@ -63,7 +236,84 @@ declare const _default: z.ZodObject<{
     }, z.core.$strip>>;
     keywords: z.ZodOptional<z.ZodAny>;
     description: z.ZodString;
-    preferences: z.ZodOptional<z.ZodAny>;
+    preferences: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"textfield">;
+        placeholder: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            macOS: z.ZodOptional<z.ZodString>;
+            Windows: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"password">;
+        placeholder: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            macOS: z.ZodOptional<z.ZodString>;
+            Windows: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"checkbox">;
+        label: z.ZodString;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            macOS: z.ZodOptional<z.ZodBoolean>;
+            Windows: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>>;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"dropdown">;
+        data: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            macOS: z.ZodOptional<z.ZodString>;
+            Windows: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"appPicker">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            macOS: z.ZodOptional<z.ZodString>;
+            Windows: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"file">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            macOS: z.ZodOptional<z.ZodString>;
+            Windows: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"directory">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            macOS: z.ZodOptional<z.ZodString>;
+            Windows: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodBoolean;
+    }, z.core.$strict>], "type">>>;
     categories: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         Web: "Web";
         Applications: "Applications";

package/dist/schemas/manifest.js

@@ -1,6 +1,204 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const zod_1 = require("zod");
+// Preference schema for extension and command preferences
+const preferenceBase = {
+    name: zod_1.z.string().min(1).describe("A unique id for the preference."),
+    title: zod_1.z
+        .string()
+        .describe("The display name of the preference shown in Raycast preferences. For 'checkbox', 'textfield' and 'password', it is shown as a section title above the respective input element. If you want to group multiple checkboxes into a single section, set the 'title' of the first checkbox and leave the 'title' of the other checkboxes empty."),
+    description: zod_1.z
+        .string()
+        .describe("It helps users understand what the preference does. It will be displayed as a tooltip when hovering over it."),
+    required: zod_1.z
+        .boolean()
+        .describe("Indicates whether the value is required and must be entered by the user before the extension is usable."),
+};
+const preferenceSchema = zod_1.z.discriminatedUnion("type", [
+    // textfield preference
+    zod_1.z
+        .object({
+        ...preferenceBase,
+        type: zod_1.z.literal("textfield"),
+        placeholder: zod_1.z
+            .string()
+            .describe("Text displayed in the preference's field when no value has been input.")
+            .optional(),
+        default: zod_1.z
+            .union([
+            zod_1.z.string(),
+            zod_1.z.object({
+                macOS: zod_1.z.string().optional(),
+                Windows: zod_1.z.string().optional(),
+            }),
+        ])
+            .describe("The optional default value for the field. For textfields, this is a string value. Additionally, you can specify a different value per platform by passing an object: { 'macOS': ..., 'Windows': ... }.")
+            .optional(),
+    })
+        .strict(),
+    // password preference
+    zod_1.z
+        .object({
+        ...preferenceBase,
+        type: zod_1.z.literal("password"),
+        placeholder: zod_1.z
+            .string()
+            .describe("Text displayed in the preference's field when no value has been input.")
+            .optional(),
+        default: zod_1.z
+            .union([
+            zod_1.z.string(),
+            zod_1.z.object({
+                macOS: zod_1.z.string().optional(),
+                Windows: zod_1.z.string().optional(),
+            }),
+        ])
+            .describe("The optional default value for the field. For passwords, this is a string value. Additionally, you can specify a different value per platform by passing an object: { 'macOS': ..., 'Windows': ... }.")
+            .optional(),
+    })
+        .strict(),
+    // checkbox preference
+    zod_1.z
+        .object({
+        ...preferenceBase,
+        type: zod_1.z.literal("checkbox"),
+        label: zod_1.z
+            .string()
+            .min(1)
+            .describe("The label of the checkbox. Shown next to the checkbox."),
+        default: zod_1.z
+            .union([
+            zod_1.z.boolean(),
+            zod_1.z.object({
+                macOS: zod_1.z.boolean().optional(),
+                Windows: zod_1.z.boolean().optional(),
+            }),
+        ])
+            .describe("The optional default value for the field. For checkboxes, this is a boolean value. Additionally, you can specify a different value per platform by passing an object: { 'macOS': ..., 'Windows': ... }.")
+            .optional(),
+    })
+        .strict(),
+    // dropdown preference
+    zod_1.z
+        .object({
+        ...preferenceBase,
+        type: zod_1.z.literal("dropdown"),
+        data: zod_1.z
+            .array(zod_1.z.object({
+            title: zod_1.z.string(),
+            value: zod_1.z.string(),
+        }))
+            .min(1)
+            .describe("An array of objects with 'title' and 'value' properties, e.g.: [{'title': 'Item 1', 'value': '1'}]"),
+        default: zod_1.z
+            .union([
+            zod_1.z.string(),
+            zod_1.z.object({
+                macOS: zod_1.z.string().optional(),
+                Windows: zod_1.z.string().optional(),
+            }),
+        ])
+            .describe("The optional default value for the field. For dropdowns, this is the value of an object in the data array. Additionally, you can specify a different value per platform by passing an object: { 'macOS': ..., 'Windows': ... }.")
+            .optional(),
+    })
+        .strict(),
+    // appPicker preference
+    zod_1.z
+        .object({
+        ...preferenceBase,
+        type: zod_1.z.literal("appPicker"),
+        default: zod_1.z
+            .union([
+            zod_1.z.string(),
+            zod_1.z.object({
+                macOS: zod_1.z.string().optional(),
+                Windows: zod_1.z.string().optional(),
+            }),
+        ])
+            .describe("The optional default value for the field. For appPickers, this is an application name, bundle ID or path. Additionally, you can specify a different value per platform by passing an object: { 'macOS': ..., 'Windows': ... }.")
+            .optional(),
+    })
+        .strict(),
+    // file preference
+    zod_1.z
+        .object({
+        ...preferenceBase,
+        type: zod_1.z.literal("file"),
+        default: zod_1.z
+            .union([
+            zod_1.z.string(),
+            zod_1.z.object({
+                macOS: zod_1.z.string().optional(),
+                Windows: zod_1.z.string().optional(),
+            }),
+        ])
+            .describe("The optional default value for the field. For file preferences, this is a file path. Additionally, you can specify a different value per platform by passing an object: { 'macOS': ..., 'Windows': ... }.")
+            .optional(),
+    })
+        .strict(),
+    // directory preference
+    zod_1.z
+        .object({
+        ...preferenceBase,
+        type: zod_1.z.literal("directory"),
+        default: zod_1.z
+            .union([
+            zod_1.z.string(),
+            zod_1.z.object({
+                macOS: zod_1.z.string().optional(),
+                Windows: zod_1.z.string().optional(),
+            }),
+        ])
+            .describe("The optional default value for the field. For directory preferences, this is a directory path. Additionally, you can specify a different value per platform by passing an object: { 'macOS': ..., 'Windows': ... }.")
+            .optional(),
+    })
+        .strict(),
+]);
+// Argument schema for command arguments
+const argumentBase = {
+    name: zod_1.z
+        .string()
+        .min(1)
+        .describe("A unique id for the argument. This value will be used to as the key in the object passed as top-level prop."),
+    placeholder: zod_1.z
+        .string()
+        .min(1)
+        .describe("Placeholder for the argument's input field."),
+    required: zod_1.z
+        .boolean()
+        .describe("Indicates whether the value is required and must be entered by the user before the command is opened. Default value for this is 'false'.")
+        .optional(),
+};
+const argumentSchema = zod_1.z.discriminatedUnion("type", [
+    // text argument
+    zod_1.z
+        .object({
+        ...argumentBase,
+        type: zod_1.z.literal("text"),
+    })
+        .strict(),
+    // password argument
+    zod_1.z
+        .object({
+        ...argumentBase,
+        type: zod_1.z.literal("password"),
+    })
+        .strict(),
+    // dropdown argument
+    zod_1.z
+        .object({
+        ...argumentBase,
+        type: zod_1.z.literal("dropdown"),
+        data: zod_1.z
+            .array(zod_1.z.object({
+            title: zod_1.z.string(),
+            value: zod_1.z.string(),
+        }))
+            .min(1)
+            .describe("An array of objects with 'title' and 'value' properties, e.g.: [{'title': 'Item 1', 'value': '1'}]"),
+    })
+        .strict(),
+]);
 exports.default = zod_1.z.object({
     icon: zod_1.z
         .string()
@@ -107,11 +305,11 @@ exports.default = zod_1.z.object({
             .describe("The value specifies that a no-view or menu-bar command should be launched in the background every X seconds (s), minutes (m), hours (h) or days (d). Examples: 90s, 1m, 12h, 1d. The minimum value is 10 seconds (10s).")
             .optional(),
         preferences: zod_1.z
-            .any()
+            .array(preferenceSchema)
             .describe('Commands can optionally contribute preferences that are shown in Vicinae Preferences > Extensions when selecting the command. You can use preferences for configuration values and passwords or personal access tokens. Commands automatically "inherit" extension preferences and can also override entries with the same `name`.')
             .optional(),
         arguments: zod_1.z
-            .any()
+            .array(argumentSchema)
             .describe("An optional array of arguments that are requested from user when the command is called")
             .optional(),
         disabledByDefault: zod_1.z
@@ -155,7 +353,7 @@ exports.default = zod_1.z.object({
             .describe("Limits the tool to the specified functionalities. If not specified, the tool can be used in any context (if it matches the requirements for each of them).")
             .optional(),
         preferences: zod_1.z
-            .any()
+            .array(preferenceSchema)
             .describe('Tools can optionally contribute preferences that are shown in Vicinae Preferences > Extensions when selecting the AI Extension item. You can use preferences for configuration values and passwords or personal access tokens. Tools automatically "inherit" extension preferences and can also override entries with the same `name`.')
             .optional(),
     })
@@ -191,7 +389,7 @@ exports.default = zod_1.z.object({
         .max(2048)
         .describe("It helps users understand what the extension does. It will be displayed in the Store and in Preferences."),
     preferences: zod_1.z
-        .any()
+        .array(preferenceSchema)
         .describe("Extensions can contribute preferences that are shown in Vicinae Preferences > Extensions. You can use preferences for configuration values and passwords or personal access tokens.")
         .optional(),
     categories: zod_1.z

package/dist/utils/extension-types.d.ts

@@ -0,0 +1,14 @@
+import type { z } from "zod";
+import type ManifestSchema from "../schemas/manifest.js";
+type Manifest = z.infer<typeof ManifestSchema>;
+/**
+ * Generates and updates the extension types file in the specified directory
+ */
+export declare function updateExtensionTypes(manifest: Manifest, outDir: string): {
+    envPath: string;
+};
+/**
+ * Generates TypeScript type definitions from a manifest (package.json)
+ */
+export declare function createExtensionTypes(manifest: Manifest): string;
+export {};

package/dist/utils/extension-types.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateExtensionTypes = updateExtensionTypes;
+exports.createExtensionTypes = createExtensionTypes;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Generates and updates the extension types file in the specified directory
+ */
+function updateExtensionTypes(manifest, outDir) {
+    const content = createExtensionTypes(manifest);
+    const envPath = (0, node_path_1.join)(outDir, "vicinae-env.d.ts");
+    (0, node_fs_1.writeFileSync)(envPath, content);
+    return { envPath };
+}
+/**
+ * Generates TypeScript type definitions from a manifest (package.json)
+ */
+function createExtensionTypes(manifest) {
+    const extPrefs = generateExtensionPreferences(manifest);
+    const cmdPrefs = generateCommandPreferences(manifest);
+    const argTypes = generateCommandArguments(manifest);
+    return `
+/// <reference types="@vicinae/api">
+
+/*
+ * This file is auto-generated from the extension's manifest.
+ * Do not modify manually. Instead, update the \`package.json\` file.
+ */
+
+type ExtensionPreferences = {
+  ${extPrefs}
+}
+
+declare type Preferences = ExtensionPreferences
+
+declare namespace Preferences {
+  ${cmdPrefs}
+}
+
+declare namespace Arguments {
+  ${argTypes}
+}
+	`.trim();
+}
+/**
+ * Generates TypeScript type definitions for extension preferences
+ */
+function generateExtensionPreferences(manifest) {
+    if (!manifest.preferences) {
+        return "";
+    }
+    const extPrefs = [];
+    for (const pref of manifest.preferences) {
+        let prefText = generateDocComment(pref.title, pref.description);
+        if (prefText) {
+            prefText += "\n\t";
+        }
+        prefText += `"${pref.name}"${pref.required ? "?" : ""}: ${getPreferenceType(pref)};`;
+        extPrefs.push(prefText);
+    }
+    return extPrefs.join("\n").trim();
+}
+/**
+ * Generates a JSDoc comment string for a preference or argument
+ */
+function generateDocComment(title, description) {
+    if (!title && !description) {
+        return "";
+    }
+    const content = [title, description].filter(Boolean).join(" - ");
+    return `\n\t/** ${content.trim()} */`;
+}
+/**
+ * Generates a TypeScript type string for a preference value
+ */
+function getPreferenceType(pref) {
+    if (pref.type === "checkbox") {
+        return "boolean";
+    }
+    if (pref.type === "dropdown" &&
+        Array.isArray(pref.data) &&
+        pref.data.length > 0) {
+        // Build a union type from the 'value' fields for dropdowns
+        const unionValues = pref.data
+            .map((option) => typeof option.value === "string" ? `"${option.value}"` : undefined)
+            .filter((v) => !!v)
+            .join(" | ");
+        return unionValues || "string";
+    }
+    return "string";
+}
+/**
+ * Generates TypeScript type definitions for command preferences
+ */
+function generateCommandPreferences(manifest) {
+    const cmdPrefs = [];
+    for (const cmd of manifest.commands) {
+        const prefix = generateDocComment(`Command: ${cmd.title}`) +
+            `\n\texport type ${toPascalCase(cmd.name)} = ExtensionPreferences & {`;
+        const prefs = [];
+        for (const pref of cmd.preferences ?? []) {
+            let prefText = "";
+            const docComment = generateDocComment(pref.title, pref.description);
+            if (docComment) {
+                prefText = `\n\t\t${docComment.trim()}\n\t\t`;
+            }
+            prefText += `"${pref.name}"${pref.required ? "?" : ""}: ${getPreferenceType(pref)};`;
+            prefs.push(prefText);
+        }
+        cmdPrefs.push(`${prefix}\n\t\t${prefs.join("\n").trim()}\n\t}`);
+    }
+    return cmdPrefs.join("\n").trim();
+}
+/**
+ * Generates TypeScript type definitions for command arguments
+ */
+function generateCommandArguments(manifest) {
+    const cmdArgs = [];
+    for (const cmd of manifest.commands) {
+        const prefix = generateDocComment(`Command: ${cmd.title}`) +
+            `\n\texport type ${toPascalCase(cmd.name)} = {`;
+        const args = [];
+        for (const arg of cmd.arguments ?? []) {
+            const docComment = generateDocComment(arg.placeholder);
+            let argText = `\n\t\t${docComment.trim()}\n\t\t`;
+            argText += `"${arg.name}"${arg.required ? "?" : ""}: ${getArgumentType(arg)}`;
+            args.push(argText);
+        }
+        cmdArgs.push(`${prefix}\n\t\t${args.join("\n").trim()}\n\t}`);
+    }
+    return cmdArgs.join("\n").trim();
+}
+/**
+ * Generates a TypeScript type string for an argument value
+ */
+function getArgumentType(arg) {
+    if (arg.type === "dropdown" &&
+        Array.isArray(arg.data) &&
+        arg.data.length > 0) {
+        // Build a union type from the 'value' fields
+        const unionValues = arg.data
+            .map((option) => typeof option.value === "string" ? `"${option.value}"` : undefined)
+            .filter((v) => !!v)
+            .join(" | ");
+        if (unionValues) {
+            return unionValues;
+        }
+    }
+    return "string";
+}
+/**
+ * Converts a string to PascalCase
+ */
+function toPascalCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1 $2") // Splits camelCase words into separate words
+        .replace(/[-_]+|[^\p{L}\p{N}]/gu, " ") // Replaces dashes, underscores, and special characters with spaces
+        .toLowerCase() // Converts the entire string to lowercase
+        .replace(/(?:^|\s)(\p{L})/gu, (_, letter) => letter.toUpperCase()) // Capitalizes the first letter of each word
+        .replace(/\s+/g, ""); // Removes all spaces
+}