@frontend-engineering-system-lyz/ui 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2026] [Lyz]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @frontend-engineering-system-lyz/ui
+
+Shared React UI components for frontend-engineering-system.
+
+## Install
+
+```bash
+pnpm add @frontend-engineering-system-lyz/ui react react-dom
+```
+
+## Usage
+
+```tsx
+import { Button } from '@frontend-engineering-system-lyz/ui';
+import '@frontend-engineering-system-lyz/ui/styles.css';
+
+export function Example() {
+  return <Button>Save</Button>;
+}
+```

package/dist/Badge.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentPropsWithoutRef } from 'react';
+type BadgeVariant = 'neutral' | 'success' | 'warning' | 'danger' | 'brand';
+type BadgeProps = ComponentPropsWithoutRef<'span'> & {
+    variant?: BadgeVariant;
+};
+export declare function Badge({ variant, className, ...props }: BadgeProps): import("react").JSX.Element;
+export {};

package/dist/Button.d.ts

@@ -0,0 +1,44 @@
+import type { ComponentPropsWithoutRef } from 'react';
+import { type ButtonSize, type ButtonVariant } from './button-styles';
+/**
+ * Button 的 props。
+ *
+ * 前半部分 `ComponentPropsWithoutRef<'button'>` 的意思是：
+ * “把原生 `<button>` 支持的全部属性都继承过来”。
+ * 这样调用方可以直接写 `<Button disabled />`、`<Button aria-label="关闭" />`、
+ * `<Button onClick={...} />`，而不需要我们在这里把几十个原生属性逐个手写，
+ * 浏览器以后新增属性也能自动跟上。
+ *
+ * 为什么是 `WithoutRef`（去掉 ref）而不是 `ComponentProps`：
+ * `ref` 是 React 用来拿到真实 DOM 元素的特殊属性，需要配合 `forwardRef` 之类的写法才会生效。
+ * 当前这个 Button 并没有处理 `ref`，如果把它算进 props，就等于类型上“声称支持”，
+ * 实际调用方写了 `ref` 却没有任何效果。所以这里主动把 `ref` 排除掉。
+ * 将来若确实需要支持 ref，再改用 `forwardRef` 或 `ComponentPropsWithRef`。
+ *
+ * 末尾的 `& { ... }` 表示在原生属性之外，再补充 Button 自己新增的属性。
+ */
+type ButtonProps = ComponentPropsWithoutRef<'button'> & {
+    /** 视觉样式，默认 `'primary'` */
+    variant?: ButtonVariant;
+    /** 尺寸，默认 `'md'` */
+    size?: ButtonSize;
+};
+/**
+ * 基础按钮组件：在原生 `<button>` 之上提供 variant / size 两套视觉配置，
+ * 其余原生属性（type、disabled、onClick、aria-* 等）全部原样透传给真实 DOM。
+ *
+ * @example
+ * ```tsx
+ * // 输入：默认用法
+ * <Button onClick={handleSave}>保存</Button>
+ * // 输出：variant=primary、size=md、type=button 的主色按钮
+ *
+ * // 输入：指定样式并透传原生属性
+ * <Button variant="danger" size="sm" disabled aria-label="删除">
+ *   删除
+ * </Button>
+ * // 输出：危险色小号按钮，且 disabled / aria-label 在真实 DOM 上正常生效
+ * ```
+ */
+export declare function Button({ variant, size, className, type, ...props }: ButtonProps): import("react").JSX.Element;
+export {};

package/dist/Card.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+type CardProps = ComponentPropsWithoutRef<'section'> & {
+    title?: string;
+    description?: string;
+    footer?: ReactNode;
+};
+export declare function Card({ title, description, footer, children, className, ...props }: CardProps): import("react").JSX.Element;
+export {};

package/dist/PageTitle.d.ts

@@ -0,0 +1,6 @@
+type PageTitleProps = {
+    title: string;
+    subtitle?: string;
+};
+export declare function PageTitle({ title, subtitle }: PageTitleProps): import("react").JSX.Element;
+export {};

package/dist/button-styles.d.ts

@@ -0,0 +1,9 @@
+export type ButtonVariant = 'primary' | 'secondary' | 'danger' | 'ghost';
+export type ButtonSize = 'sm' | 'md' | 'lg';
+type ButtonClassNameOptions = {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    className?: string;
+};
+export declare function getButtonClassName({ variant, size, className, }?: ButtonClassNameOptions): string;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import './styles.css';
+export { Badge } from './Badge';
+export { Button } from './Button';
+export { Card } from './Card';
+export { PageTitle } from './PageTitle';
+export { getButtonClassName } from './button-styles';
+export type { ButtonSize, ButtonVariant } from './button-styles';

package/dist/index.js

@@ -0,0 +1,93 @@
+import { jsx as e, jsxs as t } from "react/jsx-runtime";
+//#region src/Badge.tsx
+var n = {
+	neutral: "bg-surface-100 text-surface-900",
+	success: "bg-success-50 text-success-700",
+	warning: "bg-warning-50 text-warning-700",
+	danger: "bg-danger-50 text-danger-700",
+	brand: "bg-brand-50 text-brand-700"
+};
+function r({ variant: t = "neutral", className: r, ...i }) {
+	return /* @__PURE__ */ e("span", {
+		className: [
+			"inline-flex items-center rounded-full px-2.5 py-0.5 text-xs font-semibold",
+			n[t],
+			r
+		].filter(Boolean).join(" "),
+		...i
+	});
+}
+//#endregion
+//#region src/button-styles.ts
+var i = "inline-flex items-center justify-center rounded-md font-medium transition-colors disabled:cursor-not-allowed disabled:opacity-60", a = {
+	primary: "bg-brand-600 text-surface-0 hover:bg-brand-700",
+	secondary: "bg-surface-100 text-surface-900 hover:bg-surface-50",
+	danger: "bg-danger-700 text-surface-0 hover:bg-danger-700/90",
+	ghost: "bg-transparent text-surface-900 hover:bg-surface-100"
+}, o = {
+	sm: "px-3 py-1.5 text-sm",
+	md: "px-4 py-2 text-sm",
+	lg: "px-5 py-2.5 text-base"
+};
+function s({ variant: e = "primary", size: t = "md", className: n } = {}) {
+	return [
+		i,
+		a[e],
+		o[t],
+		n
+	].filter(Boolean).join(" ");
+}
+//#endregion
+//#region src/Button.tsx
+function c({ variant: t = "primary", size: n = "md", className: r, type: i = "button", ...a }) {
+	return /* @__PURE__ */ e("button", {
+		className: s({
+			variant: t,
+			size: n,
+			className: r
+		}),
+		type: i,
+		...a
+	});
+}
+//#endregion
+//#region src/Card.tsx
+function l({ title: n, description: r, footer: i, children: a, className: o, ...s }) {
+	return /* @__PURE__ */ t("section", {
+		className: ["rounded-(--radius-card) border border-surface-100 bg-surface-0 p-6 shadow-sm", o].filter(Boolean).join(" "),
+		...s,
+		children: [
+			n || r ? /* @__PURE__ */ t("header", {
+				className: "mb-4",
+				children: [n ? /* @__PURE__ */ e("h2", {
+					className: "text-base font-semibold text-surface-900",
+					children: n
+				}) : null, r ? /* @__PURE__ */ e("p", {
+					className: "mt-1 text-sm text-surface-900/70",
+					children: r
+				}) : null]
+			}) : null,
+			a,
+			i ? /* @__PURE__ */ e("footer", {
+				className: "mt-4",
+				children: i
+			}) : null
+		]
+	});
+}
+//#endregion
+//#region src/PageTitle.tsx
+function u({ title: n, subtitle: r }) {
+	return /* @__PURE__ */ t("section", {
+		className: "mb-6",
+		children: [/* @__PURE__ */ e("h1", {
+			className: "text-3xl font-semibold tracking-tight text-surface-900",
+			children: n
+		}), r ? /* @__PURE__ */ e("p", {
+			className: "mt-2 max-w-2xl text-sm leading-6 text-surface-900/70",
+			children: r
+		}) : null]
+	});
+}
+//#endregion
+export { r as Badge, c as Button, l as Card, u as PageTitle, s as getButtonClassName };

package/dist/styles.css

@@ -0,0 +1,3 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000}}}@layer theme{:root,:host{--font-sans:Inter, ui-sans-serif, system-ui, sans-serif;--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--spacing:.25rem;--container-2xl:42rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-base:1rem;--text-base--line-height:calc(1.5 / 1);--text-3xl:1.875rem;--text-3xl--line-height:calc(2.25 / 1.875);--font-weight-medium:500;--font-weight-semibold:600;--tracking-tight:-.025em;--radius-md:.375rem;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono);--color-brand-50:#eff6ff;--color-brand-600:#2563eb;--color-brand-700:#1d4ed8;--color-surface-0:#fff;--color-surface-50:#f8fafc;--color-surface-100:#f1f5f9;--color-surface-900:#0f172a;--color-success-50:#ecfdf5;--color-success-700:#047857;--color-warning-50:#fffbeb;--color-warning-700:#b45309;--color-danger-50:#fef2f2;--color-danger-700:#b91c1c;--radius-card:.75rem}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.mt-1{margin-top:var(--spacing)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mt-4{margin-top:calc(var(--spacing) * 4)}.mb-4{margin-bottom:calc(var(--spacing) * 4)}.mb-6{margin-bottom:calc(var(--spacing) * 6)}.inline-flex{display:inline-flex}.max-w-2xl{max-width:var(--container-2xl)}.items-center{align-items:center}.justify-center{justify-content:center}.rounded-\(--radius-card\){border-radius:var(--radius-card)}.rounded-full{border-radius:2147483647px}.rounded-md{border-radius:var(--radius-md)}.border{border-style:var(--tw-border-style);border-width:1px}.border-surface-100{border-color:var(--color-surface-100)}.bg-brand-50{background-color:var(--color-brand-50)}.bg-brand-600{background-color:var(--color-brand-600)}.bg-danger-50{background-color:var(--color-danger-50)}.bg-danger-700{background-color:var(--color-danger-700)}.bg-success-50{background-color:var(--color-success-50)}.bg-surface-0{background-color:var(--color-surface-0)}.bg-surface-100{background-color:var(--color-surface-100)}.bg-transparent{background-color:#0000}.bg-warning-50{background-color:var(--color-warning-50)}.p-6{padding:calc(var(--spacing) * 6)}.px-2\.5{padding-inline:calc(var(--spacing) * 2.5)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-4{padding-inline:calc(var(--spacing) * 4)}.px-5{padding-inline:calc(var(--spacing) * 5)}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-2\.5{padding-block:calc(var(--spacing) * 2.5)}.text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.leading-6{--tw-leading:calc(var(--spacing) * 6);line-height:calc(var(--spacing) * 6)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.text-brand-700{color:var(--color-brand-700)}.text-danger-700{color:var(--color-danger-700)}.text-success-700{color:var(--color-success-700)}.text-surface-0{color:var(--color-surface-0)}.text-surface-900{color:var(--color-surface-900)}.text-surface-900\/70{color:#0f172ab3}@supports (color:color-mix(in lab, red, red)){.text-surface-900\/70{color:color-mix(in oklab, var(--color-surface-900) 70%, transparent)}}.text-warning-700{color:var(--color-warning-700)}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}@media (hover:hover){.hover\:bg-brand-700:hover{background-color:var(--color-brand-700)}.hover\:bg-danger-700\/90:hover{background-color:#b91c1ce6}@supports (color:color-mix(in lab, red, red)){.hover\:bg-danger-700\/90:hover{background-color:color-mix(in oklab, var(--color-danger-700) 90%, transparent)}}.hover\:bg-surface-50:hover{background-color:var(--color-surface-50)}.hover\:bg-surface-100:hover{background-color:var(--color-surface-100)}}.disabled\:cursor-not-allowed:disabled{cursor:not-allowed}.disabled\:opacity-60:disabled{opacity:.6}}:root{color:var(--color-surface-900);background:var(--color-surface-50);font-family:var(--font-sans)}*{box-sizing:border-box}body{margin:0}button,input,textarea,select{font:inherit}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}
+/*$vite$:1*/

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@frontend-engineering-system-lyz/ui",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7"
+  },
+  "devDependencies": {
+    "@storybook/react-vite": "^10.6.1",
+    "@tailwindcss/vite": "^4.3.3",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.1.0",
+    "eslint": "^10.6.0",
+    "eslint-plugin-storybook": "^10.6.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "storybook": "^10.6.1",
+    "tailwindcss": "^4.3.3",
+    "typescript": "~6.0.2",
+    "vite": "^8.2.2",
+    "@frontend-engineering-system-lyz/eslint-config": "0.0.0",
+    "@frontend-engineering-system-lyz/ts-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "pnpm build:js && pnpm build:types",
+    "build:js": "vite build",
+    "build:types": "tsc -p tsconfig.build.json",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "pack:check": "npm pack --dry-run"
+  }
+}