@skopon-cool/form-sdk 0.1.8 → 0.2.0

package/dist/theme/antd-theme.d.ts

@@ -0,0 +1,7 @@
+import type { ThemeConfig } from 'antd';
+/**
+ * Ant Design 主题映射（与 design/ui/UI规范.md §2.4、§2.5 一致）
+ * 品牌主色 hex 仅来自 ./brand-colors.ts
+ */
+export declare const antdTheme: ThemeConfig;
+//# sourceMappingURL=antd-theme.d.ts.map

package/dist/theme/antd-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antd-theme.d.ts","sourceRoot":"","sources":["../../src/theme/antd-theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAGvC;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,WAqFvB,CAAA"}

package/dist/theme/brand-colors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 品牌墨绿（Jade）唯一 hex 源
+ * CSS 侧通过 Radix --jade-* / 语义变量 --color-* 引用；Ant Design 从此文件同步
+ * 规范：front/design/ui/UI规范.md §2.2、§2.5
+ */
+export declare const brandColors: {
+    readonly jade9: "#29a383";
+    readonly jade10: "#26997b";
+    readonly jade11: "#208368";
+    readonly jade12: "#1d3b31";
+    /** 链接、边框、Logo 图形、实心底（与 primarySolid 同色） */
+    readonly primary: "#208368";
+    /** Primary 实心按钮、Sider 胶囊、发布等 type="primary" */
+    readonly primarySolid: "#208368";
+    readonly primaryHover: "#26997b";
+    readonly primaryActive: "#1d3b31";
+    readonly onPrimary: "#ffffff";
+};
+//# sourceMappingURL=brand-colors.d.ts.map

package/dist/theme/brand-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-colors.d.ts","sourceRoot":"","sources":["../../src/theme/brand-colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;IAKtB,2CAA2C;;IAE3C,+CAA+C;;;;;CAKvC,CAAA"}

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Skopon form rendering SDK (A2UI + form_definition) with submit helpers",
   "type": "module",
   "sideEffects": [
@@ -27,9 +27,11 @@
   "scripts": {
     "build": "vite build && tsc -p tsconfig.build.json",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
+    "@radix-ui/colors": "^3.0.0",
     "dayjs": "^1.11.13",
     "zod": "^3.24.0"
   },

package/src/components/AskUserFormCard.tsx

@@ -16,6 +16,7 @@ import type { CaseSearchFn } from '../catalog/caseSearchContext'
 import type { ResumeSearchFn } from '../catalog/resumeSearchContext'
 import SkoponFormRenderer, { type SkoponFormRendererRef } from './SkoponFormRenderer'
 import CurlSubmitBlock from './CurlSubmitBlock'
+import SkoponFormProvider from './SkoponFormProvider'
 
 function formatSubmitErrorMessage(status: number, body: unknown): string {
   if (body && typeof body === 'object' && body !== null && 'message' in body) {
@@ -154,21 +155,25 @@ export default function AskUserFormCard({
 
   if (loading) {
     return (
-      <div className="ask-user-form-card">
-        <Spin size="small" />
-      </div>
+      <SkoponFormProvider>
+        <div className="ask-user-form-card">
+          <Spin size="small" />
+        </div>
+      </SkoponFormProvider>
     )
   }
 
   if (!payloadDef || renderBlocks.length === 0) {
     return (
-      <CurlSubmitBlock
-        payload={payload}
-        callbackUrl={callbackUrl}
-        copyMode="submitFields"
-        unpublishedFormId={formDisabled && resolvedFormUniqueId ? resolvedFormUniqueId : undefined}
-        onNotify={onNotify}
-      />
+      <SkoponFormProvider>
+        <CurlSubmitBlock
+          payload={payload}
+          callbackUrl={callbackUrl}
+          copyMode="submitFields"
+          unpublishedFormId={formDisabled && resolvedFormUniqueId ? resolvedFormUniqueId : undefined}
+          onNotify={onNotify}
+        />
+      </SkoponFormProvider>
     )
   }
 
@@ -210,7 +215,8 @@ export default function AskUserFormCard({
   }
 
   return (
-    <div className="ask-user-form-card">
+    <SkoponFormProvider>
+      <div className="ask-user-form-card">
       {formDisabled && resolvedFormUniqueId ? (
         <div className="ask-user-form-card-status">
           <Tooltip title={resolvedFormUniqueId}>
@@ -241,6 +247,7 @@ export default function AskUserFormCard({
           </Button>
         </Tooltip>
       </div>
-    </div>
+      </div>
+    </SkoponFormProvider>
   )
 }

package/src/components/SkoponA2uiStreamRenderer.tsx

@@ -7,6 +7,7 @@ import { buildSkoponCatalog } from '../catalog/a2uiCustomCatalog'
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
 import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
 import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
+import SkoponFormProvider from './SkoponFormProvider'
 
 export interface SkoponA2uiStreamRendererProps {
   /** 增量追加的 A2UI v0.9 消息 */
@@ -177,10 +178,11 @@ export default function SkoponA2uiStreamRenderer({
     }
   }, [messages, surfaceId])
 
-  if (surfaces.length === 0) return <>{emptyHint}</>
+  if (surfaces.length === 0) return <SkoponFormProvider>{emptyHint}</SkoponFormProvider>
 
   return (
-    <ResumeSearchProvider resumeSearch={resumeSearch}>
+    <SkoponFormProvider>
+      <ResumeSearchProvider resumeSearch={resumeSearch}>
       <CaseSearchProvider caseSearch={caseSearch}>
         <A2uiPreviewModeProvider interactive={interactive}>
           <div className="a2ui-surface a2ui-container">
@@ -191,5 +193,6 @@ export default function SkoponA2uiStreamRenderer({
         </A2uiPreviewModeProvider>
       </CaseSearchProvider>
     </ResumeSearchProvider>
+    </SkoponFormProvider>
   )
 }

package/src/components/SkoponFormProvider.tsx

@@ -0,0 +1,23 @@
+import { ConfigProvider, type ThemeConfig } from 'antd'
+import type { Locale } from 'antd/es/locale'
+import type { ReactNode } from 'react'
+import { antdTheme as skoponAntdTheme } from '../theme/antd-theme'
+
+export interface SkoponFormProviderProps {
+  children: ReactNode
+  locale?: Locale
+  /** 默认 Skopon 墨绿主题；传入可覆盖 */
+  theme?: ThemeConfig
+}
+
+export default function SkoponFormProvider({
+  children,
+  locale,
+  theme,
+}: SkoponFormProviderProps) {
+  return (
+    <ConfigProvider theme={theme ?? skoponAntdTheme} locale={locale}>
+      {children}
+    </ConfigProvider>
+  )
+}

package/src/components/SkoponFormRenderer.tsx

@@ -17,6 +17,7 @@ import { SKOPON_CATALOG_ID, buildSkoponCatalog } from '../catalog/a2uiCustomCata
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
 import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
 import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
+import SkoponFormProvider from './SkoponFormProvider'
 
 export interface SkoponFormRendererRef {
   getValues: (fieldNames?: string[]) => Record<string, unknown>
@@ -104,10 +105,11 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
       [surfaceId],
     )
 
-    if (surfaces.length === 0) return <>{emptyHint}</>
+    if (surfaces.length === 0) return <SkoponFormProvider>{emptyHint}</SkoponFormProvider>
 
     return (
-      <ResumeSearchProvider resumeSearch={resumeSearch}>
+      <SkoponFormProvider>
+        <ResumeSearchProvider resumeSearch={resumeSearch}>
         <CaseSearchProvider caseSearch={caseSearch}>
           <A2uiPreviewModeProvider interactive={interactive}>
             <div className="a2ui-surface a2ui-container">
@@ -117,7 +119,8 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
             </div>
           </A2uiPreviewModeProvider>
         </CaseSearchProvider>
-      </ResumeSearchProvider>
+        </ResumeSearchProvider>
+      </SkoponFormProvider>
     )
   },
 )

package/src/index.ts

@@ -80,6 +80,12 @@ export type { AskUserFormCardProps } from './components/AskUserFormCard'
 export { default as CurlSubmitBlock } from './components/CurlSubmitBlock'
 export type { CurlSubmitBlockProps } from './components/CurlSubmitBlock'
 
+export { default as SkoponFormProvider } from './components/SkoponFormProvider'
+export type { SkoponFormProviderProps } from './components/SkoponFormProvider'
+
+export { antdTheme as skoponAntdTheme } from './theme/antd-theme'
+export { brandColors as skoponBrandColors } from './theme/brand-colors'
+
 
 export {
   ResumeSearchProvider,

package/src/styles/index.css

@@ -1,3 +1,4 @@
+@import './tokens.css';
 @import './a2ui-preview.css';
 
 /* form-block-preview（与 admin form-tally 预览对齐的子集） */

package/src/styles/tokens.css

@@ -0,0 +1,224 @@
+/**
+ * VidTempl 设计令牌
+ * 基础色阶：@radix-ui/colors（Gray 中性 + Jade 墨绿品牌）
+ * 语义变量：供全局 CSS 与自定义组件使用
+ */
+
+@import '@radix-ui/colors/gray.css';
+@import '@radix-ui/colors/jade.css';
+@import '@radix-ui/colors/green.css';
+@import '@radix-ui/colors/red.css';
+@import '@radix-ui/colors/amber.css';
+
+:root,
+.light,
+.light-theme {
+  /* —— 品牌色（墨绿 · Radix Jade）—— */
+  --brand-1: var(--jade-1);
+  --brand-2: var(--jade-2);
+  --brand-3: var(--jade-3);
+  --brand-4: var(--jade-4);
+  --brand-5: var(--jade-5);
+  --brand-6: var(--jade-6);
+  --brand-7: var(--jade-7);
+  --brand-8: var(--jade-8);
+  --brand-9: var(--jade-9);
+  --brand-10: var(--jade-10);
+  --brand-11: var(--jade-11);
+  --brand-12: var(--jade-12);
+
+  /* —— 中性色（Radix Gray）—— */
+  --neutral-1: var(--gray-1);
+  --neutral-2: var(--gray-2);
+  --neutral-3: var(--gray-3);
+  --neutral-4: var(--gray-4);
+  --neutral-5: var(--gray-5);
+  --neutral-6: var(--gray-6);
+  --neutral-7: var(--gray-7);
+  --neutral-8: var(--gray-8);
+  --neutral-9: var(--gray-9);
+  --neutral-10: var(--gray-10);
+  --neutral-11: var(--gray-11);
+  --neutral-12: var(--gray-12);
+
+  /* —— 功能色 —— */
+  --success-9: var(--green-9);
+  --success-11: var(--green-11);
+  --danger-9: var(--red-9);
+  --danger-11: var(--red-11);
+  --danger-3: var(--red-3);
+  --warning-9: var(--amber-9);
+  --warning-11: var(--amber-11);
+
+  /* —— 语义色（交互设计统一引用）—— */
+  --color-primary: var(--brand-11);
+  --color-primary-hover: var(--brand-10);
+  --color-primary-active: var(--brand-12);
+  /* 实心底：与 --color-primary 同为 Jade 11，供按钮 / Sider 等大面积铺色 */
+  --color-primary-solid: var(--brand-11);
+  --color-primary-subtle: var(--brand-3);
+  --color-primary-muted: var(--brand-4);
+  --color-on-primary: #ffffff;
+
+  --color-bg: var(--neutral-1);
+  --color-bg-subtle: var(--neutral-2);
+  --color-bg-muted: var(--neutral-3);
+  --color-surface: #ffffff;
+  --color-surface-raised: var(--neutral-2);
+
+  --color-border: var(--neutral-6);
+  --color-border-subtle: var(--neutral-4);
+  --color-border-strong: var(--neutral-8);
+
+  --color-text: var(--neutral-12);
+  --color-text-secondary: var(--neutral-11);
+  --color-text-muted: var(--neutral-9);
+  --color-text-placeholder: var(--neutral-9);
+  --color-text-disabled: var(--neutral-8);
+
+  --color-success: var(--success-9);
+  --color-success-text: var(--success-11);
+  --color-danger: var(--danger-9);
+  --color-danger-text: var(--danger-11);
+  --color-danger-subtle: var(--danger-3);
+  --color-warning: var(--warning-9);
+  --color-warning-text: var(--warning-11);
+  --color-warning-solid: var(--amber-9);
+  --color-warning-solid-hover: var(--amber-10);
+  --color-on-warning: var(--neutral-12);
+
+  --color-focus-ring: color-mix(in srgb, var(--brand-11) 35%, transparent);
+
+  /* —— 间距（4px 基准刻度）—— */
+  --space-1: 4px;
+  --space-2: 8px;
+  --space-3: 12px;
+  --space-4: 16px;
+  --space-5: 24px;
+  --space-6: 32px;
+  --space-7: 48px;
+  --space-8: 64px;
+  /* 语义间距 */
+  --space-page-x: var(--space-5);
+  --space-page-y: var(--space-5);
+  --space-section: var(--space-5);
+  --space-card: var(--space-4);
+  --space-form-item: var(--space-5);
+  --space-inline: var(--space-2);
+  --space-stack-sm: var(--space-3);
+  --space-stack-md: var(--space-4);
+  --space-stack-lg: var(--space-5);
+
+  /* —— 圆角 —— */
+  --radius-sm: 4px;
+  --radius-md: 8px;
+  --radius-lg: 12px;
+  /** 胶囊形（按钮）：两侧半圆，等效 border-radius: 50% / 9999px */
+  --radius-pill: 9999px;
+  --radius-button: var(--radius-pill);
+
+  /* —— 阴影 —— */
+  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.04);
+  --shadow-md: 0 2px 8px rgba(0, 0, 0, 0.06);
+  --shadow-focus: 0 0 0 2px var(--color-focus-ring);
+
+  /* —— 字体 —— */
+  --font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
+    'Helvetica Neue', Arial, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei',
+    'Noto Sans SC', sans-serif;
+  --font-weight-normal: 400;
+  --font-weight-medium: 500;
+  --font-weight-semibold: 600;
+  --font-size-xs: 11px;
+  --font-size-sm: 13px;
+  --font-size-base: 14px;
+  --font-size-lg: 16px;
+  --font-size-xl: 20px;
+  --font-size-2xl: 24px;
+  --line-height-tight: 1.25;
+  --line-height-base: 1.5715;
+  --line-height-relaxed: 1.6;
+
+  /* —— 按钮尺寸 —— */
+  --button-height-sm: 28px;
+  --button-height-md: 36px;
+  --button-height-lg: 40px;
+  --button-padding-x-sm: 12px;
+  --button-padding-x-md: 16px;
+  --button-padding-x-lg: 20px;
+  --button-font-size-sm: 13px;
+  --button-font-size-md: 14px;
+  --button-font-size-lg: 16px;
+  --button-icon-sm: 14px;
+  --button-icon-md: 16px;
+  --button-icon-lg: 18px;
+  --button-font-weight: var(--font-weight-semibold);
+  --button-icon-stroke-width: 2.5px;
+
+  /* —— 布局（design/ui/UI规范.md §12）—— */
+  /* 列表页不设 max-width；流程编辑 1400px；窄表单 800px */
+  --layout-sider-width: 60px;
+  --layout-sider-width-expanded: 158px;
+  --layout-sider-capsule-radius: calc(var(--layout-sider-width) / 2);
+  --layout-sider-inset: var(--space-3);
+  --layout-sider-rail-width: calc(var(--layout-sider-width) + 2 * var(--layout-sider-inset));
+  --layout-sider-rail-width-expanded: calc(
+    var(--layout-sider-width-expanded) + 2 * var(--layout-sider-inset)
+  );
+  --layout-header-height: 56px;
+  --layout-bottom-nav-height: 56px;
+  --layout-sider-mobile-inset: var(--layout-sider-inset);
+  --layout-sider-mobile-padding-y: var(--layout-sider-padding-y);
+  --layout-sider-mobile-padding-x: var(--layout-sider-padding-y);
+  --layout-sider-mobile-clearance: calc(
+    var(--layout-sider-nav-size) + 2 * var(--layout-sider-mobile-padding-y) +
+      var(--layout-sider-mobile-inset) + env(safe-area-inset-bottom, 0px)
+  );
+  --layout-content-gap: var(--space-section);
+  --layout-kpi-min-height: 96px;
+  --layout-chart-min-height: 320px;
+  --layout-sider-logo-size: 36px;
+  --layout-sider-padding-y: var(--space-3);
+  --layout-sider-padding-x: 0;
+  --layout-sider-gap: var(--space-2);
+  /** Logo → 首导航项；退出登录 → 头像（须一致） */
+  --layout-sider-logo-gap: var(--space-4);
+  --layout-sider-nav-size: 36px;
+  /** 展开态 icon 与 label 间距 */
+  --layout-sider-icon-label-gap: 10px;
+  /** 侧栏未选中导航 / 退出图标不透明度 69%（选中、hover 为 1） */
+  --layout-sider-nav-icon-opacity-idle: 0.69;
+  --color-nav-bg: var(--color-primary-solid);
+  --color-nav-icon: var(--color-on-primary);
+  --color-nav-logo-bg: #ffffff;
+  --color-nav-logo-icon: var(--color-primary);
+
+  /* —— 动效 —— */
+  --duration-fast: 150ms;
+  --duration-normal: 200ms;
+  --ease-default: cubic-bezier(0.4, 0, 0.2, 1);
+
+  /* 断点参考（design/ui/UI规范.md §8.1）：640 / 768 / 992 px */
+}
+
+@media (max-width: 768px) {
+  :root {
+    --space-page-x: var(--space-4);
+    --space-page-y: var(--space-4);
+    --space-section: var(--space-4);
+    --space-card: var(--space-3);
+    --layout-sider-mobile-inset: var(--space-5);
+    --layout-sider-mobile-padding-y: var(--space-3);
+    --layout-sider-mobile-padding-x: var(--space-3);
+    --layout-sider-mobile-clearance: calc(
+      var(--layout-sider-nav-size) + 2 * var(--layout-sider-mobile-padding-y) +
+        var(--layout-sider-mobile-inset) + env(safe-area-inset-bottom, 0px)
+    );
+    --layout-flow-artifact-fab-bottom: calc(
+      var(--layout-sider-mobile-clearance) + var(--space-5)
+    );
+    --layout-flow-artifact-panel-bottom: calc(
+      var(--layout-flow-artifact-fab-bottom) + 48px + var(--space-3)
+    );
+  }
+}

package/src/theme/antd-theme.ts

@@ -0,0 +1,93 @@
+import type { ThemeConfig } from 'antd'
+import { brandColors } from './brand-colors'
+
+/**
+ * Ant Design 主题映射（与 design/ui/UI规范.md §2.4、§2.5 一致）
+ * 品牌主色 hex 仅来自 ./brand-colors.ts
+ */
+export const antdTheme: ThemeConfig = {
+  cssVar: { key: 'vidtempl' },
+  token: {
+    colorPrimary: brandColors.primarySolid,
+    colorPrimaryHover: brandColors.primaryHover,
+    colorPrimaryActive: brandColors.primaryActive,
+    colorLink: brandColors.primary,
+    colorLinkHover: brandColors.primaryHover,
+    colorSuccess: brandColors.jade9,
+    colorWarning: '#f5a623',
+    gold6: '#f5a623',
+    gold7: '#e6951a',
+    colorError: '#e5484d',
+    colorInfo: brandColors.primary,
+    colorBgLayout: '#f9f9f9',
+    colorBgContainer: '#ffffff',
+    colorBgElevated: '#ffffff',
+    colorBorder: '#d9d9d9',
+    colorBorderSecondary: '#f0f0f0',
+    colorText: '#202020',
+    colorTextSecondary: '#646464',
+    colorTextTertiary: '#8d8d8d',
+    colorTextQuaternary: '#bbbbbb',
+    borderRadius: 8,
+    borderRadiusSM: 4,
+    borderRadiusLG: 12,
+    fontFamily:
+      "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', 'Noto Sans SC', sans-serif",
+    fontSize: 14,
+    fontSizeLG: 16,
+    fontSizeSM: 13,
+    fontWeightStrong: 600,
+    lineHeight: 1.5715,
+    lineHeightLG: 1.5,
+    lineHeightSM: 1.5715,
+    controlHeight: 36,
+    controlHeightLG: 40,
+    controlHeightSM: 28,
+    paddingContentHorizontal: 16,
+    paddingContentHorizontalLG: 20,
+    paddingContentHorizontalSM: 12,
+    marginLG: 24,
+    marginMD: 16,
+    marginSM: 12,
+    marginXS: 8,
+  },
+  components: {
+    Button: {
+      borderRadius: 9999,
+      borderRadiusSM: 9999,
+      borderRadiusLG: 9999,
+      controlHeight: 36,
+      controlHeightLG: 40,
+      controlHeightSM: 28,
+      paddingInline: 16,
+      paddingInlineLG: 20,
+      paddingInlineSM: 12,
+      fontSize: 14,
+      fontSizeLG: 16,
+      fontSizeSM: 13,
+      fontWeight: 600,
+      primaryShadow: 'none',
+      defaultShadow: 'none',
+      dangerShadow: 'none',
+    },
+    Card: {
+      borderRadiusLG: 8,
+    },
+    Layout: {
+      headerBg: '#ffffff',
+      bodyBg: '#f9f9f9',
+    },
+    Tag: {
+      defaultBg: '#e6f7ed',
+      defaultColor: brandColors.primary,
+      fontSizeSM: 13,
+    },
+    Form: {
+      itemMarginBottom: 24,
+    },
+    Typography: {
+      titleMarginBottom: 16,
+      titleMarginTop: 0,
+    },
+  },
+}

package/src/theme/brand-colors.ts

@@ -0,0 +1,18 @@
+/**
+ * 品牌墨绿（Jade）唯一 hex 源
+ * CSS 侧通过 Radix --jade-* / 语义变量 --color-* 引用；Ant Design 从此文件同步
+ * 规范：front/design/ui/UI规范.md §2.2、§2.5
+ */
+export const brandColors = {
+  jade9: '#29a383',
+  jade10: '#26997b',
+  jade11: '#208368',
+  jade12: '#1d3b31',
+  /** 链接、边框、Logo 图形、实心底（与 primarySolid 同色） */
+  primary: '#208368',
+  /** Primary 实心按钮、Sider 胶囊、发布等 type="primary" */
+  primarySolid: '#208368',
+  primaryHover: '#26997b',
+  primaryActive: '#1d3b31',
+  onPrimary: '#ffffff',
+} as const