@locode2/harness 0.1.0-preview.1

package/bundled-plugins/fast-frontend/runtimes/antd-admin/types/runtime.d.ts

@@ -0,0 +1,227 @@
+declare module "@harness/frontend-runtime" {
+  import type {
+    ComponentType,
+    CSSProperties,
+    Dispatch,
+    Key,
+    LazyExoticComponent,
+    PropsWithChildren,
+    ReactNode,
+    SetStateAction,
+  } from "react";
+  import type {
+    CardProps,
+    DrawerProps,
+    FormInstance,
+    FormProps,
+    RowProps,
+    StatisticProps,
+    TableProps,
+    TagProps,
+  } from "antd";
+
+  export interface FrontendAppTheme {
+    readonly colorPrimary?: string;
+    readonly borderRadius?: number;
+    readonly compact?: boolean;
+  }
+
+  export interface FrontendBusinessAppManifest {
+    readonly name?: string;
+    /** Project-relative URL below `./generated/`; remote URLs are forbidden. */
+    readonly logo?: string;
+    readonly theme?: FrontendAppTheme;
+  }
+
+  export interface FrontendRouteMetadata {
+    readonly id: string;
+    readonly path: string;
+    readonly title: string;
+    readonly icon?: string;
+    readonly order?: number;
+    readonly parentId?: string;
+    readonly hidden?: boolean;
+  }
+
+  export type FrontendPageComponent = ComponentType<Record<string, never>>;
+  export type FrontendLazyPageComponent = LazyExoticComponent<FrontendPageComponent>;
+  export type FrontendRuntimeProvider = ComponentType<PropsWithChildren>;
+
+  export interface FrontendBusinessRoute {
+    readonly metadata: FrontendRouteMetadata;
+    readonly Component: FrontendLazyPageComponent;
+  }
+
+  export interface FrontendRuntimeApi {
+    readonly app: FrontendBusinessAppManifest;
+    readonly routes: readonly FrontendRouteMetadata[];
+    readonly currentPath: string;
+    navigate(to: string): void;
+  }
+
+  export interface FrontendStorage {
+    readonly length: number;
+    clear(): void;
+    getItem(key: string): string | null;
+    key(index: number): string | null;
+    removeItem(key: string): void;
+    setItem(key: string, value: string): void;
+  }
+
+  export type FrontendPageWidth = "standard" | "wide" | "full";
+
+  export interface FrontendShellUser {
+    readonly name: ReactNode;
+    readonly description?: ReactNode;
+    readonly avatar?: ReactNode;
+  }
+
+  export interface FrontendShellOptions {
+    readonly headerActions?: ReactNode;
+    readonly currentUser?: FrontendShellUser;
+    readonly userSwitcher?: ReactNode;
+  }
+
+  export interface FrontendPageOptions {
+    readonly title?: ReactNode;
+    readonly description?: ReactNode;
+    readonly titleActions?: ReactNode;
+    readonly width?: FrontendPageWidth;
+  }
+
+  export type FrontendShellProviderProps = PropsWithChildren<FrontendShellOptions>;
+
+  export function useFrontendShell(options: FrontendShellOptions): void;
+
+  export function useFrontendPage(options: FrontendPageOptions): void;
+
+  export function FrontendShellProvider(props: FrontendShellProviderProps): ReactNode;
+
+  export interface PageContainerProps extends PropsWithChildren<FrontendPageOptions> {
+    readonly className?: string;
+    readonly style?: CSSProperties;
+  }
+
+  export function PageContainer(props: PageContainerProps): ReactNode;
+
+  export interface FrontendMetric {
+    readonly key: Key;
+    readonly title: ReactNode;
+    readonly value: StatisticProps["value"];
+    readonly prefix?: ReactNode;
+    readonly suffix?: ReactNode;
+    readonly precision?: number;
+    readonly valueStyle?: CSSProperties;
+    readonly description?: ReactNode;
+    readonly loading?: boolean;
+  }
+
+  export interface MetricGridProps {
+    readonly items: readonly FrontendMetric[];
+    readonly columns?: 1 | 2 | 3 | 4 | 6;
+    readonly gutter?: RowProps["gutter"];
+    readonly className?: string;
+    readonly style?: CSSProperties;
+  }
+
+  export function MetricGrid(props: MetricGridProps): ReactNode;
+
+  export interface DataTableProps<RecordType extends object = Record<string, unknown>>
+    extends Omit<TableProps<RecordType>, "title"> {
+    readonly title?: ReactNode;
+    readonly description?: ReactNode;
+    readonly toolbar?: ReactNode;
+    readonly cardProps?: Omit<CardProps, "children" | "extra" | "title">;
+  }
+
+  export function DataTable<RecordType extends object = Record<string, unknown>>(
+    props: DataTableProps<RecordType>,
+  ): ReactNode;
+
+  export interface CrudDrawerProps<Values extends object = Record<string, unknown>>
+    extends Omit<DrawerProps, "children" | "footer" | "onClose" | "open"> {
+    readonly open: boolean;
+    readonly form?: FormInstance<Values>;
+    readonly formProps?: Omit<FormProps<Values>, "children" | "form" | "initialValues" | "onFinish">;
+    readonly initialValues?: Partial<Values>;
+    readonly children?: ReactNode;
+    readonly submitText?: ReactNode;
+    readonly cancelText?: ReactNode;
+    readonly submitting?: boolean;
+    readonly onClose: () => void;
+    readonly onSubmit: (values: Values) => void | Promise<void>;
+    readonly onSubmitError?: (error: unknown) => void;
+  }
+
+  export function CrudDrawer<Values extends object = Record<string, unknown>>(
+    props: CrudDrawerProps<Values>,
+  ): ReactNode;
+
+  export interface StatusTagProps extends Omit<TagProps, "children" | "color"> {
+    readonly status: string;
+    readonly label?: ReactNode;
+    readonly color?: TagProps["color"];
+    readonly colors?: Readonly<Record<string, TagProps["color"]>>;
+  }
+
+  export function StatusTag(props: StatusTagProps): ReactNode;
+
+  export type FrontendStoreSetter<TState> = TState | ((current: TState) => TState);
+  export type FrontendStorePatch<TState extends object> =
+    Partial<TState> | ((current: TState) => Partial<TState>);
+
+  export interface FrontendStore<TState extends object> {
+    getState(): TState;
+    setState(next: FrontendStoreSetter<TState>): void;
+    update(patch: FrontendStorePatch<TState>): void;
+    reset(): void;
+    subscribe(listener: () => void): () => void;
+    useStore<Selection = TState>(selector?: (state: TState) => Selection): Selection;
+  }
+
+  export function createFrontendStore<TState extends object>(
+    initialState: TState | (() => TState),
+  ): FrontendStore<TState>;
+
+  export interface PersistentFrontendStateOptions<T> {
+    readonly namespace?: string;
+    readonly serialize?: (value: T) => string;
+    readonly deserialize?: (value: string) => T;
+  }
+
+  export function usePersistentFrontendState<T>(
+    key: string,
+    initialState: T | (() => T),
+    options?: PersistentFrontendStateOptions<T>,
+  ): [T, Dispatch<SetStateAction<T>>];
+
+  export function FrontendRuntimeContextProvider(
+    props: PropsWithChildren<{ readonly value: FrontendRuntimeApi }>,
+  ): ReactNode;
+
+  export function useFrontendRuntime(): FrontendRuntimeApi;
+
+  export function defineFrontendProviders(
+    providers: readonly FrontendRuntimeProvider[],
+  ): readonly FrontendRuntimeProvider[];
+
+  /**
+   * Returns namespace-isolated synchronous storage. Harness previews persist
+   * it through a scoped parent bridge and safely fall back to memory when no
+   * persistent backend is available.
+   */
+  export function getFrontendStorage(namespace?: string): FrontendStorage;
+}
+
+declare module "virtual:harness-business-registry" {
+  import type {
+    FrontendBusinessAppManifest,
+    FrontendBusinessRoute,
+    FrontendRuntimeProvider,
+  } from "@harness/frontend-runtime";
+
+  export const routes: readonly FrontendBusinessRoute[];
+  export const appManifest: FrontendBusinessAppManifest;
+  export const providers: readonly FrontendRuntimeProvider[];
+  export const stylesUrl: string | undefined;
+}

package/bundled-plugins/fast-frontend/templates/antd-admin/.gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+*.tsbuildinfo
+.env
+.env.*
+!.env.example
+!.harness/
+!.harness/template.json
+.harness/install.json

package/bundled-plugins/fast-frontend/templates/antd-admin/.harness/template.json

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "pluginId": "harness.fast-frontend",
+  "modeId": "fast-frontend",
+  "templateId": "antd-admin",
+  "templateVersion": "1.1.0",
+  "pluginContentHash": "{{HARNESS_PLUGIN_CONTENT_HASH}}",
+  "installedAt": "{{HARNESS_INSTALLED_AT}}",
+  "protectedFiles": {}
+}

package/bundled-plugins/fast-frontend/templates/antd-admin/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#f5f7fb" />
+    <title>业务管理后台</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/bundled-plugins/fast-frontend/templates/antd-admin/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "harness-antd-admin",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.1.1",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build --config vite.config.ts",
+    "preview": "vite preview",
+    "typecheck": "tsc -b --pretty false",
+    "validate:routes": "node scripts/validate-routes.mjs",
+    "validate": "pnpm run validate:routes && pnpm run typecheck && pnpm run build"
+  },
+  "dependencies": {
+    "@ant-design/icons": "6.3.2",
+    "antd": "6.6.1",
+    "dayjs": "1.11.23",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "react-router-dom": "7.18.2"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.5",
+    "@vitejs/plugin-react": "6.1.0",
+    "typescript": "5.9.2",
+    "vite": "8.2.2"
+  }
+}