themelia-ui 3.0.0 → 3.2.0

package/docs/generated/workflows/index.json

@@ -0,0 +1,691 @@
+{
+  "schemaVersion": 1,
+  "packageVersion": "3.2.0",
+  "workflows": [
+    {
+      "id": "record-detail",
+      "page": "/page",
+      "exampleId": "page-layout/record-detail-reference",
+      "modules": [
+        "layout/page",
+        "base/cards",
+        "base/display"
+      ],
+      "description": "One route heading, independent subjects, semantic facts and related records.",
+      "ownership": "Page owns route geometry; Card owns each subject; table owns tabular semantics.",
+      "cases": [
+        "subject commands",
+        "related table",
+        "long copy"
+      ],
+      "verification": [
+        {
+          "kind": "browser",
+          "test": "record and communication subjects keep their own headings facts and commands",
+          "cases": [
+            "subject commands",
+            "related table"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "visual-review",
+          "cases": [
+            "long copy"
+          ],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "record-detail/page-layout/record-detail-reference.tsx",
+      "files": [
+        "record-detail/page-layout/record-detail-reference.tsx"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/buttons",
+        "themelia-ui/base/cards",
+        "themelia-ui/base/display",
+        "themelia-ui/base/structure",
+        "themelia-ui/base/table",
+        "themelia-ui/base/typography",
+        "themelia-ui/layout/page"
+      ],
+      "apiDocs": [
+        "../components/layout--page.md",
+        "../components/base--cards.md",
+        "../components/base--display.md"
+      ]
+    },
+    {
+      "id": "resource-index",
+      "page": "/data-view",
+      "exampleId": "data-view/resource-index-reference",
+      "modules": [
+        "features/data-view",
+        "features/table",
+        "features/filters"
+      ],
+      "description": "Constrained server index with unknown totals, paging and selected-page commands.",
+      "ownership": "Application owns transport, cursors and selection policy; DataView owns filter/table presentation.",
+      "cases": [
+        "server passthrough",
+        "unknown total",
+        "refresh failure",
+        "empty recovery",
+        "narrow controls",
+        "selected-page commands",
+        "column visibility"
+      ],
+      "verification": [
+        {
+          "kind": "browser",
+          "test": "server index matches hidden fields and keeps refresh errors and page commands honest",
+          "cases": [
+            "server passthrough",
+            "unknown total",
+            "refresh failure",
+            "empty recovery",
+            "selected-page commands"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "browser",
+          "test": "server index mobile filters and column controls remain reachable and retain state",
+          "cases": [
+            "narrow controls",
+            "column visibility"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "visual-review",
+          "cases": [
+            "narrow controls"
+          ],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "resource-index/data-view/resource-index-reference.tsx",
+      "files": [
+        "resource-index/data-view/resource-index-reference.tsx"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/buttons",
+        "themelia-ui/base/structure",
+        "themelia-ui/base/typography",
+        "themelia-ui/features/data-view",
+        "themelia-ui/features/filters"
+      ],
+      "apiDocs": [
+        "../components/features--data-view.md",
+        "../components/features--table.md",
+        "../components/features--filters.md"
+      ]
+    },
+    {
+      "id": "multi-section-form",
+      "page": "/form-workflow",
+      "exampleId": "form-workflow/multi-section-reference",
+      "modules": [
+        "base/forms",
+        "base/cards"
+      ],
+      "description": "Flat sections in an existing surface with semantic groups and retained drafts.",
+      "ownership": "Card owns surface; flat sections retain region insets; application owns validation and completion.",
+      "cases": [
+        "binding",
+        "validation failure",
+        "transport failure",
+        "duplicate submit"
+      ],
+      "verification": [
+        {
+          "kind": "browser",
+          "test": "flat multi-section form retains failed drafts and completes once with associated fields",
+          "cases": [
+            "binding",
+            "validation failure",
+            "transport failure",
+            "duplicate submit"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "visual-review",
+          "cases": [],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "multi-section-form/form-workflow/multi-section-reference.tsx",
+      "files": [
+        "multi-section-form/form-workflow/multi-section-reference.tsx"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/cards",
+        "themelia-ui/base/display",
+        "themelia-ui/base/forms",
+        "themelia-ui/base/structure",
+        "themelia-ui/base/text-inputs",
+        "themelia-ui/base/typography",
+        "themelia-ui/forms"
+      ],
+      "apiDocs": [
+        "../components/base--forms.md",
+        "../components/base--cards.md"
+      ]
+    },
+    {
+      "id": "scoped-resource-selection",
+      "page": "/combobox",
+      "exampleId": "combobox/scoped-resource-reference",
+      "modules": [
+        "features/combobox",
+        "base/overlay"
+      ],
+      "description": "Scoped asynchronous selection inside a form dialog.",
+      "ownership": "scopeKey owns lookup identity; application owns selected-value validity; popup uses the modal host.",
+      "cases": [
+        "late responses",
+        "pending empty error retry",
+        "Enter IME",
+        "portal focus"
+      ],
+      "verification": [
+        {
+          "kind": "browser",
+          "test": "scoped modal lookup rejects old answers and Enter selects without submitting",
+          "cases": [
+            "late responses",
+            "Enter IME",
+            "portal focus"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "browser",
+          "test": "pending and empty modal resource lists do not submit on Enter",
+          "cases": [
+            "pending empty error retry"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "browser",
+          "test": "lookup retry retains query and selection while error mode changes scope",
+          "cases": [
+            "pending empty error retry"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "visual-review",
+          "cases": [],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "scoped-resource-selection/combobox/scoped-resource-reference.tsx",
+      "files": [
+        "scoped-resource-selection/combobox/scoped-resource-reference.tsx"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/buttons",
+        "themelia-ui/base/forms",
+        "themelia-ui/base/overlay",
+        "themelia-ui/base/structure",
+        "themelia-ui/base/typography",
+        "themelia-ui/features/combobox"
+      ],
+      "apiDocs": [
+        "../components/features--combobox.md",
+        "../components/base--overlay.md"
+      ]
+    },
+    {
+      "id": "nested-action-flow",
+      "page": "/action-overlays",
+      "exampleId": "action-overlays/nested-action-reference",
+      "modules": [
+        "features/overlays",
+        "base/forms"
+      ],
+      "description": "Parent inspector and child save with application-owned successful completion.",
+      "ownership": "Each overlay owns its dismissal; application owns draft, outcome and session validity.",
+      "cases": [
+        "child cancel Escape",
+        "focus return",
+        "resolved validation",
+        "successful retry"
+      ],
+      "verification": [
+        {
+          "kind": "browser",
+          "test": "nested action cancel and resolved validation preserve the inspector draft until successful retry",
+          "cases": [
+            "child cancel Escape",
+            "focus return",
+            "resolved validation",
+            "successful retry"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "visual-review",
+          "cases": [],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "nested-action-flow/action-overlays/nested-action-reference.tsx",
+      "files": [
+        "nested-action-flow/action-overlays/nested-action-reference.tsx"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/buttons",
+        "themelia-ui/base/forms",
+        "themelia-ui/base/structure",
+        "themelia-ui/base/text-inputs",
+        "themelia-ui/base/typography",
+        "themelia-ui/features/overlays"
+      ],
+      "apiDocs": [
+        "../components/features--overlays.md",
+        "../components/base--forms.md"
+      ]
+    },
+    {
+      "id": "workspace-navigation",
+      "page": "/app-shell",
+      "exampleId": "app-shell/workspace-navigation-reference",
+      "modules": [
+        "layout/app-shell",
+        "layout/sidebar"
+      ],
+      "description": "Workspace disclosure and same-app destination navigation on mobile and desktop.",
+      "ownership": "Sidebar owns disclosure/dismissal; link adapter owns navigation and external destinations.",
+      "cases": [
+        "mobile disclosure",
+        "destination once",
+        "external links",
+        "Escape focus"
+      ],
+      "verification": [
+        {
+          "kind": "browser",
+          "test": "mobile workspace disclosure preserves the sheet and destination selection routes once",
+          "cases": [
+            "mobile disclosure",
+            "destination once",
+            "external links",
+            "Escape focus"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "browser",
+          "repositoryFile": "tests/consumer-workflows.spec.ts",
+          "test": "desktop workspace destination preserves the shell and routes once",
+          "cases": [
+            "destination once",
+            "external links"
+          ]
+        },
+        {
+          "kind": "visual-review",
+          "cases": [],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "workspace-navigation/app-shell/workspace-navigation-reference.tsx",
+      "files": [
+        "workspace-navigation/app-shell/workspace-navigation-reference.tsx"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/typography",
+        "themelia-ui/layout/app-shell",
+        "themelia-ui/layout/sidebar"
+      ],
+      "apiDocs": [
+        "../components/layout--app-shell.md",
+        "../components/layout--sidebar.md"
+      ]
+    },
+    {
+      "id": "media-picking",
+      "page": "/media-library",
+      "exampleId": "media-library/media-picking-reference",
+      "modules": [
+        "features/media-library"
+      ],
+      "description": "Scoped, paged media lookup with saved-id hydration and unavailable asset recovery.",
+      "ownership": "Application owns scope, pages, saved-id hydration and authorization; library owns picking and cached selected records.",
+      "cases": [
+        "missing selected asset",
+        "lookup failure",
+        "keyboard picking",
+        "selection hydration",
+        "scope recovery",
+        "paging",
+        "request races"
+      ],
+      "verification": [
+        {
+          "kind": "unit",
+          "repositoryFile": "src/components/features/media-library/use-media-library.test.tsx",
+          "test": "ignores obsolete successes and failures even when the fetcher ignores abort",
+          "cases": [
+            "request races"
+          ]
+        },
+        {
+          "kind": "browser",
+          "test": "media replacement hydrates selection and keeps unavailable ids through cancellation",
+          "cases": [
+            "missing selected asset",
+            "keyboard picking"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "browser",
+          "test": "media failure and changed scope preserve a saved selection through retry",
+          "cases": [
+            "lookup failure",
+            "scope recovery"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "browser",
+          "test": "saved media hydrates independently of paging and selection survives page changes",
+          "cases": [
+            "selection hydration",
+            "paging"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "visual-review",
+          "cases": [],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "media-picking/media-library/media-picking-reference.tsx",
+      "files": [
+        "media-picking/media-library/media-picking-reference.tsx",
+        "media-picking/media-library/reference-data.ts"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/buttons",
+        "themelia-ui/base/structure",
+        "themelia-ui/base/typography",
+        "themelia-ui/features/media-library"
+      ],
+      "apiDocs": [
+        "../components/features--media-library.md"
+      ]
+    },
+    {
+      "id": "communications-overview",
+      "page": "/analytics",
+      "exampleId": "analytics/communications-reference",
+      "modules": [
+        "blocks/analytics",
+        "base/display"
+      ],
+      "description": "Quantities separated from semantic communication facts.",
+      "ownership": "Metrics own quantitative presentation; record facts and business delivery policy stay distinct.",
+      "cases": [
+        "unknown values",
+        "long labels",
+        "mock retry"
+      ],
+      "verification": [
+        {
+          "kind": "browser",
+          "test": "record and communication subjects keep their own headings facts and commands",
+          "cases": [
+            "unknown values",
+            "mock retry"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "visual-review",
+          "cases": [
+            "long labels"
+          ],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "communications-overview/analytics/communications-reference.tsx",
+      "files": [
+        "communications-overview/analytics/communications-reference.tsx"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/buttons",
+        "themelia-ui/base/cards",
+        "themelia-ui/base/display",
+        "themelia-ui/base/structure",
+        "themelia-ui/base/typography",
+        "themelia-ui/blocks/analytics"
+      ],
+      "apiDocs": [
+        "../components/blocks--analytics.md",
+        "../components/base--display.md"
+      ]
+    },
+    {
+      "id": "website-content-editor",
+      "page": "/rich-text-editor",
+      "exampleId": "rich-text-editor/website-content-reference",
+      "modules": [
+        "features/rich-text-editor",
+        "features/media-library"
+      ],
+      "description": "Locale drafts, hero media, alternative text and sanitized preview.",
+      "ownership": "Application owns locale drafts, save policy and persistence sanitization; editor owns editing.",
+      "cases": [
+        "locale retention RTL",
+        "failed save",
+        "media alt",
+        "sanitized preview"
+      ],
+      "verification": [
+        {
+          "kind": "browser",
+          "test": "website editor retains locale drafts and image text after failed save",
+          "cases": [
+            "locale retention RTL",
+            "failed save",
+            "media alt"
+          ],
+          "repositoryFile": "tests/consumer-workflows.spec.ts"
+        },
+        {
+          "kind": "unit",
+          "cases": [
+            "sanitized preview"
+          ],
+          "repositoryFile": "src/components/features/rich-text-editor/rich-text-security.test.tsx"
+        },
+        {
+          "kind": "visual-review",
+          "cases": [],
+          "conditions": {
+            "widths": [
+              390,
+              1024,
+              1680
+            ],
+            "themes": [
+              "light",
+              "dark"
+            ],
+            "densities": [
+              "compact",
+              "comfortable"
+            ],
+            "content": "default fixture with long labels; website locale switching includes RTL"
+          },
+          "procedure": "Inspect the complete fixture, run accessibility and read-only geometry observations, and record inspected screenshots and unverified states."
+        }
+      ],
+      "entryPoint": "website-content-editor/rich-text-editor/website-content-reference.tsx",
+      "files": [
+        "website-content-editor/media-library/reference-data.ts",
+        "website-content-editor/rich-text-editor/website-content-reference.tsx"
+      ],
+      "imports": [
+        "react",
+        "themelia-ui/base/buttons",
+        "themelia-ui/base/cards",
+        "themelia-ui/base/choice-inputs",
+        "themelia-ui/base/forms",
+        "themelia-ui/base/structure",
+        "themelia-ui/base/text-inputs",
+        "themelia-ui/base/typography",
+        "themelia-ui/features/media-library",
+        "themelia-ui/features/rich-text-editor"
+      ],
+      "apiDocs": [
+        "../components/features--rich-text-editor.md",
+        "../components/features--media-library.md"
+      ]
+    }
+  ]
+}