@stina/extension-api 0.32.0 → 0.33.0-alpha.8cab91c

package/src/schemas/components.schema.ts

@@ -210,6 +210,9 @@ export const ButtonPropsSchema = z
   .object({
     component: z.literal('Button'),
     text: z.string().describe('Button text'),
+    type: z.enum(['normal', 'primary', 'danger', 'accent']).optional().describe('Visual style'),
+    title: z.string().optional().describe('Tooltip shown on hover'),
+    disabled: z.boolean().optional().describe('Disable the button'),
     onClickAction: ExtensionActionRefSchema.describe('Action to call on click'),
     style: ExtensionComponentStyleSchema.optional(),
   })
@@ -222,18 +225,58 @@ export const TextInputPropsSchema = z
     label: z.string().describe('Input label'),
     placeholder: z.string().optional().describe('Placeholder text'),
     value: z.string().optional().describe('Current value'),
-    onChangeAction: ExtensionActionRefSchema.describe('Action to call on change'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
     style: ExtensionComponentStyleSchema.optional(),
   })
   .passthrough()
   .describe('TextInput component')
 
+export const PasswordInputPropsSchema = z
+  .object({
+    component: z.literal('PasswordInput'),
+    label: z.string().describe('Input label'),
+    placeholder: z.string().optional().describe('Placeholder text'),
+    value: z.string().optional().describe('Current value'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('Password input component (text is masked)')
+
+export const NumberInputPropsSchema = z
+  .object({
+    component: z.literal('NumberInput'),
+    label: z.string().describe('Input label'),
+    placeholder: z.string().optional().describe('Placeholder text'),
+    value: z.union([z.string(), z.number()]).optional().describe('Current value'),
+    min: z.number().optional().describe('Minimum value'),
+    max: z.number().optional().describe('Maximum value'),
+    step: z.number().optional().describe('Step'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('Numeric input component')
+
+export const TextAreaPropsSchema = z
+  .object({
+    component: z.literal('TextArea'),
+    label: z.string().describe('Input label'),
+    placeholder: z.string().optional().describe('Placeholder text'),
+    value: z.string().optional().describe('Current value'),
+    rows: z.number().int().positive().optional().describe('Number of visible text rows'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('TextArea component for multi-line text input')
+
 export const DateTimeInputPropsSchema = z
   .object({
     component: z.literal('DateTimeInput'),
     label: z.string().describe('Input label'),
     value: z.string().optional().describe('Current value'),
-    onChangeAction: ExtensionActionRefSchema.describe('Action to call on change'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
     style: ExtensionComponentStyleSchema.optional(),
   })
   .passthrough()
@@ -245,7 +288,7 @@ export const SelectPropsSchema = z
     label: z.string().describe('Select label'),
     options: z.array(z.object({ label: z.string(), value: z.string() })).describe('Available options'),
     selectedValue: z.string().optional().describe('Currently selected value'),
-    onChangeAction: ExtensionActionRefSchema.describe('Action to call on change'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
     style: ExtensionComponentStyleSchema.optional(),
   })
   .passthrough()
@@ -256,7 +299,7 @@ export const IconPickerPropsSchema = z
     component: z.literal('IconPicker'),
     label: z.string().optional().describe('Picker label'),
     value: z.string().optional().describe('Currently selected icon name'),
-    onChangeAction: ExtensionActionRefSchema.describe('Action to call on change'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
     style: ExtensionComponentStyleSchema.optional(),
   })
   .passthrough()
@@ -358,7 +401,7 @@ export const TogglePropsSchema = z
     description: z.string().optional().describe('Description text'),
     checked: z.boolean().optional().describe('Whether the toggle is checked'),
     disabled: z.boolean().optional().describe('Whether the toggle is disabled'),
-    onChangeAction: ExtensionActionRefSchema.describe('Action to call on change'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
     style: ExtensionComponentStyleSchema.optional(),
   })
   .passthrough()
@@ -399,7 +442,7 @@ export const CheckboxPropsSchema = z
     checked: z.boolean().optional().describe('Whether the checkbox is checked'),
     disabled: z.boolean().optional().describe('Whether the checkbox is disabled'),
     strikethrough: z.boolean().optional().describe('Strike through label when checked'),
-    onChangeAction: ExtensionActionRefSchema.describe('Action to call on change'),
+    onChangeAction: ExtensionActionRefSchema.optional().describe('Action to call on change'),
     style: ExtensionComponentStyleSchema.optional(),
   })
   .passthrough()
@@ -495,6 +538,9 @@ export type LabelProps = z.infer<typeof LabelPropsSchema>
 export type ParagraphProps = z.infer<typeof ParagraphPropsSchema>
 export type ButtonProps = z.infer<typeof ButtonPropsSchema>
 export type TextInputProps = z.infer<typeof TextInputPropsSchema>
+export type PasswordInputProps = z.infer<typeof PasswordInputPropsSchema>
+export type NumberInputProps = z.infer<typeof NumberInputPropsSchema>
+export type TextAreaProps = z.infer<typeof TextAreaPropsSchema>
 export type DateTimeInputProps = z.infer<typeof DateTimeInputPropsSchema>
 export type SelectProps = z.infer<typeof SelectPropsSchema>
 export type IconPickerProps = z.infer<typeof IconPickerPropsSchema>

package/src/schemas/contributions.schema.ts

@@ -18,121 +18,6 @@ export const LocalizedStringSchema = z
   .union([z.string(), z.record(z.string())])
   .describe('String or localized string map')
 
-// =============================================================================
-// Settings
-// =============================================================================
-
-/**
- * Options mapping for select field options from tool response
- */
-export const SettingOptionsMappingSchema = z
-  .object({
-    itemsKey: z.string().describe('Key for items array in tool result data'),
-    valueKey: z.string().describe('Key for option value'),
-    labelKey: z.string().describe('Key for option label'),
-    descriptionKey: z.string().optional().describe('Optional key for description'),
-  })
-  .describe('Mapping for select field options')
-
-/**
- * Create mapping for create tool response
- */
-export const SettingCreateMappingSchema = z
-  .object({
-    resultKey: z.string().optional().describe('Key for result data object'),
-    valueKey: z.string().describe('Key for option value (defaults to "id")'),
-  })
-  .describe('Mapping for create tool response')
-
-/**
- * Validation rules for settings
- */
-export const SettingValidationSchema = z
-  .object({
-    required: z.boolean().optional().describe('Whether the field is required'),
-    min: z.number().optional().describe('Minimum value (number) or length (string)'),
-    max: z.number().optional().describe('Maximum value (number) or length (string)'),
-    pattern: z.string().optional().describe('Regex pattern for validation'),
-  })
-  .describe('Validation rules')
-
-/**
- * Setting definition type interface for recursive typing
- */
-export interface SettingDefinitionType {
-  id: string
-  title: string
-  description?: string
-  type: 'string' | 'number' | 'boolean' | 'select'
-  default?: unknown
-  options?: { value: string; label: string }[]
-  optionsToolId?: string
-  optionsParams?: Record<string, unknown>
-  optionsMapping?: z.infer<typeof SettingOptionsMappingSchema>
-  createToolId?: string
-  createLabel?: string
-  createFields?: SettingDefinitionType[]
-  createParams?: Record<string, unknown>
-  createMapping?: z.infer<typeof SettingCreateMappingSchema>
-  validation?: z.infer<typeof SettingValidationSchema>
-}
-
-export const SettingDefinitionSchema: z.ZodType<SettingDefinitionType> = z.lazy(() =>
-  z
-    .object({
-      id: z.string().describe('Setting ID (namespaced automatically)'),
-      title: z.string().describe('Display title'),
-      description: z.string().optional().describe('Help text'),
-      type: z.enum(['string', 'number', 'boolean', 'select']).describe('Setting type'),
-      default: z.unknown().optional().describe('Default value'),
-      options: z
-        .array(z.object({ value: z.string(), label: z.string() }))
-        .optional()
-        .describe('For select type: available options'),
-      optionsToolId: z.string().optional().describe('For select type: load options from tool'),
-      optionsParams: z.record(z.unknown()).optional().describe('Params for options tool'),
-      optionsMapping: SettingOptionsMappingSchema.optional().describe('Mapping for options tool response'),
-      createToolId: z.string().optional().describe('Tool ID for creating a new option'),
-      createLabel: z.string().optional().describe('Label for create action'),
-      createFields: z.array(SettingDefinitionSchema).optional().describe('Fields for create form'),
-      createParams: z.record(z.unknown()).optional().describe('Static params for create tool'),
-      createMapping: SettingCreateMappingSchema.optional().describe('Mapping for create tool response'),
-      validation: SettingValidationSchema.optional().describe('Validation rules'),
-    })
-    .superRefine((data, ctx) => {
-      // Validate that create* fields are only used with type: 'select'
-      const hasCreateFields =
-        data.createToolId !== undefined ||
-        data.createLabel !== undefined ||
-        data.createFields !== undefined ||
-        data.createParams !== undefined ||
-        data.createMapping !== undefined
-
-      if (hasCreateFields && data.type !== 'select') {
-        ctx.addIssue({
-          code: z.ZodIssueCode.custom,
-          message: 'create* fields (createToolId, createLabel, createFields, createParams, createMapping) are only valid for type "select"',
-          path: ['type'],
-        })
-      }
-
-      // Validate that select type has options or optionsToolId
-      if (data.type === 'select') {
-        const hasOptions = data.options && data.options.length > 0
-        const hasOptionsToolId = data.optionsToolId !== undefined
-
-        if (!hasOptions && !hasOptionsToolId) {
-          ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: 'Setting of type "select" must have "options" or "optionsToolId"',
-            path: ['type'],
-          })
-        }
-      }
-    })
-    .describe('Setting definition')
-)
-
 // =============================================================================
 // Tool Settings Views
 // =============================================================================
@@ -162,6 +47,23 @@ export const ToolSettingsActionDataSourceSchema = z
   })
   .describe('Action-based data source')
 
+/**
+ * Grouping configuration for a list view
+ */
+export const ToolSettingsListGroupBySchema = z
+  .object({
+    key: z.string().describe('Key in each item used to determine group membership'),
+    order: z
+      .array(z.string())
+      .optional()
+      .describe('Explicit ordering of group values; unlisted groups appear afterwards alphabetically'),
+    labels: z
+      .record(z.string())
+      .optional()
+      .describe('Human-friendly labels per group value (rendered as section headers)'),
+  })
+  .describe('List view grouping configuration')
+
 /**
  * List view backed by tools
  */
@@ -177,6 +79,15 @@ export const ToolSettingsListViewSchema = z
     limitParam: z.string().optional().describe('Param name for limit'),
     idParam: z.string().optional().describe('Param name for get/delete ID'),
     listParams: z.record(z.unknown()).optional().describe('Static params for list tool'),
+    editView: z
+      .object({
+        content: ExtensionComponentDataSchema.describe('Root component for the create/edit modal'),
+      })
+      .optional()
+      .describe('Component-tree create/edit form bound to $item.<key>'),
+    groupBy: ToolSettingsListGroupBySchema.optional().describe(
+      'Optional grouping configuration; when set, items are visually grouped by this field',
+    ),
   })
   .describe('List view backed by tools')
 
@@ -207,7 +118,6 @@ export const ToolSettingsViewDefinitionSchema = z
     title: z.string().describe('Display title'),
     description: z.string().optional().describe('Help text'),
     view: ToolSettingsViewSchema.describe('View configuration'),
-    fields: z.array(SettingDefinitionSchema).optional().describe('Fields for create/edit forms'),
   })
   .describe('Tool settings view definition')
 
@@ -271,60 +181,13 @@ export const PanelDefinitionSchema = z
 // =============================================================================
 
 /**
- * Provider config property type
- */
-export const ProviderConfigPropertyTypeSchema = z
-  .enum(['string', 'number', 'boolean', 'select', 'password', 'url'])
-  .describe('Property type')
-
-/**
- * Provider config select option
+ * Component-tree-based provider config view.
  */
-export const ProviderConfigSelectOptionSchema = z
+export const ProviderConfigViewSchema = z
   .object({
-    value: z.string().describe('Value stored in settings'),
-    label: z.string().describe('Display label'),
-  })
-  .describe('Select option')
-
-/**
- * Provider config validation
- */
-export const ProviderConfigValidationSchema = z
-  .object({
-    pattern: z.string().optional().describe('Regex pattern the value must match'),
-    minLength: z.number().optional().describe('Minimum string length'),
-    maxLength: z.number().optional().describe('Maximum string length'),
-    min: z.number().optional().describe('Minimum number value'),
-    max: z.number().optional().describe('Maximum number value'),
-  })
-  .describe('Validation rules')
-
-/**
- * Provider config property
- */
-export const ProviderConfigPropertySchema = z
-  .object({
-    type: ProviderConfigPropertyTypeSchema.describe('Property type'),
-    title: z.string().describe('Display label'),
-    description: z.string().optional().describe('Help text'),
-    default: z.unknown().optional().describe('Default value'),
-    required: z.boolean().optional().describe('Whether the field is required'),
-    placeholder: z.string().optional().describe('Placeholder text'),
-    options: z.array(ProviderConfigSelectOptionSchema).optional().describe('For select type'),
-    validation: ProviderConfigValidationSchema.optional().describe('Validation rules'),
-  })
-  .describe('Provider config property')
-
-/**
- * Provider config schema
- */
-export const ProviderConfigSchemaSchema = z
-  .object({
-    properties: z.record(ProviderConfigPropertySchema).describe('Property definitions'),
-    order: z.array(z.string()).optional().describe('Display order of properties'),
+    content: ExtensionComponentDataSchema.describe('Root component to render'),
   })
-  .describe('Provider configuration schema')
+  .describe('Provider configuration view (component tree)')
 
 /**
  * Provider definition
@@ -336,7 +199,7 @@ export const ProviderDefinitionSchema = z
     description: z.string().optional().describe('Description'),
     suggestedDefaultModel: z.string().optional().describe('Suggested default model'),
     defaultSettings: z.record(z.unknown()).optional().describe('Default settings'),
-    configSchema: ProviderConfigSchemaSchema.optional().describe('Configuration UI schema'),
+    configView: ProviderConfigViewSchema.optional().describe('Component-tree configuration view'),
   })
   .describe('Provider definition')
 
@@ -429,7 +292,6 @@ export const StorageContributionsSchema = z
  */
 export const ExtensionContributionsSchema = z
   .object({
-    settings: z.array(SettingDefinitionSchema).optional().describe('User-configurable settings'),
     toolSettings: z.array(ToolSettingsViewDefinitionSchema).optional().describe('Tool settings views'),
     panels: z.array(PanelDefinitionSchema).optional().describe('Right panel contributions'),
     providers: z.array(ProviderDefinitionSchema).optional().describe('AI providers'),
@@ -445,13 +307,10 @@ export const ExtensionContributionsSchema = z
 // =============================================================================
 
 export type LocalizedString = z.infer<typeof LocalizedStringSchema>
-export type SettingOptionsMapping = z.infer<typeof SettingOptionsMappingSchema>
-export type SettingCreateMapping = z.infer<typeof SettingCreateMappingSchema>
-export type SettingValidation = z.infer<typeof SettingValidationSchema>
-export type SettingDefinition = z.infer<typeof SettingDefinitionSchema>
 export type ToolSettingsListMapping = z.infer<typeof ToolSettingsListMappingSchema>
 export type ToolSettingsActionDataSource = z.infer<typeof ToolSettingsActionDataSourceSchema>
 export type ToolSettingsListView = z.infer<typeof ToolSettingsListViewSchema>
+export type ToolSettingsListGroupBy = z.infer<typeof ToolSettingsListGroupBySchema>
 export type ToolSettingsComponentView = z.infer<typeof ToolSettingsComponentViewSchema>
 export type ToolSettingsView = z.infer<typeof ToolSettingsViewSchema>
 export type ToolSettingsViewDefinition = z.infer<typeof ToolSettingsViewDefinitionSchema>
@@ -460,11 +319,7 @@ export type PanelComponentView = z.infer<typeof PanelComponentViewSchema>
 export type PanelUnknownView = z.infer<typeof PanelUnknownViewSchema>
 export type PanelView = z.infer<typeof PanelViewSchema>
 export type PanelDefinition = z.infer<typeof PanelDefinitionSchema>
-export type ProviderConfigPropertyType = z.infer<typeof ProviderConfigPropertyTypeSchema>
-export type ProviderConfigSelectOption = z.infer<typeof ProviderConfigSelectOptionSchema>
-export type ProviderConfigValidation = z.infer<typeof ProviderConfigValidationSchema>
-export type ProviderConfigProperty = z.infer<typeof ProviderConfigPropertySchema>
-export type ProviderConfigSchema = z.infer<typeof ProviderConfigSchemaSchema>
+export type ProviderConfigView = z.infer<typeof ProviderConfigViewSchema>
 export type ProviderDefinition = z.infer<typeof ProviderDefinitionSchema>
 export type ToolDefinition = z.infer<typeof ToolDefinitionSchema>
 export type CommandDefinition = z.infer<typeof CommandDefinitionSchema>

package/src/schemas/index.ts

@@ -39,13 +39,10 @@ export {
 export {
   ExtensionContributionsSchema,
   LocalizedStringSchema,
-  SettingDefinitionSchema,
-  SettingOptionsMappingSchema,
-  SettingCreateMappingSchema,
-  SettingValidationSchema,
   ToolSettingsViewDefinitionSchema,
   ToolSettingsViewSchema,
   ToolSettingsListViewSchema,
+  ToolSettingsListGroupBySchema,
   ToolSettingsComponentViewSchema,
   ToolSettingsListMappingSchema,
   ToolSettingsActionDataSourceSchema,
@@ -55,24 +52,17 @@ export {
   PanelUnknownViewSchema,
   PanelActionDataSourceSchema,
   ProviderDefinitionSchema,
-  ProviderConfigSchemaSchema,
-  ProviderConfigPropertySchema,
-  ProviderConfigPropertyTypeSchema,
-  ProviderConfigSelectOptionSchema,
-  ProviderConfigValidationSchema,
+  ProviderConfigViewSchema,
   ToolDefinitionSchema,
   CommandDefinitionSchema,
   PromptContributionSchema,
   PromptSectionSchema,
   type ExtensionContributions,
   type LocalizedString,
-  type SettingDefinition,
-  type SettingOptionsMapping,
-  type SettingCreateMapping,
-  type SettingValidation,
   type ToolSettingsViewDefinition,
   type ToolSettingsView,
   type ToolSettingsListView,
+  type ToolSettingsListGroupBy,
   type ToolSettingsComponentView,
   type ToolSettingsListMapping,
   type ToolSettingsActionDataSource,
@@ -82,11 +72,7 @@ export {
   type PanelUnknownView,
   type PanelActionDataSource,
   type ProviderDefinition,
-  type ProviderConfigSchema,
-  type ProviderConfigProperty,
-  type ProviderConfigPropertyType,
-  type ProviderConfigSelectOption,
-  type ProviderConfigValidation,
+  type ProviderConfigView,
   type ToolDefinition,
   type CommandDefinition,
   type PromptContribution,

package/src/types.components.ts

@@ -261,6 +261,11 @@ export interface ParagraphProps extends ExtensionComponentData {
 export interface ButtonProps extends ExtensionComponentData {
   component: 'Button'
   text: string
+  /** Visual style. Defaults to "normal". */
+  type?: 'normal' | 'primary' | 'danger' | 'accent'
+  /** Optional tooltip shown on hover. */
+  title?: string
+  disabled?: boolean
   onClickAction: ExtensionActionRef
 }
 
@@ -270,7 +275,42 @@ export interface TextInputProps extends ExtensionComponentData {
   label: string
   placeholder?: string
   value?: string
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
+}
+
+/** The extension API properties for the PasswordInput component. */
+export interface PasswordInputProps extends ExtensionComponentData {
+  component: 'PasswordInput'
+  label: string
+  placeholder?: string
+  value?: string
+  onChangeAction?: ExtensionActionRef
+}
+
+/** The extension API properties for the NumberInput component. */
+export interface NumberInputProps extends ExtensionComponentData {
+  component: 'NumberInput'
+  label: string
+  placeholder?: string
+  value?: string | number
+  /** Optional minimum value. */
+  min?: number
+  /** Optional maximum value. */
+  max?: number
+  /** Optional step. */
+  step?: number
+  onChangeAction?: ExtensionActionRef
+}
+
+/** The extension API properties for the TextArea component. */
+export interface TextAreaProps extends ExtensionComponentData {
+  component: 'TextArea'
+  label: string
+  placeholder?: string
+  value?: string
+  /** Number of visible text rows. Defaults to 4. */
+  rows?: number
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the DateTimeInput component. */
@@ -278,7 +318,7 @@ export interface DateTimeInputProps extends ExtensionComponentData {
   component: 'DateTimeInput'
   label: string
   value?: string
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the Select component. */
@@ -287,7 +327,7 @@ export interface SelectProps extends ExtensionComponentData {
   label: string
   options: Array<{ label: string; value: string }>
   selectedValue?: string
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the IconPicker component. */
@@ -295,7 +335,7 @@ export interface IconPickerProps extends ExtensionComponentData {
   component: 'IconPicker'
   label?: string
   value?: string
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the VerticalStack component. */
@@ -371,7 +411,7 @@ export interface ToggleProps extends ExtensionComponentData {
   description?: string
   checked?: boolean
   disabled?: boolean
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the Collapsible component. */
@@ -415,7 +455,7 @@ export interface CheckboxProps extends ExtensionComponentData {
   /** Whether to strike through the label when checked. Defaults to true. */
   strikethrough?: boolean
   /** Action to call when the checkbox state changes. */
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the Markdown component. */