@contentrail/astro 0.2.0 → 0.2.2

package/README.md

@@ -22,10 +22,10 @@ pnpm install
 pnpm --filter @contentrail/astro build
 ```
 
-### From npm (upcoming `0.2.0` after authorized publish)
+### From npm (`0.2.2`)
 
 ```sh
-pnpm add @contentrail/core@0.2.0 @contentrail/reader@0.2.0 @contentrail/astro@0.2.0 zod@^4.6.7
+pnpm add @contentrail/core@0.2.2 @contentrail/reader@0.2.2 @contentrail/astro@0.2.2 zod@^4.6.7
 pnpm add -D astro@^7.3.3
 ```
 
@@ -49,3 +49,13 @@ const entries = await rail.loadCollection(articles);
 ```
 
 This package re-exports the Node reader. Do not import it from client-side scripts.
+
+## Self-hosted `/admin`
+
+Optional. Install `@contentrail/editor` and `preact`, then add:
+
+```ts
+import { contentrailAdmin } from "@contentrail/astro/admin";
+```
+
+Existing public routes are unchanged. See `docs/ADMIN.md`. Next.js and other frameworks are **not** claimed.

package/admin-page.astro

@@ -0,0 +1,37 @@
+---
+export const prerender = true;
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="robots" content="noindex" />
+    <title>ContentRail Admin</title>
+  </head>
+  <body>
+    <div id="contentrail-admin"></div>
+    <script>
+      import { mountAdmin } from "@contentrail/editor";
+      import "@contentrail/editor/styles.css";
+      import {
+        site,
+        apiBaseUrl,
+        title,
+        pageSize,
+      } from "virtual:contentrail-admin-config";
+
+      const root = document.getElementById("contentrail-admin");
+      if (!(root instanceof HTMLElement)) {
+        throw new Error("#contentrail-admin is required");
+      }
+      mountAdmin({
+        target: root,
+        sites: [site],
+        apiBaseUrl,
+        title,
+        pageSize,
+      });
+    </script>
+  </body>
+</html>

package/dist/admin.d.ts

@@ -0,0 +1,9 @@
+import type { AstroIntegration } from "astro";
+import { type ContentrailAdminOptions } from "@contentrail/editor/vite";
+export type { ContentrailAdminOptions };
+/**
+ * Injects `/admin` into an Astro site without replacing existing public routes.
+ * Requires `@contentrail/editor` and `preact` in the website project.
+ */
+export declare function contentrailAdmin(options: ContentrailAdminOptions): AstroIntegration;
+//# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,CAkBlB"}

package/dist/admin.js

@@ -0,0 +1,26 @@
+import { fileURLToPath } from "node:url";
+import { contentrailAdmin as viteContentrailAdmin, } from "@contentrail/editor/vite";
+/**
+ * Injects `/admin` into an Astro site without replacing existing public routes.
+ * Requires `@contentrail/editor` and `preact` in the website project.
+ */
+export function contentrailAdmin(options) {
+    const page = fileURLToPath(new URL("../admin-page.astro", import.meta.url));
+    return {
+        name: "contentrail-admin",
+        hooks: {
+            "astro:config:setup": ({ injectRoute, updateConfig }) => {
+                updateConfig({
+                    vite: {
+                        plugins: [viteContentrailAdmin({ ...options, serveRoute: false })],
+                    },
+                });
+                injectRoute({
+                    pattern: "/admin",
+                    entrypoint: page,
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=admin.js.map

package/dist/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACL,gBAAgB,IAAI,oBAAoB,GAEzC,MAAM,0BAA0B,CAAC;AAIlC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAgC;IAEhC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE;YACL,oBAAoB,EAAE,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE;gBACtD,YAAY,CAAC;oBACX,IAAI,EAAE;wBACJ,OAAO,EAAE,CAAC,oBAAoB,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;qBACnE;iBACF,CAAC,CAAC;gBACH,WAAW,CAAC;oBACV,OAAO,EAAE,QAAQ;oBACjB,UAAU,EAAE,IAAI;iBACjB,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentrail/astro",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "type": "module",
   "description": "Astro build-time helpers for ContentRail local JSON content.",
@@ -15,29 +15,45 @@
       "import": "./dist/index.js",
       "node": "./dist/index.js"
     },
+    "./admin": {
+      "types": "./dist/admin.d.ts",
+      "import": "./dist/admin.js",
+      "node": "./dist/admin.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
+    "admin-page.astro",
     "README.md",
     "LICENSE"
   ],
   "dependencies": {
-    "@contentrail/core": "0.2.0",
-    "@contentrail/reader": "0.2.0"
+    "@contentrail/core": "0.2.2",
+    "@contentrail/reader": "0.2.2"
   },
   "peerDependencies": {
-    "astro": "^7.3.3"
+    "astro": "^7.3.3",
+    "preact": "^10.26.0",
+    "@contentrail/editor": "^0.2.2"
   },
   "peerDependenciesMeta": {
+    "@contentrail/editor": {
+      "optional": true
+    },
     "astro": {
       "optional": true
+    },
+    "preact": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@types/node": "^22.20.5",
     "astro": "7.3.8",
-    "typescript": "5.9.3"
+    "preact": "^10.26.9",
+    "typescript": "5.9.3",
+    "@contentrail/editor": "0.2.2"
   },
   "repository": {
     "type": "git",