astro-md-editor 0.0.4 → 0.0.5

package/.output/nitro.json

@@ -1,5 +1,5 @@
 {
-  "date": "2026-03-08T01:34:08.005Z",
+  "date": "2026-03-08T06:10:30.750Z",
   "preset": "node-server",
   "framework": {
     "name": "nitro",

package/.output/server/_ssr/index.mjs

@@ -612,12 +612,6 @@ const manifest = { "e3ae5ae6db5120d43fecff71cd0258cb4a93807a1a382949ccd189596d19
 }, "1f487dcb5d0b909c2785163b904a0ee48e748b32783309e964b4502d83a2e7a7": {
   functionName: "getImageAssetPreview_createServerFn_handler",
   importer: () => import("./ImageAssetBrowser-DNDdTqtf.mjs")
-}, "3ba1a566c82090c8422dd6ca7258b2e1aed644206364441faf1bd80942f21745": {
-  functionName: "listIconifyCollectionsServerFn_createServerFn_handler",
-  importer: () => import("./IconPickerPopover-fNUx2jAc.mjs")
-}, "c9dff6ed7373b505d6aeeb84c63f87a0d0c205051d9d817929a5b500e5e79e03": {
-  functionName: "listCollectionIconsServerFn_createServerFn_handler",
-  importer: () => import("./IconPickerPopover-fNUx2jAc.mjs")
 }, "dcd3839820feeaed3b1a4f86186dd05c2e7e26ffaacdeaba309f44d121c95ad1": {
   functionName: "listFileHistoryServerFn_createServerFn_handler",
   importer: () => import("./file-history.api-oydnxFVV.mjs")
@@ -627,6 +621,12 @@ const manifest = { "e3ae5ae6db5120d43fecff71cd0258cb4a93807a1a382949ccd189596d19
 }, "8346edc0b9da2addd68ca674ed9b2030f439d40deb713c45ef88393f5bdb91b9": {
   functionName: "getLocalImagePreviewServerFn_createServerFn_handler",
   importer: () => import("./image-preview.api-pcN5PQhH.mjs")
+}, "3ba1a566c82090c8422dd6ca7258b2e1aed644206364441faf1bd80942f21745": {
+  functionName: "listIconifyCollectionsServerFn_createServerFn_handler",
+  importer: () => import("./IconPickerPopover-fNUx2jAc.mjs")
+}, "c9dff6ed7373b505d6aeeb84c63f87a0d0c205051d9d817929a5b500e5e79e03": {
+  functionName: "listCollectionIconsServerFn_createServerFn_handler",
+  importer: () => import("./IconPickerPopover-fNUx2jAc.mjs")
 } };
 async function getServerFnById(id) {
   const serverFnInfo = manifest[id];

package/.output/server/index.mjs

@@ -100,105 +100,105 @@ const assets = {
   "/favicon.ico": {
     "type": "image/vnd.microsoft.icon",
     "etag": '"f1e-ESBTjHetHyiokkO0tT/irBbMO8Y"',
-    "mtime": "2026-03-08T01:34:03.121Z",
+    "mtime": "2026-03-08T06:10:25.839Z",
     "size": 3870,
     "path": "../public/favicon.ico"
   },
+  "/manifest.json": {
+    "type": "application/json",
+    "etag": '"1f2-Oqn/x1R1hBTtEjA8nFhpBeFJJNg"',
+    "mtime": "2026-03-08T06:10:25.839Z",
+    "size": 498,
+    "path": "../public/manifest.json"
+  },
   "/logo192.png": {
     "type": "image/png",
     "etag": '"14e3-f08taHgqf6/O2oRVTsq5tImHdQA"',
-    "mtime": "2026-03-08T01:34:03.121Z",
+    "mtime": "2026-03-08T06:10:25.839Z",
     "size": 5347,
     "path": "../public/logo192.png"
   },
-  "/logo512.png": {
-    "type": "image/png",
-    "etag": '"25c0-RpFfnQJpTtSb/HqVNJR2hBA9w/4"',
-    "mtime": "2026-03-08T01:34:03.121Z",
-    "size": 9664,
-    "path": "../public/logo512.png"
-  },
   "/robots.txt": {
     "type": "text/plain; charset=utf-8",
     "etag": '"43-BEzmj4PuhUNHX+oW9uOnPSihxtU"',
-    "mtime": "2026-03-08T01:34:03.121Z",
+    "mtime": "2026-03-08T06:10:25.839Z",
     "size": 67,
     "path": "../public/robots.txt"
   },
-  "/manifest.json": {
-    "type": "application/json",
-    "etag": '"1f2-Oqn/x1R1hBTtEjA8nFhpBeFJJNg"',
-    "mtime": "2026-03-08T01:34:03.121Z",
-    "size": 498,
-    "path": "../public/manifest.json"
+  "/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2": {
+    "type": "font/woff2",
+    "etag": '"493c-n3Oy9D6jvzfMjpClqox+Zo7ERQQ"',
+    "mtime": "2026-03-08T06:10:25.333Z",
+    "size": 18748,
+    "path": "../public/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2"
   },
   "/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2": {
     "type": "font/woff2",
     "etag": '"2be0-BP5iTzJeB8nLqYAgKpWNi5o1Zm8"',
-    "mtime": "2026-03-08T01:34:02.637Z",
+    "mtime": "2026-03-08T06:10:25.332Z",
     "size": 11232,
     "path": "../public/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2"
   },
-  "/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2": {
-    "type": "font/woff2",
-    "etag": '"493c-n3Oy9D6jvzfMjpClqox+Zo7ERQQ"',
-    "mtime": "2026-03-08T01:34:02.637Z",
-    "size": 18748,
-    "path": "../public/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2"
-  },
   "/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2": {
     "type": "font/woff2",
     "etag": '"6568-cF1iUGbboMFZ8TfnP5HiMgl9II0"',
-    "mtime": "2026-03-08T01:34:02.637Z",
+    "mtime": "2026-03-08T06:10:25.332Z",
     "size": 25960,
     "path": "../public/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2"
   },
-  "/assets/inter-latin-wght-normal-Dx4kXJAl.woff2": {
+  "/logo512.png": {
+    "type": "image/png",
+    "etag": '"25c0-RpFfnQJpTtSb/HqVNJR2hBA9w/4"',
+    "mtime": "2026-03-08T06:10:25.839Z",
+    "size": 9664,
+    "path": "../public/logo512.png"
+  },
+  "/assets/inter-greek-wght-normal-CkhJZR-_.woff2": {
     "type": "font/woff2",
-    "etag": '"bc80-8R1ym7Ck2DUNLqPQ/AYs9u8tUpg"',
-    "mtime": "2026-03-08T01:34:02.637Z",
-    "size": 48256,
-    "path": "../public/assets/inter-latin-wght-normal-Dx4kXJAl.woff2"
+    "etag": '"4a34-xor/hj4YNqI52zFecXnUbzQ4Xs4"',
+    "mtime": "2026-03-08T06:10:25.333Z",
+    "size": 18996,
+    "path": "../public/assets/inter-greek-wght-normal-CkhJZR-_.woff2"
   },
   "/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2": {
     "type": "font/woff2",
     "etag": '"14c4c-zz61D7IQFMB9QxHvTAOk/Vh4ibQ"',
-    "mtime": "2026-03-08T01:34:02.637Z",
+    "mtime": "2026-03-08T06:10:25.333Z",
     "size": 85068,
     "path": "../public/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2"
   },
+  "/assets/inter-latin-wght-normal-Dx4kXJAl.woff2": {
+    "type": "font/woff2",
+    "etag": '"bc80-8R1ym7Ck2DUNLqPQ/AYs9u8tUpg"',
+    "mtime": "2026-03-08T06:10:25.333Z",
+    "size": 48256,
+    "path": "../public/assets/inter-latin-wght-normal-Dx4kXJAl.woff2"
+  },
   "/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2": {
     "type": "font/woff2",
     "etag": '"280c-nBythjoDQ0+5wVAendJ6wU7Xz2M"',
-    "mtime": "2026-03-08T01:34:02.637Z",
+    "mtime": "2026-03-08T06:10:25.333Z",
     "size": 10252,
     "path": "../public/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2"
   },
-  "/assets/inter-greek-wght-normal-CkhJZR-_.woff2": {
-    "type": "font/woff2",
-    "etag": '"4a34-xor/hj4YNqI52zFecXnUbzQ4Xs4"',
-    "mtime": "2026-03-08T01:34:02.637Z",
-    "size": 18996,
-    "path": "../public/assets/inter-greek-wght-normal-CkhJZR-_.woff2"
+  "/assets/styles-CezfLgHY.css": {
+    "type": "text/css; charset=utf-8",
+    "etag": '"16c03-6spcY0zAbMWYIfx4MkgUIWefXb0"',
+    "mtime": "2026-03-08T06:10:25.333Z",
+    "size": 93187,
+    "path": "../public/assets/styles-CezfLgHY.css"
   },
   "/assets/main-DzXOjsqg.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": '"59339-tSYXNZ6CNL1Zt0KVnL8TeohfAog"',
-    "mtime": "2026-03-08T01:34:02.637Z",
+    "mtime": "2026-03-08T06:10:25.336Z",
     "size": 365369,
     "path": "../public/assets/main-DzXOjsqg.js"
   },
-  "/assets/styles-CezfLgHY.css": {
-    "type": "text/css; charset=utf-8",
-    "etag": '"16c03-6spcY0zAbMWYIfx4MkgUIWefXb0"',
-    "mtime": "2026-03-08T01:34:02.637Z",
-    "size": 93187,
-    "path": "../public/assets/styles-CezfLgHY.css"
-  },
   "/assets/index-UQt6zCrS.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": '"fd680-MTEy4A2zDMKeSP7AuzGHvXOYiSs"',
-    "mtime": "2026-03-08T01:34:02.637Z",
+    "mtime": "2026-03-08T06:10:25.337Z",
     "size": 1037952,
     "path": "../public/assets/index-UQt6zCrS.js"
   }

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bibek Timsina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,38 +2,38 @@
 
 [![npm version](https://img.shields.io/npm/v/astro-md-editor.svg)](https://www.npmjs.com/package/astro-md-editor)
 
-Editor UI for Astro content collections (`src/content`) with schema-aware frontmatter editing and markdown body editing.
+Schema-aware editor for Astro content collections. It lets you edit frontmatter and markdown/MDX together, validates on save, and can reuse values from file Git history.
 
-## Run
+Demo video: https://www.youtube.com/watch?v=-cI6ct8yLHM
 
-```bash
-npx astro-md-editor
-```
+https://github.com/user-attachments/assets/7f38b6a4-fe1a-4e30-80c8-19a58aa860f1
+
+## Quick start
 
 ```bash
-pnpm dlx astro-md-editor
+npx astro-md-editor
 # or
-pnpx astro-md-editor
+pnpm dlx astro-md-editor
 ```
 
-### Target project path
+By default, it targets the current directory.
 
-```bash
-# positional
-npx astro-md-editor /absolute/path/to/astro-project
+Target a specific Astro project:
 
-# flag
-npx astro-md-editor --path /absolute/path/to/astro-project
+```bash
+astro-md-editor /absolute/path/to/astro-project
+# or
+astro-md-editor --path /absolute/path/to/astro-project
 ```
 
-Path resolution order:
+Root resolution order:
 
-1. positional CLI arg (`astro-md-editor <astro-project-root>`)
-2. `--path=<astro-project-root>`
+1. positional argument (`astro-md-editor <astro-project-root>`)
+2. `--path`
 3. `APP_ROOT_PATH`
 4. current working directory
 
-### Port
+Port can be set with `PORT` or `NITRO_PORT`.
 
 ```bash
 PORT=1234 npx astro-md-editor
@@ -41,54 +41,29 @@ PORT=1234 npx astro-md-editor
 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`.
+- Astro project with collections under `src/content`
+- Generated collection schemas in `.astro/collections/*.schema.json`
 
-If schema files are missing, run:
+If schema files are missing, run in the target project:
 
 ```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.
-- Includes a per-file Git History tab in the right sidebar (timeline-style commit list).
-- Shows commit message, author, and time; expands each item to inspect revision frontmatter.
-- Can apply a selected revision into the current draft with schema-safe frontmatter reapply (incompatible keys are skipped).
-- Applying history updates only the in-editor draft; normal Save flow still controls disk writes.
+## Highlights
 
-## Local development
-
-```bash
-pnpm dev
-```
+- Reads collection schemas and content files (`.md`, `.mdx`, `.markdown`)
+- Renders schema-aware controls (`string`, `number`, `boolean`, `enum`, `date`, arrays)
+- Validates frontmatter with AJV before saving
+- Infers image fields from `src/content.config.*` (`image()` / `z.array(image())`)
+- Supports image pickers for both `src` assets and `public` assets
+- Shows per-file Git history and applies selected revision values to the current draft safely
 
-`pnpm dev` uses `--path example-blog --port 3000`.
+## Field overrides (optional)
 
-Run dev against another project:
-
-```bash
-node scripts/dev.mjs /absolute/path/to/astro-project --port 3000
-```
-
-In dev mode, startup always runs `astro sync` for the selected project before loading collections.
-
-## Field overrides
-
-Create `astro-md-editor.fields.json` at the Astro project root.
-
-Example:
+Create `astro-md-editor.fields.json` at the Astro project root to force specific UI controls.
 
 ```json
 {
@@ -104,32 +79,48 @@ Example:
 }
 ```
 
-Rules:
+Supported override types:
 
-- `type`: `image`, `color`, or `icon`
-- for `type: "image"`, optional `mode`: `asset` (default) or `public`
-- for `type: "image"`, optional `multiple: true` for array-style image input
-- for `type: "icon"`, optional `icon_libraries: string[]` to restrict picker libraries by Iconify prefix
-- shape: `{ [collectionName]: { [fieldName]: override } }`
+- `image` (`mode: "asset" | "public"`, optional `multiple: true`)
+- `color`
+- `icon` (optional `icon_libraries: string[]`)
 
-Precedence:
+Precedence: `astro-md-editor.fields.json` > inferred `image()` fields > schema defaults.
 
-1. `astro-md-editor.fields.json` overrides
-2. inferred `image()` / `array(image())` from content config
-3. schema-based fallback rendering
+Invalid or schema-incompatible overrides are ignored with startup warnings.
 
-Invalid or incompatible overrides are ignored with bootstrap warnings.
+## Notes
 
-### Example blog demo
+- Applying Git history updates the in-editor draft only; files are written only on normal Save
+- `public` assets are saved as `/path/from/public`
+- `src` assets are saved relative to the edited content file (`./...` or `../...`)
+- Icon values are saved as Iconify IDs (for example `lucide:messages-square`)
+- Custom controls currently target top-level frontmatter fields
 
-`example-blog` includes icon override samples in the `blog` collection:
+## Add a custom UI handler in code
 
-- `menuIconFiltered`: icon picker restricted to `lucide` and `mdi`
-- `menuIconAny`: icon picker with all Iconify libraries
+If you are extending the editor itself (not just using `astro-md-editor.fields.json`), add a new field kind in these places:
 
-## Notes
+1. `src/lib/schema-form.ts`
+   - Extend `FieldUiKind`, `FieldUiConfig`, and `ResolvedField`
+   - Update `resolveCustomFieldKind` to map your override kind to a resolved field
+
+2. `scripts/bootstrap-collections.mjs`
+   - Extend `fieldOverrideSchema` so config accepts your new `type`
+   - Update `getOverrideConfig` and `resolveSchemaCompatibilityKind`
+
+3. `src/components/editor/RightSidebar.tsx`
+   - Add your new field component
+   - Render it in the `resolvedFields.map(...)` switch (`field.kind === '<yourKind>'`)
+
+4. `src/lib/frontmatter-history-merge.ts`
+   - Update `isCompatibleValue` so Git-history apply validates your new kind correctly
+
+Quick checklist for a new kind (example: `slug`):
+
+- add `slug` to schema/field types
+- parse `type: "slug"` in bootstrap overrides
+- render `<SlugField />` in `RightSidebar`
+- add compatibility logic in history merge
 
-- `public` assets are saved as `/path/from/public`.
-- `src` assets are saved as relative paths from the content file (`./...` or `../...`).
-- `icon` values are saved as Iconify strings like `lucide:messages-square`.
-- Custom controls currently target top-level frontmatter fields.
+If any part is missing, the field falls back to default/unsupported handling.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astro-md-editor",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "private": false,
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
     ".output/",
     "index.mjs",
     "scripts/bootstrap-collections.mjs",
-    "README.md"
+    "README.md",
+    "LICENSE.md"
   ],
   "imports": {
     "#/*": "./src/*"