@almadar/std 16.217.0 → 16.219.0

package/behaviors/registry/ui/core/atoms/std-gantt-schedule.orb

@@ -0,0 +1,723 @@
+{
+  "description": "std-gantt-schedule — GENERIC view-only Gantt/timeline atom: fetches a task collection on INIT and renders it as bars on a day-scale axis via the gantt pattern, with group headers, dependency arrows, and a today marker. Fully rebindable: a host overrides the linked entity and points the field-mapping configs (labelField/startField/endField/durationField/statusField/groupField) at its own columns; clicking a bar emits the config-named onBarClick event with the row id. No drag-edit, no zoom — schedule viewing only.",
+  "ledger": {
+    "entries": {
+      "ent_01M2M5G80ZEXM0SP6SA5JV6G45": {
+        "bakedName": "Task",
+        "curName": "Task",
+        "id": "ent_01M2M5G80ZEXM0SP6SA5JV6G45",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M2M5G80Z5MV21CQ3KM8QK5WD": {
+        "bakedName": "@config.onBarClick",
+        "curName": "@config.onBarClick",
+        "id": "evt_01M2M5G80Z5MV21CQ3KM8QK5WD",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M2M5G80ZT7QV7EQP5CNSAJWG",
+        "renames": []
+      },
+      "evt_01M2M5G80Z95J9AAB577H7J2FY": {
+        "bakedName": "TaskLoadFailed",
+        "curName": "TaskLoadFailed",
+        "id": "evt_01M2M5G80Z95J9AAB577H7J2FY",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M2M5G80ZT7QV7EQP5CNSAJWG",
+        "renames": []
+      },
+      "evt_01M2M5G80ZB5N0ZDQGCG54E63E": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M2M5G80ZB5N0ZDQGCG54E63E",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M2M5G80ZT7QV7EQP5CNSAJWG",
+        "renames": []
+      },
+      "evt_01M2M5G80ZHK3TRG4D09CPG3GA": {
+        "bakedName": "TaskLoaded",
+        "curName": "TaskLoaded",
+        "id": "evt_01M2M5G80ZHK3TRG4D09CPG3GA",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M2M5G80ZT7QV7EQP5CNSAJWG",
+        "renames": []
+      },
+      "evt_01M2M5G80ZJN33H0Y5G7P8DTEA": {
+        "bakedName": "RETRY",
+        "curName": "RETRY",
+        "id": "evt_01M2M5G80ZJN33H0Y5G7P8DTEA",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M2M5G80ZT7QV7EQP5CNSAJWG",
+        "renames": []
+      },
+      "orb_01M2M5G80ZJZF2E4Z8K6XYKYZF": {
+        "bakedName": "GanttScheduleOrbital",
+        "curName": "GanttScheduleOrbital",
+        "id": "orb_01M2M5G80ZJZF2E4Z8K6XYKYZF",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M2M5G81062W5B5SHP2SM3MW8": {
+        "bakedName": "TaskGanttSchedulePage",
+        "curName": "TaskGanttSchedulePage",
+        "id": "pag_01M2M5G81062W5B5SHP2SM3MW8",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M2M5G80ZT7QV7EQP5CNSAJWG": {
+        "bakedName": "TaskGanttSchedule",
+        "curName": "TaskGanttSchedule",
+        "id": "trt_01M2M5G80ZT7QV7EQP5CNSAJWG",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-gantt-schedule",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "task label shown on the bar",
+            "name": "title",
+            "synonyms": "name, label, summary, subject",
+            "type": "string"
+          },
+          {
+            "description": "task start timestamp the bar is placed from",
+            "name": "start",
+            "synonyms": "starts, begins, start date, from",
+            "type": "datetime"
+          },
+          {
+            "description": "task end timestamp the bar is placed to; when absent, duration days are used",
+            "name": "end",
+            "synonyms": "finish, due, end date, until",
+            "type": "datetime"
+          },
+          {
+            "default": "pending",
+            "description": "task lifecycle status, drives bar colour",
+            "name": "status",
+            "synonyms": "state, stage, phase",
+            "type": "string",
+            "values": [
+              "pending",
+              "active",
+              "complete",
+              "blocked"
+            ]
+          },
+          {
+            "default": "",
+            "description": "group/section the task renders under a header row for",
+            "name": "group",
+            "synonyms": "team, swimlane, section, project",
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M2M5G80ZEXM0SP6SA5JV6G45",
+        "name": "Task",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M2M5G80ZJZF2E4Z8K6XYKYZF",
+      "name": "GanttScheduleOrbital",
+      "pages": [
+        {
+          "id": "pag_01M2M5G81062W5B5SHP2SM3MW8",
+          "name": "TaskGanttSchedulePage",
+          "path": "/tasks/gantt",
+          "traits": [
+            {
+              "ref": "TaskGanttSchedule",
+              "refId": "trt_01M2M5G80ZT7QV7EQP5CNSAJWG"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "dayWidth": {
+              "default": 28.0,
+              "description": "Pixels per day on the time axis.",
+              "label": "Day width",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "durationField": {
+              "default": "",
+              "description": "Row column holding the task length in days, used when the row has no end value. Empty = bars always read endField.",
+              "label": "Duration field",
+              "synonyms": "duration column, length field, days field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "endField": {
+              "default": "end",
+              "description": "Row column holding the end timestamp each bar is placed to. When a row has no end, durationField (days) is used instead.",
+              "label": "End field",
+              "synonyms": "end column, due field, finish field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "groupField": {
+              "default": "",
+              "description": "Row column rows are grouped under header rows by (e.g. team, project). Empty (default) = flat list, no group headers.",
+              "label": "Group field",
+              "synonyms": "group column, swimlane field, section field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "include": {
+              "default": [],
+              "description": "Entity relation field names to hydrate on fetch, so field mappings can use dot-paths like assignee.name. Empty = no hydration, the default.",
+              "items": {
+                "type": "string"
+              },
+              "label": "Which relation fields to hydrate?",
+              "synonyms": "relation hydration, populate relations, joined fields",
+              "tier": "internal",
+              "type": "[string]"
+            },
+            "labelField": {
+              "default": "title",
+              "description": "Row column holding the bar label. Rebound hosts point this at their own column (e.g. name, summary).",
+              "label": "Label field",
+              "synonyms": "title field, label column, name field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "links": {
+              "default": [],
+              "description": "Dependency arrows between task ids ({ from, to }); the host derives them from its own relation field and passes them here.",
+              "items": {
+                "properties": {
+                  "from": {
+                    "name": "from",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "to": {
+                    "name": "to",
+                    "required": true,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Dependency links",
+              "synonyms": "dependencies, dependency arrows, precedences",
+              "tier": "presentation",
+              "type": "[GanttLinkSpec]"
+            },
+            "onBarClick": {
+              "default": "",
+              "description": "Event emitted when a bar is clicked: UI:{onBarClick} with { id } carrying the clicked row's id. Empty means bars are not clickable.",
+              "label": "On bar click",
+              "synonyms": "bar click, task click, select task, open task",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "rangeEnd": {
+              "default": "",
+              "description": "Last visible day (ISO date). Empty (default) = 2 days after the latest task end.",
+              "label": "Range end",
+              "synonyms": "window end, axis end, to date",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "rangeStart": {
+              "default": "",
+              "description": "First visible day (ISO date). Empty (default) = 2 days before the earliest task.",
+              "label": "Range start",
+              "synonyms": "window start, axis start, from date",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "showToday": {
+              "default": true,
+              "description": "Paint the today marker line when today falls inside the visible range.",
+              "label": "Show today marker",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "startField": {
+              "default": "start",
+              "description": "Row column holding the start timestamp each bar is placed from (e.g. startTime, startsAt, beginsAt).",
+              "label": "Start field",
+              "synonyms": "start column, from field, begin field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "statusField": {
+              "default": "status",
+              "description": "Row column holding the status value that drives bar colour.",
+              "label": "Status field",
+              "synonyms": "status column, state field, stage field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "title": {
+              "default": "Schedule",
+              "description": "Header text shown above the gantt chart.",
+              "label": "Title",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "fetch",
+              "resource": "Task"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "emits": [
+            {
+              "description": "Indicates that schedule tasks have been successfully retrieved.",
+              "event": "TaskLoaded",
+              "eventId": "evt_01M2M5G80ZHK3TRG4D09CPG3GA",
+              "payloadSchema": [
+                {
+                  "entity": "Task",
+                  "name": "data",
+                  "properties": [
+                    {
+                      "name": "id",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "title",
+                      "type": "string"
+                    },
+                    {
+                      "name": "start",
+                      "type": "datetime"
+                    },
+                    {
+                      "name": "end",
+                      "type": "datetime"
+                    },
+                    {
+                      "name": "status",
+                      "type": "string"
+                    },
+                    {
+                      "name": "group",
+                      "type": "string"
+                    }
+                  ],
+                  "type": "[object]"
+                }
+              ],
+              "scope": "internal",
+              "synonyms": "loaded, fetched, retrieved, populated",
+              "tier": "domain"
+            },
+            {
+              "description": "Indicates a failure to load schedule tasks.",
+              "event": "TaskLoadFailed",
+              "eventId": "evt_01M2M5G80Z95J9AAB577H7J2FY",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ],
+              "scope": "internal",
+              "synonyms": "error, failed, problem, loading issue",
+              "tier": "internal"
+            },
+            {
+              "definerKnob": "onBarClick",
+              "description": "Emitted when a gantt bar is clicked; { id } carries the clicked task row's id.",
+              "event": "@config.onBarClick",
+              "eventId": "evt_01M2M5G80Z5MV21CQ3KM8QK5WD",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "presentation"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "Task": "ent_01M2M5G80ZEXM0SP6SA5JV6G45"
+          },
+          "id": "trt_01M2M5G80ZT7QV7EQP5CNSAJWG",
+          "linkedEntity": "Task",
+          "linkedEntityId": "ent_01M2M5G80ZEXM0SP6SA5JV6G45",
+          "name": "TaskGanttSchedule",
+          "scope": "collection",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M2M5G80ZB5N0ZDQGCG54E63E",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Indicates that schedule tasks have been successfully retrieved.",
+                "id": "evt_01M2M5G80ZHK3TRG4D09CPG3GA",
+                "key": "TaskLoaded",
+                "name": "Task loaded",
+                "payloadSchema": [
+                  {
+                    "entity": "Task",
+                    "name": "data",
+                    "properties": [
+                      {
+                        "name": "id",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "title",
+                        "type": "string"
+                      },
+                      {
+                        "name": "start",
+                        "type": "datetime"
+                      },
+                      {
+                        "name": "end",
+                        "type": "datetime"
+                      },
+                      {
+                        "name": "status",
+                        "type": "string"
+                      },
+                      {
+                        "name": "group",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  }
+                ],
+                "synonyms": "loaded, fetched, retrieved, populated",
+                "tier": "domain"
+              },
+              {
+                "description": "Indicates a failure to load schedule tasks.",
+                "id": "evt_01M2M5G80Z95J9AAB577H7J2FY",
+                "key": "TaskLoadFailed",
+                "name": "Task load failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
+                  },
+                  {
+                    "name": "code",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "error, failed, problem, loading issue",
+                "tier": "internal"
+              },
+              {
+                "id": "evt_01M2M5G80ZJN33H0Y5G7P8DTEA",
+                "key": "RETRY",
+                "name": "Retry"
+              },
+              {
+                "description": "Emitted when a gantt bar is clicked; { id } carries the clicked task row's id.",
+                "id": "evt_01M2M5G80Z5MV21CQ3KM8QK5WD",
+                "key": "@config.onBarClick",
+                "name": "@config.on bar click",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "presentation"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "loading"
+              },
+              {
+                "name": "chart"
+              },
+              {
+                "name": "error"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "Task",
+                    {
+                      "emit": {
+                        "failure": "TaskLoadFailed",
+                        "success": "TaskLoaded"
+                      },
+                      "include": "@config.include"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "Loading schedule…",
+                          "type": "typography",
+                          "variant": "caption"
+                        }
+                      ],
+                      "className": "py-12",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M2M5G80ZB5N0ZDQGCG54E63E",
+                "from": "loading",
+                "to": "loading"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "align": "center",
+                          "children": [
+                            {
+                              "name": "gantt-chart",
+                              "size": "xl",
+                              "type": "icon"
+                            },
+                            {
+                              "content": "@config.title",
+                              "type": "typography",
+                              "variant": "h2"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack"
+                        },
+                        {
+                          "barClickEvent": "@config.onBarClick",
+                          "dayWidth": "@config.dayWidth",
+                          "durationField": "@config.durationField",
+                          "endField": "@config.endField",
+                          "groupField": "@config.groupField",
+                          "links": "@config.links",
+                          "rangeEnd": "@config.rangeEnd",
+                          "rangeStart": "@config.rangeStart",
+                          "showToday": "@config.showToday",
+                          "startField": "@config.startField",
+                          "statusField": "@config.statusField",
+                          "tasks": "@payload.data",
+                          "titleField": "@config.labelField",
+                          "type": "gantt"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "TaskLoaded",
+                "eventId": "evt_01M2M5G80ZHK3TRG4D09CPG3GA",
+                "from": "loading",
+                "to": "chart"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "align": "center",
+                      "children": [
+                        {
+                          "color": "error",
+                          "name": "alert-triangle",
+                          "size": "lg",
+                          "type": "icon"
+                        },
+                        {
+                          "content": "Failed to load",
+                          "type": "typography",
+                          "variant": "h3"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "@payload.error",
+                          "type": "typography",
+                          "variant": "body"
+                        },
+                        {
+                          "action": "RETRY",
+                          "icon": "rotate-ccw",
+                          "label": "Retry",
+                          "type": "button",
+                          "variant": "primary"
+                        }
+                      ],
+                      "className": "py-12",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "TaskLoadFailed",
+                "eventId": "evt_01M2M5G80Z95J9AAB577H7J2FY",
+                "from": "loading",
+                "to": "error"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "Task",
+                    {
+                      "emit": {
+                        "failure": "TaskLoadFailed",
+                        "success": "TaskLoaded"
+                      },
+                      "include": "@config.include"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "spinner"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M2M5G80ZB5N0ZDQGCG54E63E",
+                "from": "chart",
+                "to": "loading"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "Task",
+                    {
+                      "emit": {
+                        "failure": "TaskLoadFailed",
+                        "success": "TaskLoaded"
+                      },
+                      "include": "@config.include"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "spinner"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M2M5G80ZB5N0ZDQGCG54E63E",
+                "from": "error",
+                "to": "loading"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "Task",
+                    {
+                      "emit": {
+                        "failure": "TaskLoadFailed",
+                        "success": "TaskLoaded"
+                      },
+                      "include": "@config.include"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "spinner"
+                    }
+                  ]
+                ],
+                "event": "RETRY",
+                "eventId": "evt_01M2M5G80ZJN33H0Y5G7P8DTEA",
+                "from": "error",
+                "to": "loading"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "GanttLinkSpec": [
+          {
+            "name": "from",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "to",
+            "required": true,
+            "type": "string"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}