@kdrgny/justjson 1.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kadir Günay
+
+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

@@ -0,0 +1,76 @@
+<div align="center">
+
+# JustJSON
+
+**A tiny local-first CMS. Build your schema in a visual UI, edit content in a clean editor — everything stays on disk as plain JSON.**
+
+No database · no account · no lock-in.
+
+[Website](https://justjson-site.vercel.app) ·
+[GitHub](https://github.com/kdrgny-dev/justjson) ·
+MIT
+
+</div>
+
+---
+
+JustJSON is the cleanest way to manage structured content **without writing config**. Design collections and fields by clicking, fill them in a real editor, and get plain JSON files you own — in your own repo, ready for your build.
+
+It runs entirely on your machine. Nothing is uploaded anywhere; your content is just files on disk.
+
+## Quick start
+
+```bash
+cd my-project/
+npx @kdrgny/justjson           # opens the editor in your browser
+```
+
+On an empty folder the editor greets you with a picker: start from a **template**, from **scratch**, or **import your own JSON** — an existing `_schema.json`, or plain content (say, an export from another tool) whose structure JustJSON figures out for you.
+
+Design your schema, enter content, upload images. Everything is written to `content/*.json` in your folder. Commit it, deploy it, import it in your build — your flow.
+
+## What you get
+
+| | |
+|---|---|
+| **Start from a template** | Blog, CV, portfolio, docs or changelog — each card previews the collections and fields it creates. |
+| **Bring your own JSON** | Paste any content JSON and JustJSON infers the structure: lists become collections, objects become singletons, HTML becomes rich text. |
+| **Visual schema builder** | Define collections and fields in the UI. Pick a field type from icon cards — no config file to hand-write. |
+| **Searchable content table** | Entries listed by title, slug and date. Search and edit instantly — content, not a pile of slugs. |
+| **Rich-text editor** | Headings, bold, lists, quotes — WYSIWYG, saved to disk as clean, diffable Markdown. |
+| **Image uploads** | Drop an image; it's resized to WebP in the browser and written under `content/media/`. |
+| **Type-safe output** | Generates `types.ts` from your schema, so your content is fully typed in your project. |
+| **Export any time** | One click downloads schema + content + types as a ZIP. Nothing is ever locked in. |
+| **The endpoint is yours** | Wherever you put the JSON becomes your API — repo raw, jsDelivr, your build. |
+
+Field types: `text` · `richtext` · `number` · `boolean` · `date` · `select` · `relation` (multi) · `image`.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `npx @kdrgny/justjson` (or `serve`) | Starts the local editor and opens it in your browser |
+| `npx @kdrgny/justjson init [template]` | Scaffolds a schema from a template (`blog`, `cv`, `portfolio`, `docs`, `changelog`) |
+| `npx @kdrgny/justjson types` | Generates `types.ts` from your schema |
+| `npx @kdrgny/justjson export` | Exports a ZIP snapshot (schema + content + types) |
+
+## How it works
+
+Your project holds a `content/` folder. JustJSON reads and writes it — that's all.
+
+```
+content/
+  _schema.json          ← your schema (built from the UI)
+  posts/
+    hello-world.json    ← one file per entry
+  settings.json         ← singletons
+  media/                ← uploaded images (WebP)
+```
+
+The editor is served locally by the CLI; it talks only to your disk. Delete `node_modules`, keep the JSON — your content is never trapped in a tool.
+
+JustJSON is deliberately small. It does one thing — turn a schema into editable JSON content — and tries to do it well.
+
+## License
+
+[MIT](https://github.com/kdrgny-dev/justjson/blob/main/LICENSE) © Kadir Günay

package/dist/cli.js

@@ -4314,6 +4314,98 @@ function buildExportManifest(input) {
   }
   return out;
 }
+var HTML = /<[a-z!/][\s\S]*>/i;
+function inferType(value) {
+  if (typeof value === "boolean") return "boolean";
+  if (typeof value === "number") return "number";
+  if (typeof value === "string") return HTML.test(value) ? "richtext" : "text";
+  return null;
+}
+function isPlainObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function fieldsFromRows(rows) {
+  const order = [];
+  const types = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    for (const [key, value] of Object.entries(row)) {
+      const t = inferType(value);
+      if (t === null) continue;
+      if (!types.has(key)) {
+        types.set(key, t);
+        order.push(key);
+      } else if (types.get(key) === "text" && t === "richtext") {
+        types.set(key, "richtext");
+      }
+    }
+  }
+  return order.map((key) => ({ key, label: key, type: types.get(key) }));
+}
+function inferProject(data) {
+  if (!isPlainObject(data)) throw new Error("\u0130\xE7e aktar\u0131lan JSON bir nesne olmal\u0131.");
+  const collections = [];
+  const singletons = [];
+  const entries = {};
+  const singletonData = {};
+  const generalFields = [];
+  const generalData = {};
+  const usedNames = /* @__PURE__ */ new Set();
+  const uniqueName = (base) => {
+    let name = base || "alan";
+    let n = 2;
+    while (usedNames.has(name)) name = `${base}-${n++}`;
+    usedNames.add(name);
+    return name;
+  };
+  const isRowList = (v) => Array.isArray(v) && v.length > 0 && v.every(isPlainObject);
+  const addCollection = (key, list, label = key) => {
+    const name = uniqueName(slugify(key));
+    const seen = /* @__PURE__ */ new Set();
+    const rows = list.map((row, i) => {
+      const firstText = Object.values(row).find((v) => typeof v === "string" && v.trim() !== "");
+      const base = slugify(
+        String(row.slug ?? row.title ?? row.name ?? row.label ?? firstText ?? `${name}-${i + 1}`)
+      ) || `${name}-${i + 1}`;
+      let slug = base;
+      let n = 2;
+      while (seen.has(slug)) slug = `${base}-${n++}`;
+      seen.add(slug);
+      return { slug, ...row };
+    });
+    const fields = fieldsFromRows(rows);
+    const keys = new Set(fields.map((f) => f.key));
+    collections.push({ name, label, path: name, fields });
+    entries[name] = rows.map(
+      (row) => Object.fromEntries(Object.entries(row).filter(([k]) => keys.has(k)))
+    );
+  };
+  for (const [key, value] of Object.entries(data)) {
+    if (isRowList(value)) {
+      addCollection(key, value);
+    } else if (isPlainObject(value)) {
+      const name = uniqueName(slugify(key));
+      const flat = {};
+      for (const [k, v] of Object.entries(value)) {
+        if (isRowList(v)) addCollection(usedNames.has(slugify(k)) ? `${key}-${k}` : k, v, k);
+        else if (inferType(v) !== null) flat[k] = v;
+      }
+      singletons.push({ name, label: key, path: `${name}.json`, fields: fieldsFromRows([flat]) });
+      singletonData[name] = flat;
+    } else {
+      const t = inferType(value);
+      if (t) {
+        generalFields.push({ key, label: key, type: t });
+        generalData[key] = value;
+      }
+    }
+  }
+  if (generalFields.length > 0) {
+    const name = uniqueName("genel");
+    singletons.push({ name, label: "Genel", path: `${name}.json`, fields: generalFields });
+    singletonData[name] = generalData;
+  }
+  return { schema: { version: 1, collections, singletons }, entries, singletons: singletonData };
+}
 
 // src/commands/export.ts
 import { zipSync } from "fflate";
@@ -4387,9 +4479,7 @@ async function resolveContentDir(root2) {
 }
 
 // src/commands/export.ts
-async function exportZip(root2, outFile = "justjson-export.zip") {
-  const adapter = new FsAdapter(root2);
-  const contentDir = await resolveContentDir(root2);
+async function collectExportZip(adapter, contentDir) {
   const schema = await loadSchema(adapter, contentDir);
   if (!schema) throw new Error("\u015Eema bulunamad\u0131. \xD6nce `justjson init` \xE7al\u0131\u015Ft\u0131r\u0131n.");
   const store = new ContentStore(adapter, schema, contentDir);
@@ -4414,7 +4504,12 @@ async function exportZip(root2, outFile = "justjson-export.zip") {
   for (const [path, content] of Object.entries(manifest)) {
     zipInput[path] = typeof content === "string" ? encoder.encode(content) : content;
   }
-  const zipped = zipSync(zipInput);
+  return zipSync(zipInput);
+}
+async function exportZip(root2, outFile = "justjson-export.zip") {
+  const adapter = new FsAdapter(root2);
+  const contentDir = await resolveContentDir(root2);
+  const zipped = await collectExportZip(adapter, contentDir);
   const outAbs = join(root2, outFile);
   await writeFile2(outAbs, zipped);
   return outAbs;
@@ -4422,6 +4517,8 @@ async function exportZip(root2, outFile = "justjson-export.zip") {
 
 // src/templates/blog.json
 var blog_default = {
+  title: "Blog",
+  description: "Rich-text i\xE7erikli yaz\u0131lar ve site ad\u0131 i\xE7in bir Ayarlar.",
   schema: {
     version: 1,
     collections: [
@@ -4451,8 +4548,49 @@ var blog_default = {
   }
 };
 
+// src/templates/changelog.json
+var changelog_default = {
+  title: "Changelog",
+  description: "S\xFCr\xFCm notlar\u0131: versiyon, tarih, t\xFCr ve rich-text a\xE7\u0131klama.",
+  schema: {
+    version: 1,
+    collections: [
+      {
+        name: "releases",
+        label: "S\xFCr\xFCmler",
+        path: "releases",
+        fields: [
+          { key: "version", label: "Versiyon", type: "text", required: true },
+          { key: "slug", label: "Slug", type: "text", required: true },
+          { key: "date", label: "Tarih", type: "date" },
+          {
+            key: "type",
+            label: "T\xFCr",
+            type: "select",
+            options: ["Eklendi", "De\u011Fi\u015Fti", "D\xFCzeltildi"]
+          },
+          { key: "body", label: "Notlar", type: "richtext" }
+        ]
+      }
+    ],
+    singletons: []
+  },
+  samples: {
+    releases: [
+      {
+        version: "1.0.0",
+        slug: "1-0-0",
+        type: "Eklendi",
+        body: "\u0130lk s\xFCr\xFCm."
+      }
+    ]
+  }
+};
+
 // src/templates/cv.json
 var cv_default = {
+  title: "CV",
+  description: "Deneyim koleksiyonu ve ki\u015Fisel bilgiler i\xE7in bir Profil.",
   schema: {
     version: 1,
     collections: [
@@ -4484,22 +4622,128 @@ var cv_default = {
   }
 };
 
+// src/templates/docs.json
+var docs_default = {
+  title: "Dok\xFCmantasyon",
+  description: "S\u0131ralanabilir sayfalar ve rich-text i\xE7erik; site ba\u015Fl\u0131\u011F\u0131 i\xE7in bir Ayarlar.",
+  schema: {
+    version: 1,
+    collections: [
+      {
+        name: "pages",
+        label: "Sayfalar",
+        path: "pages",
+        fields: [
+          { key: "title", label: "Ba\u015Fl\u0131k", type: "text", required: true },
+          { key: "slug", label: "Slug", type: "text", required: true },
+          { key: "order", label: "S\u0131ra", type: "number" },
+          { key: "body", label: "\u0130\xE7erik", type: "richtext" }
+        ]
+      }
+    ],
+    singletons: [
+      {
+        name: "settings",
+        label: "Ayarlar",
+        path: "settings.json",
+        fields: [
+          { key: "title", label: "Site ad\u0131", type: "text" },
+          { key: "tagline", label: "Slogan", type: "text" }
+        ]
+      }
+    ]
+  },
+  samples: {
+    pages: [
+      { title: "Ba\u015Flarken", slug: "baslarken", order: 1, body: "Kuruluma ho\u015F geldin." }
+    ]
+  }
+};
+
+// src/templates/portfolio.json
+var portfolio_default = {
+  title: "Portfolyo",
+  description: "Kapak g\xF6rseli, etiket ve rich-text i\xE7erikli projeler; bir de Hakk\u0131nda sayfas\u0131.",
+  schema: {
+    version: 1,
+    collections: [
+      {
+        name: "projects",
+        label: "Projeler",
+        path: "projects",
+        fields: [
+          { key: "title", label: "Ba\u015Fl\u0131k", type: "text", required: true },
+          { key: "slug", label: "Slug", type: "text", required: true },
+          { key: "summary", label: "\xD6zet", type: "text" },
+          { key: "cover", label: "Kapak", type: "image" },
+          { key: "url", label: "Ba\u011Flant\u0131", type: "text" },
+          {
+            key: "kind",
+            label: "T\xFCr",
+            type: "select",
+            options: ["Web", "Mobil", "Tasar\u0131m"]
+          },
+          { key: "body", label: "\u0130\xE7erik", type: "richtext" },
+          { key: "date", label: "Tarih", type: "date" }
+        ]
+      }
+    ],
+    singletons: [
+      {
+        name: "about",
+        label: "Hakk\u0131nda",
+        path: "about.json",
+        fields: [
+          { key: "name", label: "Ad", type: "text", required: true },
+          { key: "avatar", label: "Avatar", type: "image" },
+          { key: "bio", label: "Biyografi", type: "richtext" }
+        ]
+      }
+    ]
+  },
+  samples: {
+    projects: [
+      {
+        title: "\xD6rnek Proje",
+        slug: "ornek-proje",
+        summary: "K\u0131sa bir a\xE7\u0131klama.",
+        kind: "Web",
+        body: "Proje detaylar\u0131 burada."
+      }
+    ]
+  }
+};
+
 // src/commands/init.ts
 var templates = {
   blog: blog_default,
-  cv: cv_default
+  cv: cv_default,
+  portfolio: portfolio_default,
+  docs: docs_default,
+  changelog: changelog_default
 };
 function listTemplates() {
   return Object.keys(templates);
 }
-async function initProject(root2, templateName) {
-  const template = templates[templateName];
-  if (!template) throw new Error(`Bilinmeyen template: ${templateName}`);
-  const adapter = new FsAdapter(root2);
-  const contentDir = await resolveContentDir(root2);
-  if (await loadSchema(adapter, contentDir)) {
-    throw new Error("Bu klas\xF6rde zaten bir \u015Fema var (content/_schema.json).");
-  }
+function getTemplate(name) {
+  return templates[name];
+}
+function templateList() {
+  return Object.entries(templates).map(([id, t]) => {
+    const s = t.schema;
+    return {
+      id,
+      title: t.title,
+      description: t.description,
+      collections: s.collections.map((c) => ({
+        label: c.label ?? c.name,
+        fields: c.fields.length
+      })),
+      singletons: s.singletons.map((sg) => ({ label: sg.label ?? sg.name }))
+    };
+  });
+}
+async function applyTemplate(adapter, contentDir, template) {
   const schema = parseSchema(template.schema);
   await saveSchema(adapter, schema, contentDir);
   const store = new ContentStore(adapter, schema, contentDir);
@@ -4509,6 +4753,17 @@ async function initProject(root2, templateName) {
       await store.writeEntry(collection, slug, row);
     }
   }
+  return schema;
+}
+async function initProject(root2, templateName) {
+  const template = templates[templateName];
+  if (!template) throw new Error(`Bilinmeyen template: ${templateName}`);
+  const adapter = new FsAdapter(root2);
+  const contentDir = await resolveContentDir(root2);
+  if (await loadSchema(adapter, contentDir)) {
+    throw new Error("Bu klas\xF6rde zaten bir \u015Fema var (content/_schema.json).");
+  }
+  await applyTemplate(adapter, contentDir, template);
 }
 
 // src/commands/types.ts
@@ -4525,7 +4780,7 @@ async function generateTypesFile(root2, outPath = "types.ts") {
 // src/server.ts
 import { exec } from "child_process";
 import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile3 } from "fs/promises";
-import { dirname as dirname2, extname, join as join3, normalize } from "path";
+import { basename, dirname as dirname2, extname, join as join3, normalize } from "path";
 import { fileURLToPath } from "url";
 import { serve } from "@hono/node-server";
 import { Hono } from "hono";
@@ -4553,6 +4808,71 @@ async function createServer(root2) {
     if (msg.startsWith("G\xFCvensiz") || msg.startsWith("Yol")) return c.json({ error: msg }, 400);
     return c.json({ error: "sunucu hatas\u0131" }, 500);
   });
+  app.get(
+    "/api/_project",
+    (c) => c.json({
+      name: basename(root2) || "proje",
+      path: root2,
+      contentDir,
+      collections: schema.collections.length,
+      singletons: schema.singletons.length
+    })
+  );
+  app.get("/api/_templates", (c) => c.json({ items: templateList() }));
+  app.post("/api/_init", async (c) => {
+    const { template: id } = await c.req.json();
+    const t = id ? getTemplate(id) : void 0;
+    if (!t) return c.json({ error: "Bilinmeyen template" }, 404);
+    if (schema.collections.length > 0 || schema.singletons.length > 0) {
+      return c.json({ error: "Bu klas\xF6rde zaten bir \u015Fema var." }, 400);
+    }
+    schema = await applyTemplate(adapter, contentDir, t);
+    store = new ContentStore(adapter, schema, contentDir);
+    return c.json({ ok: true });
+  });
+  app.post("/api/_import", async (c) => {
+    if (schema.collections.length > 0 || schema.singletons.length > 0) {
+      return c.json({ error: "Bu klas\xF6rde zaten bir \u015Fema var." }, 400);
+    }
+    const { raw } = await c.req.json();
+    let next;
+    let entries = {};
+    let singletonData = {};
+    try {
+      next = parseSchema(raw);
+    } catch {
+      try {
+        const inferred = inferProject(raw);
+        next = parseSchema(inferred.schema);
+        entries = inferred.entries;
+        singletonData = inferred.singletons;
+      } catch (e) {
+        return c.json({ error: `\u0130\xE7e aktar\u0131lamad\u0131: ${e.message}` }, 400);
+      }
+    }
+    await saveSchema(adapter, next, contentDir);
+    schema = next;
+    store = new ContentStore(adapter, schema, contentDir);
+    for (const [collection, rows] of Object.entries(entries)) {
+      for (const row of rows) {
+        const slug = slugify(String(row.slug ?? row.title ?? "icerik")) || "icerik";
+        await store.writeEntry(collection, slug, row);
+      }
+    }
+    for (const [name, data] of Object.entries(singletonData)) {
+      await store.writeSingleton(name, data);
+    }
+    return c.json({ ok: true });
+  });
+  app.get("/api/_export", async (c) => {
+    const zipped = await collectExportZip(adapter, contentDir);
+    return new Response(zipped, {
+      headers: {
+        "content-type": "application/zip",
+        "content-disposition": 'attachment; filename="justjson-export.zip"'
+      }
+    });
+  });
   app.get("/api/_schema", (c) => c.json(schema));
   app.put("/api/_schema", async (c) => {
     let next;