nebula-cms 0.1.0

package/playground/src/content/authors/jane-doe.json

@@ -0,0 +1,8 @@
+{
+  "name": "Jane Doe",
+  "bio": "Technical writer and web developer.",
+  "social": {
+    "github": "janedoe",
+    "twitter": "janedoe"
+  }
+}

package/playground/src/content/config/build.toml

@@ -0,0 +1,2 @@
+name = "production"
+debug = false

package/playground/src/content/courses/web-fundamentals.json

@@ -0,0 +1,29 @@
+{
+  "title": "Web Fundamentals",
+  "instructor": {
+    "name": "Dr. Smith",
+    "credentials": [
+      {
+        "institution": "MIT",
+        "year": 2015
+      }
+    ]
+  },
+  "modules": [
+    {
+      "title": "HTML Basics",
+      "lessons": [
+        {
+          "title": "Document Structure",
+          "duration": 30,
+          "resources": [
+            {
+              "type": "video",
+              "url": "https://example.com/html-structure"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/playground/src/content/docs/advanced.mdx

@@ -0,0 +1,6 @@
+---
+title: Advanced Usage
+category: advanced
+---
+
+This guide covers advanced topics.

package/playground/src/content/docs/intro.md

@@ -0,0 +1,6 @@
+---
+title: Introduction
+category: basics
+---
+
+Welcome to the documentation.

package/playground/src/content/guides/getting-started.mdx

@@ -0,0 +1,6 @@
+---
+title: Getting Started
+order: 1
+---
+
+Welcome to the **getting started** guide.

package/playground/src/content/posts/hello-world.md

@@ -0,0 +1,7 @@
+---
+title: Hello World
+date: 2026-01-15
+author: jane-doe
+---
+
+A sample post for development testing.

package/playground/src/content/products/t-shirt.json

@@ -0,0 +1,16 @@
+{
+  "name": "Logo T-Shirt",
+  "price": 29.99,
+  "variants": [
+    {
+      "sku": "TS-BLK-M",
+      "color": "black",
+      "sizes": ["S", "M", "L", "XL"]
+    },
+    {
+      "sku": "TS-WHT-M",
+      "color": "white",
+      "sizes": ["S", "M", "L"]
+    }
+  ]
+}

package/playground/src/content/recipes/pancakes.mdoc

@@ -0,0 +1,8 @@
+---
+title: Fluffy Pancakes
+servings: 4
+---
+
+# Fluffy Pancakes
+
+Mix dry ingredients, add wet, cook on griddle.

package/playground/src/content/settings/site.yml

@@ -0,0 +1,2 @@
+siteName: My Blog
+maxPosts: 10

package/playground/src/content.config.ts

@@ -0,0 +1,198 @@
+import { defineCollection, reference } from 'astro:content';
+import { glob } from 'astro/loaders';
+import { z } from 'astro/zod';
+
+//////////////////////////////
+// Content collection definitions for the playground.
+//
+// These exercise a range of schema shapes: flat fields, cross-collection references, nested objects, and deeply nested arrays of objects.
+//////////////////////////////
+
+// Simple flat schema with a cross-collection reference
+const posts = defineCollection({
+  loader: glob({ base: './src/content/posts', pattern: '**/*.md' }),
+  schema: z
+    .object({
+      title: z.string(),
+      date: z.date(),
+      draft: z.boolean().optional(),
+      author: reference('authors'),
+    })
+    .meta({
+      title: 'Posts',
+      description: 'Blog posts',
+      files: ['md'],
+    }),
+});
+
+// Nested object — social has optional string fields
+const authors = defineCollection({
+  loader: glob({ base: './src/content/authors', pattern: '**/*.json' }),
+  schema: z
+    .object({
+      name: z.string(),
+      bio: z.string(),
+      social: z.object({
+        twitter: z.string().optional(),
+        github: z.string().optional(),
+        website: z.string().optional(),
+      }),
+    })
+    .meta({
+      title: 'Authors',
+      description: 'Those who write',
+      files: ['json'],
+    }),
+});
+
+// Array of nested objects, each containing a nested array
+const products = defineCollection({
+  loader: glob({ base: './src/content/products', pattern: '**/*.json' }),
+  schema: z
+    .object({
+      name: z.string(),
+      price: z.number(),
+      variants: z.array(
+        z.object({
+          sku: z.string(),
+          color: z.string(),
+          sizes: z.array(z.string()),
+        }),
+      ),
+    })
+    .meta({
+      title: 'Products',
+      description: 'Things to buy',
+      files: ['json'],
+    }),
+});
+
+// Deep nesting: object with array, array of objects with nested arrays of objects
+const courses = defineCollection({
+  loader: glob({ base: './src/content/courses', pattern: '**/*.json' }),
+  schema: z
+    .object({
+      title: z.string(),
+      instructor: z.object({
+        name: z.string(),
+        credentials: z.array(
+          z.object({
+            institution: z.string(),
+            year: z.number(),
+          }),
+        ),
+      }),
+      modules: z.array(
+        z.object({
+          title: z.string(),
+          lessons: z.array(
+            z.object({
+              title: z.string(),
+              duration: z.number(),
+              resources: z.array(
+                z.object({
+                  type: z.string(),
+                  url: z.string(),
+                }),
+              ),
+            }),
+          ),
+        }),
+      ),
+    })
+    .meta({
+      title: 'Courses',
+      description: 'Things to learn',
+      files: ['json'],
+    }),
+});
+
+// How-to guides authored in MDX
+const guides = defineCollection({
+  loader: glob({ base: './src/content/guides', pattern: '**/*.mdx' }),
+  schema: z
+    .object({
+      title: z.string(),
+      order: z.number(),
+    })
+    .meta({
+      title: 'Guides',
+      description: 'How-to guides in MDX',
+      files: ['mdx'],
+    }),
+});
+
+// Cooking recipes authored in Markdoc
+const recipes = defineCollection({
+  loader: glob({
+    base: './src/content/recipes',
+    pattern: '**/*.{mdoc,markdoc}',
+  }),
+  schema: z
+    .object({
+      title: z.string(),
+      servings: z.number(),
+    })
+    .meta({
+      title: 'Recipes',
+      description: 'Cooking recipes in Markdoc',
+      files: ['markdoc'],
+    }),
+});
+
+// Site configuration stored as YAML
+const settings = defineCollection({
+  loader: glob({ base: './src/content/settings', pattern: '**/*.{yml,yaml}' }),
+  schema: z
+    .object({
+      siteName: z.string(),
+      maxPosts: z.number(),
+    })
+    .meta({
+      title: 'Settings',
+      description: 'Site configuration in YAML',
+      files: ['yaml'],
+    }),
+});
+
+// Build configuration stored as TOML
+const config = defineCollection({
+  loader: glob({ base: './src/content/config', pattern: '**/*.toml' }),
+  schema: z
+    .object({
+      name: z.string(),
+      debug: z.boolean(),
+    })
+    .meta({
+      title: 'Config',
+      description: 'Build configuration in TOML',
+      files: ['toml'],
+    }),
+});
+
+// Documentation pages supporting both MD and MDX
+const docs = defineCollection({
+  loader: glob({ base: './src/content/docs', pattern: '**/*.{md,mdx}' }),
+  schema: z
+    .object({
+      title: z.string(),
+      category: z.string(),
+    })
+    .meta({
+      title: 'Documentation',
+      description: 'Docs in MD and MDX',
+      files: ['md', 'mdx'],
+    }),
+});
+
+export const collections = {
+  posts,
+  authors,
+  products,
+  courses,
+  guides,
+  recipes,
+  settings,
+  config,
+  docs,
+};

package/playground/src/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="nebula-cms/virtual" />

package/playground/src/pages/index.astro

@@ -0,0 +1,11 @@
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Nebula CMS playground</title>
+  </head>
+  <body>
+    <h1>Nebula CMS</h1>
+    <a href="/nebula">Nebula Admin Page</a>
+  </body>
+</html>

package/playground/src/pages/nebula.astro

@@ -0,0 +1,14 @@
+---
+import Admin from 'nebula-cms/client';
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>nebula-cms playground</title>
+  </head>
+  <body>
+    <Admin client:only="svelte" />
+  </body>
+</html>

package/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - playground

package/scripts/subset-icons.mjs

@@ -0,0 +1,178 @@
+/*
+ * Fetches a subsetted Material Symbols Outlined woff2 font from Google Fonts
+ * and inlines it as base64 in a self-contained CSS file. Run this script
+ * whenever the icon set changes to regenerate src/client/css/icons.css.
+ *
+ * Usage: node scripts/subset-icons.mjs
+ */
+
+import { writeFileSync, mkdirSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+//////////////////////////////
+// Icon set definition
+//////////////////////////////
+
+// Icons used across the admin UI — keep sorted alphabetically.
+const ICON_NAMES = [
+  'add',
+  'arrow_downward',
+  'arrow_upward',
+  'brightness_auto',
+  'chevron_right',
+  'close',
+  'dark_mode',
+  'drag_indicator',
+  'hourglass_arrow_down',
+  'hourglass_arrow_up',
+  'info',
+  'light_mode',
+  'logout',
+  'sort_by_alpha',
+];
+
+//////////////////////////////
+// Path resolution
+//////////////////////////////
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Absolute path where the generated CSS will be written.
+const OUTPUT_PATH = join(__dirname, '../src/client/css/icons.css');
+
+//////////////////////////////
+// Font fetch helpers
+//////////////////////////////
+
+/**
+ * Builds the Google Fonts CSS2 API URL for the subsetted icon font.
+ * @param {string[]} names - Sorted array of icon ligature names
+ * @return {string} The fully-formed Google Fonts API URL
+ */
+function buildFontsURL(names) {
+  const joined = names.sort().join(',');
+  return `https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined&icon_names=${joined}&display=block`;
+}
+
+/**
+ * Fetches the Google Fonts CSS stylesheet for the icon subset.
+ * @param {string} url - The Google Fonts API URL to fetch
+ * @return {Promise<string>} The CSS text returned by Google Fonts
+ */
+async function fetchFontCSS(url) {
+  // Spoof a modern browser UA — Google Fonts returns woff2 for modern UAs.
+  const res = await fetch(url, {
+    headers: {
+      'User-Agent':
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+    },
+  });
+
+  if (!res.ok) {
+    throw new Error(
+      `Google Fonts API returned ${res.status}: ${res.statusText}`,
+    );
+  }
+
+  return res.text();
+}
+
+/**
+ * Extracts the woff2 font binary URL from the Google Fonts CSS response.
+ * Google Fonts returns unquoted urls in the form: url(https://fonts.gstatic.com/...)
+ * The URL does not end in .woff2 — it is a signed CDN path — so we match on
+ * the format hint that follows it instead.
+ * @param {string} css - The CSS text returned by Google Fonts
+ * @return {string} The absolute woff2 URL
+ */
+function extractWoff2URL(css) {
+  // Match unquoted url(...) followed by format('woff2')
+  const match = css.match(/url\((https:\/\/[^)]+)\)\s+format\('woff2'\)/);
+  if (!match) {
+    throw new Error('Could not find woff2 URL in Google Fonts CSS response');
+  }
+  return match[1];
+}
+
+/**
+ * Downloads the woff2 binary and returns it as a base64-encoded string.
+ * @param {string} url - The absolute URL to the woff2 font file
+ * @return {Promise<string>} Base64-encoded woff2 binary data
+ */
+async function fetchWoff2AsBase64(url) {
+  const res = await fetch(url);
+
+  if (!res.ok) {
+    throw new Error(
+      `Font binary fetch returned ${res.status}: ${res.statusText}`,
+    );
+  }
+
+  const arrayBuffer = await res.arrayBuffer();
+  return Buffer.from(arrayBuffer).toString('base64');
+}
+
+//////////////////////////////
+// CSS generation
+//////////////////////////////
+
+/**
+ * Generates the full icons.css content with an inlined base64 woff2 font.
+ * @param {string} base64Font - The base64-encoded woff2 font data
+ * @return {string} Complete CSS file content
+ */
+function generateCSS(base64Font) {
+  return `/* Material Symbols Outlined, Subsetted 
+ * Icons: ${ICON_NAMES.sort().join(', ')}
+ */
+
+@font-face {
+  font-family: 'Material Symbols Outlined';
+  font-style: normal;
+  font-weight: 400;
+  font-display: block;
+  src: url('data:font/woff2;base64,${base64Font}') format('woff2');
+}
+
+.icon {
+  font-family: 'Material Symbols Outlined';
+  font-weight: normal;
+  font-style: normal;
+  font-size: 1.5rem;
+  line-height: 1;
+  letter-spacing: normal;
+  text-transform: none;
+  display: inline-block;
+  white-space: nowrap;
+  word-wrap: normal;
+  direction: ltr;
+  -webkit-font-smoothing: antialiased;
+  text-rendering: optimizeLegibility;
+  -moz-osx-font-smoothing: grayscale;
+  font-feature-settings: 'liga';
+}
+`;
+}
+
+//////////////////////////////
+// Entry point
+//////////////////////////////
+
+const fontsURL = buildFontsURL(ICON_NAMES);
+console.log(`Fetching icon subset CSS from Google Fonts...`);
+console.log(`URL: ${fontsURL}`);
+
+const fontCSS = await fetchFontCSS(fontsURL);
+const woff2URL = extractWoff2URL(fontCSS);
+console.log(`Found woff2 URL: ${woff2URL}`);
+
+console.log(`Downloading woff2 binary...`);
+const base64Font = await fetchWoff2AsBase64(woff2URL);
+console.log(`Base64-encoded font: ${base64Font.length} characters`);
+
+const css = generateCSS(base64Font);
+mkdirSync(dirname(OUTPUT_PATH), { recursive: true });
+writeFileSync(OUTPUT_PATH, css, 'utf8');
+console.log(`Written to: ${OUTPUT_PATH}`);