@q1travel/design-system 0.25.1 → 0.26.1

package/README.md

@@ -98,6 +98,8 @@ npm run dev
 
 **技术栈**：React 19 · TypeScript · Vite 7（文档站 / 库双构建管线）· lucide-react · npm
 
+**Token 刻度原则**：目标是刻度纯粹、正交，而不是冻结。字号、行高、控件高度、圆角等刻度以 Geist 原生档位为基准，Geist 有而本仓缺失的档位可以补齐。业务页面参考其他产品时，只借鉴页面布局、信息架构与间距节奏，并映射到现有档位；仅为贴合某个产品像素而插入孤立私有尺寸的请求，设计系统直接拒绝，无需上报。确有通用诉求、且契合现有比例与刻度演进的新档位，仍走正常的规范评审。完整规则见 `contracts/token-naming.md` 的 Scale Governance。
+
 ### Sources
 
 - Source contracts（设计契约源，canonical）：`contracts/design.md`、`contracts/design.dark.md`、`contracts/token-naming.md`、`contracts/icon-system.md`、`contracts/button-api-compatibility.md`、`contracts/interface-guidelines.md`、`contracts/design-engineering-principles.md`、`contracts/implementation-map.md`、`contracts/overlay-foundation.md`，以及迁移契约 `contracts/context-contrast-migration.md`、`contracts/status-chip-badge-migration.md`、`contracts/pagination-migration.md`、`contracts/table-migration.md`、`contracts/overlay-shadow-migration.md`。独立 HTML 文档的有界 class 词汇表源为 `contracts/design.css`。

package/contracts/design.dark.md

@@ -267,6 +267,12 @@ typography:
     fontWeight: 400
     lineHeight: 18px
     letterSpacing: 0
+  label-12:
+    fontFamily: Noto Sans SC
+    fontSize: 12px
+    fontWeight: 400
+    lineHeight: 16px
+    letterSpacing: 0
   copy-16:
     fontFamily: Noto Sans SC
     fontSize: 16px

package/contracts/design.md

@@ -267,6 +267,12 @@ typography:
     fontWeight: 400
     lineHeight: 18px
     letterSpacing: 0
+  label-12:
+    fontFamily: Noto Sans SC
+    fontSize: 12px
+    fontWeight: 400
+    lineHeight: 16px
+    letterSpacing: 0
   copy-16:
     fontFamily: Noto Sans SC
     fontSize: 16px

package/contracts/token-naming.md

@@ -165,6 +165,12 @@ gets an input with no border and no background.
 - Shadow tokens should be displayed as token references, not as color swatches.
 - Theme-specific values may differ, but token names must stay stable across light and dark themes.
 
+## Scale Governance
+
+- The goal is a pure, orthogonal scale, not a frozen one. The size, typography, radius, and control-height scales are based on Geist's native steps; a step Geist defines and q1travel lacks may be filled (for example `label-12`, 12px / 16px).
+- Product surfaces may take page layout, information architecture, and spacing rhythm from other products, but MUST map them onto existing steps. A request to add an isolated, non-standard step only so one surface matches another product's pixels is declined by the design system without escalation.
+- A genuine, reusable need that fits the existing ratios and evolves the scale orthogonally still goes through normal design review. A new step must serve many surfaces, not close a gap of a few pixels on one page.
+
 ## Migration Rules
 
 - Do not create new public `--ds-*` tokens.

package/dist-pkg/design-system.d.ts

@@ -965,13 +965,11 @@ export declare type ExternalOverlayRegistration = {
     getContainer: () => HTMLElement | null;
 };
 
-export declare function Feedback({ label, prompt, placeholder, inline, topics, onSubmit, disabled, }: FeedbackProps): JSX.Element;
+export declare function Feedback({ label, prompt, inline, topics, onSubmit, disabled, }: FeedbackProps): JSX.Element;
 
 export declare interface FeedbackProps {
     label?: string;
     prompt?: string;
-    /** textarea 占位：换成更具体的引导，帮助用户知道从哪里说起。 */
-    placeholder?: string;
     inline?: boolean;
     topics?: string[];
     onSubmit?: (payload: FeedbackSubmitPayload) => void | Promise<void>;
@@ -1333,7 +1331,7 @@ declare type MentionQuery = (query: string, options: {
     signal: AbortSignal;
 }) => Promise<ComposerMention[]>;
 
-export declare function Menu({ label, entries, withChevron, align, triggerContent, size }: {
+export declare function Menu({ label, entries, withChevron, align, triggerContent, prefix, size }: {
     label: string;
     /** 文字触发器尺寸，默认 md；图标触发器保留原尺寸。 */
     size?: ButtonSize;
@@ -1342,6 +1340,8 @@ export declare function Menu({ label, entries, withChevron, align, triggerConten
     align?: 'start' | 'end';
     /** 自定义触发器内容（如纯图标）；label 始终作为可访问名称的兜底，图标-only 时经 aria-label 暴露。 */
     triggerContent?: ReactNode;
+    /** 文字触发器的前置图标，与 Button 的 prefix 一致；仍按文字触发器的尺寸与内边距渲染，传了 triggerContent 时忽略。 */
+    prefix?: ReactNode;
 }): JSX.Element;
 
 export declare type MenuEntry = (MenuItemBase & {
@@ -1603,25 +1603,21 @@ export declare type OverlaySnapshot = {
     readonly blockingCount: number;
 };
 
-export declare function PageFeedback({ variant, onSubmit, contactConsent, privacyHref }: PageFeedbackProps): JSX.Element;
+export declare function PageFeedback({ variant, onSubmit }: PageFeedbackProps): JSX.Element;
 
 export declare type PageFeedbackPayload = {
     scale: 'rating4';
     rating: PageFeedbackRating;
     comment: string;
-    contactConsent: boolean;
 } | {
     scale: 'helpful';
     rating: 'yes' | 'no';
     comment: string;
-    contactConsent: boolean;
 };
 
 export declare type PageFeedbackProps = {
     variant: 'rating' | 'helpful';
     onSubmit: (payload: PageFeedbackPayload) => Promise<void>;
-    contactConsent?: boolean;
-    privacyHref?: string;
 };
 
 export declare type PageFeedbackRating = 'not-great' | 'okay' | 'good' | 'love';