@choiceopen/atomemo-plugin-schema 0.2.0 → 0.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 [English](./README.md) | [中文](./README.zh-CN.md)
 
-A comprehensive TypeScript type definitions and Zod schema validation library for developing Choiceform Atomemo plugins. This library ensures type safety at compile time and runtime validation for plugin definitions.
+A comprehensive TypeScript type definitions and Zod schema validation library for developing Choiceform Atomemo plugins. This library ensures type safety at compile time and runtime validation for plugin definitions. Plugins must declare the implementation language via the `lang` field (currently `elixir` or `typescript`).
 
 ## Features
 
@@ -78,6 +78,7 @@ const pluginDefinition: PluginDefinition = {
   icon: 'https://example.com/icon.png',
   version: '1.0.0',
   locales: ['en', 'zh_CN'],
+  lang: 'typescript',
 };
 
 // Validate at runtime
@@ -141,7 +142,7 @@ Each property type can be configured with different UI components:
 - `number-input`, `slider`
 
 **Boolean type components:**
-- `switch`, `checkbox`
+- `switch`
 
 **Array type components:**
 - `multi-select`, `tag-input`, `key-value-editor`, `slider`, `array-section`

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](./README.md) | [中文](./README.zh-CN.md)
 
-一个全面的 TypeScript 类型定义和 Zod Schema 验证库，用于开发 Choiceform Atomemo 插件。该库确保插件定义在编译时和运行时的类型安全与验证。
+一个全面的 TypeScript 类型定义和 Zod Schema 验证库，用于开发 Choiceform Atomemo 插件。该库确保插件定义在编译时和运行时的类型安全与验证。插件需要通过 `lang` 字段声明实现语言（目前支持 `elixir` 与 `typescript`）。
 
 ## 特性
 
@@ -78,6 +78,7 @@ const pluginDefinition: PluginDefinition = {
   icon: 'https://example.com/icon.png',
   version: '1.0.0',
   locales: ['en', 'zh_CN'],
+  lang: 'typescript',
 };
 
 // 运行时验证
@@ -141,7 +142,7 @@ if (!result.success) {
 - `number-input`、`slider`
 
 **布尔类型可用组件：**
-- `switch`、`checkbox`
+- `switch`
 
 **数组类型可用组件：**
 - `multi-select`、`tag-input`、`key-value-editor`、`slider`、`array-section`

package/dist/{definition-DEEuUiSF.d.mts → definition-DzbEI2zh.d.mts}

@@ -108,10 +108,24 @@ interface PropertyUINumberInputProps extends PropertyUICommonProps {
 /** 代码编辑器 UI 属性 */
 interface PropertyUICodeEditorProps extends PropertyUICommonProps {
   component: "code-editor";
-  language?: "json" | "javascript" | "python3" | "html";
+  language?: "json" | "javascript" | "python3";
+  /**
+   * Show line numbers in the code editor.
+   * @default false
+   */
   line_numbers?: boolean;
+  /**
+   * Enable line wrapping in the code editor.
+   * @default false
+   */
+  line_wrapping?: boolean;
   max_height?: number;
   min_height?: number;
+  /**
+   * Number of rows to show in the code editor.
+   * @default 4
+   */
+  rows?: number;
 }
 interface PropertyUISelectPropsBase {
   clearable?: boolean;
@@ -137,9 +151,6 @@ interface PropertyUIMultiSelectProps extends PropertyUICommonProps, PropertyUISe
 interface PropertyUISwitchProps extends PropertyUICommonProps {
   component: "switch";
 }
-interface PropertyUICheckboxProps extends PropertyUICommonProps {
-  component: "checkbox";
-}
 interface PropertyUISliderProps extends PropertyUICommonProps {
   component: "slider";
   marks?: Record<number, string>;
@@ -189,13 +200,16 @@ interface PropertyUICollapsiblePanelProps extends PropertyUICommonProps {
   remove_tooltip?: I18nText;
   sortable?: boolean;
 }
-type PropertyUIProps = PropertyUIInputProps | PropertyUITextareaProps | PropertyUINumberInputProps | PropertyUICodeEditorProps | PropertyUISingleSelectProps | PropertyUIRadioGroupProps | PropertyUIEmojiPickerProps | PropertyUIColorPickerProps | PropertyUIMultiSelectProps | PropertyUISwitchProps | PropertyUICheckboxProps | PropertyUISliderProps | PropertyUIKeyValueEditorProps | PropertyUITagInputProps | PropertyUICredentialSelectProps | PropertyUIJsonSchemaEditorProps | PropertyUIConditionsEditorProps | PropertyUIArraySectionProps | PropertyUICollapsiblePanelProps | PropertyUIEncryptedInputProps;
+interface PropertyUISectionProps extends PropertyUICommonProps {
+  component: "section";
+}
+type PropertyUIProps = PropertyUIInputProps | PropertyUITextareaProps | PropertyUINumberInputProps | PropertyUICodeEditorProps | PropertyUISingleSelectProps | PropertyUIRadioGroupProps | PropertyUIEmojiPickerProps | PropertyUIColorPickerProps | PropertyUIMultiSelectProps | PropertyUISwitchProps | PropertyUISliderProps | PropertyUIKeyValueEditorProps | PropertyUITagInputProps | PropertyUICredentialSelectProps | PropertyUIJsonSchemaEditorProps | PropertyUIConditionsEditorProps | PropertyUIArraySectionProps | PropertyUICollapsiblePanelProps | PropertyUISectionProps | PropertyUIEncryptedInputProps;
 type PropertyUIComponentType = PropertyUIProps["component"];
-type PropertyUIBoolean = PropertyUISwitchProps | PropertyUICheckboxProps;
+type PropertyUIBoolean = PropertyUISwitchProps;
 type PropertyUINumber = PropertyUINumberInputProps | PropertyUISliderProps;
 type PropertyUIString = PropertyUIInputProps | PropertyUITextareaProps | PropertyUICodeEditorProps | PropertyUISingleSelectProps | PropertyUICredentialSelectProps | PropertyUIRadioGroupProps | PropertyUIEmojiPickerProps | PropertyUIColorPickerProps;
 type PropertyUIArray = PropertyUIMultiSelectProps | PropertyUITagInputProps | PropertyUIKeyValueEditorProps | PropertyUISliderProps | PropertyUIArraySectionProps;
-type PropertyUIContainer = PropertyUICollapsiblePanelProps;
+type PropertyUIContainer = PropertyUICollapsiblePanelProps | PropertyUISectionProps;
 type PropertyUIMisc = PropertyUIJsonSchemaEditorProps | PropertyUIConditionsEditorProps;
 type PropertyUIObject = PropertyUIContainer | PropertyUIMisc | PropertyUICodeEditorProps;
 type PropertyUICredentialId = PropertyUICredentialSelectProps;
@@ -221,15 +235,15 @@ interface RootFilter<TSchema extends JsonObject = JsonObject> {
   /**
    * Joins conditions with logical AND; all conditions must be true
    */
-  $and?: Array<DisplayCondition<TSchema>>;
+  $and?: Array<DisplayCondition<TSchema>> | null;
   /**
    * Joins conditions with logical NOR; none of the conditions must be true
    */
-  $nor?: Array<DisplayCondition<TSchema>>;
+  $nor?: Array<DisplayCondition<TSchema>> | null;
   /**
    * Joins conditions with logical OR; at least one condition must be true
    */
-  $or?: Array<DisplayCondition<TSchema>>;
+  $or?: Array<DisplayCondition<TSchema>> | null;
 }
 type Condition<T extends JsonValue = JsonValue> = T | FilterOperators<T>;
 /**
@@ -240,55 +254,55 @@ interface FilterOperators<TValue extends JsonValue = JsonValue> {
   /**
    * Matches values equal to a specified value
    */
-  $eq?: TValue;
+  $eq?: TValue | null;
   /**
    * Checks if a field exists
    */
-  $exists?: boolean;
+  $exists?: boolean | null;
   /**
    * Matches values greater than a specified value
    */
-  $gt?: TValue;
+  $gt?: TValue | null;
   /**
    * Matches values greater than or equal to a specified value
    */
-  $gte?: TValue;
+  $gte?: TValue | null;
   /**
    * Matches any value specified in an array
    */
-  $in?: Array<TValue>;
+  $in?: Array<TValue> | null;
   /**
    * Matches values less than a specified value
    */
-  $lt?: TValue;
+  $lt?: TValue | null;
   /**
    * Matches values less than or equal to a specified value
    */
-  $lte?: TValue;
+  $lte?: TValue | null;
   /**
    * Matches values based on a modulo operation; value: [divisor, remainder]
    */
-  $mod?: TValue extends number ? [number, number] : never;
+  $mod?: TValue extends number ? [number, number] | null : never;
   /**
    * Matches values not equal to a specified value
    */
-  $ne?: TValue;
+  $ne?: TValue | null;
   /**
    * Matches values not in a specified array
    */
-  $nin?: Array<TValue>;
+  $nin?: Array<TValue> | null;
   /**
    * Regex options: i=case-insensitive, m=multiline, x=ignore whitespace, s=dotAll, u=unicode
    */
-  $options?: TValue extends string ? string : never;
+  $options?: TValue extends string ? string | null : never;
   /**
    * Matches values against a regular expression pattern
    */
-  $regex?: TValue extends string ? RegExp | string : never;
+  $regex?: TValue extends string ? RegExp | string | null : never;
   /**
    * Matches arrays with a specified number of elements
    */
-  $size?: TValue extends Array<unknown> ? number : never;
+  $size?: TValue extends Array<unknown> ? number | null : never;
 }
 interface PropertyBase<TName extends string = string> {
   /**
@@ -298,92 +312,92 @@ interface PropertyBase<TName extends string = string> {
   /**
    * Display name (supports i18n)
    */
-  display_name?: I18nText;
+  display_name?: I18nText | null;
   /**
    * Whether this property is required
    */
-  required?: boolean;
+  required?: boolean | null;
   /**
    * Display condition; if not set, property is always visible
    */
   display?: {
-    hide?: DisplayCondition;
-    show?: DisplayCondition;
-  };
+    hide?: DisplayCondition | null;
+    show?: DisplayCondition | null;
+  } | null;
   /**
    * AI-related configuration
    */
   ai?: {
-    llm_description?: I18nText;
-  };
+    llm_description?: I18nText | null;
+  } | null;
   /**
    * UI configuration for how the property is displayed
    */
-  ui?: PropertyUICommonProps;
+  ui?: PropertyUICommonProps | null;
 }
 interface PropertyString<TName extends string = string> extends PropertyBase<TName> {
   type: "string";
   /**
    * Restrict value to a single constant
    */
-  constant?: string;
+  constant?: string | null;
   /**
    * Default value when not specified
    */
-  default?: string;
+  default?: string | null;
   /**
    * Restrict value to a set of allowed values
    */
-  enum?: Array<string>;
+  enum?: Array<string> | null;
   /**
    * Maximum string length
    */
-  max_length?: number;
+  max_length?: number | null;
   /**
    * Minimum string length
    */
-  min_length?: number;
-  ui?: PropertyUIString;
+  min_length?: number | null;
+  ui?: PropertyUIString | null;
 }
 interface PropertyNumber<TName extends string = string> extends PropertyBase<TName> {
   type: "number" | "integer";
   /**
    * Restrict value to a single constant
    */
-  constant?: number;
+  constant?: number | null;
   /**
    * Default value when not specified
    */
-  default?: number;
+  default?: number | null;
   /**
    * Restrict value to a set of allowed values
    */
-  enum?: Array<number>;
+  enum?: Array<number> | null;
   /**
    * Maximum value (inclusive)
    */
-  maximum?: number;
+  maximum?: number | null;
   /**
    * Minimum value (inclusive)
    */
-  minimum?: number;
-  ui?: PropertyUINumber;
+  minimum?: number | null;
+  ui?: PropertyUINumber | null;
 }
 interface PropertyBoolean<TName extends string = string> extends PropertyBase<TName> {
   type: "boolean";
   /**
    * Restrict value to a single constant
    */
-  constant?: boolean;
+  constant?: boolean | null;
   /**
    * Default value when not specified
    */
-  default?: boolean;
+  default?: boolean | null;
   /**
    * Restrict value to a set of allowed values
    */
-  enum?: Array<boolean>;
-  ui?: PropertyUIBoolean;
+  enum?: Array<boolean> | null;
+  ui?: PropertyUIBoolean | null;
 }
 /**
  * Object Property Type
@@ -402,22 +416,22 @@ interface PropertyObject<TName extends string = string, TDiscriminator extends s
   /**
    * Restrict value to a single constant
    */
-  constant?: TValue;
+  constant?: TValue | null;
   /**
    * Default value when not specified
    */
-  default?: TValue;
+  default?: TValue | null;
   /**
    * Restrict value to a set of allowed values
    */
-  enum?: Array<TValue>;
+  enum?: Array<TValue> | null;
   /**
    * Schema for additional properties beyond those defined in `properties`.
    * Supports dynamic keys with values conforming to the specified property schema.
    * Semantics similar to JSON Schema's additionalProperties: https://json-schema.org/draft/2019-09/draft-handrews-json-schema-02#additionalProperties
    */
-  additional_properties?: Property;
-  ui?: PropertyUIObject;
+  additional_properties?: Property | null;
+  ui?: PropertyUIObject | null;
 }
 interface PropertyDiscriminatedUnion<TName extends string = string, TDiscriminator extends string = string> extends PropertyBase<TName> {
   type: "discriminated_union";
@@ -432,13 +446,13 @@ interface PropertyDiscriminatedUnion<TName extends string = string, TDiscriminat
   /**
    * UI component for displaying the discriminator field
    */
-  discriminator_ui?: PropertyUISwitchProps | PropertyUISingleSelectProps | PropertyUIRadioGroupProps;
+  discriminator_ui?: PropertyUISwitchProps | PropertyUISingleSelectProps | PropertyUIRadioGroupProps | null;
 }
 interface PropertyArray<TName extends string = string> extends PropertyBase<TName> {
   type: "array";
-  constant?: Array<JsonValue>;
-  default?: Array<JsonValue>;
-  enum?: Array<Array<JsonValue>>;
+  constant?: Array<JsonValue> | null;
+  default?: Array<JsonValue> | null;
+  enum?: Array<Array<JsonValue>> | null;
   /**
    * Item schema for array elements
    */
@@ -446,12 +460,12 @@ interface PropertyArray<TName extends string = string> extends PropertyBase<TNam
   /**
    * Maximum array size (inclusive)
    */
-  max_items?: number;
+  max_items?: number | null;
   /**
    * Minimum array size (inclusive)
    */
-  min_items?: number;
-  ui?: PropertyUIArray;
+  min_items?: number | null;
+  ui?: PropertyUIArray | null;
 }
 interface PropertyCredentialId<TName extends string = string> extends PropertyBase<TName> {
   type: "credential_id";
@@ -461,11 +475,11 @@ interface PropertyCredentialId<TName extends string = string> extends PropertyBa
    * **Note:** The name must match exactly, otherwise the system will be unable to find the corresponding credential.
    */
   credential_name: string;
-  ui?: PropertyUICredentialId;
+  ui?: PropertyUICredentialId | null;
 }
 interface PropertyEncryptedString<TName extends string = string> extends PropertyBase<TName> {
   type: "encrypted_string";
-  ui?: PropertyUIEncryptedString;
+  ui?: PropertyUIEncryptedString | null;
 }
 type PropertyScalar<TName extends string = string> = PropertyString<TName> | PropertyBoolean<TName> | PropertyNumber<TName> | PropertyEncryptedString<TName>;
 type Property<TName extends string = string, TValue extends JsonValue = JsonValue> = PropertyScalar<TName> | PropertyCredentialId<TName> | PropertyArray<TName> | PropertyObject<TName, string, TValue extends JsonObject ? TValue : JsonObject> | PropertyDiscriminatedUnion<TName, string>;
@@ -500,15 +514,15 @@ interface PluginDefinition<Locales extends string[], TransporterOptions> extends
   /**
    * The author's name of the plugin.
    */
-  author?: string;
+  author?: string | null;
   /**
    * The author's email address.
    */
-  email?: string;
+  email?: string | null;
   /**
    * The source URL of the plugin.
    */
-  repo?: string;
+  repo?: string | null;
   /**
    * The version of the plugin.
    *
@@ -516,11 +530,15 @@ interface PluginDefinition<Locales extends string[], TransporterOptions> extends
    *
    * We recommend doing it this way, but if you do provide this value, please ensure that it remains consistent with the version field in package.json.
    */
-  version?: string;
+  version?: string | null;
   /**
    * The options for the transporter.
    */
   transporterOptions?: TransporterOptions;
+  /**
+   * The programming language the plugin is implemented in.
+   */
+  lang: "elixir" | "typescript";
 }
 type Feature = CredentialDefinition | DataSourceDefinition | ModelDefinition | ToolDefinition;
 /**
@@ -716,5 +734,5 @@ interface ToolDefinition extends BaseDefinition {
   parameters: Array<Property>;
 }
 //#endregion
-export { PropertyUIEmojiPickerProps as A, PropertyUIRadioGroupProps as B, PropertyUIBoolean as C, PropertyUIComponentType as D, PropertyUICommonProps as E, PropertyUIMisc as F, JsonValueSchema as G, PropertyUIString as H, PropertyUINumber as I, I18nText as K, PropertyUIObject as L, PropertyUIEncryptedString as M, PropertyUIInputProps as N, PropertyUIContainer as O, PropertyUIKeyValueEditorProps as P, PropertyUIOption as R, PropertyUIArraySectionProps as S, PropertyUIColorPickerProps as T, PropertyUISwitchProps as U, PropertyUISingleSelectProps as V, JsonValue$1 as W, PropertyNumber as _, ModelDefinition as a, PropertyString as b, DisplayCondition as c, PropertyArray as d, PropertyBase as f, PropertyEncryptedString as g, PropertyDiscriminatedUnion as h, Feature as i, PropertyUIEncryptedInputProps as j, PropertyUICredentialId as k, FilterOperators as l, PropertyCredentialId as m, CredentialDefinition as n, PluginDefinition as o, PropertyBoolean as p, DataSourceDefinition as r, ToolDefinition as s, BaseDefinition as t, Property as u, PropertyObject as v, PropertyUICollapsiblePanelProps as w, PropertyUIArray as x, PropertyScalar as y, PropertyUIProps as z };
-//# sourceMappingURL=definition-DEEuUiSF.d.mts.map
+export { PropertyUIEmojiPickerProps as A, PropertyUIRadioGroupProps as B, PropertyUIBoolean as C, PropertyUIComponentType as D, PropertyUICommonProps as E, PropertyUIMisc as F, JsonValue$1 as G, PropertyUISingleSelectProps as H, PropertyUINumber as I, JsonValueSchema as K, PropertyUIObject as L, PropertyUIEncryptedString as M, PropertyUIInputProps as N, PropertyUIContainer as O, PropertyUIKeyValueEditorProps as P, PropertyUIOption as R, PropertyUIArraySectionProps as S, PropertyUIColorPickerProps as T, PropertyUIString as U, PropertyUISectionProps as V, PropertyUISwitchProps as W, PropertyNumber as _, ModelDefinition as a, PropertyString as b, DisplayCondition as c, PropertyArray as d, PropertyBase as f, PropertyEncryptedString as g, PropertyDiscriminatedUnion as h, Feature as i, PropertyUIEncryptedInputProps as j, PropertyUICredentialId as k, FilterOperators as l, PropertyCredentialId as m, CredentialDefinition as n, PluginDefinition as o, PropertyBoolean as p, I18nText as q, DataSourceDefinition as r, ToolDefinition as s, BaseDefinition as t, Property as u, PropertyObject as v, PropertyUICollapsiblePanelProps as w, PropertyUIArray as x, PropertyScalar as y, PropertyUIProps as z };
+//# sourceMappingURL=definition-DzbEI2zh.d.mts.map