@synopackageland/ui 0.9.4 → 0.9.6

package/dist/json-ai-prompt.md

@@ -47,13 +47,13 @@ For lists where users can add/remove items (todos, carts, etc.), use pushState a
 
 IMPORTANT: State paths use RFC 6901 JSON Pointer syntax (e.g. "/todos/0/title"). Do NOT use JavaScript-style dot notation (e.g. "/todos.length" is WRONG). To generate unique IDs for new items, use "$id" instead of trying to read array length.
 
-AVAILABLE COMPONENTS (30):
+AVAILABLE COMPONENTS (34):
 
 - AppRoot: { modalScope?: "document" | "app" } - Root of a DSM application. Use once around the application shell. Dialogs stay inside the app by default (modalScope "app"); "document" is only for full-page web/Portal apps. [accepts children]
 - AppShell: { sidebarWidth?: string, minHeight?: string, responsive?: boolean, wideLayout?: "window" | "web" } - DSM application interior with optional sidebar, toolbar, main content and footer regions. Set wideLayout "web" only for a standalone Portal page; DSM windows keep the default "window" at every width. [accepts children; slots: sidebar, toolbar, footer]
 - ResponsiveView: { mode?: "auto" | "mobile" | "window" | "web" } - Optionally replace a specialized element with a phone-friendly alternative. mobile/window/web slots follow AppShell container width (web only with AppShell wideLayout "web"); default is always the fallback. [accepts children; slots: mobile, window, web]
 - Page: { width?: string, surface?: "auto" | "flat" | "card" } - Page content area. Use width "fill" for data-heavy screens and "readable" for forms/settings. [accepts children]
-- PageHeader: { title: string, description?: string } - Page heading with optional description and page-level actions. [slots: actions]
+- PageHeader: { title: string, description?: string } - Page heading with optional description and page-level actions. The meta slot sits on the title line, for a small chip such as when the data was read. [slots: actions, meta]
 - Toolbar: { height?: string } - Application toolbar. Put primary page-independent actions in the actions slot. [accepts children; slots: leading, actions]
 - SidebarNav: { value?: string, groups: Array<{ label?: string, items: Array<unknown> }>, searchable?: boolean, collapsible?: boolean, searchPlaceholder?: string } - DSM sidebar navigation. Icon values are names registered by the host application. [events: change]
 - Tabs: { value: string, items: Array<{ label: string, value: string, disabled?: boolean }>, ariaLabel?: string } - Section tabs for switching a local mode or filter. Bind value to state for two-way updates. [events: change]
@@ -71,13 +71,17 @@ AVAILABLE COMPONENTS (30):
 - SettingsField: { label: string, description?: string, required?: boolean, fieldWidth?: string, align?: "start" | "center" } - DSM settings row with label, description and one control/content region. [accepts children]
 - Surface: { padding?: "none" | "sm" | "md" | "lg", border?: boolean, raised?: boolean } - Neutral bordered/raised content surface when Card semantics are not needed. [accepts children]
 - Card: { title?: string, layoutType?: "regular" | "compact", expandable?: boolean, expanded?: boolean, footerAlign?: "start" | "end" | "between" } - Grouped content with optional header/actions/footer. Do not use a Card just to add spacing. [accepts children; slots: header-actions, footer] [events: expandedChange]
-- Callout: { tone?: "info" | "success" | "warning" | "danger", title?: string, closable?: boolean } - Inline information, success, warning or error message. [accepts children; slots: actions] [events: close]
+- Callout: { tone?: "info" | "success" | "warning" | "danger", title?: string, closable?: boolean, code?: string } - Inline information, success, warning or error message. Put a machine error code in `code`, not in the text. [accepts children; slots: actions] [events: close]
 - EmptyState: { title: string, description?: string, icon?: string } - Empty/no-results state with optional recovery or create actions. [slots: actions]
-- Progress: { value?: number, max?: number, label?: string, valueLabel?: string } - Linear determinate progress. Domain-specific progress visualizations should be custom components.
+- Progress: { value?: number, max?: number, label?: string, valueLabel?: string, tone?: "primary" | "success" | "warning" | "danger" } - Linear determinate progress. Domain-specific progress visualizations should be custom components.
 - Badge: { text: string, tone?: "neutral" | "info" | "success" | "warning" | "danger" } - Short status/category badge.
 - Dialog: { open?: boolean, title?: string, description?: string, width?: string, showClose?: boolean } - Modal task/dialog. Bind open to state. Put confirmation or form actions in footer. [accepts children; slots: footer] [events: openChange]
 - DataTable: { columns: Array<{ key: string, label: string, width?: string, align?: "left" | "center" | "right" }>, rows: Array<Record<string, unknown>>, rowKey?: string, emptyText?: string, compact?: boolean, mobileView?: "auto" | "cards" | "table" } - Simple resource table where cells display scalar row fields. Use an app extension component for rich/custom cells and row actions.
 - ResourceList: { columns: Array<{ key: string, label: string, width?: string, align?: "left" | "center" | "right" }>, rows: Array<Record<string, unknown>>, rowKey?: string, emptyText?: string, compact?: boolean, mobileView?: "auto" | "cards" | "table" } - Common resource collection pattern: optional toolbar plus a simple table. For domain-specific row rendering, extend the catalog with a custom list/table component. [slots: toolbar]
+- CellText: { text: string, secondary?: string, layout?: "stacked" | "inline", openLabel?: string, openDisabled?: boolean } - Main text with secondary information (size, time, path), truncated with a tooltip. With openLabel the main text is a link-styled button that emits open, e.g. "Open in File Station". [events: open]
+- CellStatus: { label: string, tone?: "neutral" | "info" | "success" | "warning" | "danger", progress?: number, detail?: string } - Task status: a toned dot and label, a bar while progress (0–100) is running, and a detail such as speed or a reason.
+- ListItem: { title?: string, description?: string } - One entry of a list (an extension, a tool, a rule): title, description, content and actions on the right. Consecutive entries are split by a hairline. [accepts children; slots: actions]
+- InputGroup: {  } - A field and the buttons acting on it on one line, such as a URL and its Install button. The first child takes the room left. [accepts children]
 - Loading: { text?: string } - Centered loading state for a page or bounded region.
 
 AVAILABLE ACTIONS:

package/dist/json-catalog.schema.json

@@ -225,6 +225,10 @@
             "Dialog",
             "DataTable",
             "ResourceList",
+            "CellText",
+            "CellStatus",
+            "ListItem",
+            "InputGroup",
             "Loading"
           ]
         },
@@ -538,7 +542,7 @@
             }
           },
           "then": {
-            "description": "Page heading with optional description and page-level actions.",
+            "description": "Page heading with optional description and page-level actions. The meta slot sits on the title line, for a small chip such as when the data was read.",
             "properties": {
               "props": {
                 "type": "object",
@@ -575,7 +579,8 @@
               "slots": {
                 "propertyNames": {
                   "enum": [
-                    "actions"
+                    "actions",
+                    "meta"
                   ]
                 }
               },
@@ -2051,7 +2056,7 @@
             }
           },
           "then": {
-            "description": "Inline information, success, warning or error message.",
+            "description": "Inline information, success, warning or error message. Put a machine error code in `code`, not in the text.",
             "properties": {
               "props": {
                 "type": "object",
@@ -2091,6 +2096,16 @@
                         "$ref": "#/$defs/expression"
                       }
                     ]
+                  },
+                  "code": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
                   }
                 },
                 "additionalProperties": false
@@ -2233,6 +2248,22 @@
                         "$ref": "#/$defs/expression"
                       }
                     ]
+                  },
+                  "tone": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "primary",
+                          "success",
+                          "warning",
+                          "danger"
+                        ]
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
                   }
                 },
                 "additionalProperties": false
@@ -2674,6 +2705,262 @@
             }
           }
         },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "CellText"
+              }
+            }
+          },
+          "then": {
+            "description": "Main text with secondary information (size, time, path), truncated with a tooltip. With openLabel the main text is a link-styled button that emits open, e.g. \"Open in File Station\".",
+            "properties": {
+              "props": {
+                "type": "object",
+                "properties": {
+                  "text": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  },
+                  "secondary": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  },
+                  "layout": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "stacked",
+                          "inline"
+                        ]
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  },
+                  "openLabel": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  },
+                  "openDisabled": {
+                    "anyOf": [
+                      {
+                        "type": "boolean"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "text"
+                ],
+                "additionalProperties": false
+              },
+              "children": {
+                "maxItems": 0
+              },
+              "slots": {
+                "propertyNames": {
+                  "enum": []
+                }
+              },
+              "on": {
+                "propertyNames": {
+                  "enum": [
+                    "open"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "CellStatus"
+              }
+            }
+          },
+          "then": {
+            "description": "Task status: a toned dot and label, a bar while progress (0–100) is running, and a detail such as speed or a reason.",
+            "properties": {
+              "props": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  },
+                  "tone": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "neutral",
+                          "info",
+                          "success",
+                          "warning",
+                          "danger"
+                        ]
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  },
+                  "progress": {
+                    "anyOf": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  },
+                  "detail": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "label"
+                ],
+                "additionalProperties": false
+              },
+              "children": {
+                "maxItems": 0
+              },
+              "slots": {
+                "propertyNames": {
+                  "enum": []
+                }
+              },
+              "on": {
+                "propertyNames": {
+                  "enum": []
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "ListItem"
+              }
+            }
+          },
+          "then": {
+            "description": "One entry of a list (an extension, a tool, a rule): title, description, content and actions on the right. Consecutive entries are split by a hairline.",
+            "properties": {
+              "props": {
+                "type": "object",
+                "properties": {
+                  "title": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  },
+                  "description": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/$defs/expression"
+                      }
+                    ]
+                  }
+                },
+                "additionalProperties": false
+              },
+              "slots": {
+                "propertyNames": {
+                  "enum": [
+                    "actions"
+                  ]
+                }
+              },
+              "on": {
+                "propertyNames": {
+                  "enum": []
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "InputGroup"
+              }
+            }
+          },
+          "then": {
+            "description": "A field and the buttons acting on it on one line, such as a URL and its Install button. The first child takes the room left.",
+            "properties": {
+              "props": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": false
+              },
+              "slots": {
+                "propertyNames": {
+                  "enum": []
+                }
+              },
+              "on": {
+                "propertyNames": {
+                  "enum": []
+                }
+              }
+            }
+          }
+        },
         {
           "if": {
             "properties": {