astro-md-editor 0.0.1

package/README.md

@@ -0,0 +1,118 @@
+# Astro MD Editor
+
+Editor UI for Astro content collections (`src/content`) with schema-aware frontmatter editing and markdown body editing.
+
+## Run
+
+```bash
+npx astro-md-editor
+```
+
+```bash
+pnpm dlx astro-md-editor
+# or
+pnpx astro-md-editor
+```
+
+### Target project path
+
+```bash
+# positional
+npx astro-md-editor /absolute/path/to/astro-project
+
+# flag
+npx astro-md-editor --path /absolute/path/to/astro-project
+```
+
+Path resolution order:
+
+1. positional CLI arg (`astro-md-editor <astro-project-root>`)
+2. `--path=<astro-project-root>`
+3. `APP_ROOT_PATH`
+4. current working directory
+
+### Port
+
+```bash
+PORT=1234 npx astro-md-editor
+# or
+NITRO_PORT=1234 npx astro-md-editor
+```
+
+The runtime reads `PORT`/`NITRO_PORT` for server port.
+
+## Requirements
+
+- Astro project with collections in `src/content`.
+- Collection schemas available in `.astro/collections/*.schema.json`.
+
+If schema files are missing, run:
+
+```bash
+astro sync
+```
+
+## Features
+
+- Reads `.astro/collections/*.schema.json`.
+- Scans `src/content/<collection>/**/*.{md,mdx,markdown}`.
+- Renders controls for schema fields (`string`, `number`, `boolean`, `enum`, `date`, arrays).
+- Edits frontmatter and markdown/MDX body in one flow.
+- Validates frontmatter with AJV before save.
+- Supports image field inference from `src/content.config.*` (`image()`, `z.array(image())`).
+- Supports image pickers for both `src` assets and `public` assets.
+
+## Local development
+
+```bash
+pnpm dev
+```
+
+`pnpm dev` uses `--path example-blog --port 3000`.
+
+Run dev against another project:
+
+```bash
+node scripts/dev.mjs /absolute/path/to/astro-project --port 3000
+```
+
+In dev mode, if schema files are missing, startup runs `astro sync` automatically for the selected project.
+
+## Field overrides
+
+Create `astro-md-editor.fields.json` at the Astro project root.
+
+Example:
+
+```json
+{
+  "blog": {
+    "brandColor": { "type": "color" },
+    "coverAssetPath": { "type": "image", "mode": "public" }
+  },
+  "snippet": {
+    "galleryPaths": { "type": "image", "multiple": true, "mode": "public" }
+  }
+}
+```
+
+Rules:
+
+- `type`: `image` or `color`
+- for `type: "image"`, optional `mode`: `asset` (default) or `public`
+- for `type: "image"`, optional `multiple: true` for array-style image input
+- shape: `{ [collectionName]: { [fieldName]: override } }`
+
+Precedence:
+
+1. `astro-md-editor.fields.json` overrides
+2. inferred `image()` / `array(image())` from content config
+3. schema-based fallback rendering
+
+Invalid or incompatible overrides are ignored with bootstrap warnings.
+
+## Notes
+
+- `public` assets are saved as `/path/from/public`.
+- `src` assets are saved as relative paths from the content file (`./...` or `../...`).
+- Custom controls currently target top-level frontmatter fields.

package/index.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+import {
+  applyCollectionsEnv,
+  bootstrapCollections,
+} from './scripts/bootstrap-collections.mjs';
+
+async function main() {
+  const bootstrapResult = await bootstrapCollections(process.argv.slice(2), {
+    mode: 'production',
+  });
+  applyCollectionsEnv(process.env, bootstrapResult);
+
+  await import('./.output/server/index.mjs');
+}
+
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`[startup] ${message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "astro-md-editor",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "astro-md-editor": "./index.mjs"
+  },
+  "files": [
+    ".output/",
+    "index.mjs",
+    "scripts/bootstrap-collections.mjs",
+    "README.md"
+  ],
+  "imports": {
+    "#/*": "./src/*"
+  },
+  "scripts": {
+    "dev": "node scripts/dev.mjs --path example-blog --port 3000",
+    "build": "vite build",
+    "start": "node index.mjs",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "lint": "eslint",
+    "format": "prettier --write .",
+    "check": "prettier --write . && eslint --fix"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.2.0",
+    "@fontsource-variable/inter": "^5.2.8",
+    "@tailwindcss/vite": "^4.1.18",
+    "@tanstack/react-devtools": "latest",
+    "@tanstack/react-router": "latest",
+    "@tanstack/react-router-devtools": "latest",
+    "@tanstack/react-router-ssr-query": "latest",
+    "@tanstack/react-start": "latest",
+    "@tanstack/router-plugin": "^1.132.0",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "date-fns": "^4.1.0",
+    "dotenv": "^17.3.1",
+    "gray-matter": "^4.0.3",
+    "lucide-react": "^0.577.0",
+    "motion": "^12.35.0",
+    "nitro": "npm:nitro-nightly@latest",
+    "react": "^19.2.0",
+    "react-day-picker": "^9.14.0",
+    "react-dom": "^19.2.0",
+    "react-resizable-panels": "^4.7.1",
+    "shadcn": "^4.0.0",
+    "tailwind-merge": "^3.0.2",
+    "tailwindcss": "^4.1.18",
+    "tw-animate-css": "^1.3.6",
+    "zod": "^3.25.76",
+    "zustand": "^5.0.11"
+  },
+  "devDependencies": {
+    "@tailwindcss/typography": "^0.5.16",
+    "@tanstack/devtools-vite": "latest",
+    "@tanstack/eslint-config": "latest",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^5.1.4",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "jsdom": "^28.1.0",
+    "prettier": "^3.8.1",
+    "prettier-plugin-tailwindcss": "^0.7.2",
+    "typescript": "^5.7.2",
+    "vite": "^7.3.1",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.0.5"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "lightningcss",
+      "msw",
+      "unrs-resolver"
+    ]
+  }
+}