npm - @huaqiu/component-gen-app - Versions diffs - 0.3.6 - Mend

@huaqiu/component-gen-app 0.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/LICENSE +21 -0
package/dist/assets/index-DTShI_jq.js +553 -0
package/dist/index.html +12 -0
package/lib/index.d.ts +427 -0
package/lib/index.js +2550 -0
package/package.json +48 -0
package/src/App.tsx +101 -0
package/src/api/component-gen-client.ts +225 -0
package/src/components/GeometryEditor.tsx +418 -0
package/src/components/HistoryPanel.tsx +119 -0
package/src/components/PreviewStage.tsx +67 -0
package/src/components/ResultStage.tsx +92 -0
package/src/components/UploadInput.tsx +121 -0
package/src/copy/en.ts +150 -0
package/src/copy/index.ts +50 -0
package/src/copy/zh.ts +154 -0
package/src/hooks/useAuthGate.ts +51 -0
package/src/hooks/useJobRunner.ts +127 -0
package/src/index.ts +37 -0
package/src/main.tsx +85 -0
package/src/pages/FootprintGenPage.tsx +185 -0
package/src/pages/SymbolGenPage.tsx +136 -0
package/src/ports.ts +149 -0
package/src/styles/inject.ts +124 -0
package/src/utils/dims.ts +266 -0
package/src/utils/ecad.ts +91 -0
package/src/utils/labels.ts +76 -0

package/dist/index.html ADDED Viewed

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>华秋 Component Gen</title>
+    <script type="module" crossorigin src="./assets/index-DTShI_jq.js"></script>
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/lib/index.d.ts ADDED Viewed

@@ -0,0 +1,427 @@
+import { ReactElement } from "react";
+//#region src/ports.d.ts
+/**
+ * `@huaqiu/component-gen-app` — the whole contract between the portable app
+ * and its host (DSH adapter or standalone server).
+ *
+ * The app has ZERO DSH imports. It only knows this ports interface. Two
+ * adapters implement it with the same HTTP client against different origins:
+ *
+ *   - DSH adapter  → `createDshPorts()` in `dsh-tool-symbol-footprint`, fetch
+ *     to `/api/v1/huaqiu/component-gen/*` (plugin-owned webServer route).
+ *   - Standalone   → `createHttpPorts()` in `api/component-gen-client.ts`,
+ *     fetch to `http://localhost:<port>/api/v1/huaqiu/component-gen/*`.
+ */
+type ComponentGenPage = 'symbol' | 'footprint';
+type JobKind = 'symbol' | 'extract-footprint' | 'generate-footprint';
+type JobStatus = 'queued' | 'running' | 'needs_confirmation' | 'completed' | 'failed' | 'cancelled';
+interface JobInput {
+  /** data URL of the uploaded image (server stores a thumbnail into history). */
+  imageDataUrl?: string;
+  instruction?: string;
+  packageType?: string;
+  dimensions?: Record<string, number>;
+  fileName?: string;
+  /** which dimensions the human edited (footprint confirmations). */
+  edited?: Record<string, boolean>;
+}
+interface JobState {
+  id: string;
+  kind: JobKind;
+  status: JobStatus;
+  progress?: string;
+  /** structured result of the generation function (status/kind/fileUrl/...). */
+  result?: Record<string, unknown>;
+  /** extracted dimensions for the `needs_confirmation` phase. */
+  dimensions?: Record<string, unknown>;
+  pkgType?: string | null;
+  fileName?: string | null;
+  error?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+type JobEvent = {
+  type: 'progress';
+  message: string;
+  at: string;
+} | {
+  type: 'needs_confirmation';
+  dimensions: Record<string, unknown>;
+  pkgType?: string | null;
+  fileName?: string | null;
+  at: string;
+} | {
+  type: 'completed';
+  job: JobState;
+  at: string;
+} | {
+  type: 'failed';
+  error: string;
+  result?: Record<string, unknown>;
+  at: string;
+} | {
+  type: 'cancelled';
+  at: string;
+};
+interface StartJobRequest {
+  kind: JobKind;
+  input: JobInput;
+}
+interface HistoryQuery {
+  limit?: number;
+  cursor?: string | null;
+}
+interface HistoryPage {
+  entries: HistoryEntry[];
+  nextCursor?: string | null;
+}
+interface HistoryEntry {
+  id: string;
+  kind: 'symbol' | 'footprint';
+  createdAt: string;
+  status: 'generated' | 'failed' | 'cancelled';
+  input: {
+    imageId?: string;
+    instruction?: string;
+    packageType?: string;
+    dimensions?: Record<string, number>;
+  };
+  /** which dimensions the human edited (footprint confirmations). */
+  edited?: Record<string, boolean>;
+  result?: {
+    artifactId: string;
+    filename: string;
+    fileUrl?: string;
+    size?: number;
+  };
+  error?: string;
+}
+interface HistoryPatch {
+  status?: HistoryEntry['status'];
+  result?: HistoryEntry['result'];
+  error?: string;
+  edited?: Record<string, boolean>;
+}
+/** Request to reopen a generated history entry in the active generation page. */
+interface ReopenRequest {
+  /** monotonically increasing so re-clicking the same entry re-applies. */
+  n: number;
+  entry: HistoryEntry;
+}
+interface ComponentGenConfig {
+  hostMode: boolean;
+  capabilities: {
+    symbol: boolean;
+    footprint: boolean;
+  };
+  limits: {
+    /** max accepted input image bytes. */
+    imageBytes: number;
+  };
+}
+/** Auth capability consumed through the public `@huaqiu/dsh-auth` surface. */
+interface ComponentGenAuthPort {
+  isAuthenticated(): Promise<boolean>;
+  getUserInfo(): Promise<{
+    nickname?: string;
+  } | null>;
+  /** Trigger the existing dsh-auth login flow (host-owned). */
+  login(): Promise<void>;
+  onAuthStateChanged(listener: (authenticated: boolean) => void): () => void;
+}
+/** The whole contract the app needs from its host. */
+interface ComponentGenPorts {
+  config(): Promise<ComponentGenConfig>;
+  startJob(req: StartJobRequest, signal?: AbortSignal): Promise<JobState>;
+  jobEvents(jobId: string, onEvent: (e: JobEvent) => void): () => void;
+  abortJob(jobId: string): Promise<void>;
+  history(query: HistoryQuery): Promise<HistoryPage>;
+  historyEntry(id: string): Promise<HistoryEntry | null>;
+  patchHistory(id: string, patch: HistoryPatch): Promise<HistoryEntry>;
+  deleteHistory(id: string): Promise<void>;
+  /** raw artifact text for preview (from `@huaqiu/dsh-artifacts` routes). */
+  artifactContent(artifactId: string): Promise<string>;
+  /** data URL of a stored input thumbnail. */
+  inputImage(imageId: string): Promise<string>;
+  auth: ComponentGenAuthPort;
+}
+//#endregion
+//#region src/App.d.ts
+interface ComponentGenAppProps {
+  ports: ComponentGenPorts;
+  page: ComponentGenPage;
+  /** host UI language: 'zh' | 'en' (default zh). */
+  lang?: string;
+  onClose?: () => void;
+}
+declare function ComponentGenApp(props: ComponentGenAppProps): ReactElement;
+//#endregion
+//#region src/copy/zh.d.ts
+/**
+ * `@huaqiu/component-gen-app` — zh copy pack (fallback everywhere).
+ *
+ * House i18n convention (`dsh-pcb-eda`): `ZH as const` → `CopyKey` →
+ * `EN: Record<CopyKey, string>` so a missing EN key is a compile error.
+ * Punctuation is i18n too（中文全角：；）.
+ */
+declare const ZH: {
+  readonly app: {
+    readonly title: "华秋元器件生成";
+    readonly symbolTitle: "符号生成";
+    readonly footprintTitle: "封装生成";
+    readonly footprintTooltip: "打开封装生成";
+    readonly symbolTooltip: "打开符号生成";
+    readonly close: "关闭";
+    readonly back: "返回";
+    readonly loading: "加载中…";
+    readonly error: "出错了";
+    readonly unknownError: "未知错误";
+  };
+  readonly upload: {
+    readonly drop: "拖拽图片到此处，或点击上传";
+    readonly paste: "也可直接 Ctrl/⌘+V 粘贴图片";
+    readonly browse: "选择图片";
+    readonly imageTooLarge: "图片过大，请使用 4MiB 以内的图片";
+    readonly noImage: "请先上传图片";
+    readonly replace: "更换图片";
+    readonly uploading: "上传中…";
+    readonly hint: "提示";
+  };
+  readonly symbol: {
+    readonly generate: "生成符号";
+    readonly regenerate: "重新生成";
+    readonly instructionPlaceholder: "可选：补充生成说明，如“3 引脚 LDO，引脚 1 为 VIN”";
+    readonly progress: "正在生成符号…";
+    readonly ready: "生成完成";
+    readonly failed: "生成失败";
+    readonly download: "下载 .kicad_sym";
+    readonly save: "保存到历史";
+    readonly saved: "已保存到历史";
+  };
+  readonly footprint: {
+    readonly extract: "提取尺寸";
+    readonly generate: "生成封装";
+    readonly regenerate: "重新生成";
+    readonly hintPlaceholder: "可选：封装类型提示，如 BGA / QFN / SOP";
+    readonly extractProgress: "正在提取封装尺寸…";
+    readonly generateProgress: "正在生成封装…";
+    readonly ready: "生成完成";
+    readonly failed: "生成失败";
+    readonly needsConfirmation: "请确认或修改提取到的封装尺寸";
+    readonly download: "下载 .kicad_mod";
+    readonly save: "保存到历史";
+    readonly saved: "已保存到历史";
+    readonly directGenerated: "已自动生成标准封装，可预览后下载";
+    readonly autoGenerated: "自动生成";
+    readonly confirm: "确认并生成";
+    readonly cancel: "取消";
+  };
+  readonly editor: {
+    readonly essential: "基本参数";
+    readonly advanced: "高级参数";
+    readonly width: "宽度";
+    readonly height: "长度";
+    readonly pinCount: "引脚数";
+    readonly pitch: "间距";
+    readonly packageType: "封装类型";
+    readonly fileName: "文件名";
+    readonly editedTag: "已修改";
+    readonly aiTag: "AI 提取";
+    readonly dragHint: "拖动控制柄调整 W / H";
+    readonly validationOutOfRange: "超出范围";
+    readonly validationMinGtMax: "最小值大于最大值";
+    readonly validationInvalid: "无效数值";
+    readonly unit: "mm";
+    readonly body: "本体";
+    readonly pins: "{count} 引脚";
+    readonly validationIssue: "{n} 处数值需要修正";
+    readonly validationOk: "数值有效";
+    readonly issueOutOfRange: "超出允许范围";
+    readonly issueMinGtMax: "最小值大于最大值";
+    readonly confirmLabel: "确认";
+    readonly cancelLabel: "取消";
+  };
+  readonly field: {
+    readonly width: "宽度";
+    readonly height: "长度";
+    readonly length: "长度";
+    readonly depth: "深度";
+    readonly span: "跨距";
+    readonly bodyWidth: "本体宽度";
+    readonly bodyLength: "本体长度";
+    readonly bodyHeight: "本体高度";
+    readonly boardWidth: "板宽";
+    readonly boardHeight: "板高";
+    readonly overallWidth: "总宽度";
+    readonly overallLength: "总长度";
+    readonly overallHeight: "总高度";
+    readonly pitch: "间距";
+    readonly pitchX: "X 间距";
+    readonly pitchY: "Y 间距";
+    readonly leadPitch: "引线间距";
+    readonly padWidth: "焊盘宽";
+    readonly padLength: "焊盘长";
+    readonly padHeight: "焊盘高";
+    readonly leadWidth: "引线宽";
+    readonly leadLength: "引线长";
+    readonly leadSpan: "引线跨距";
+    readonly pinCount: "引脚数";
+    readonly rows: "行数";
+    readonly columns: "列数";
+    readonly standoff: "离地高度";
+    readonly maxOf: "{field} 最大值";
+    readonly minOf: "{field} 最小值";
+  };
+  readonly history: {
+    readonly title: "历史记录";
+    readonly empty: "暂无历史";
+    readonly symbol: "符号";
+    readonly footprint: "封装";
+    readonly generated: "已生成";
+    readonly failed: "失败";
+    readonly cancelled: "已取消";
+    readonly rename: "重命名";
+    readonly delete: "删除";
+    readonly download: "下载";
+    readonly reopen: "打开";
+    readonly view: "查看历史";
+    readonly createdAt: "创建时间";
+    readonly loadMore: "加载更多";
+    readonly noMore: "没有更多了";
+  };
+  readonly auth: {
+    readonly notLoggedIn: "未登录华秋账号";
+    readonly login: "登录华秋 EDA";
+    readonly loginRequired: "该功能需要登录华秋 EDA 账号";
+    readonly loggedIn: "已登录";
+  };
+  readonly status: {
+    readonly queued: "排队中";
+    readonly running: "进行中";
+    readonly needsConfirmation: "待确认";
+    readonly completed: "已完成";
+    readonly failed: "失败";
+    readonly cancelled: "已取消";
+  };
+};
+//#endregion
+//#region src/copy/en.d.ts
+type DeepStrings<T> = { [K in keyof T]: T[K] extends string ? string : DeepStrings<T[K]>; };
+declare const EN: DeepStrings<typeof ZH>;
+//#endregion
+//#region src/copy/index.d.ts
+type Translate = (key: string, params?: Record<string, unknown>) => string;
+declare function translate(lang: string | undefined, key: string, params?: Record<string, unknown>): string;
+/** Build a `(key, params?) => string` resolver for a given language. */
+declare function translateFor(lang: string | undefined): Translate;
+/** zh-only fallback (used when no locale is supplied). */
+declare const defaultT: Translate;
+//#endregion
+//#region src/pages/SymbolGenPage.d.ts
+interface SymbolGenPageProps {
+  ports: ComponentGenPorts;
+  t: Translate;
+  /** reopen a generated history entry into the completed stage. */
+  reopen?: ReopenRequest | null;
+  /** the app calls back to switch tabs (not used on the symbol page). */
+  onClose?: () => void;
+}
+declare function SymbolGenPage({ ports, t, reopen }: SymbolGenPageProps): ReactElement;
+//#endregion
+//#region src/pages/FootprintGenPage.d.ts
+interface FootprintGenPageProps {
+  ports: ComponentGenPorts;
+  t: Translate;
+  /** reopen a generated history entry into the completed stage. */
+  reopen?: ReopenRequest | null;
+}
+declare function FootprintGenPage({ ports, t, reopen }: FootprintGenPageProps): ReactElement;
+//#endregion
+//#region src/utils/dims.d.ts
+/** A dimension map with all scalar values coerced to numbers. */
+type DimensionValues = Record<string, number>;
+//#endregion
+//#region src/components/GeometryEditor.d.ts
+interface GeometryEditorProps {
+  dimensions: Record<string, unknown>;
+  pkgType?: string | null;
+  fileName?: string | null;
+  disabled?: boolean;
+  t: Translate;
+  onConfirm: (values: DimensionValues, edited: Record<string, boolean>) => void;
+  onCancel: () => void;
+}
+declare const GeometryEditor: import("react").NamedExoticComponent<GeometryEditorProps>;
+//#endregion
+//#region src/components/PreviewStage.d.ts
+interface PreviewStageProps {
+  kind: string | null;
+  content: string;
+  srcKey: string | null;
+  t: Translate;
+}
+declare function PreviewStage({ kind, content, srcKey, t }: PreviewStageProps): ReactElement;
+//#endregion
+//#region src/components/ResultStage.d.ts
+interface ResultStageProps {
+  ports: ComponentGenPorts;
+  kind: 'symbol' | 'footprint';
+  result: Record<string, unknown>;
+  t: Translate;
+  /** bump to force a re-render of the preview for a new result. */
+  srcKey: string;
+}
+declare function ResultStage({ ports, kind, result, t, srcKey }: ResultStageProps): ReactElement;
+//#endregion
+//#region src/components/UploadInput.d.ts
+interface UploadInputProps {
+  maxBytes: number;
+  t: Translate;
+  disabled?: boolean;
+  imageDataUrl?: string | null;
+  /** original file, for the server to store into history. */
+  file?: File | null;
+  onFile: (file: File | null, dataUrl: string | null) => void;
+}
+/** Downscale an image file to a data URL bounded in edge + bytes. */
+declare function fileToDataUrl(file: File, maxBytes: number): Promise<string>;
+declare function UploadInput(props: UploadInputProps): ReactElement;
+//#endregion
+//#region src/components/HistoryPanel.d.ts
+interface HistoryPanelProps {
+  ports: ComponentGenPorts;
+  t: Translate;
+  activeKind?: 'symbol' | 'footprint' | null;
+  onReopen: (entry: HistoryEntry) => void;
+}
+declare function HistoryPanel({ ports, t, activeKind, onReopen }: HistoryPanelProps): ReactElement;
+//#endregion
+//#region src/api/component-gen-client.d.ts
+interface HttpPortsOptions {
+  /** component-gen API base, e.g. `/api/v1/huaqiu/component-gen`. */
+  base: string;
+  /** artifacts API base, e.g. `/api/v1/huaqiu/artifacts` (same origin). */
+  artifactsBase?: string;
+  doFetch?: typeof fetch;
+  auth?: ComponentGenAuthPort;
+}
+/** The shared fetch client. */
+declare function createHttpPorts(options: HttpPortsOptions): ComponentGenPorts;
+/** Derive the artifacts base from the component-gen base path. */
+declare function defaultArtifactsBase(componentGenBase: string): string;
+//#endregion
+//#region src/styles/inject.d.ts
+/**
+ * `@huaqiu/component-gen-app` — scoped stylesheet.
+ *
+ * Injected as a `<style>` tag (never a CSS import) so both build surfaces work:
+ * the standalone vite bundle AND the DSH client-module bundle (tsdown has no
+ * CSS pipeline). Reuses the `hq-genhit__*` class vocabulary (shared with
+ * `dsh-tool-symbol-footprint`) plus an `cga-*` app-shell layer. Uses the same
+ * DSW design tokens so the app follows the host palette in DSH.
+ */
+declare const APP_STYLE_ID = "hq-cga-styles";
+declare function injectAppStyles(): void;
+declare function removeAppStyles(): void;
+//#endregion
+export { APP_STYLE_ID, ComponentGenApp, type ComponentGenAppProps, type ComponentGenAuthPort, type ComponentGenConfig, type ComponentGenPage, type ComponentGenPorts, EN, FootprintGenPage, type FootprintGenPageProps, GeometryEditor, type GeometryEditorProps, type HistoryEntry, type HistoryPage, HistoryPanel, type HistoryPanelProps, type HistoryPatch, type HistoryQuery, type HttpPortsOptions, type JobEvent, type JobInput, type JobKind, type JobState, PreviewStage, type PreviewStageProps, ResultStage, type ResultStageProps, type StartJobRequest, SymbolGenPage, type SymbolGenPageProps, type Translate, UploadInput, type UploadInputProps, ZH, createHttpPorts, defaultArtifactsBase, defaultT, fileToDataUrl, injectAppStyles, removeAppStyles, translate, translateFor };