nebula-cms 0.1.3 → 0.1.5

package/dist/client/js/state/router.svelte.js

@@ -0,0 +1,141 @@
+/*
+ * Parsed route state for the admin SPA.
+ * The base path is set at build time via virtual:nebula/config so both
+ * client-side code and the Vite dev server share the same value.
+ */
+import config from 'virtual:nebula/config';
+// Build-time constant — configured via the Astro integration
+const basePath = config.basePath;
+/*
+ * Current route, reactive via Svelte 5 runes.
+ * Defaults to 'home' during SSR where location is unavailable;
+ * the client re-initializes from the real pathname on hydration.
+ */
+let route = $state(typeof location !== 'undefined'
+    ? parsePathname(location.pathname)
+    : { view: 'home' });
+export const nav = {
+    // Current parsed admin route.
+    get route() {
+        return route;
+    },
+};
+/**
+ * Builds an absolute path under the configured basePath by joining segments.
+ * Handles the root basePath case ('/') without producing double slashes.
+ * @param {...string} segments - Path segments to append (e.g. 'authors', 'my-post')
+ * @return {string} The joined path (e.g. '/admin/authors/my-post' or '/authors/my-post')
+ */
+export function adminPath(...segments) {
+    if (segments.length === 0)
+        return basePath;
+    const prefix = basePath === '/' ? '' : basePath;
+    return prefix + '/' + segments.join('/');
+}
+/**
+ * Checks whether a pathname falls under the configured basePath.
+ * Matches the basePath exactly or as a prefix followed by '/'.
+ * @param {string} pathname - The URL pathname to test
+ * @return {boolean} True if the pathname is within the basePath
+ */
+function isUnderBasePath(pathname) {
+    // When basePath is '/', every absolute path is under it
+    if (basePath === '/')
+        return pathname.startsWith('/');
+    return pathname === basePath || pathname.startsWith(basePath + '/');
+}
+/**
+ * Parses a pathname into an AdminRoute by stripping the basePath prefix.
+ * @param {string} pathname - The URL pathname to parse
+ * @return {AdminRoute} The route corresponding to the given pathname
+ */
+function parsePathname(pathname) {
+    /*
+     * Strip the basePath prefix at a segment boundary, then split the remainder.
+     * Must mirror isUnderBasePath's boundary check to avoid false matches
+     * (e.g. basePath '/cms' should not match pathname '/cmsextra/posts').
+     */
+    const underBase = isUnderBasePath(pathname);
+    const rest = underBase ? pathname.slice(basePath.length) : pathname;
+    const segments = rest.split('/').filter(Boolean);
+    /*
+     * Draft URLs use a 2-segment pattern: {basePath}/{collection}/draft-{draftId}
+     * This keeps the same URL depth as regular files so Astro static paths work.
+     */
+    if (segments.length >= 2 && segments[1].startsWith('draft-')) {
+        return {
+            view: 'draft',
+            collection: segments[0],
+            draftId: segments[1].slice('draft-'.length),
+        };
+    }
+    if (segments.length >= 2) {
+        return { view: 'file', collection: segments[0], slug: segments[1] };
+    }
+    if (segments.length === 1) {
+        return { view: 'collection', collection: segments[0] };
+    }
+    return { view: 'home' };
+}
+/**
+ * Navigates to a path within the admin SPA using the Navigation API.
+ * @param {string} path - The path to navigate to (e.g., '/admin/posts')
+ * @return {void}
+ */
+export function navigate(path) {
+    navigation.navigate(path);
+}
+// Callback to check if the editor has unsaved changes
+let dirtyChecker = null;
+/**
+ * Registers a function that returns whether the editor has unsaved changes.
+ * @param {() => boolean} checker - Function returning true if there are unsaved changes
+ * @return {void}
+ */
+export function registerDirtyChecker(checker) {
+    dirtyChecker = checker;
+}
+// Guard against duplicate listener registration (e.g., HMR remount)
+let initialized = false;
+/**
+ * Initializes the Navigation API listener, intercepting navigations under the
+ * configured basePath and updating reactive route state.
+ * Safe to call multiple times — registers the listener only once.
+ * @return {void}
+ */
+export function initRouter() {
+    if (initialized)
+        return;
+    initialized = true;
+    navigation.addEventListener('navigate', (event) => {
+        const url = new URL(event.destination.url);
+        // Only intercept navigations within the configured basePath
+        if (!isUnderBasePath(url.pathname))
+            return;
+        // Don't intercept downloads or hash-only changes
+        if (event.hashChange || event.downloadRequest)
+            return;
+        if (!event.canIntercept)
+            return;
+        /*
+         * Block navigation if editor has unsaved changes and user cancels.
+         * This check must happen before event.intercept() — if it were inside the
+         * handler, the URL would already be updated by the time the user cancels.
+         */
+        if (dirtyChecker?.() &&
+            !confirm('You have unsaved changes. Leave without saving?')) {
+            event.preventDefault();
+            return;
+        }
+        event.intercept({
+            async handler() {
+                route = parsePathname(url.pathname);
+            },
+        });
+    });
+    window.addEventListener('beforeunload', (event) => {
+        if (dirtyChecker?.()) {
+            event.preventDefault();
+        }
+    });
+}

package/dist/client/js/state/schema.svelte.d.ts

@@ -0,0 +1,51 @@
+type JsonSchema = Record<string, unknown>;
+export declare const schema: {
+    readonly active: JsonSchema | null;
+};
+/**
+ * Fetches all collection schemas in parallel and caches them.
+ * Call once on app startup so schema-derived state is available before the first collection renders.
+ * @return {Promise<void>}
+ */
+export declare function prefetchAllSchemas(): Promise<void>;
+/**
+ * Fetches and caches the JSON Schema for a collection, then sets the reactive schema state.
+ * @param {string} collection - The collection name to fetch the schema for
+ * @return {Promise<void>}
+ */
+export declare function fetchSchema(collection: string): Promise<void>;
+/**
+ * Returns true if the collection's schema has a date-time property, indicating it supports date-based sorting.
+ * Requires prefetchAllSchemas to have been called; returns false if the schema isn't cached yet.
+ * @param {string} collection - The collection name to check
+ * @return {boolean} True if any property in the schema uses the date-time format
+ */
+export declare function collectionHasDates(collection: string): boolean;
+/**
+ * Returns the display title for a collection from its cached schema.
+ * Returns null if the schema hasn't been fetched or has no title.
+ * @param {string} collection - The collection name
+ * @return {string | null} The schema title, or null
+ */
+export declare function getCollectionTitle(collection: string): string | null;
+/**
+ * Returns the description for a collection from its cached schema.
+ * Returns null if the schema hasn't been fetched or has no description.
+ * @param {string} collection - The collection name
+ * @return {string | null} The schema description, or null
+ */
+export declare function getCollectionDescription(collection: string): string | null;
+/**
+ * Returns the resolved file extensions for a collection from its cached schema.
+ * Falls back to ['.md', '.mdx'] if the schema hasn't been fetched or declares no files.
+ * @param {string} collection - The collection name
+ * @return {string[]} Array of file extensions
+ */
+export declare function getSchemaExtensions(collection: string): string[];
+/**
+ * Clears the active schema.
+ * @return {void}
+ */
+export declare function clearSchema(): void;
+export {};
+//# sourceMappingURL=schema.svelte.d.ts.map

package/dist/client/js/state/schema.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.svelte.d.ts","sourceRoot":"","sources":["../../../../src/client/js/state/schema.svelte.ts"],"names":[],"mappings":"AASA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAQ1C,eAAO,MAAM,MAAM;qBAEH,UAAU,GAAG,IAAI;CAGhC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAYxD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAM9D;AAgBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1E;AAUD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAKhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/{src/client/js/state/schema.svelte.ts → dist/client/js/state/schema.svelte.js}

@@ -2,80 +2,68 @@
  * Reactive schema state for the admin SPA.
  * Fetches, caches, and exposes JSON Schemas for content collections.
  */
-
 import schemas from 'virtual:nebula/collections';
 import { getExtensionsForSchema } from '../utils/file-types';
-
-// JSON Schema object type.
-type JsonSchema = Record<string, unknown>;
-
 // Cache of fetched schemas keyed by collection name
-const cache = new Map<string, JsonSchema>();
-
+const cache = new Map();
 // Currently active schema for the selected collection
-let activeSchema = $state<JsonSchema | null>(null);
-
+let activeSchema = $state(null);
 export const schema = {
-  // The loaded JSON Schema for the active collection, or null.
-  get active(): JsonSchema | null {
-    return activeSchema;
-  },
+    // The loaded JSON Schema for the active collection, or null.
+    get active() {
+        return activeSchema;
+    },
 };
-
 /**
  * Fetches all collection schemas in parallel and caches them.
  * Call once on app startup so schema-derived state is available before the first collection renders.
  * @return {Promise<void>}
  */
-export async function prefetchAllSchemas(): Promise<void> {
-  const entries = Object.entries(schemas);
-  const results = await Promise.all(
-    entries.map(async ([name, url]) => {
-      const response = await fetch(url);
-      const data = (await response.json()) as JsonSchema;
-      return [name, data] as const;
-    }),
-  );
-  for (const [name, data] of results) {
-    cache.set(name, data);
-  }
+export async function prefetchAllSchemas() {
+    const entries = Object.entries(schemas);
+    const results = await Promise.all(entries.map(async ([name, url]) => {
+        const response = await fetch(url);
+        const data = (await response.json());
+        return [name, data];
+    }));
+    for (const [name, data] of results) {
+        cache.set(name, data);
+    }
 }
-
 /**
  * Fetches and caches the JSON Schema for a collection, then sets the reactive schema state.
  * @param {string} collection - The collection name to fetch the schema for
  * @return {Promise<void>}
  */
-export async function fetchSchema(collection: string): Promise<void> {
-  const cached = cache.get(collection);
-  if (cached) {
-    activeSchema = cached;
-    return;
-  }
-
-  const url = schemas[collection];
-  if (!url) return;
-
-  const response = await fetch(url);
-  const data = (await response.json()) as JsonSchema;
-  cache.set(collection, data);
-  activeSchema = data;
+export async function fetchSchema(collection) {
+    const cached = cache.get(collection);
+    if (cached) {
+        activeSchema = cached;
+        return;
+    }
+    const url = schemas[collection];
+    if (!url)
+        return;
+    const response = await fetch(url);
+    const data = (await response.json());
+    cache.set(collection, data);
+    activeSchema = data;
 }
-
 /**
  * Returns true if the collection's schema has a date-time property, indicating it supports date-based sorting.
  * Requires prefetchAllSchemas to have been called; returns false if the schema isn't cached yet.
  * @param {string} collection - The collection name to check
  * @return {boolean} True if any property in the schema uses the date-time format
  */
-export function collectionHasDates(collection: string): boolean {
-  const s = cache.get(collection);
-  if (!s) return false;
-  const props = s['properties'] as Record<string, JsonSchema> | undefined;
-  if (!props) return false;
-  return Object.values(props).some((p) => p['format'] === 'date-time');
+export function collectionHasDates(collection) {
+    const s = cache.get(collection);
+    if (!s)
+        return false;
+    const props = s['properties'];
+    if (!props)
+        return false;
+    return Object.values(props).some((p) => p['format'] === 'date-time');
 }
-
 /**
  * Reads a top-level string field from a collection's cached schema.
  * Returns null if the schema isn't cached or the field is absent/non-string.
@@ -83,33 +71,31 @@ export function collectionHasDates(collection: string): boolean {
  * @param {string} field - The schema field to read (e.g. 'title', 'description')
  * @return {string | null} The field value, or null
  */
-function getStringField(collection: string, field: string): string | null {
-  const s = cache.get(collection);
-  if (!s) return null;
-  const value = s[field];
-  return typeof value === 'string' ? value : null;
+function getStringField(collection, field) {
+    const s = cache.get(collection);
+    if (!s)
+        return null;
+    const value = s[field];
+    return typeof value === 'string' ? value : null;
 }
-
 /**
  * Returns the display title for a collection from its cached schema.
  * Returns null if the schema hasn't been fetched or has no title.
  * @param {string} collection - The collection name
  * @return {string | null} The schema title, or null
  */
-export function getCollectionTitle(collection: string): string | null {
-  return getStringField(collection, 'title');
+export function getCollectionTitle(collection) {
+    return getStringField(collection, 'title');
 }
-
 /**
  * Returns the description for a collection from its cached schema.
  * Returns null if the schema hasn't been fetched or has no description.
  * @param {string} collection - The collection name
  * @return {string | null} The schema description, or null
  */
-export function getCollectionDescription(collection: string): string | null {
-  return getStringField(collection, 'description');
+export function getCollectionDescription(collection) {
+    return getStringField(collection, 'description');
 }
-
 /*
  * Known race condition: if a caller invokes getSchemaExtensions before
  * prefetchAllSchemas() has completed, the schema won't be cached yet and the
@@ -117,24 +103,23 @@ export function getCollectionDescription(collection: string): string | null {
  * mitigates this by awaiting initPromise, which includes prefetchAllSchemas().
  * If the ordering changes, callers should await prefetchAllSchemas() first.
  */
-
 /**
  * Returns the resolved file extensions for a collection from its cached schema.
  * Falls back to ['.md', '.mdx'] if the schema hasn't been fetched or declares no files.
  * @param {string} collection - The collection name
  * @return {string[]} Array of file extensions
  */
-export function getSchemaExtensions(collection: string): string[] {
-  const s = cache.get(collection);
-  if (!s) return ['.md', '.mdx'];
-  const extensions = getExtensionsForSchema(s);
-  return extensions.length > 0 ? extensions : ['.md', '.mdx'];
+export function getSchemaExtensions(collection) {
+    const s = cache.get(collection);
+    if (!s)
+        return ['.md', '.mdx'];
+    const extensions = getExtensionsForSchema(s);
+    return extensions.length > 0 ? extensions : ['.md', '.mdx'];
 }
-
 /**
  * Clears the active schema.
  * @return {void}
  */
-export function clearSchema(): void {
-  activeSchema = null;
+export function clearSchema() {
+    activeSchema = null;
 }

package/dist/client/js/state/state.svelte.d.ts

@@ -0,0 +1,68 @@
+import { StorageClient } from '../storage/client';
+import { drafts, refreshDrafts } from '../drafts/merge.svelte';
+export { drafts, refreshDrafts };
+export type ContentItem = {
+    filename: string;
+    data: Record<string, unknown>;
+};
+type PermissionState = 'granted' | 'prompt' | 'denied';
+type BackendType = 'fsa' | 'github' | null;
+export declare const collections: string[];
+export declare const storageClient: StorageClient;
+export declare const backend: {
+    readonly type: BackendType;
+    readonly ready: boolean;
+    readonly permission: PermissionState;
+};
+export declare const content: {
+    readonly list: ContentItem[];
+    readonly loading: boolean;
+    readonly error: string | null;
+};
+/**
+ * Restores a stored backend config from IndexedDB and initializes the SharedWorker.
+ * @return {Promise<void>}
+ */
+export declare function restoreBackend(): Promise<void>;
+/**
+ * Re-requests FSA permission. Must be called from a user gesture.
+ * @return {Promise<void>}
+ */
+export declare function requestPermission(): Promise<void>;
+/**
+ * Opens the directory picker and initializes the FSA backend. Must be called from a user gesture.
+ * @return {Promise<void>}
+ */
+export declare function pickDirectory(): Promise<void>;
+/**
+ * Connects to a GitHub repository via PAT and persists the config.
+ * @param {string} token - GitHub Personal Access Token
+ * @param {string} repo - Repository in "owner/repo" format
+ * @return {Promise<void>}
+ */
+export declare function connectGitHub(token: string, repo: string): Promise<void>;
+/**
+ * Disconnects the backend, clears credentials, and resets all state.
+ * @return {Promise<void>}
+ */
+export declare function disconnect(): Promise<void>;
+/**
+ * Loads a collection. Serves from cache instantly if available, then background refreshes.
+ * @param {string} collection - The collection name to load
+ * @return {void}
+ */
+export declare function loadCollection(collection: string): void;
+/**
+ * Forces a background reload, keeping the sidebar visible.
+ * @param {string} collection - The collection to reload
+ * @return {void}
+ */
+export declare function reloadCollection(collection: string): void;
+/**
+ * Optimistically updates a single item's frontmatter in the content list and cache.
+ * @param {string} filename - The filename to update
+ * @param {Record<string, unknown>} data - The new frontmatter data
+ * @return {void}
+ */
+export declare function updateContentItem(filename: string, data: Record<string, unknown>): void;
+//# sourceMappingURL=state.svelte.d.ts.map

package/dist/client/js/state/state.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.svelte.d.ts","sourceRoot":"","sources":["../../../../src/client/js/state/state.svelte.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EACL,MAAM,EAEN,aAAa,EAEd,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAGjC,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAGF,KAAK,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,KAAK,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE3C,eAAO,MAAM,WAAW,UAA8B,CAAC;AAoBvD,eAAO,MAAM,aAAa,EAErB,aAAa,CAAC;AAQnB,eAAO,MAAM,OAAO;mBAEN,WAAW;oBAIV,OAAO;yBAIF,eAAe;CAGlC,CAAC;AAEF,eAAO,MAAM,OAAO;mBAEN,WAAW,EAAE;sBAIV,OAAO;oBAIT,MAAM,GAAG,IAAI;CAG3B,CAAC;AAoEF;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA6CpD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAcvD;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAcnD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAehD;AAYD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAYvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAMN"}