@almadar/std 16.145.0 → 16.147.0

package/dist/behaviors/registry/ui/core/atoms/std-import.orb

@@ -0,0 +1,701 @@
+{
+  "description": "std-import — a dropdown source menu (Paste text / Markdown files defaults; caller can override via config.sources) plus the OS file picker for file-kind sources. Emits IMPORT_REQUESTED { source, files } on the bus — source is the picked SourceOption descriptor; files carries file metadata when the picker ran (empty otherwise). The actual import work is delegated to a sibling std-migration-job, which listens for IMPORT_REQUESTED and drives the migration service. Mirrors std-export: the menu emits each entry's own literal event field, so overriding the event alone does not retarget the click — also set sources[].event to match.",
+  "ledger": {
+    "entries": {
+      "ent_01KYEH1JJPJH06F07Q6CNTHTR8": {
+        "bakedName": "ImportPanel",
+        "curName": "ImportPanel",
+        "id": "ent_01KYEH1JJPJH06F07Q6CNTHTR8",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYEH1JJP2KTQ0EAMRQSJBV5W": {
+        "bakedName": "FILES_PICKED",
+        "curName": "FILES_PICKED",
+        "id": "evt_01KYEH1JJP2KTQ0EAMRQSJBV5W",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+        "renames": []
+      },
+      "evt_01KYEH1JJP6BZ2YWZ9WRJ0GTGW": {
+        "bakedName": "IMPORT_FAILED",
+        "curName": "IMPORT_FAILED",
+        "id": "evt_01KYEH1JJP6BZ2YWZ9WRJ0GTGW",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+        "renames": []
+      },
+      "evt_01KYEH1JJP9T6G59Z0W8QZ0RQT": {
+        "bakedName": "PICK_FAILED",
+        "curName": "PICK_FAILED",
+        "id": "evt_01KYEH1JJP9T6G59Z0W8QZ0RQT",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+        "renames": []
+      },
+      "evt_01KYEH1JJPC0KCYZF4BRZPTNXK": {
+        "bakedName": "IMPORT_SOURCE_PICKED",
+        "curName": "IMPORT_SOURCE_PICKED",
+        "id": "evt_01KYEH1JJPC0KCYZF4BRZPTNXK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+        "renames": []
+      },
+      "evt_01KYEH1JJPE7K0P5GAFH9G8Z0B": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYEH1JJPE7K0P5GAFH9G8Z0B",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+        "renames": []
+      },
+      "evt_01KYEH1JJPV11XQCNH3ZM9THPS": {
+        "bakedName": "IMPORT_REQUESTED",
+        "curName": "IMPORT_REQUESTED",
+        "id": "evt_01KYEH1JJPV11XQCNH3ZM9THPS",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+        "renames": []
+      },
+      "evt_01KYEH1JJPWP17G49K8GJRF8A2": {
+        "bakedName": "OPEN_IMPORT",
+        "curName": "OPEN_IMPORT",
+        "id": "evt_01KYEH1JJPWP17G49K8GJRF8A2",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+        "renames": []
+      },
+      "orb_01KYEH1JJPY8EKC5AAXRAZJ4Q3": {
+        "bakedName": "ImportOrbital",
+        "curName": "ImportOrbital",
+        "id": "orb_01KYEH1JJPY8EKC5AAXRAZJ4Q3",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYEH1JJPGXG8YK410ESQ4SSK": {
+        "bakedName": "ImportMenuPage",
+        "curName": "ImportMenuPage",
+        "id": "pag_01KYEH1JJPGXG8YK410ESQ4SSK",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYEH1JJP5EXVKFPCJ0SNERNR": {
+        "bakedName": "Button1",
+        "curName": "Button1",
+        "id": "trt_01KYEH1JJP5EXVKFPCJ0SNERNR",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYEH1JJPRZYSZAK1NXNH5K01": {
+        "bakedName": "ImportMenu",
+        "curName": "ImportMenu",
+        "id": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYEH1JJPZEXZV3CY28VFT2W4": {
+        "bakedName": "Menu1",
+        "curName": "Menu1",
+        "id": "trt_01KYEH1JJPZEXZV3CY28VFT2W4",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-import",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": {},
+            "name": "pendingSource",
+            "type": "object"
+          },
+          {
+            "default": [],
+            "items": {
+              "type": "object"
+            },
+            "name": "pendingFiles",
+            "type": "array"
+          }
+        ],
+        "id": "ent_01KYEH1JJPJH06F07Q6CNTHTR8",
+        "name": "ImportPanel",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYEH1JJPY8EKC5AAXRAZJ4Q3",
+      "name": "ImportOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYEH1JJPGXG8YK410ESQ4SSK",
+          "name": "ImportMenuPage",
+          "path": "/imports/menu",
+          "traits": [
+            {
+              "ref": "ImportMenu",
+              "refId": "trt_01KYEH1JJPRZYSZAK1NXNH5K01"
+            },
+            {
+              "ref": "Button1",
+              "refId": "trt_01KYEH1JJP5EXVKFPCJ0SNERNR"
+            },
+            {
+              "ref": "Menu1",
+              "refId": "trt_01KYEH1JJPZEXZV3CY28VFT2W4"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "config": {
+            "action": {
+              "default": "OPEN_IMPORT",
+              "type": "unknown"
+            },
+            "icon": {
+              "default": "upload",
+              "type": "unknown"
+            },
+            "label": {
+              "default": "@config.buttonLabel",
+              "type": "unknown"
+            },
+            "size": {
+              "default": "sm",
+              "type": "unknown"
+            },
+            "variant": {
+              "default": "ghost",
+              "type": "unknown"
+            }
+          },
+          "id": "trt_01KYEH1JJP5EXVKFPCJ0SNERNR",
+          "linkedEntity": "ImportPanel",
+          "linkedEntityId": "ent_01KYEH1JJPJH06F07Q6CNTHTR8",
+          "name": "Button1",
+          "ref": "Button.traits.ButtonRender"
+        },
+        {
+          "config": {
+            "items": {
+              "default": "@config.sources",
+              "type": "unknown"
+            },
+            "position": {
+              "default": "bottom-start",
+              "type": "unknown"
+            },
+            "trigger": {
+              "default": [
+                "@trait.Button1"
+              ],
+              "type": "unknown"
+            }
+          },
+          "id": "trt_01KYEH1JJPZEXZV3CY28VFT2W4",
+          "linkedEntity": "ImportPanel",
+          "linkedEntityId": "ent_01KYEH1JJPJH06F07Q6CNTHTR8",
+          "name": "Menu1",
+          "ref": "Menu.traits.MenuRender"
+        },
+        {
+          "category": "interaction",
+          "config": {
+            "accept": {
+              "default": ".md,.markdown,.txt",
+              "description": "File-extension filter for the OS file picker when a file-kind source is picked",
+              "label": "Accepted file types",
+              "synonyms": "file filter, allowed extensions, accepted formats",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "buttonLabel": {
+              "default": "Import",
+              "description": "Text shown on the toolbar button that opens the import source popover",
+              "label": "Button label",
+              "synonyms": "the text on the import trigger button. user phrases: 'rename import button to X' / 'set the button label to X' -> X (e.g. 'Import Data', 'Add Sources')",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "event": {
+              "default": "IMPORT_SOURCE_PICKED",
+              "description": "Event emitted when the user picks a source. Each entry in sources[] carries its own literal event field (no per-item templating in .lolo) — overriding this alone does not retarget the click; also set sources[].event to match.",
+              "label": "Source-picked event",
+              "synonyms": "bus event name. internal wiring; users rarely target directly",
+              "tier": "internal",
+              "type": "string"
+            },
+            "sources": {
+              "default": [
+                {
+                  "event": "IMPORT_SOURCE_PICKED",
+                  "id": "paste",
+                  "kind": "paste",
+                  "label": "Paste text"
+                },
+                {
+                  "event": "IMPORT_SOURCE_PICKED",
+                  "id": "markdown",
+                  "kind": "file",
+                  "label": "Markdown files"
+                }
+              ],
+              "description": "Sources shown in the import popover. kind 'file' opens the OS file picker before IMPORT_REQUESTED; any other kind emits immediately (the host renders the matching input UI, e.g. a paste textarea).",
+              "items": {
+                "properties": {
+                  "event": {
+                    "name": "event",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "kind": {
+                    "name": "kind",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Import sources",
+              "synonyms": "list of import source entries (paste / file / api / database). user phrases: 'only paste' -> keep only the paste entry; 'add database' -> append a database entry",
+              "tier": "presentation",
+              "type": "[SourceOption]"
+            }
+          },
+          "emits": [
+            {
+              "description": "Requests an import from the picked source. source is the SourceOption descriptor (id/kind/label); files carries picker metadata (name/size/type/lastModified) for file-kind sources, empty otherwise. A sibling std-migration-job listens and drives the run.",
+              "event": "IMPORT_REQUESTED",
+              "eventId": "evt_01KYEH1JJPV11XQCNH3ZM9THPS",
+              "payloadSchema": [
+                {
+                  "name": "source",
+                  "required": true,
+                  "type": "object"
+                },
+                {
+                  "name": "files",
+                  "type": "[object]"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "import, upload, migrate, bring in data",
+              "tier": "domain"
+            },
+            {
+              "description": "The file picker failed or was cancelled at the OS level",
+              "event": "IMPORT_FAILED",
+              "eventId": "evt_01KYEH1JJP6BZ2YWZ9WRJ0GTGW",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "import error, picker failed",
+              "tier": "internal"
+            },
+            {
+              "description": "browser/open-file-picker success envelope — result.files holds the picked file metadata",
+              "event": "FILES_PICKED",
+              "eventId": "evt_01KYEH1JJP2KTQ0EAMRQSJBV5W",
+              "payloadSchema": [
+                {
+                  "name": "result",
+                  "required": true,
+                  "type": "object"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "browser/open-file-picker failure signal",
+              "event": "PICK_FAILED",
+              "eventId": "evt_01KYEH1JJP9T6G59Z0W8QZ0RQT",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "secondary"
+            }
+          ],
+          "entityRefIds": {
+            "ImportPanel": "ent_01KYEH1JJPJH06F07Q6CNTHTR8"
+          },
+          "id": "trt_01KYEH1JJPRZYSZAK1NXNH5K01",
+          "linkedEntity": "ImportPanel",
+          "linkedEntityId": "ent_01KYEH1JJPJH06F07Q6CNTHTR8",
+          "name": "ImportMenu",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYEH1JJPE7K0P5GAFH9G8Z0B",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01KYEH1JJPWP17G49K8GJRF8A2",
+                "key": "OPEN_IMPORT",
+                "name": "Open Import"
+              },
+              {
+                "description": "A source entry was picked from the menu. itemId matches the SourceOption.id of the picked entry; kind is resolved from config.sources by id.",
+                "id": "evt_01KYEH1JJPC0KCYZF4BRZPTNXK",
+                "key": "IMPORT_SOURCE_PICKED",
+                "name": "Import Source Picked",
+                "payloadSchema": [
+                  {
+                    "name": "itemId",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "source selected, import source chosen",
+                "tier": "domain"
+              },
+              {
+                "description": "Requests an import from the picked source. source is the SourceOption descriptor (id/kind/label); files carries picker metadata (name/size/type/lastModified) for file-kind sources, empty otherwise. A sibling std-migration-job listens and drives the run.",
+                "id": "evt_01KYEH1JJPV11XQCNH3ZM9THPS",
+                "key": "IMPORT_REQUESTED",
+                "name": "Import Requested",
+                "payloadSchema": [
+                  {
+                    "name": "source",
+                    "required": true,
+                    "type": "object"
+                  },
+                  {
+                    "name": "files",
+                    "type": "[object]"
+                  }
+                ],
+                "synonyms": "import, upload, migrate, bring in data",
+                "tier": "domain"
+              },
+              {
+                "description": "The file picker failed or was cancelled at the OS level",
+                "id": "evt_01KYEH1JJP6BZ2YWZ9WRJ0GTGW",
+                "key": "IMPORT_FAILED",
+                "name": "Import Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "import error, picker failed",
+                "tier": "internal"
+              },
+              {
+                "description": "browser/open-file-picker success envelope — result.files holds the picked file metadata",
+                "id": "evt_01KYEH1JJP2KTQ0EAMRQSJBV5W",
+                "key": "FILES_PICKED",
+                "name": "Files Picked",
+                "payloadSchema": [
+                  {
+                    "name": "result",
+                    "required": true,
+                    "type": "object"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "browser/open-file-picker failure signal",
+                "id": "evt_01KYEH1JJP9T6G59Z0W8QZ0RQT",
+                "key": "PICK_FAILED",
+                "name": "Pick Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "secondary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              },
+              {
+                "name": "picking"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        "@trait.Menu1"
+                      ],
+                      "type": "box"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYEH1JJPE7K0P5GAFH9G8Z0B",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "event": "OPEN_IMPORT",
+                "eventId": "evt_01KYEH1JJPWP17G49K8GJRF8A2",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.pendingSource",
+                    [
+                      "array/find",
+                      "@config.sources",
+                      [
+                        "fn",
+                        "s",
+                        [
+                          "==",
+                          [
+                            "object/get",
+                            "@s",
+                            "id"
+                          ],
+                          "@payload.itemId"
+                        ]
+                      ]
+                    ]
+                  ],
+                  [
+                    "browser/open-file-picker",
+                    {
+                      "accept": "@config.accept",
+                      "multiple": true
+                    },
+                    {
+                      "emit": {
+                        "failure": "PICK_FAILED",
+                        "success": "FILES_PICKED"
+                      }
+                    }
+                  ]
+                ],
+                "event": "IMPORT_SOURCE_PICKED",
+                "eventId": "evt_01KYEH1JJPC0KCYZF4BRZPTNXK",
+                "from": "idle",
+                "guard": [
+                  "==",
+                  [
+                    "object/get",
+                    [
+                      "array/find",
+                      "@config.sources",
+                      [
+                        "fn",
+                        "s",
+                        [
+                          "==",
+                          [
+                            "object/get",
+                            "@s",
+                            "id"
+                          ],
+                          "@payload.itemId"
+                        ]
+                      ]
+                    ],
+                    "kind",
+                    ""
+                  ],
+                  "file"
+                ],
+                "to": "picking"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.pendingSource",
+                    [
+                      "array/find",
+                      "@config.sources",
+                      [
+                        "fn",
+                        "s",
+                        [
+                          "==",
+                          [
+                            "object/get",
+                            "@s",
+                            "id"
+                          ],
+                          "@payload.itemId"
+                        ]
+                      ]
+                    ]
+                  ],
+                  [
+                    "emit",
+                    "IMPORT_REQUESTED",
+                    {
+                      "files": "@entity.pendingFiles",
+                      "source": "@entity.pendingSource"
+                    }
+                  ]
+                ],
+                "event": "IMPORT_SOURCE_PICKED",
+                "eventId": "evt_01KYEH1JJPC0KCYZF4BRZPTNXK",
+                "from": "idle",
+                "guard": [
+                  "!=",
+                  [
+                    "object/get",
+                    [
+                      "array/find",
+                      "@config.sources",
+                      [
+                        "fn",
+                        "s",
+                        [
+                          "==",
+                          [
+                            "object/get",
+                            "@s",
+                            "id"
+                          ],
+                          "@payload.itemId"
+                        ]
+                      ]
+                    ],
+                    "kind",
+                    ""
+                  ],
+                  "file"
+                ],
+                "to": "idle"
+              },
+              {
+                "event": "IMPORT_REQUESTED",
+                "eventId": "evt_01KYEH1JJPV11XQCNH3ZM9THPS",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "event": "IMPORT_FAILED",
+                "eventId": "evt_01KYEH1JJP6BZ2YWZ9WRJ0GTGW",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.pendingFiles",
+                    [
+                      "object/get",
+                      "@payload.result",
+                      "files",
+                      []
+                    ]
+                  ],
+                  [
+                    "emit",
+                    "IMPORT_REQUESTED",
+                    {
+                      "files": "@entity.pendingFiles",
+                      "source": "@entity.pendingSource"
+                    }
+                  ]
+                ],
+                "event": "FILES_PICKED",
+                "eventId": "evt_01KYEH1JJP2KTQ0EAMRQSJBV5W",
+                "from": "picking",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "IMPORT_FAILED",
+                    {
+                      "error": "@payload.error"
+                    }
+                  ]
+                ],
+                "event": "PICK_FAILED",
+                "eventId": "evt_01KYEH1JJP9T6G59Z0W8QZ0RQT",
+                "from": "picking",
+                "to": "idle"
+              }
+            ]
+          },
+          "traitEmbedIds": {
+            "Menu1": "trt_01KYEH1JJPZEXZV3CY28VFT2W4"
+          }
+        }
+      ],
+      "uses": [
+        {
+          "as": "Button",
+          "from": "std/behaviors/ui-button"
+        },
+        {
+          "as": "Menu",
+          "from": "std/behaviors/ui-menu"
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}