@almadar/core 10.36.0 → 10.38.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-25T06:32:53.902Z",
+  exportedAt: "2026-07-26T06:18:13.545Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -40322,6 +40322,360 @@ var patterns_registry_default = {
           description: "className prop"
         }
       }
+    },
+    "import-preview-tree": {
+      type: "import-preview-tree",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "ImportPreviewTree component",
+      suggestedFor: [
+        "import",
+        "preview",
+        "tree",
+        "import preview tree"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Staged units to preview",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              ref: {
+                types: [
+                  "string"
+                ]
+              },
+              targetEntity: {
+                types: [
+                  "string"
+                ]
+              },
+              fields: {
+                types: [
+                  "object"
+                ],
+                mapValue: {
+                  types: [
+                    "object"
+                  ],
+                  freeform: true
+                }
+              },
+              parentRef: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "ref",
+              "targetEntity",
+              "fields"
+            ]
+          }
+        },
+        skipped: {
+          types: [
+            "array"
+          ],
+          description: "Elements skipped during extraction, with reasons",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              ref: {
+                types: [
+                  "string"
+                ]
+              },
+              reason: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "ref",
+              "reason"
+            ]
+          },
+          default: []
+        },
+        entityDisplay: {
+          types: [
+            "object"
+          ],
+          description: "Entity name \u2192 display labels; falls back to the entity name",
+          required: true,
+          mapValue: {
+            types: [
+              "object"
+            ],
+            properties: {
+              singular: {
+                types: [
+                  "string"
+                ]
+              },
+              plural: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "singular",
+              "plural"
+            ]
+          }
+        },
+        onConfirm: {
+          types: [
+            "function"
+          ],
+          description: "Called when the user confirms the staged import",
+          kind: "callback",
+          callbackArgs: []
+        },
+        onCancel: {
+          types: [
+            "function"
+          ],
+          description: "Called when the user cancels the staged import",
+          kind: "callback",
+          callbackArgs: []
+        },
+        confirmLabel: {
+          types: [
+            "string"
+          ],
+          description: "Confirm button label",
+          default: "Confirm import"
+        },
+        cancelLabel: {
+          types: [
+            "string"
+          ],
+          description: "Cancel button label",
+          default: "Cancel"
+        },
+        indent: {
+          types: [
+            "number"
+          ],
+          description: "Indent per tree depth in px (default: 16)",
+          default: 16
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "import-progress": {
+      type: "import-progress",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "ImportProgress component",
+      suggestedFor: [
+        "import",
+        "progress",
+        "import progress"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        step: {
+          types: [
+            "string"
+          ],
+          description: "Current lifecycle step",
+          required: true,
+          enumValues: [
+            "fetching",
+            "mapping",
+            "reviewing",
+            "committing",
+            "done",
+            "failed"
+          ]
+        },
+        counts: {
+          types: [
+            "object"
+          ],
+          description: "Unit counts",
+          properties: {
+            staged: {
+              types: [
+                "number"
+              ]
+            },
+            committed: {
+              types: [
+                "number"
+              ]
+            },
+            failed: {
+              types: [
+                "number"
+              ]
+            }
+          }
+        },
+        labels: {
+          types: [
+            "object"
+          ],
+          description: "Step label overrides",
+          mapValue: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "import-source-picker": {
+      type: "import-source-picker",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "ImportSourcePicker component",
+      suggestedFor: [
+        "import",
+        "source",
+        "picker",
+        "import source picker"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        sources: {
+          types: [
+            "array"
+          ],
+          description: "Source options to render",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              description: {
+                types: [
+                  "string"
+                ]
+              },
+              icon: {
+                types: [
+                  "icon",
+                  "string"
+                ]
+              },
+              kind: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "action",
+                  "file"
+                ]
+              },
+              accept: {
+                types: [
+                  "string"
+                ]
+              },
+              multiple: {
+                types: [
+                  "boolean"
+                ]
+              },
+              disabled: {
+                types: [
+                  "boolean"
+                ]
+              }
+            },
+            required: [
+              "id",
+              "label"
+            ]
+          }
+        },
+        onSelect: {
+          types: [
+            "function"
+          ],
+          description: "Called with the source id when an 'action' option is picked",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "sourceId",
+              type: "string"
+            }
+          ]
+        },
+        onFilesSelected: {
+          types: [
+            "function"
+          ],
+          description: "Called with the chosen files when a 'file' option resolves",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "files",
+              type: "array"
+            }
+          ],
+          nonEmittable: true
+        },
+        title: {
+          types: [
+            "string"
+          ],
+          description: "Optional heading above the options"
+        },
+        moreSources: {
+          types: [
+            "node"
+          ],
+          description: "Generic slot for additional sources rendered below the options"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
     }
   },
   categories: [
@@ -40971,15 +41325,35 @@ var integrators_registry_default = {
           }
         }
       ]
+    },
+    database: {
+      name: "database",
+      description: "Generic SQL database integration - read-only queries over external connections",
+      category: "infrastructure",
+      actions: [
+        {
+          name: "query",
+          description: "Run a single read-only SELECT against a connection referenced by env var name",
+          params: [
+            { name: "connectionRef", type: "string", required: true, description: "Name of the environment variable holding the connection string (never the secret itself)" },
+            { name: "sql", type: "string", required: true, description: "Single SELECT statement (read-only enforced)" },
+            { name: "params", type: "array", required: false, description: "Bind parameters for the query" }
+          ],
+          responseShape: {
+            rows: "array",
+            rowCount: "number"
+          }
+        }
+      ]
     }
   },
-  categories: ["media", "payment", "messaging", "ai", "devtools"]
+  categories: ["media", "payment", "messaging", "ai", "devtools", "infrastructure"]
 };
 
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-25T06:32:53.902Z",
+  exportedAt: "2026-07-26T06:18:13.545Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -42337,6 +42711,21 @@ var component_mapping_default = {
       component: "PageTransition",
       importPath: "@/components/core/molecules/PageTransition",
       category: "component"
+    },
+    "import-preview-tree": {
+      component: "ImportPreviewTree",
+      importPath: "@/components/core/molecules/ImportPreviewTree",
+      category: "component"
+    },
+    "import-progress": {
+      component: "ImportProgress",
+      importPath: "@/components/core/molecules/ImportProgress",
+      category: "component"
+    },
+    "import-source-picker": {
+      component: "ImportSourcePicker",
+      importPath: "@/components/core/molecules/ImportSourcePicker",
+      category: "component"
     }
   }
 };
@@ -42344,7 +42733,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-25T06:32:53.902Z",
+  exportedAt: "2026-07-26T06:18:13.545Z",
   contracts: {
     form: {
       emits: [
@@ -43623,6 +44012,9 @@ var PATTERN_TYPES = [
   "hero-section",
   "hstack",
   "icon",
+  "import-preview-tree",
+  "import-progress",
+  "import-source-picker",
   "infinite-scroll-sentinel",
   "input",
   "input-group",