@evjs/manifest 0.0.1-rc.13

package/AGENT.md

@@ -0,0 +1,28 @@
+# @evjs/manifest
+
+Shared manifest schema types for the ev framework build system.
+
+## Types
+
+- `ServerManifest` — Server manifest interface (`dist/server/manifest.json`).
+- `ClientManifest` — Client manifest interface (reserved for future `dist/client/manifest.json`).
+- `ServerFnEntry` — `{ moduleId: string; export: string }` — server function metadata.
+- `RscEntry` — Reserved for future (React Server Components).
+- `PageEntry` — Reserved for future (MPA per-page assets).
+
+## Server Manifest (v1)
+```json
+{
+  "version": 1,
+  "entry": "main.a1b2c3d4.js",
+  "fns": {
+    "<fnId>": { "moduleId": "f9b6...", "export": "getUsers" }
+  }
+}
+```
+
+## Usage
+Produced by `@evjs/webpack-plugin`, consumed by `@evjs/runtime` and adapters:
+```ts
+import type { ServerManifest, ServerFnEntry } from "@evjs/manifest";
+```

package/README.md

@@ -0,0 +1,39 @@
+# @evjs/manifest
+
+Shared manifest schema types for the **ev** framework build system.
+
+## Installation
+
+```bash
+npm install @evjs/manifest
+```
+
+## Purpose
+
+Defines the structure of per-environment manifest files emitted by `@evjs/webpack-plugin` and consumed by `@evjs/runtime`. Each environment gets its own `manifest.json`:
+
+- `dist/server/manifest.json` → `ServerManifest`
+- `dist/client/manifest.json` → `ClientManifest` (future)
+
+## Server Manifest (v1)
+
+```json
+{
+  "version": 1,
+  "entry": "main.a1b2c3d4.js",
+  "fns": {
+    "<fnId>": {
+      "moduleId": "f9b6...",
+      "export": "getUsers"
+    }
+  }
+}
+```
+
+## Exported Types
+
+- **`ServerManifest`** — server manifest (`dist/server/manifest.json`).
+- **`ClientManifest`** — client manifest (reserved for future).
+- **`ServerFnEntry`** — server function metadata (`{ moduleId, export }`).
+- **`RscEntry`** — React Server Components (reserved for future).
+- **`PageEntry`** — per-page assets for MPA (reserved for future).

package/esm/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @evjs/manifest
+ *
+ * Shared manifest schemas for the ev framework build system.
+ *
+ * Each environment emits its own manifest file:
+ *   - dist/server/manifest.json → ServerManifest
+ *   - dist/client/manifest.json → ClientManifest (future)
+ */
+/** Base manifest fields shared by all environment manifests. */
+interface ManifestBase {
+    /** Schema version — bump on breaking changes. */
+    version: 1;
+}
+/** A registered server function entry. */
+export interface ServerFnEntry {
+    /** Webpack module identifier (hash-based, no source paths exposed). */
+    moduleId: string;
+    /** Exported function name. */
+    export: string;
+}
+/** A React Server Component entry (future — reserved). */
+export interface RscEntry {
+    /** Webpack module ID. */
+    moduleId: string;
+    /** Exported component name. */
+    export: string;
+}
+/**
+ * Server manifest — emitted to `dist/server/manifest.json`.
+ *
+ * Contains everything needed to boot and serve the server bundle:
+ * entry filename, registered server functions, and future RSC/SSR metadata.
+ */
+export interface ServerManifest extends ManifestBase {
+    /** Server bundle entry filename (e.g. "main.js" or "main.a1b2c3d4.js"). */
+    entry: string;
+    /** Registered server functions (fnId → module + export). */
+    fns: Record<string, ServerFnEntry>;
+    /** React Server Components (future — reserved). */
+    rsc?: Record<string, RscEntry>;
+}
+/** Per-page asset entry for MPA support (future — reserved). */
+export interface PageEntry {
+    /** JavaScript bundle paths for this page. */
+    js: string[];
+    /** CSS bundle paths for this page. */
+    css: string[];
+}
+/**
+ * Client manifest — emitted to `dist/client/manifest.json` (future).
+ *
+ * Contains everything needed for SSR HTML injection and asset preloading.
+ */
+export interface ClientManifest extends ManifestBase {
+    /** JavaScript bundle paths for HTML injection. */
+    js: string[];
+    /** CSS bundle paths for HTML injection. */
+    css: string[];
+    /** Per-page assets for MPA support (future — reserved). */
+    pages?: Record<string, PageEntry>;
+}
+export {};

package/esm/index.js

@@ -0,0 +1,10 @@
+/**
+ * @evjs/manifest
+ *
+ * Shared manifest schemas for the ev framework build system.
+ *
+ * Each environment emits its own manifest file:
+ *   - dist/server/manifest.json → ServerManifest
+ *   - dist/client/manifest.json → ClientManifest (future)
+ */
+export {};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@evjs/manifest",
+  "version": "0.0.1-rc.13",
+  "description": "Shared manifest types for the ev framework",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./esm/index.js",
+  "exports": {
+    ".": {
+      "types": "./esm/index.d.ts",
+      "import": "./esm/index.js",
+      "require": "./esm/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit"
+  },
+  "files": [
+    "esm",
+    "AGENT.md"
+  ],
+  "keywords": [
+    "evjs",
+    "manifest",
+    "server-functions"
+  ],
+  "author": "xusd320",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  },
+  "homepage": "https://github.com/evaijs/evjs#readme",
+  "bugs": {
+    "url": "https://github.com/evaijs/evjs/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evaijs/evjs.git"
+  }
+}