nebula-cms 0.1.0

package/tests/stubs/codemirror.ts

@@ -0,0 +1,197 @@
+/**
+ * Stub module for all @codemirror/* and @lezer/* imports used in the component test environment.
+ * These packages are runtime-only dependencies not installed as devDependencies.
+ * The vitest.config.ts components project redirects every @codemirror/* and @lezer/*
+ * specifier here so EditorPane can be imported without resolution failures.
+ */
+
+/**
+ * Noop class standing in for CodeMirror's EditorView.
+ * Static members cover all call sites in EditorPane, link-wrap, and markdown-shortcuts.
+ */
+export class EditorView {
+  static theme = () => ({});
+  static lineWrapping = {};
+  static updateListener = { of: () => ({}) };
+  static contentAttributes = { of: () => ({}) };
+  // Used by markdown-shortcuts to register a paste event handler
+  static domEventHandlers = () => ({});
+  // Used by markdown-shortcuts for bracket/quote wrapping
+  static inputHandler = { of: () => ({}) };
+
+  /**
+   * Noop replacement for EditorView.destroy().
+   * @return {void}
+   */
+  destroy() {}
+
+  /**
+   * Noop replacement for EditorView.setState().
+   * @param {unknown} _state - Ignored
+   * @return {void}
+   */
+  setState(_state?: unknown) {}
+
+  /**
+   * Noop replacement for EditorView.dispatch().
+   * @param {unknown} _tr - Ignored
+   * @return {void}
+   */
+  dispatch(_tr?: unknown) {}
+
+  /**
+   * Stub getter returning a minimal EditorState-like shape.
+   * @return {{ selection: { main: { from: number, to: number, empty: boolean } }, changeByRange: Function, sliceDoc: Function }}
+   */
+  get state() {
+    return {
+      selection: { main: { from: 0, to: 0, empty: true } },
+      changeByRange: () => ({ changes: [], selection: {} }),
+      sliceDoc: () => '',
+    };
+  }
+}
+
+// Noop standing in for EditorState
+export const EditorState = {
+  create: () => ({}),
+};
+
+/**
+ * Noop class standing in for CodeMirror's Compartment.
+ * Used by EditorPane to isolate the language extension for runtime reconfiguration.
+ */
+export class Compartment {
+  /**
+   * Wraps an extension value for initial configuration.
+   * @param {unknown} _ext - Ignored
+   * @return {Record<string, never>} Empty object
+   */
+  of(_ext?: unknown) {
+    return {};
+  }
+
+  /**
+   * Returns a StateEffect for reconfiguring this compartment.
+   * @param {unknown} _ext - Ignored
+   * @return {Record<string, never>} Empty object standing in for a StateEffect
+   */
+  reconfigure(_ext?: unknown) {
+    return {};
+  }
+}
+
+// Minimal keymap stub
+export const keymap = { of: () => ({}) };
+
+// Command stubs
+export const defaultKeymap: unknown[] = [];
+
+/**
+ * Noop replacement for CodeMirror's history extension.
+ * @return {Record<string, never>} Empty object
+ */
+export function history() {
+  return {};
+}
+export const historyKeymap: unknown[] = [];
+
+/**
+ * Noop replacement for CodeMirror's markdown language extension.
+ * @return {Record<string, never>} Empty object
+ */
+export function markdown() {
+  return {};
+}
+export const markdownLanguage = {};
+
+// Language data stub
+export const languages: unknown[] = [];
+
+/**
+ * Noop replacement for CodeMirror's syntaxHighlighting extension.
+ * @return {Record<string, never>} Empty object
+ */
+export function syntaxHighlighting() {
+  return {};
+}
+export const HighlightStyle = {
+  define: () => ({}),
+};
+
+// ViewPlugin stub (used by link-wrap and markdown-shortcuts)
+// Both .define() and .fromClass() are used across the editor modules.
+export const ViewPlugin = {
+  define: () => ({}),
+  fromClass: () => ({}),
+};
+
+// Decoration stub (used by link-wrap)
+export const Decoration = {
+  mark: () => ({}),
+  none: {},
+  set: () => ({}),
+};
+
+/**
+ * Noop replacement for CodeMirror's RangeSetBuilder.
+ * Used by link-wrap to build decoration sets.
+ */
+export class RangeSetBuilder {
+  /**
+   * Noop replacement for RangeSetBuilder.add().
+   * @param {unknown} _from - Ignored
+   * @param {unknown} _to - Ignored
+   * @param {unknown} _value - Ignored
+   * @return {void}
+   */
+  add(_from?: unknown, _to?: unknown, _value?: unknown) {}
+
+  /**
+   * Noop replacement for RangeSetBuilder.finish().
+   * @return {Record<string, never>} Empty object standing in for a DecorationSet
+   */
+  finish() {
+    return {};
+  }
+}
+
+// EditorSelection stub (used by markdown-shortcuts)
+export const EditorSelection = {
+  cursor: () => ({}),
+  range: () => ({}),
+};
+
+// Tags stub — returns a proxy so any tag property access is valid
+export const tags = new Proxy(
+  {},
+  {
+    get: () =>
+      new Proxy(() => ({}), {
+        get: () => () => ({}),
+        apply: () => ({}),
+      }),
+  },
+);
+
+/**
+ * Noop replacement for CodeMirror's syntaxTree function.
+ * Used by link-wrap and markdown-shortcuts for AST traversal.
+ * @return {{ cursor: Function }} Minimal tree stub
+ */
+export function syntaxTree() {
+  return { cursor: () => ({ next: () => false }) };
+}
+
+/**
+ * Stub for url-utils isURL. Always returns false in the test environment.
+ * @return {boolean} Always false
+ */
+export function isURL() {
+  return false;
+}
+
+/**
+ * Stub type standing in for CodeMirror's KeyBinding interface.
+ */
+export type KeyBinding = unknown;

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "types": ["svelte", "vitest/globals"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "playground", "tests"]
+}

package/vitest.config.ts

@@ -0,0 +1,178 @@
+import { existsSync } from 'fs';
+import { defineConfig } from 'vitest/config';
+import { svelte } from '@sveltejs/vite-plugin-svelte';
+import { playwright } from '@vitest/browser-playwright';
+
+// icons.css is generated by scripts/subset-icons.mjs and gitignored.
+// Stub it to an empty string in tests so they pass without generating the font.
+const iconsPath = new URL('src/client/css/icons.css', import.meta.url).pathname;
+
+/**
+ * Vite plugin that stubs the generated icons.css import when the file doesn't exist.
+ * This allows tests to run in CI or fresh clones without first running the subset script.
+ * @return {import('vite').Plugin} The Vite plugin
+ */
+function stubIconsCSS(): import('vite').Plugin {
+  return {
+    name: 'stub-icons-css',
+    resolveId(id: string) {
+      if (id.endsWith('css/icons.css') && !existsSync(iconsPath)) {
+        return '\0stub-icons-css';
+      }
+    },
+    load(id: string) {
+      if (id === '\0stub-icons-css') return '';
+    },
+  };
+}
+
+export default defineConfig({
+  test: {
+    // Inline project definitions replace the separate vitest.workspace.ts file.
+    // This keeps the config co-located with package.json so Vite's config
+    // search stops here rather than walking up to the parent repo root.
+    projects: [
+      //////////////////////////////
+      // Unit tests — Node.js environment (pure JS/TS, no DOM)
+      //////////////////////////////
+      {
+        plugins: [svelte(), stubIconsCSS()],
+        test: {
+          name: 'unit',
+          include: [
+            'tests/**/*.test.ts',
+            '!tests/e2e/**',
+            '!tests/**/*components*/**',
+          ],
+          setupFiles: ['tests/setup.ts'],
+          coverage: {
+            provider: 'v8',
+            reportsDirectory: '.coverage',
+          },
+        },
+      },
+
+      //////////////////////////////
+      // Component tests — jsdom environment (Svelte components via @testing-library/svelte)
+      //////////////////////////////
+      {
+        plugins: [svelte(), stubIconsCSS()],
+        // browser condition is required so Vite resolves Svelte's client-side
+        // entry point instead of the SSR server entry, which does not have `mount`
+        resolve: {
+          conditions: ['browser'],
+          // @codemirror/* and @lezer/* require a real browser DOM that jsdom cannot
+          // provide. Redirect them to a stub so EditorPane (and its transitive
+          // imports) can be loaded in the jsdom test environment.
+          alias: [
+            {
+              find: /^@codemirror\/.+/,
+              replacement: new URL('tests/stubs/codemirror.ts', import.meta.url)
+                .pathname,
+            },
+            {
+              find: /^@lezer\/.+/,
+              replacement: new URL('tests/stubs/codemirror.ts', import.meta.url)
+                .pathname,
+            },
+          ],
+        },
+        test: {
+          name: 'components',
+          environment: 'jsdom',
+          include: ['tests/**/components/**/*.test.ts'],
+          setupFiles: ['tests/setup.ts'],
+        },
+      },
+
+      //////////////////////////////
+      // Browser tests — Playwright via system Chrome
+      //////////////////////////////
+      {
+        plugins: [
+          svelte(),
+          stubIconsCSS(),
+          /*
+           * Stub plugin that resolves virtual:nebula/* for the browser test
+           * environment. The real virtual:nebula/* plugins are injected by the
+           * Astro integration, which is not running during Vitest browser tests.
+           * They are mocked in tests, but Vite's dependency scanner runs before
+           * mocks are applied and would fail without a resolver.
+           */
+          {
+            name: 'stub-virtual-modules',
+            /**
+             * Resolves virtual:nebula/* to internal stubs so Vite's dependency scanner doesn't fail before mocks apply.
+             * @param {string} id - The module specifier to resolve
+             * @return {string | undefined} The resolved internal ID, or undefined to skip
+             */
+            resolveId(id: string) {
+              if (id === 'virtual:nebula/collections')
+                return '\0virtual:nebula/collections';
+              if (id === 'virtual:nebula/config')
+                return '\0virtual:nebula/config';
+            },
+            /**
+             * Provides stub module source for virtual:nebula/* modules.
+             * @param {string} id - The internal module ID to load
+             * @return {string | undefined} The module source code, or undefined to skip
+             */
+            load(id: string) {
+              if (id === '\0virtual:nebula/collections')
+                return 'export default {};';
+              if (id === '\0virtual:nebula/config') {
+                return 'export default { basePath: "/admin", collectionsPath: "/collections" };';
+              }
+            },
+          },
+        ],
+        // Exclude @testing-library/svelte-core from pre-bundling so its
+        // .svelte.js files go through the Svelte plugin's transform pipeline
+        // (Vite pre-bundling skips plugin transforms, which leaves $state
+        // runes uncompiled and causes ReferenceError at runtime).
+        optimizeDeps: {
+          exclude: ['@testing-library/svelte-core'],
+        },
+        // browser condition ensures Vite resolves Svelte's client-side entry
+        // instead of the SSR server entry. @codemirror/* and @lezer/* are
+        // stubbed because browser tests mock the editor — the same stub used
+        // by component tests is reused here.
+        resolve: {
+          conditions: ['browser'],
+          alias: [
+            {
+              find: /^@codemirror\/.+/,
+              replacement: new URL('tests/stubs/codemirror.ts', import.meta.url)
+                .pathname,
+            },
+            {
+              find: /^@lezer\/.+/,
+              replacement: new URL('tests/stubs/codemirror.ts', import.meta.url)
+                .pathname,
+            },
+          ],
+        },
+        test: {
+          name: 'browser',
+          include: ['tests/e2e/**/*.test.ts'],
+          browser: {
+            enabled: true,
+            headless: true,
+            // Uses system Chrome via the 'chrome' channel to avoid downloading
+            // a separate Chromium binary. CI adds --no-sandbox because most CI
+            // containers lack the kernel namespace support sandboxing requires.
+            provider: playwright({
+              launchOptions: {
+                channel: 'chrome',
+                ...(process.env.CI
+                  ? { args: ['--no-sandbox', '--disable-setuid-sandbox'] }
+                  : {}),
+              },
+            }),
+            instances: [{ browser: 'chromium' }],
+          },
+        },
+      },
+    ],
+  },
+});