@evjs/manifest 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,35 @@
+# @evjs/manifest
+
+Shared manifest schema types for the **ev** framework build system.
+
+## Installation
+
+```bash
+npm install @evjs/manifest
+```
+
+## Purpose
+
+Defines the structure of `manifest.json` emitted by `@evjs/webpack-plugin` and consumed by `@evjs/runtime`. Provides a single source of truth for the build manifest schema.
+
+## Schema (v1)
+
+```json
+{
+  "version": 1,
+  "serverFunctions": {
+    "<fnId>": {
+      "file": "src/api/users.server.ts",
+      "export": "getUsers"
+    }
+  }
+}
+```
+
+## Exported Types
+
+- **`EvManifest`** — the root manifest interface (versioned).
+- **`ServerFnEntry`** — server function metadata (current).
+- **`SsrEntry`** — SSR configuration (reserved for Stage 3).
+- **`AssetsEntry`** — client JS/CSS assets (reserved for Stage 3).
+- **`RscEntry`** — React Server Components (reserved for future).

package/esm/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @evjs/manifest
+ *
+ * Shared manifest schema for the ev framework build system.
+ * This package defines the structure of `manifest.json` emitted
+ * by @evjs/webpack-plugin and consumed by @evjs/runtime.
+ */
+/** A registered server function entry. */
+export interface ServerFnEntry {
+    /** Webpack module identifier (hash-based, no source paths exposed). */
+    moduleId: string;
+    /** Exported function name. */
+    export: string;
+}
+/** Server-side rendering configuration. */
+export interface SsrEntry {
+    /** Path to the server entry bundle. */
+    serverEntry: string;
+    /** Path to the client entry bundle. */
+    clientEntry: string;
+}
+/** Client assets for HTML injection during SSR. */
+export interface AssetsEntry {
+    /** JavaScript bundle paths. */
+    js: string[];
+    /** CSS bundle paths. */
+    css: string[];
+}
+/** A React Server Component entry. */
+export interface RscEntry {
+    /** Webpack module ID. */
+    moduleId: string;
+    /** Exported component name. */
+    export: string;
+}
+/**
+ * The ev build manifest.
+ *
+ * Version 1 supports:
+ * - `serverFunctions`: AJAX RPC server functions.
+ *
+ * Future versions will add:
+ * - `ssr`: Server-side rendering entry points.
+ * - `assets`: Client JS/CSS assets for HTML injection.
+ * - `serverComponents`: React Server Components.
+ */
+export interface EvManifest {
+    /** Schema version — bump on breaking changes. */
+    version: 1;
+    /** Server function registry (Stage 2). */
+    serverFunctions: Record<string, ServerFnEntry>;
+    /** SSR configuration (Stage 3 — reserved). */
+    ssr?: SsrEntry;
+    /** Client assets (Stage 3 — reserved). */
+    assets?: AssetsEntry;
+    /** React Server Components (future — reserved). */
+    serverComponents?: Record<string, RscEntry>;
+}

package/esm/index.js

@@ -0,0 +1,8 @@
+/**
+ * @evjs/manifest
+ *
+ * Shared manifest schema for the ev framework build system.
+ * This package defines the structure of `manifest.json` emitted
+ * by @evjs/webpack-plugin and consumed by @evjs/runtime.
+ */
+export {};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@evjs/manifest",
+  "version": "0.0.1-alpha.1",
+  "description": "Shared manifest types for the ev framework",
+  "type": "module",
+  "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",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "esm"
+  ],
+  "keywords": [
+    "ev",
+    "manifest"
+  ],
+  "author": "xusd320",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  },
+  "homepage": "https://github.com/evjs/evjs#readme",
+  "bugs": {
+    "url": "https://github.com/evjs/evjs/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evjs/evjs.git"
+  }
+}