@almadar/patterns 2.41.0 → 2.42.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-12T08:35:33.532Z",
+  exportedAt: "2026-06-16T06:23:39.790Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -13952,7 +13952,7 @@ var patterns_registry_default = {
         },
         language: {
           types: [
-            "string"
+            "unknown"
           ],
           description: "Language for display label"
         },
@@ -14067,7 +14067,7 @@ var patterns_registry_default = {
               },
               language: {
                 types: [
-                  "string"
+                  "unknown"
                 ]
               }
             },
@@ -14467,7 +14467,7 @@ var patterns_registry_default = {
         },
         language: {
           types: [
-            "string"
+            "unknown"
           ],
           description: "Programming language for syntax highlighting",
           default: "text"
@@ -23037,6 +23037,13 @@ var patterns_registry_default = {
           ],
           description: "placeholder prop"
         },
+        enableBlocks: {
+          types: [
+            "boolean"
+          ],
+          description: "Opt-in to the Notion-style block authoring chrome (insert toolbar, per-row +/menu gutter, turn-into menu). Off by default: the editor renders as a plain rich text surface that edits block content inline without any add-block affordances.",
+          default: false
+        },
         showToolbar: {
           types: [
             "boolean"
@@ -25867,7 +25874,7 @@ var patterns_registry_default = {
         },
         language: {
           types: [
-            "string"
+            "unknown"
           ],
           description: "Programming language label"
         },
@@ -40965,6 +40972,412 @@ var patterns_registry_default = {
         }
       }
     },
+    "asset-picker": {
+      type: "asset-picker",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "AssetPicker component",
+      suggestedFor: [
+        "asset",
+        "picker",
+        "asset picker"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        assets: {
+          types: [
+            "object"
+          ],
+          description: "Browsable asset catalog supplied by the host.",
+          required: true,
+          freeform: true
+        },
+        value: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected asset url (controlled highlight)."
+        },
+        onChange: {
+          types: [
+            "function"
+          ],
+          description: "Fired with the chosen asset's url.",
+          required: true,
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "url",
+              type: "string"
+            }
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes applied to the root."
+        }
+      }
+    },
+    "grid-picker": {
+      type: "grid-picker",
+      category: "display",
+      tier: "molecules",
+      family: "core",
+      description: "GridPicker component",
+      suggestedFor: [
+        "grid",
+        "picker",
+        "grid picker"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        items: {
+          types: [
+            "array"
+          ],
+          description: "Items to render as grid cells.",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              category: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "id",
+              "label",
+              "category"
+            ]
+          }
+        },
+        value: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected item id (controlled highlight)."
+        },
+        onChange: {
+          types: [
+            "function"
+          ],
+          description: "Fired with the clicked/selected item's id.",
+          required: true,
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "value",
+              type: "string"
+            }
+          ]
+        },
+        categories: {
+          types: [
+            "array"
+          ],
+          description: 'Category keys for the filter chip row. When omitted, the categories are derived from the items. An "All" chip is always prepended.',
+          items: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        searchPlaceholder: {
+          types: [
+            "string"
+          ],
+          description: "Placeholder for the search input."
+        },
+        renderThumbnail: {
+          types: [
+            "function"
+          ],
+          description: "Renders the visual content of a cell (e.g. an emoji glyph or an image).",
+          required: true,
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "item",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  label: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  category: {
+                    types: [
+                      "string"
+                    ]
+                  }
+                },
+                required: [
+                  "id",
+                  "label",
+                  "category"
+                ]
+              }
+            }
+          ],
+          renderCallback: true
+        },
+        cellSize: {
+          types: [
+            "number"
+          ],
+          description: "Cell edge length in px.",
+          numericEnumValues: [
+            16,
+            32,
+            48
+          ],
+          default: 32
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes applied to the root."
+        }
+      }
+    },
+    "icon-picker": {
+      type: "icon-picker",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "IconPicker component",
+      suggestedFor: [
+        "icon",
+        "picker",
+        "icon picker"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        value: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected icon name (kebab-case)."
+        },
+        onChange: {
+          types: [
+            "function"
+          ],
+          description: "Fired with the chosen icon's kebab-case name.",
+          required: true,
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "name",
+              type: "string"
+            }
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes applied to the root."
+        }
+      }
+    },
+    "property-inspector": {
+      type: "property-inspector",
+      category: "debug",
+      tier: "molecules",
+      family: "core",
+      description: "PropertyInspector \u2014 Storybook-style controls panel for a trait's `config`.  Derives one control per declared config field directly from the schema (`@almadar/core` `DeclaredTraitConfig`): `boolean \u2192 Switch`, `string` with `values \u2192 Select`, `number \u2192 numeric Input`, `string \u2192 Input`. Non-scalar fields (array/object/node/SExpr) are shown read-only. Fields group + collapse by `@tier`. The component is controlled \u2014 it emits `onChange(field, value)`; text/number commit on blur (so the host can re-render without hammering it).",
+      suggestedFor: [
+        "property",
+        "inspector",
+        "property inspector"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state indicator"
+        },
+        error: {
+          types: [
+            "object"
+          ],
+          description: "Error state (UiError)",
+          properties: {
+            message: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            code: {
+              types: [
+                "string"
+              ]
+            },
+            stack: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "message"
+          ]
+        },
+        sortBy: {
+          types: [
+            "string"
+          ],
+          description: "Current sort field"
+        },
+        sortDirection: {
+          types: [
+            "string"
+          ],
+          description: "Current sort direction",
+          enumValues: [
+            "asc",
+            "desc"
+          ]
+        },
+        searchValue: {
+          types: [
+            "string"
+          ],
+          description: "Current search query value"
+        },
+        page: {
+          types: [
+            "number"
+          ],
+          description: "Current page number"
+        },
+        pageSize: {
+          types: [
+            "number"
+          ],
+          description: "Number of items per page"
+        },
+        totalCount: {
+          types: [
+            "number"
+          ],
+          description: "Total number of items"
+        },
+        activeFilters: {
+          types: [
+            "object"
+          ],
+          description: "Active filters"
+        },
+        selectedIds: {
+          types: [
+            "array"
+          ],
+          description: "Currently selected item IDs",
+          items: {
+            types: [
+              "string",
+              "number"
+            ]
+          }
+        },
+        config: {
+          types: [
+            "object"
+          ],
+          description: "The trait's declared config schema (field name \u2192 declaration).",
+          required: true,
+          freeform: true
+        },
+        values: {
+          types: [
+            "object"
+          ],
+          description: "Current override values keyed by field name (falls back to each field's `default`).",
+          freeform: true
+        },
+        onChange: {
+          types: [
+            "function"
+          ],
+          description: "Fired when a control commits a new value.",
+          required: true,
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "field",
+              type: "string"
+            },
+            {
+              name: "value",
+              type: "object"
+            }
+          ]
+        },
+        onReset: {
+          types: [
+            "function"
+          ],
+          description: "Optional reset-to-defaults handler.",
+          kind: "callback",
+          callbackArgs: []
+        },
+        title: {
+          types: [
+            "string"
+          ],
+          description: "Panel heading (e.g. the trait name)."
+        },
+        assets: {
+          types: [
+            "object"
+          ],
+          description: "Browsable asset catalog supplied to `control: 'asset'` fields.",
+          freeform: true
+        }
+      }
+    },
     heading: {
       type: "heading",
       category: "component",
@@ -41919,7 +42332,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-12T08:35:33.532Z",
+  exportedAt: "2026-06-16T06:23:39.790Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -43433,6 +43846,26 @@ var component_mapping_default = {
       importPath: "@/components/atoms/StatCard",
       category: "display"
     },
+    "asset-picker": {
+      component: "AssetPicker",
+      importPath: "@/components/molecules/AssetPicker",
+      category: "component"
+    },
+    "grid-picker": {
+      component: "GridPicker",
+      importPath: "@/components/molecules/GridPicker",
+      category: "display"
+    },
+    "icon-picker": {
+      component: "IconPicker",
+      importPath: "@/components/molecules/IconPicker",
+      category: "component"
+    },
+    "property-inspector": {
+      component: "PropertyInspector",
+      importPath: "@/components/molecules/PropertyInspector",
+      category: "debug"
+    },
     heading: {
       component: "Typography",
       importPath: "@/components/atoms/Typography",
@@ -43449,7 +43882,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-12T08:35:33.532Z",
+  exportedAt: "2026-06-16T06:23:39.790Z",
   contracts: {
     form: {
       emits: [