@stina/extension-api 0.28.1 → 0.29.0

package/src/schemas/components.schema.ts

@@ -414,6 +414,16 @@ export const MarkdownPropsSchema = z
   .passthrough()
   .describe('Markdown component')
 
+export const TextPreviewPropsSchema = z
+  .object({
+    component: z.literal('TextPreview'),
+    content: z.string().describe('Markdown content'),
+    maxLines: z.number().optional().describe('Max visible lines before truncating (default 5)'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('TextPreview component')
+
 export const ModalPropsSchema = z
   .object({
     component: z.literal('Modal'),
@@ -438,6 +448,33 @@ export const ConditionalGroupPropsSchema = z
   .passthrough()
   .describe('ConditionalGroup component')
 
+export const FrameVariantSchema = z
+  .enum(['border', 'solid'])
+  .describe('Frame visual variant')
+
+export const FramePropsSchema = z
+  .object({
+    component: z.literal('Frame'),
+    title: z.union([z.string(), ExtensionComponentChildrenSchema]).optional().describe('Optional title (string or components)'),
+    icon: z.string().optional().describe('Icon name'),
+    collapsible: z.boolean().optional().describe('Whether content can be toggled'),
+    defaultExpanded: z.boolean().optional().describe('Whether expanded by default'),
+    variant: FrameVariantSchema.optional().describe('Visual variant'),
+    children: ExtensionComponentChildrenSchema.describe('Child components'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('Frame container component')
+
+export const ListPropsSchema = z
+  .object({
+    component: z.literal('List'),
+    children: ExtensionComponentChildrenSchema.describe('Child components rendered as list items'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('List component')
+
 // =============================================================================
 // Type Exports
 // =============================================================================
@@ -473,5 +510,9 @@ export type CollapsibleProps = z.infer<typeof CollapsiblePropsSchema>
 export type PillProps = z.infer<typeof PillPropsSchema>
 export type CheckboxProps = z.infer<typeof CheckboxPropsSchema>
 export type MarkdownProps = z.infer<typeof MarkdownPropsSchema>
+export type TextPreviewProps = z.infer<typeof TextPreviewPropsSchema>
 export type ModalProps = z.infer<typeof ModalPropsSchema>
 export type ConditionalGroupProps = z.infer<typeof ConditionalGroupPropsSchema>
+export type FrameVariant = z.infer<typeof FrameVariantSchema>
+export type FrameProps = z.infer<typeof FramePropsSchema>
+export type ListProps = z.infer<typeof ListPropsSchema>

package/src/schemas/index.ts

@@ -123,6 +123,10 @@ export {
   PanelPropsSchema,
   TogglePropsSchema,
   CollapsiblePropsSchema,
+  FrameVariantSchema,
+  FramePropsSchema,
+  TextPreviewPropsSchema,
+  ListPropsSchema,
   PillPropsSchema,
   CheckboxPropsSchema,
   MarkdownPropsSchema,
@@ -156,6 +160,10 @@ export {
   type PanelProps,
   type ToggleProps,
   type CollapsibleProps,
+  type FrameVariant,
+  type FrameProps,
+  type TextPreviewProps,
+  type ListProps,
   type PillProps,
   type CheckboxProps,
   type MarkdownProps,

package/src/types.components.ts

@@ -1,3 +1,10 @@
+// =============================================================================
+// Icon Names
+// =============================================================================
+
+/** Semantic type alias for icon names (e.g. Hugeicons). Accepts any string. */
+export type HugeIconName = string
+
 // =============================================================================
 // Styling
 // =============================================================================
@@ -235,7 +242,7 @@ export interface HeaderProps extends ExtensionComponentData {
   level: number
   title: string
   description?: string | string[]
-  icon?: string
+  icon?: HugeIconName
 }
 
 /** The extension API properties for the Label component. */
@@ -321,7 +328,7 @@ export interface DividerProps extends ExtensionComponentData {
 /** The extension API properties for the Icon component. */
 export interface IconProps extends ExtensionComponentData {
   component: 'Icon'
-  name: string
+  name: HugeIconName
   title?: string
 }
 
@@ -331,7 +338,7 @@ export type IconButtonType = 'normal' | 'primary' | 'danger' | 'accent'
 /** The extension API properties for the IconButton component. */
 export interface IconButtonProps extends ExtensionComponentData {
   component: 'IconButton'
-  icon: string
+  icon: HugeIconName
   tooltip: string
   active?: boolean
   disabled?: boolean
@@ -341,7 +348,7 @@ export interface IconButtonProps extends ExtensionComponentData {
 
 /** Action button definition for Panel component. */
 export interface PanelAction {
-  icon: string
+  icon: HugeIconName
   tooltip: string
   action: ExtensionActionRef
   type?: IconButtonType
@@ -352,7 +359,7 @@ export interface PanelProps extends ExtensionComponentData {
   component: 'Panel'
   title: string
   description?: string | string[]
-  icon?: string
+  icon?: HugeIconName
   actions?: PanelAction[]
   content?: ExtensionComponentData
 }
@@ -375,7 +382,7 @@ export interface CollapsibleProps extends ExtensionComponentData {
   /** Optional description rendered under the title. */
   description?: string | string[]
   /** Optional icon shown to the left of the title. */
-  icon?: string
+  icon?: HugeIconName
   /** Whether the section is expanded by default. */
   defaultExpanded?: boolean
   /** Child component to render when expanded. */
@@ -391,7 +398,7 @@ export interface PillProps extends ExtensionComponentData {
   /** Text to display in the pill. */
   text: string
   /** Optional icon shown to the left of the text. */
-  icon?: string
+  icon?: HugeIconName
   /** Color variant. Defaults to 'default'. */
   variant?: PillVariant
 }
@@ -418,6 +425,15 @@ export interface MarkdownProps extends ExtensionComponentData {
   content: string
 }
 
+/** The extension API properties for the TextPreview component. */
+export interface TextPreviewProps extends ExtensionComponentData {
+  component: 'TextPreview'
+  /** Markdown content to render. */
+  content: string
+  /** Maximum number of visible lines before truncating. Defaults to 5. */
+  maxLines?: number
+}
+
 /** The extension API properties for the Modal component. */
 export interface ModalProps extends ExtensionComponentData {
   component: 'Modal'
@@ -455,3 +471,28 @@ export interface ConditionalGroupProps extends ExtensionComponentData {
   /** Children to render when condition is true. */
   children: ExtensionComponentChildren
 }
+
+/** Visual variant for the Frame component. */
+export type FrameVariant = 'border' | 'solid'
+
+/** The extension API properties for the Frame component. */
+export interface FrameProps extends ExtensionComponentData {
+  component: 'Frame'
+  /** Optional title displayed in the header. Can be a plain string or extension components. */
+  title?: string | ExtensionComponentChildren
+  /** Whether the content can be toggled (collapsed/expanded) by clicking the title. Requires title to be set. */
+  collapsible?: boolean
+  /** Whether the frame content is expanded by default. Only used when collapsible is true. Defaults to true. */
+  defaultExpanded?: boolean
+  /** Visual variant: 'border' shows a bordered container, 'solid' shows a solid background. Defaults to 'border'. */
+  variant?: FrameVariant
+  /** Child components to render inside the frame. */
+  children: ExtensionComponentChildren
+}
+
+/** The extension API properties for the List component. */
+export interface ListProps extends ExtensionComponentData {
+  component: 'List'
+  /** Child components to render as list items. Supports iteration. */
+  children: ExtensionComponentChildren
+}