@workday/canvas-kit-docs 16.0.0-alpha.0499-next.0 → 16.0.0

package/dist/es6/lib/docs.js

@@ -227236,6 +227236,22 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
       }
     }
   },
+  {
+    "name": "CanvasBrandStyleContext",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx",
+    "description": "Context for providing brand CSS variables to popup containers.\nThis carries the resolved CSS variable style map from CanvasProvider\nto usePopupStack for proper popup theming, regardless of whether\na numerical or legacy theme is used.",
+    "declarations": [
+      {
+        "name": "CanvasBrandStyleContext",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "object",
+      "properties": []
+    }
+  },
   {
     "name": "CanvasProviderProps",
     "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx",
@@ -227268,6 +227284,171 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
       "value": "string"
     }
   },
+  {
+    "name": "canvasThemeToCssVars",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx",
+    "description": "Pure function — safe to call outside React hooks (e.g. usePopupStack).",
+    "declarations": [
+      {
+        "name": "canvasThemeToCssVars",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "theme",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "symbol",
+                "name": "CanvasProviderTheme",
+                "value": "CanvasProviderTheme"
+              },
+              {
+                "kind": "primitive",
+                "value": "undefined"
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "theme",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "elemProps",
+          "type": {
+            "kind": "symbol",
+            "name": "React.HTMLAttributes",
+            "typeParameters": [
+              {
+                "kind": "symbol",
+                "name": "HTMLElement",
+                "value": "HTMLElement"
+              }
+            ],
+            "value": "HTMLAttributes<T>"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "elemProps",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "options",
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "themeScope",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasThemingScope",
+                  "value": "CanvasThemingScope"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "themeScope",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "filledSemanticTheme",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "EmotionCanvasTheme",
+                  "value": "EmotionCanvasTheme"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "filledSemanticTheme",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "options",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "object",
+        "properties": [
+          {
+            "kind": "property",
+            "name": "className",
+            "type": {
+              "kind": "primitive",
+              "value": "string"
+            },
+            "description": "",
+            "declarations": [
+              {
+                "name": "className",
+                "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+              }
+            ],
+            "tags": {}
+          },
+          {
+            "kind": "property",
+            "name": "style",
+            "type": {
+              "kind": "external",
+              "name": "CSSProperties",
+              "url": "https://emotion.sh/docs/object-styles"
+            },
+            "description": "",
+            "declarations": [
+              {
+                "name": "style",
+                "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+              }
+            ],
+            "tags": {}
+          }
+        ]
+      }
+    }
+  },
   {
     "name": "useCanvasThemeToCssVars",
     "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx",
@@ -227290,8 +227471,8 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
             "value": [
               {
                 "kind": "symbol",
-                "name": "PartialEmotionCanvasTheme",
-                "value": "PartialEmotionCanvasTheme"
+                "name": "CanvasProviderTheme",
+                "value": "CanvasProviderTheme"
               },
               {
                 "kind": "primitive",
@@ -227337,6 +227518,25 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
             }
           ],
           "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "themeScope",
+          "type": {
+            "kind": "symbol",
+            "name": "CanvasThemingScope",
+            "value": "CanvasThemingScope"
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "themeScope",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+            }
+          ],
+          "tags": {}
         }
       ],
       "members": [],
@@ -227400,10 +227600,10 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
           "required": false,
           "type": {
             "kind": "symbol",
-            "name": "PartialEmotionCanvasTheme",
-            "value": "PartialEmotionCanvasTheme"
+            "name": "CanvasProviderTheme",
+            "value": "CanvasProviderTheme"
           },
-          "description": "⚠️ Only use this prop if you intent to to theme a part of your application that is different from global theming.\nFor more information, view our [Theming Docs](https://workday.github.io/canvas-kit/?path=/docs/features-theming-overview--docs#global-vs-scoped-theming).\n\nWhile we support theme overrides, we advise to use global theming via CSS Variables.",
+          "description": "⚠️ Only use this prop if you intent to to theme a part of your application that is different from global theming.\nFor more information, view our [Theming Docs](https://workday.github.io/canvas-kit/?path=/docs/features-theming-overview--docs#scoped-theming).\n\nWhile we support theme overrides, we advise to use global theming via CSS Variables.",
           "declarations": [
             {
               "name": "theme",
@@ -227411,6 +227611,30 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
             }
           ],
           "tags": {}
+        },
+        {
+          "kind": "property",
+          "name": "themeScope",
+          "required": false,
+          "type": {
+            "kind": "symbol",
+            "name": "CanvasThemingScope",
+            "value": "CanvasThemingScope"
+          },
+          "description": "How partial theme input expands. Default `'brand'`.\n\n**Numerical `brand` shape:** `'brand'` applies the `primary['600']` shortcut\n(PrimaryButton + selected states). `'full'` writes each ramp key literally with\nno shortcuts. Other `brand.*` keys always map 1:1 to CSS variables.\n\n**Legacy `canvas.palette` shape:** `'brand'` = primary.main shortcut only.\n`'full'` = auto-generated ramps + broad `system.color.brand.*` forwarding.",
+          "declarations": [
+            {
+              "name": "themeScope",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/CanvasProvider.tsx"
+            }
+          ],
+          "tags": {
+            "default": "'brand'"
+          },
+          "defaultValue": {
+            "kind": "string",
+            "value": "brand"
+          }
         }
       ]
     }
@@ -229302,6 +229526,1797 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
       }
     }
   },
+  {
+    "name": "hasExplicitSemanticPalette",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "True when a semantic theme intentionally passes a non-empty `canvas.palette`.",
+    "declarations": [
+      {
+        "name": "hasExplicitSemanticPalette",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "theme",
+          "type": {
+            "kind": "symbol",
+            "name": "CanvasProviderTheme",
+            "value": "CanvasProviderTheme"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "theme",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "unknown",
+        "value": "unknown",
+        "text": "theme is PartialEmotionCanvasTheme"
+      }
+    }
+  },
+  {
+    "name": "BRAND_SCOPE_PRIMARY_BUNDLE",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Tokens that change when a consumer sets only their primary brand color.",
+    "declarations": [
+      {
+        "name": "BRAND_SCOPE_PRIMARY_BUNDLE",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "object",
+      "properties": [
+        {
+          "kind": "property",
+          "name": "action",
+          "defaultValue": {
+            "kind": "tuple",
+            "value": [
+              {
+                "kind": "string",
+                "value": "base"
+              },
+              {
+                "kind": "string",
+                "value": "dark"
+              },
+              {
+                "kind": "string",
+                "value": "darkest"
+              },
+              {
+                "kind": "string",
+                "value": "accent"
+              }
+            ]
+          },
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "string",
+                "value": "base"
+              },
+              {
+                "kind": "string",
+                "value": "dark"
+              },
+              {
+                "kind": "string",
+                "value": "darkest"
+              },
+              {
+                "kind": "string",
+                "value": "accent"
+              }
+            ]
+          },
+          "required": true,
+          "description": "",
+          "declarations": [
+            {
+              "name": "action",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "property",
+          "name": "accent",
+          "defaultValue": {
+            "kind": "tuple",
+            "value": [
+              {
+                "kind": "string",
+                "value": "primary"
+              },
+              {
+                "kind": "string",
+                "value": "action"
+              }
+            ]
+          },
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "string",
+                "value": "primary"
+              },
+              {
+                "kind": "string",
+                "value": "action"
+              }
+            ]
+          },
+          "required": true,
+          "description": "",
+          "declarations": [
+            {
+              "name": "accent",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "property",
+          "name": "selected",
+          "defaultValue": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "fg",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "selected",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-sys-color-brand-fg-selected"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-sys-color-brand-fg-selected"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "fg",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "surface",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "selected",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-sys-color-brand-surface-selected"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-sys-color-brand-surface-selected"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "surface",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "fg",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "selected",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-sys-color-brand-fg-selected"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-sys-color-brand-fg-selected"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "fg",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "surface",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "selected",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-sys-color-brand-surface-selected"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-sys-color-brand-surface-selected"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "surface",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "required": true,
+          "description": "",
+          "declarations": [
+            {
+              "name": "selected",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ]
+    }
+  },
+  {
+    "name": "BRAND_SCOPE_INDEPENDENT",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Independently brandable tokens — writable when explicitly provided,\nbut NEVER derived from primary.main / brand.primary.600.",
+    "declarations": [
+      {
+        "name": "BRAND_SCOPE_INDEPENDENT",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "object",
+      "properties": [
+        {
+          "kind": "property",
+          "name": "focus",
+          "defaultValue": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "primary",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "primary",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-sys-color-brand-focus-primary"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-sys-color-brand-focus-primary"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "primary",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "brandToken",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "primary500",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-brand-primary-500"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-brand-primary-500"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "brandToken",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "semanticKey",
+                "defaultValue": {
+                  "kind": "string",
+                  "value": "focusOutline"
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "focusOutline"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "semanticKey",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "primary",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "primary",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-sys-color-brand-focus-primary"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-sys-color-brand-focus-primary"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "primary",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "brandToken",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "primary500",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-brand-primary-500"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-brand-primary-500"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "brandToken",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "semanticKey",
+                "defaultValue": {
+                  "kind": "string",
+                  "value": "focusOutline"
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "focusOutline"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "semanticKey",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "required": true,
+          "description": "",
+          "declarations": [
+            {
+              "name": "focus",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "property",
+          "name": "border",
+          "defaultValue": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "primary",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "primary",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-sys-color-brand-border-primary"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-sys-color-brand-border-primary"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "primary",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "brandToken",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "primary500",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-brand-primary-500"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-brand-primary-500"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "brandToken",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "semanticKey",
+                "defaultValue": {
+                  "kind": "string",
+                  "value": "focusOutline"
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "focusOutline"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "semanticKey",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "primary",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "primary",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-sys-color-brand-border-primary"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-sys-color-brand-border-primary"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "primary",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "brandToken",
+                "defaultValue": {
+                  "kind": "property",
+                  "name": "primary500",
+                  "type": {
+                    "kind": "string",
+                    "value": "--cnvs-brand-primary-500"
+                  }
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "--cnvs-brand-primary-500"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "brandToken",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "semanticKey",
+                "defaultValue": {
+                  "kind": "string",
+                  "value": "focusOutline"
+                },
+                "type": {
+                  "kind": "string",
+                  "value": "focusOutline"
+                },
+                "required": true,
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "semanticKey",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "required": true,
+          "description": "",
+          "declarations": [
+            {
+              "name": "border",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ]
+    }
+  },
+  {
+    "name": "writeNumericalBrandRamp",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Maps a numerical brand ramp onto `brand.<color><rampKey>` CSS variables.",
+    "declarations": [
+      {
+        "name": "writeNumericalBrandRamp",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "color",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "symbol",
+                "name": "BrandColor",
+                "value": "BrandColor"
+              },
+              {
+                "kind": "string",
+                "value": "action"
+              }
+            ]
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "color",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "ramp",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "symbol",
+                "name": "CanvasBrandRamp",
+                "value": "Partial<Record<\"25\" | \"50\" | \"100\" | \"200\" | \"300\" | \"400\" | \"500\" | \"600\" | \"700\" | \"800\" | \"900\" | \"950\" | \"975\" | \"A25\" | \"A50\" | \"A100\" | \"A200\", string>>"
+              },
+              {
+                "kind": "symbol",
+                "name": "CanvasNeutralBrandRamp",
+                "value": "CanvasNeutralBrandRamp"
+              },
+              {
+                "kind": "symbol",
+                "name": "CanvasActionBrandRamp",
+                "value": "Partial<Record<\"accent\" | \"dark\" | \"light\" | \"lighter\" | \"base\" | \"darkest\" | \"lightest\" | \"darker\", string>>"
+              },
+              {
+                "kind": "primitive",
+                "value": "undefined"
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "ramp",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "options",
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "skipKeys",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "Set",
+                  "typeParameters": [
+                    {
+                      "kind": "primitive",
+                      "value": "string"
+                    }
+                  ],
+                  "value": "Set<T>"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "skipKeys",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "options",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "applyPrimaryBrandBundle",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Called when consumer sets only `primary.main` or `brand.primary['600']`.",
+    "declarations": [
+      {
+        "name": "applyPrimaryBrandBundle",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "primaryColor",
+          "type": {
+            "kind": "primitive",
+            "value": "string"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "primaryColor",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "applyCriticalBrandBundle",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Called when consumer sets only `error.main` or `brand.critical['600']`.",
+    "declarations": [
+      {
+        "name": "applyCriticalBrandBundle",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "criticalColor",
+          "type": {
+            "kind": "primitive",
+            "value": "string"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "criticalColor",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "applyCautionBrandBundle",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Called when consumer sets only `alert.main` or `brand.caution['400']`.",
+    "declarations": [
+      {
+        "name": "applyCautionBrandBundle",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "cautionColor",
+          "type": {
+            "kind": "primitive",
+            "value": "string"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "cautionColor",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "applyPositiveBrandBundle",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Called when consumer sets only `success.main` or `brand.positive['600']`.",
+    "declarations": [
+      {
+        "name": "applyPositiveBrandBundle",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "positiveColor",
+          "type": {
+            "kind": "primitive",
+            "value": "string"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "positiveColor",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "applyNeutralBrandBundle",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Called when consumer sets only `neutral.main` or `brand.neutral['600']`.",
+    "declarations": [
+      {
+        "name": "applyNeutralBrandBundle",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "neutralColor",
+          "type": {
+            "kind": "primitive",
+            "value": "string"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "neutralColor",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "writeSelectedShortcuts",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Writes first-class selected shortcuts from numerical theme input.",
+    "declarations": [
+      {
+        "name": "writeSelectedShortcuts",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "selected",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "union",
+                "value": [
+                  {
+                    "kind": "object",
+                    "properties": [
+                      {
+                        "kind": "property",
+                        "name": "fg",
+                        "required": false,
+                        "type": {
+                          "kind": "union",
+                          "value": [
+                            {
+                              "kind": "primitive",
+                              "value": "string"
+                            },
+                            {
+                              "kind": "primitive",
+                              "value": "undefined"
+                            }
+                          ]
+                        },
+                        "description": "",
+                        "tags": {},
+                        "declarations": []
+                      },
+                      {
+                        "kind": "property",
+                        "name": "surface",
+                        "required": false,
+                        "type": {
+                          "kind": "union",
+                          "value": [
+                            {
+                              "kind": "primitive",
+                              "value": "string"
+                            },
+                            {
+                              "kind": "primitive",
+                              "value": "undefined"
+                            }
+                          ]
+                        },
+                        "description": "",
+                        "tags": {},
+                        "declarations": []
+                      }
+                    ]
+                  },
+                  {
+                    "kind": "primitive",
+                    "value": "undefined"
+                  }
+                ]
+              },
+              {
+                "kind": "primitive",
+                "value": "undefined"
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "selected",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "writeIndependentBrandTokens",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Writes focus/border from explicit common or brand.primary.500 input — never from primary.main.",
+    "declarations": [
+      {
+        "name": "writeIndependentBrandTokens",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "theme",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "symbol",
+                "name": "CanvasProviderTheme",
+                "value": "CanvasProviderTheme"
+              },
+              {
+                "kind": "primitive",
+                "value": "undefined"
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "theme",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "writeSystemBrandOverrides",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Walks nested system override object and sets matching system CSS vars.",
+    "declarations": [
+      {
+        "name": "writeSystemBrandOverrides",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "systemOverrides",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "object",
+                "properties": [
+                  {
+                    "kind": "property",
+                    "name": "color",
+                    "required": false,
+                    "type": {
+                      "kind": "object",
+                      "properties": [
+                        {
+                          "kind": "property",
+                          "name": "brand",
+                          "required": false,
+                          "type": {
+                            "kind": "external",
+                            "name": "Record",
+                            "url": "https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type",
+                            "typeParameters": [
+                              {
+                                "kind": "primitive",
+                                "value": "string"
+                              },
+                              {
+                                "kind": "primitive",
+                                "value": "unknown"
+                              }
+                            ]
+                          },
+                          "description": "",
+                          "declarations": [
+                            {
+                              "name": "brand",
+                              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                            }
+                          ],
+                          "tags": {}
+                        }
+                      ]
+                    },
+                    "description": "",
+                    "declarations": [
+                      {
+                        "name": "color",
+                        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                      }
+                    ],
+                    "tags": {}
+                  }
+                ]
+              },
+              {
+                "kind": "primitive",
+                "value": "undefined"
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "systemOverrides",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "writeSemanticTheme",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Full-scope semantic writer — filled palette compared against defaults unless `writeAll`.",
+    "declarations": [
+      {
+        "name": "writeSemanticTheme",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "palette",
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "common",
+                "required": true,
+                "type": {
+                  "kind": "object",
+                  "properties": [
+                    {
+                      "kind": "property",
+                      "name": "focusOutline",
+                      "required": true,
+                      "type": {
+                        "kind": "primitive",
+                        "value": "string"
+                      },
+                      "description": "",
+                      "declarations": [
+                        {
+                          "name": "focusOutline",
+                          "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                        }
+                      ],
+                      "tags": {}
+                    },
+                    {
+                      "kind": "property",
+                      "name": "alertInner",
+                      "required": true,
+                      "type": {
+                        "kind": "primitive",
+                        "value": "string"
+                      },
+                      "description": "",
+                      "declarations": [
+                        {
+                          "name": "alertInner",
+                          "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                        }
+                      ],
+                      "tags": {}
+                    },
+                    {
+                      "kind": "property",
+                      "name": "alertOuter",
+                      "required": true,
+                      "type": {
+                        "kind": "primitive",
+                        "value": "string"
+                      },
+                      "description": "",
+                      "declarations": [
+                        {
+                          "name": "alertOuter",
+                          "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                        }
+                      ],
+                      "tags": {}
+                    },
+                    {
+                      "kind": "property",
+                      "name": "errorInner",
+                      "required": true,
+                      "type": {
+                        "kind": "primitive",
+                        "value": "string"
+                      },
+                      "description": "",
+                      "declarations": [
+                        {
+                          "name": "errorInner",
+                          "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                        }
+                      ],
+                      "tags": {}
+                    }
+                  ]
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "common",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "primary",
+                "required": true,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasThemePalette",
+                  "value": "CanvasThemePalette"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "primary",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "error",
+                "required": true,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasThemePalette",
+                  "value": "CanvasThemePalette"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "error",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "alert",
+                "required": true,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasThemePalette",
+                  "value": "CanvasThemePalette"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "alert",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "success",
+                "required": true,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasThemePalette",
+                  "value": "CanvasThemePalette"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "success",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "neutral",
+                "required": true,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasThemePalette",
+                  "value": "CanvasThemePalette"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "neutral",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "palette",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "options",
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "writeAll",
+                "required": false,
+                "type": {
+                  "kind": "primitive",
+                  "value": "boolean"
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "writeAll",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "options",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "writeNumericalTheme",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Writes numerical theme — brand scope applies per-family shortcuts; remaining keys write 1:1.",
+    "declarations": [
+      {
+        "name": "writeNumericalTheme",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "theme",
+          "type": {
+            "kind": "symbol",
+            "name": "CanvasNumericalBrandTheme",
+            "value": "CanvasNumericalBrandTheme"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "theme",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "scope",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "string",
+                "value": "brand"
+              },
+              {
+                "kind": "string",
+                "value": "full"
+              }
+            ]
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "scope",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
+  {
+    "name": "writeBrandScopeSemantic",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts",
+    "description": "Brand-scope semantic path — reads raw input only, not useTheme-filled palette.",
+    "declarations": [
+      {
+        "name": "writeBrandScopeSemantic",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "theme",
+          "type": {
+            "kind": "symbol",
+            "name": "PartialEmotionCanvasTheme",
+            "value": "PartialEmotionCanvasTheme"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "theme",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "parameter",
+          "name": "style",
+          "type": {
+            "kind": "symbol",
+            "name": "React.CSSProperties",
+            "value": "CSSProperties"
+          },
+          "required": true,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "style",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/brandScope.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "primitive",
+        "value": "void"
+      }
+    }
+  },
   {
     "name": "BreakpointKey",
     "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/breakpoints.ts",
@@ -229996,6 +232011,42 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
       }
     }
   },
+  {
+    "name": "sanaCanvasNumericalTheme",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/sanaTheme.ts",
+    "description": "Sana Canvas brand tokens for scoped `CanvasProvider` / popup forwarding.\nValues are `var()` references to Sana brand variables — not merged from `defaultCanvasTheme`.",
+    "declarations": [
+      {
+        "name": "sanaCanvasNumericalTheme",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/sanaTheme.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "symbol",
+      "name": "CanvasNumericalBrandTheme",
+      "value": "CanvasNumericalBrandTheme"
+    }
+  },
+  {
+    "name": "sanaCanvasProviderTheme",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/sanaTheme.ts",
+    "description": "Pass to root `CanvasProvider` to forward Sana brand CSS variables onto popup containers\n(menus, selects, modals, tooltips).\n\n**When to use it**\n- **Required** when you cannot set `data-theme=\"sana-canvas\"` on `<html>` (embedded apps,\n  microfrontends, third-party shells). Popups portal to `document.body` and will not inherit\n  a nested `data-theme` — this preset copies Sana brand vars onto the popup stack container.\n- Also useful in tests without global Sana CSS, or custom popup hosts outside normal cascade.\n\n**When you can skip it**\n- Prefer setting `data-theme=\"sana-canvas\"` on `<html>` with Sana CSS imported. Popups then\n  inherit brand variables from the document and no `theme` prop is needed.",
+    "declarations": [
+      {
+        "name": "sanaCanvasProviderTheme",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/sanaTheme.ts"
+      }
+    ],
+    "tags": {
+      "example": "```tsx\n// Preferred — control <html>\nimport '@workday/canvas-tokens-web/css/sana/_variables.css';\n// <html data-theme=\"sana-canvas\">\n<CanvasProvider><App /></CanvasProvider>\n\n// No access to <html> — required for popup parity\n<CanvasProvider theme={sanaCanvasProviderTheme}><App /></CanvasProvider>\n```"
+    },
+    "type": {
+      "kind": "symbol",
+      "name": "sanaCanvasNumericalTheme",
+      "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/sanaTheme.ts"
+    }
+  },
   {
     "name": "filterOutProps",
     "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/styled.ts",
@@ -230928,42 +232979,775 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
     }
   },
   {
-    "name": "EmotionCanvasTheme",
+    "name": "EmotionCanvasTheme",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
+    "description": "",
+    "declarations": [
+      {
+        "name": "EmotionCanvasTheme",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+      }
+    ],
+    "tags": {
+      "deprecated": "⚠️ `EmotionCanvasTheme` is deprecated. In previous versions of Canvas Kit, we allowed teams to pass a theme object, this supported [Emotion's theming](https://emotion.sh/docs/theming). Now that we're shifting to a global theming approach based on CSS variables, we advise to no longer using the theme prop. For more information, view our [Theming Docs](https://workday.github.io/canvas-kit/?path=/docs/features-theming-overview--docs#-preferred-approach-v14)."
+    },
+    "type": {
+      "kind": "object",
+      "properties": [
+        {
+          "kind": "property",
+          "name": "canvas",
+          "required": true,
+          "type": {
+            "kind": "symbol",
+            "name": "CanvasTheme",
+            "value": "CanvasTheme"
+          },
+          "description": "",
+          "declarations": [
+            {
+              "name": "canvas",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ]
+    }
+  },
+  {
+    "name": "CanvasBrandRamp",
     "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
-    "description": "",
+    "description": "Numerical brand ramp keys. Each key maps 1:1 to a `--cnvs-brand-{family}-{key}` CSS variable.\n\nCommon keys:\n- `'600'` — main accent / button fill / default brand fg\n- `'700'` — strong fg / selected text (when not using `selected.fg`)\n- `'500'` — focus rings and border primary (independent of `'600'`)\n- `'A50'` — selected surface tint (when not using `selected.surface`)\n- `'25'` / `'A25'` — subtle brand surfaces\n\nNeutral-only Sana steps (`'150'`, `'850'`, `'A150'`) live on {@link CanvasNeutralBrandRamp }.",
     "declarations": [
       {
-        "name": "EmotionCanvasTheme",
+        "name": "CanvasBrandRamp",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "type",
+      "typeParameters": [],
+      "value": {
+        "kind": "symbol",
+        "name": "Partial",
+        "typeParameters": [
+          {
+            "kind": "external",
+            "name": "Record",
+            "url": "https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type",
+            "typeParameters": [
+              {
+                "kind": "union",
+                "value": [
+                  {
+                    "kind": "string",
+                    "value": "25"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "50"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "100"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "200"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "300"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "400"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "500"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "600"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "700"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "800"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "900"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "950"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "975"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "A25"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "A50"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "A100"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "A200"
+                  }
+                ]
+              },
+              {
+                "kind": "primitive",
+                "value": "string"
+              }
+            ]
+          }
+        ],
+        "value": "Partial<T>"
+      }
+    }
+  },
+  {
+    "name": "CanvasNeutralBrandRamp",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
+    "description": "Neutral brand ramp — includes Sana-only steps (`150` / `850` / `A150`) that are not\nexported for primary/critical/caution/positive families.",
+    "declarations": [
+      {
+        "name": "CanvasNeutralBrandRamp",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "type",
+      "typeParameters": [],
+      "value": {
+        "kind": "intersection",
+        "value": [
+          {
+            "kind": "symbol",
+            "name": "CanvasBrandRamp",
+            "value": "Partial<Record<\"25\" | \"50\" | \"100\" | \"200\" | \"300\" | \"400\" | \"500\" | \"600\" | \"700\" | \"800\" | \"900\" | \"950\" | \"975\" | \"A25\" | \"A50\" | \"A100\" | \"A200\", string>>"
+          },
+          {
+            "kind": "symbol",
+            "name": "Partial",
+            "typeParameters": [
+              {
+                "kind": "external",
+                "name": "Record",
+                "url": "https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type",
+                "typeParameters": [
+                  {
+                    "kind": "union",
+                    "value": [
+                      {
+                        "kind": "string",
+                        "value": "150"
+                      },
+                      {
+                        "kind": "string",
+                        "value": "850"
+                      },
+                      {
+                        "kind": "string",
+                        "value": "A150"
+                      }
+                    ]
+                  },
+                  {
+                    "kind": "primitive",
+                    "value": "string"
+                  }
+                ]
+              }
+            ],
+            "value": "Partial<T>"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "name": "CanvasActionBrandRamp",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
+    "description": "Semantic keys for `brand.action.*` CSS variables (PrimaryButton, etc.).",
+    "declarations": [
+      {
+        "name": "CanvasActionBrandRamp",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "type",
+      "typeParameters": [],
+      "value": {
+        "kind": "symbol",
+        "name": "Partial",
+        "typeParameters": [
+          {
+            "kind": "external",
+            "name": "Record",
+            "url": "https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type",
+            "typeParameters": [
+              {
+                "kind": "union",
+                "value": [
+                  {
+                    "kind": "string",
+                    "value": "base"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "lightest"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "lighter"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "light"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "dark"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "darkest"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "darker"
+                  },
+                  {
+                    "kind": "string",
+                    "value": "accent"
+                  }
+                ]
+              },
+              {
+                "kind": "primitive",
+                "value": "string"
+              }
+            ]
+          }
+        ],
+        "value": "Partial<T>"
+      }
+    }
+  },
+  {
+    "name": "CanvasThemingScope",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
+    "description": "Controls how partial theme input is expanded.\n\n- `'brand'` (default): predictable, design-aligned behavior. Setting only\n  `brand.primary['600']` themes PrimaryButton and selected list/menu\n  states. Other keys write only their CSS variable — no auto-generated ramps.\n- `'full'`: legacy behavior for the deprecated `canvas.palette` shape — auto-fills\n  lightest→darkest via `shiftColor` and forwards to many `system.color.brand.*`\n  tokens. On the numerical `brand` shape, `'full'` disables the primary shortcut\n  and writes each ramp key literally.",
+    "declarations": [
+      {
+        "name": "CanvasThemingScope",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "type",
+      "typeParameters": [],
+      "value": {
+        "kind": "union",
+        "value": [
+          {
+            "kind": "string",
+            "value": "brand"
+          },
+          {
+            "kind": "string",
+            "value": "full"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "name": "CanvasNumericalBrandTheme",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
+    "description": "Preferred theme input for `CanvasProvider`. Each value maps directly to brand CSS\nvariables unless noted as a shortcut below.",
+    "declarations": [
+      {
+        "name": "CanvasNumericalBrandTheme",
         "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
       }
     ],
     "tags": {
-      "deprecated": "⚠️ `EmotionCanvasTheme` is deprecated. In previous versions of Canvas Kit, we allowed teams to pass a theme object, this supported [Emotion's theming](https://emotion.sh/docs/theming). Now that we're shifting to a global theming approach based on CSS variables, we advise to no longer using the theme prop. For more information, view our [Theming Docs](https://workday.github.io/canvas-kit/?path=/docs/features-theming-overview--docs#-preferred-approach-v14)."
+      "example": "Minimal — brand buttons + selected states only\n```tsx\n<CanvasProvider theme={{brand: {primary: {'600': base.magenta600}}}} />\n```\nExplicit — focus independent of primary\n```tsx\n<CanvasProvider theme={{\nbrand: {primary: {'600': base.red600, '500': base.blue500}},\nselected: {fg: base.red700, surface: base.redA50},\n}} />\n```",
+      "see": "sanaCanvasProviderTheme\n \nwhen `<html>` is unavailable and popups need Sana brand forwarding"
     },
     "type": {
       "kind": "object",
       "properties": [
         {
           "kind": "property",
-          "name": "canvas",
-          "required": true,
+          "name": "brand",
+          "required": false,
           "type": {
-            "kind": "symbol",
-            "name": "CanvasTheme",
-            "value": "CanvasTheme"
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "primary",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasBrandRamp",
+                  "value": "Partial<Record<\"25\" | \"50\" | \"100\" | \"200\" | \"300\" | \"400\" | \"500\" | \"600\" | \"700\" | \"800\" | \"900\" | \"950\" | \"975\" | \"A25\" | \"A50\" | \"A100\" | \"A200\", string>>"
+                },
+                "description": "Primary brand ramp (`--cnvs-brand-primary-*`).\n\n**Shortcut (brand scope only):** when `'600'` is the only key under `primary`,\nalso sets:\n- `PrimaryButton` — `brand.action.base`, `accent.primary`, `accent.action`\n- Selected `Menu.Item` — `system.color.brand.fg.selected`, `surface.selected`\n\nDoes **not** set focus rings — use `'500'` or `canvas.palette.common.focusOutline`.\n\n| Key | CSS variable | Typical consumers |\n|-----|--------------|-------------------|\n| `'600'` | `--cnvs-brand-primary-600` | PrimaryButton, brand links, accent.primary |\n| `'700'` | `--cnvs-brand-primary-700` | Strong primary fg, selected text |\n| `'500'` | `--cnvs-brand-primary-500` | Focus rings, border primary |\n| `'A50'` | `--cnvs-brand-primary-A50` | Selected/hover surfaces |",
+                "declarations": [
+                  {
+                    "name": "primary",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "action",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasActionBrandRamp",
+                  "value": "Partial<Record<\"accent\" | \"dark\" | \"light\" | \"lighter\" | \"base\" | \"darkest\" | \"lightest\" | \"darker\", string>>"
+                },
+                "description": "Button-specific ramp (`--cnvs-brand-action-*`). PrimaryButton reads\nthese **before** `brand.primary`.\n\n| Key | Typical consumers |\n|-----|-------------------|\n| `base` | PrimaryButton background |\n| `dark` / `darkest` | PrimaryButton hover / pressed |\n| `accent` | PrimaryButton label color |",
+                "declarations": [
+                  {
+                    "name": "action",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "critical",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasBrandRamp",
+                  "value": "Partial<Record<\"25\" | \"50\" | \"100\" | \"200\" | \"300\" | \"400\" | \"500\" | \"600\" | \"700\" | \"800\" | \"900\" | \"950\" | \"975\" | \"A25\" | \"A50\" | \"A100\" | \"A200\", string>>"
+                },
+                "description": "Critical/error ramp (`--cnvs-brand-critical-*`).\n\n| Key | Typical consumers |\n|-----|-------------------|\n| `'600'` | TextInput error, DeleteButton, critical fg |\n| `'500'` | Critical focus ring, error border |\n| `'A25'` / `'A50'` | Error surface tints |",
+                "declarations": [
+                  {
+                    "name": "critical",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "caution",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasBrandRamp",
+                  "value": "Partial<Record<\"25\" | \"50\" | \"100\" | \"200\" | \"300\" | \"400\" | \"500\" | \"600\" | \"700\" | \"800\" | \"900\" | \"950\" | \"975\" | \"A25\" | \"A50\" | \"A100\" | \"A200\", string>>"
+                },
+                "description": "Caution/warning ramp (`--cnvs-brand-caution-*`).\n\n| Key | Typical consumers |\n|-----|-------------------|\n| `'400'` | Caution accent, TextInput caution |\n| `'500'` | Caution focus outer, caution border |\n| `'A25'` / `'A50'` | Caution surface tints |",
+                "declarations": [
+                  {
+                    "name": "caution",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "positive",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasBrandRamp",
+                  "value": "Partial<Record<\"25\" | \"50\" | \"100\" | \"200\" | \"300\" | \"400\" | \"500\" | \"600\" | \"700\" | \"800\" | \"900\" | \"950\" | \"975\" | \"A25\" | \"A50\" | \"A100\" | \"A200\", string>>"
+                },
+                "description": "Positive/success ramp (`--cnvs-brand-positive-*`).\n\n| Key | Typical consumers |\n|-----|-------------------|\n| `'600'` | Checkbox/Radio checked, success fg |\n| `'A25'` / `'A50'` | Success surface tints |",
+                "declarations": [
+                  {
+                    "name": "positive",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "neutral",
+                "required": false,
+                "type": {
+                  "kind": "symbol",
+                  "name": "CanvasNeutralBrandRamp",
+                  "value": "CanvasNeutralBrandRamp"
+                },
+                "description": "Neutral brand ramp (`--cnvs-brand-neutral-*`). Sana Canvas uses `base.neutral*`\ninstead of legacy `base.slate*` — see {@link sanaCanvasNumericalTheme}.\n\nAffects brand-neutral text, borders, and surfaces where components reference\n`brand.neutral.*` or `system.color.brand` tokens tied to neutral.",
+                "declarations": [
+                  {
+                    "name": "neutral",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
           },
           "description": "",
           "declarations": [
             {
-              "name": "canvas",
+              "name": "brand",
               "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
             }
           ],
           "tags": {}
+        },
+        {
+          "kind": "property",
+          "name": "selected",
+          "required": false,
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "fg",
+                "required": false,
+                "type": {
+                  "kind": "primitive",
+                  "value": "string"
+                },
+                "description": "Selected text/icon color",
+                "declarations": [
+                  {
+                    "name": "fg",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              },
+              {
+                "kind": "property",
+                "name": "surface",
+                "required": false,
+                "type": {
+                  "kind": "primitive",
+                  "value": "string"
+                },
+                "description": "Selected row/chip background",
+                "declarations": [
+                  {
+                    "name": "surface",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "description": "Selected-state shortcuts. Prefer these over indirect `brand.primary['700']` /\n`brand.primary.A50` when customizing list/menu selection.\n\n| Key | CSS variable | Typical consumers |\n|-----|--------------|-------------------|\n| `fg` | `--cnvs-sys-color-brand-fg-selected` | Menu.Item, SegmentedControl selected text |\n| `surface` | `--cnvs-sys-color-brand-surface-selected` | Menu.Item, list selected background |",
+          "declarations": [
+            {
+              "name": "selected",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "property",
+          "name": "system",
+          "required": false,
+          "type": {
+            "kind": "object",
+            "properties": [
+              {
+                "kind": "property",
+                "name": "color",
+                "required": false,
+                "type": {
+                  "kind": "object",
+                  "properties": [
+                    {
+                      "kind": "property",
+                      "name": "brand",
+                      "required": false,
+                      "type": {
+                        "kind": "external",
+                        "name": "Record",
+                        "url": "https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type",
+                        "typeParameters": [
+                          {
+                            "kind": "primitive",
+                            "value": "string"
+                          },
+                          {
+                            "kind": "primitive",
+                            "value": "unknown"
+                          }
+                        ]
+                      },
+                      "description": "",
+                      "declarations": [
+                        {
+                          "name": "brand",
+                          "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                        }
+                      ],
+                      "tags": {}
+                    }
+                  ]
+                },
+                "description": "",
+                "declarations": [
+                  {
+                    "name": "color",
+                    "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                  }
+                ],
+                "tags": {}
+              }
+            ]
+          },
+          "description": "Escape hatch for `system.color.brand.*` tokens not covered by `brand` ramps.\nKeys mirror the token path, e.g. `{color: {brand: {focus: {primary: '#00f'}}}}`.",
+          "declarations": [
+            {
+              "name": "system",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "property",
+          "name": "direction",
+          "required": false,
+          "type": {
+            "kind": "symbol",
+            "name": "ContentDirection",
+            "value": "ContentDirection"
+          },
+          "description": "Text direction for the provider subtree.",
+          "declarations": [
+            {
+              "name": "direction",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+            }
+          ],
+          "tags": {}
+        },
+        {
+          "kind": "property",
+          "name": "themeScope",
+          "required": false,
+          "type": {
+            "kind": "symbol",
+            "name": "CanvasThemingScope",
+            "value": "CanvasThemingScope"
+          },
+          "description": "",
+          "declarations": [
+            {
+              "name": "themeScope",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+            }
+          ],
+          "tags": {
+            "default": "'brand'",
+            "see": "CanvasThemingScope"
+          }
         }
       ]
     }
   },
+  {
+    "name": "CanvasProviderTheme",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
+    "description": "Theme input accepted by {@link CanvasProvider}.\n- Numerical `brand` shape (preferred)\n- Deprecated `canvas.palette` shape (legacy)",
+    "declarations": [
+      {
+        "name": "CanvasProviderTheme",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "type",
+      "typeParameters": [],
+      "value": {
+        "kind": "union",
+        "value": [
+          {
+            "kind": "parenthesis",
+            "value": {
+              "kind": "intersection",
+              "value": [
+                {
+                  "kind": "symbol",
+                  "name": "PartialEmotionCanvasTheme",
+                  "value": "PartialEmotionCanvasTheme"
+                },
+                {
+                  "kind": "object",
+                  "properties": [
+                    {
+                      "kind": "property",
+                      "name": "themeScope",
+                      "required": false,
+                      "type": {
+                        "kind": "symbol",
+                        "name": "CanvasThemingScope",
+                        "value": "CanvasThemingScope"
+                      },
+                      "description": "",
+                      "declarations": [
+                        {
+                          "name": "themeScope",
+                          "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+                        }
+                      ],
+                      "tags": {}
+                    }
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "kind": "symbol",
+            "name": "CanvasNumericalBrandTheme",
+            "value": "CanvasNumericalBrandTheme"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "name": "isNumericalTheme",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
+    "description": "",
+    "declarations": [
+      {
+        "name": "isNumericalTheme",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "theme",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "symbol",
+                "name": "CanvasProviderTheme",
+                "value": "CanvasProviderTheme"
+              },
+              {
+                "kind": "primitive",
+                "value": "undefined"
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "theme",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "unknown",
+        "value": "unknown",
+        "text": "theme is CanvasNumericalBrandTheme"
+      }
+    }
+  },
+  {
+    "name": "resolveThemingScope",
+    "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts",
+    "description": "",
+    "declarations": [
+      {
+        "name": "resolveThemingScope",
+        "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+      }
+    ],
+    "tags": {},
+    "type": {
+      "kind": "function",
+      "parameters": [
+        {
+          "kind": "parameter",
+          "name": "theme",
+          "type": {
+            "kind": "union",
+            "value": [
+              {
+                "kind": "symbol",
+                "name": "CanvasProviderTheme",
+                "value": "CanvasProviderTheme"
+              },
+              {
+                "kind": "primitive",
+                "value": "undefined"
+              }
+            ]
+          },
+          "required": false,
+          "rest": false,
+          "description": "",
+          "declarations": [
+            {
+              "name": "theme",
+              "filePath": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/types.ts"
+            }
+          ],
+          "tags": {}
+        }
+      ],
+      "members": [],
+      "returnType": {
+        "kind": "symbol",
+        "name": "CanvasThemingScope",
+        "value": "CanvasThemingScope"
+      }
+    }
+  },
   {
     "name": "useIsRTL",
     "fileName": "/home/runner/work/canvas-kit/canvas-kit/modules/react/common/lib/theming/useIsRTL.ts",
@@ -437154,8 +439938,8 @@ export const docs = (typeof window !== 'undefined' && window.__docs) ||
           "required": false,
           "type": {
             "kind": "symbol",
-            "name": "PartialEmotionCanvasTheme",
-            "value": "PartialEmotionCanvasTheme"
+            "name": "CanvasProviderTheme",
+            "value": "CanvasProviderTheme"
           },
           "description": "",
           "declarations": [