@janga/norna 0.7.18 → 0.7.23

package/scripts/test-theme-presets.mjs

@@ -1,188 +0,0 @@
-import assert from 'node:assert/strict';
-import { spawnSync } from 'node:child_process';
-import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { load } from 'js-yaml';
-import { resolveThemePresentation } from './lib/presentation.mjs';
-import {
-	getThemePresetMetadata,
-	resolveThemeConfig,
-	themePresetDefinitions,
-	themePresetNames,
-	themePresets,
-} from './lib/theme-presets.mjs';
-
-const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const cliPath = path.join(repoRoot, 'bin', 'norna.mjs');
-const tempParent = path.join(repoRoot, 'node_modules', '.cache');
-await mkdir(tempParent, { recursive: true });
-const tempRoot = await mkdtemp(path.join(tempParent, 'norna theme presets-'));
-const siteDir = path.join(tempRoot, 'site');
-
-const runCli = (args) => spawnSync(process.execPath, [cliPath, '--site-dir', siteDir, ...args], {
-	cwd: repoRoot,
-	encoding: 'utf8',
-});
-
-try {
-	assert.deepEqual(Object.keys(themePresets), themePresetNames);
-	assert.deepEqual(Object.keys(themePresetDefinitions), themePresetNames);
-	for (const presetName of themePresetNames) {
-		const metadata = getThemePresetMetadata(presetName);
-		assert.equal(metadata.name, presetName);
-		assert.ok(metadata.title);
-		assert.ok(metadata.description);
-		const resolved = resolveThemeConfig({ preset: presetName }, 'test theme');
-		assert.equal(resolved.preset, presetName);
-		assert.ok(resolved.layout?.contentSpacing);
-		assert.ok(resolved.layout?.textWidth);
-		assert.ok(resolved.shape);
-		assert.ok(resolved.images?.width);
-		assert.ok(resolved.typography?.fontFamily);
-		assert.ok(resolved.typography?.profile);
-		assert.ok(resolved.palette);
-		assert.ok(resolved.sections?.backgroundPattern);
-	}
-
-	const overridden = resolveThemeConfig({
-		preset: 'documentation',
-		layout: { pageWidth: '1300px' },
-		palette: 'dark',
-	}, 'test theme');
-	assert.equal(overridden.layout.contentSpacing, 'compact');
-	assert.equal(overridden.layout.textWidth, 'narrow');
-	assert.equal(overridden.layout.pageWidth, '1300px');
-	assert.equal(overridden.layout.localNavigationGap, 'clamp(1.5rem, 3vw, 3rem)');
-	assert.equal(overridden.images.width, '920px');
-	assert.equal(overridden.palette, 'dark');
-	assert.equal(overridden.sections.backgroundPattern, 'alternating');
-	assert.throws(
-		() => resolveThemeConfig({ preset: 'unknown' }, 'test/theme.yaml'),
-		/Unknown theme preset "unknown" in test\/theme\.yaml.*portfolio, documentation, project, statement/,
-	);
-	assert.throws(
-		() => resolveThemePresentation({ sections: { backgroundPattern: 'glowing' } }, 'test/theme.yaml'),
-		/sections\.backgroundPattern must be one of uniform, alternating, cycling in test\/theme\.yaml/,
-	);
-
-	const listResult = runCli(['theme:presets']);
-	assert.equal(listResult.status, 0, listResult.stderr || listResult.stdout);
-	for (const presetName of themePresetNames) {
-		const metadata = getThemePresetMetadata(presetName);
-		assert.ok(listResult.stdout.includes(`${presetName}\n  ${metadata.description}`));
-	}
-	const invalidListResult = runCli(['theme:presets', 'documentation']);
-	assert.notEqual(invalidListResult.status, 0);
-	assert.match(invalidListResult.stderr, /Usage: norna theme:presets/);
-
-	const themeSchema = JSON.parse(await readFile(path.join(repoRoot, 'schemas', 'theme.schema.json'), 'utf8'));
-	assert.deepEqual(
-		themeSchema.properties.preset.oneOf.map((entry) => entry.const),
-		themePresetNames,
-	);
-	for (const entry of themeSchema.properties.preset.oneOf) {
-		const metadata = getThemePresetMetadata(entry.const);
-		assert.equal(entry.title, metadata.title);
-		assert.equal(entry.description, metadata.description);
-	}
-
-	await mkdir(path.join(siteDir, 'pages', '000-home'), { recursive: true });
-	await mkdir(path.join(siteDir, 'pages', '010-guide'), { recursive: true });
-	await writeFile(path.join(siteDir, 'config.yaml'), 'url: https://example.com/\nnavigation:\n  mode: top\n');
-	await writeFile(path.join(siteDir, 'pages', '000-home', 'content.md'), `---
-page:
-  description: Root page
----
-
-# Theme preset test
-
-## Home {#home}
-
-Root content.
-`);
-	await writeFile(path.join(siteDir, 'theme.yaml'), `preset: documentation
-layout:
-  pageWidth: 1300px
-palette: dark
-`);
-	await writeFile(path.join(siteDir, 'pages', '010-guide', 'content.md'), `---
-page:
-  description: Additional page
----
-
-# Guide
-Page content.
-`);
-	await writeFile(path.join(siteDir, 'pages', '010-guide', 'theme.yaml'), `layout:
-  contentSpacing: spacious
-  textWidth: wide
-images:
-  width: 700px
-sections:
-  backgroundPattern: cycling
-`);
-
-	const buildResult = runCli(['build']);
-	assert.equal(buildResult.status, 0, buildResult.stderr || buildResult.stdout);
-	const rootHtml = await readFile(path.join(tempRoot, 'dist', 'index.html'), 'utf8');
-	const pageHtml = await readFile(path.join(tempRoot, 'dist', 'guide', 'index.html'), 'utf8');
-	assert.match(rootHtml, /--page-width: 1300px/);
-	assert.match(rootHtml, /--font-sans: Georgia, 'Times New Roman', serif/);
-	assert.match(rootHtml, /--color-page: #000000/);
-	assert.match(pageHtml, /--page-width: 1300px/);
-	assert.match(pageHtml, /--font-sans: Georgia, 'Times New Roman', serif/);
-	assert.match(pageHtml, /--color-page: #000000/);
-	assert.match(pageHtml, /--image-width: 700px/);
-	assert.match(pageHtml, /--space-section-to-section-desktop: clamp\(2\.25rem, 5vw, 4\.5rem\)/);
-	assert.match(rootHtml, /data-navigation-mode="top"/);
-	assert.match(pageHtml, /data-navigation-mode="top"/);
-
-	const typographyResult = runCli(['typography', 'show']);
-	assert.equal(typographyResult.status, 0, typographyResult.stderr || typographyResult.stdout);
-	assert.match(typographyResult.stdout, /value: reading/);
-	assert.doesNotMatch(typographyResult.stdout, /value: restrained/);
-
-	const pageThemePath = path.join(siteDir, 'pages', '010-guide', 'theme.yaml');
-	const pageThemeSource = await readFile(pageThemePath, 'utf8');
-	await writeFile(pageThemePath, 'preset: unknown\n');
-	const invalidPagePresetResult = runCli(['config:check']);
-	assert.notEqual(invalidPagePresetResult.status, 0);
-	assert.match(invalidPagePresetResult.stderr, /page themes may not define site-wide visual identity through "preset"/);
-	await writeFile(pageThemePath, pageThemeSource);
-	await writeFile(pageThemePath, 'navigation:\n  mode: sections\n');
-	const pageNavigationResult = runCli(['config:check']);
-	assert.notEqual(pageNavigationResult.status, 0);
-	assert.match(pageNavigationResult.stderr, /navigation is technical, site-wide configuration/);
-	assert.match(pageNavigationResult.stderr, /config\.yaml/);
-	await writeFile(pageThemePath, pageThemeSource);
-
-	const exportResult = runCli(['theme:export', 'documentation']);
-	assert.equal(exportResult.status, 0, exportResult.stderr || exportResult.stdout);
-	assert.match(exportResult.stdout, /orig-documentation-theme\.yaml/);
-	const exportedPath = path.join(siteDir, 'orig-documentation-theme.yaml');
-	const exportedSource = await readFile(exportedPath, 'utf8');
-	assert.match(exportedSource, /This is a reference file\. Norna only loads theme\.yaml\./);
-	assert.match(exportedSource, /Available theme presets: portfolio, documentation, project, statement\./);
-	assert.match(exportedSource, /# Alternatives: dark, light, paper\./);
-	const exportedConfig = load(exportedSource);
-	assert.equal(exportedConfig.preset, 'documentation');
-	assert.equal(exportedConfig.navigation, undefined);
-	assert.equal(exportedConfig.shape, themePresets.documentation.shape);
-	assert.equal(exportedConfig.layout.pageWidth, themePresets.documentation.layout.pageWidth);
-	assert.equal(exportedConfig.typography.fontFamily, themePresets.documentation.typography.fontFamily);
-	assert.equal(exportedConfig.sections.backgroundPattern, 'alternating');
-
-	const exportAgainResult = runCli(['theme:export', 'documentation']);
-	assert.notEqual(exportAgainResult.status, 0);
-	assert.match(exportAgainResult.stderr, /already exists\. Norna will not overwrite it\./);
-	assert.equal(await readFile(exportedPath, 'utf8'), exportedSource);
-
-	const unknownExportResult = runCli(['theme:export', 'unknown']);
-	assert.notEqual(unknownExportResult.status, 0);
-	assert.match(unknownExportResult.stderr, /Unknown theme preset "unknown"/);
-
-	console.log('ok - complete root presets and limited inherited page themes resolve and export as protected references');
-} finally {
-	await rm(tempRoot, { force: true, recursive: true });
-}

package/src/components/SiteNotesScript.astro

@@ -1,43 +0,0 @@
-<script>
-	const noteParts = Array.from(document.querySelectorAll<HTMLElement>('[data-note-id]'));
-	const noteReferences = noteParts.filter((part) => part.matches('.section-note-ref a'));
-	const marginNotes = noteParts.filter((part) => part.matches('.section-note'));
-
-	const setNoteState = (noteId: string, active: boolean) => {
-		noteParts
-			.filter((part) => part.dataset.noteId === noteId)
-			.forEach((part) => part.classList.toggle('is-referenced', active));
-	};
-
-	noteParts.forEach((part) => {
-		const noteId = part.dataset.noteId;
-		if (!noteId) return;
-
-		part.addEventListener('pointerenter', () => setNoteState(noteId, true));
-		part.addEventListener('pointerleave', () => setNoteState(noteId, false));
-		part.addEventListener('focusin', () => setNoteState(noteId, true));
-		part.addEventListener('focusout', () => setNoteState(noteId, false));
-	});
-
-	const alignMarginNotes = () => {
-		const wideLayout = window.matchMedia('(min-width: 1101px)').matches;
-		if (!wideLayout) {
-			marginNotes.forEach((note) => note.style.removeProperty('--section-note-offset'));
-			return;
-		}
-
-		marginNotes.forEach((note) => {
-			const noteId = note.dataset.noteId;
-			const reference = noteReferences.find((part) => part.dataset.noteId === noteId);
-			if (!noteId || !reference) return;
-
-			note.style.removeProperty('--section-note-offset');
-			const offset = reference.getBoundingClientRect().top - note.getBoundingClientRect().top;
-			note.style.setProperty('--section-note-offset', `${Math.max(0, offset)}px`);
-		});
-	};
-
-	alignMarginNotes();
-	window.addEventListener('resize', alignMarginNotes);
-	document.fonts?.ready.then(alignMarginNotes);
-</script>

package/starters/project/.github/workflows/deploy.yml

@@ -1,64 +0,0 @@
-name: Deploy to GitHub Pages
-
-on:
-  push:
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: github-pages
-  cancel-in-progress: false
-
-jobs:
-  build:
-    if: github.ref_name == github.event.repository.default_branch
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 24.18.0
-          cache: npm
-
-      - name: Install image tools
-        run: sudo apt-get update && sudo apt-get install -y imagemagick
-
-      - name: Restore generated images
-        uses: actions/cache@v4
-        with:
-          path: site/.norna/public/images/generated
-          key: norna-images-${{ hashFiles('site/.norna/generated-images.json') }}
-          restore-keys: |
-            norna-images-
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Check and build
-        run: npm run norna:build
-
-      - name: Configure Pages
-        uses: actions/configure-pages@v5
-
-      - name: Upload Pages artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: dist
-
-  deploy:
-    needs: build
-    runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

package/starters/project/README.md

@@ -1,84 +0,0 @@
-# Project Starter
-
-This is a compact Norna starter for small open source projects, CLI tools,
-libraries, and similar project sites.
-
-## Setup
-
-```sh
-npm install
-npm run norna:dev
-```
-
-If the standard local port is blocked, start with:
-
-```sh
-npm run norna:dev -- --kill
-```
-
-## Files
-
-- `site/config.yaml`: public URL and optional language and smooth scrolling.
-- `site/sitewide-content.yaml`: shared logo display settings, banners, and footer.
-- `site/theme.yaml`: the site-wide visual preset and any focused overrides.
-- `site/pages/000-home/content.md`: homepage title, sections, placeholders,
-  project summary,
-  links, install command, example usage, benefits, next steps, Norna blocks,
-  and license.
-- `site/pages/010-guide/content.md`: short secondary page with realistic
-  project guide content.
-- `site/public/robots.txt`: static public file copied into the built site.
-
-The starter intentionally does not include generated output, `node_modules`, or
-a local Norna installation. It does include `package-lock.json` because the
-GitHub Pages workflow uses `npm ci`.
-
-## Adapt The Starter
-
-1. Replace the project name, tagline, links, install command, example usage,
-   benefits, use cases, and license in `site/pages/000-home/content.md`.
-2. Replace the guide examples in `site/pages/010-guide/content.md`, or
-   delete the page if the homepage is enough.
-3. Edit `site/sitewide-content.yaml` for logo display settings,
-   banners, and footer.
-4. Select a preset in `site/theme.yaml`. Add focused overrides only when the
-   project needs them.
-5. Put managed homepage source images in `site/pages/000-home/images/`. Images
-   for another page belong directly in that page's `images/` directory.
-6. Edit `site/config.yaml` for the public URL and, when needed, language or smooth
-   scrolling. Deploy commands discover the GitHub repository and default branch.
-7. Update `package.json` with the site's package name and keep
-   `package-lock.json` committed.
-
-## Common Commands
-
-```sh
-npm run norna:check
-npm run norna:sync
-npm run norna:typography:show
-npm run norna:build
-```
-
-The standalone aliases `npm run dev` and `npm run build` are also available.
-For direct `norna dev`, `norna check`, and `norna build` commands, install the
-launcher globally with `npm install --global @janga/norna@latest`; it delegates
-to this project's locally installed Norna version.
-
-To verify the same install path used by GitHub Pages:
-
-```sh
-npm ci
-npm run norna:build
-```
-
-Generic Norna documentation lives in the Norna repository:
-
-- `docs/getting-started.md`
-- `docs/site-files.md`
-- `docs/public-files.md`
-- `docs/content.md`
-- `docs/theme.md`
-- `docs/typography.md`
-- `docs/pages.md`
-- `docs/configuration.md`
-- `docs/commands.md`