@morphemecms/cms 0.1.0 → 0.2.0-next-20261104150211

package/lib/git.mjs

@@ -1,64 +1,64 @@
-// Git's ids for a file's content (a blob) and a folder (a tree), as git computes them, for the editor
-// (packages/editor/src/github.ts) and the site's Worker (packages/editor/worker/files.js): what either gets from GitHub, R2 or the site
-// is checked against them, so a file is never kept or saved broken. No Node, no DOM: both run it.
-
-const encoder = new TextEncoder();
-
-/** Git's id for a file's content: sha1 of "blob <size>\0<content>". @param {Uint8Array} bytes */
-export async function blobId(bytes) {
-  return sha1(join([encoder.encode(`blob ${bytes.length}\0`), bytes]));
-}
-
-/** The mode git gives a folder in a tree (040000), as GitHub's GraphQL API gives modes: a number. */
-export const TREE_MODE = 0o40000;
-
-/**
- * A folder's entries in git's order: by the names' bytes, a folder's as if it ended with "/".
- * @template {{ name: string, mode: number }} E
- * @param {E[]} entries
- * @returns {E[]}
- */
-export function sortTree(entries) {
-  const keyed = entries.map((e) => ({ e, key: encoder.encode(e.mode === TREE_MODE ? `${e.name}/` : e.name) }));
-  return keyed.sort((a, b) => compare(a.key, b.key)).map(({ e }) => e);
-}
-
-/**
- * Git's id for a folder: sha1 of "tree <size>\0" and its entries in git's order, each "<mode in octal> <name>\0" and
- * the 20 bytes of its id.
- * @param {{ name: string, oid: string, mode: number }[]} entries
- */
-export async function treeId(entries) {
-  const body = join(sortTree(entries).flatMap((e) => [encoder.encode(`${e.mode.toString(8)} ${e.name}\0`), hexBytes(e.oid)]));
-  return sha1(join([encoder.encode(`tree ${body.length}\0`), body]));
-}
-
-/** @param {Uint8Array} a @param {Uint8Array} b */
-function compare(a, b) {
-  for (let i = 0; i < Math.min(a.length, b.length); i++) if (a[i] !== b[i]) return a[i] - b[i];
-  return a.length - b.length;
-}
-
-/** @param {Uint8Array[]} parts */
-function join(parts) {
-  const all = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
-  let at = 0;
-  for (const p of parts) {
-    all.set(p, at);
-    at += p.length;
-  }
-  return all;
-}
-
-/** @param {string} hex */
-function hexBytes(hex) {
-  const bytes = new Uint8Array(hex.length / 2);
-  for (let i = 0; i < bytes.length; i++) bytes[i] = parseInt(hex.slice(2 * i, 2 * i + 2), 16);
-  return bytes;
-}
-
-/** @param {Uint8Array} bytes */
-async function sha1(bytes) {
-  const hash = new Uint8Array(await crypto.subtle.digest('SHA-1', bytes));
-  return Array.from(hash, (b) => b.toString(16).padStart(2, '0')).join('');
-}
+// Git's ids for a file's content (a blob) and a folder (a tree), as git computes them, for the editor
+// (packages/editor/src/github.ts) and the site's Worker (packages/editor/worker/files.js): what either gets from GitHub, R2 or the site
+// is checked against them, so a file is never kept or saved broken. No Node, no DOM: both run it.
+
+const encoder = new TextEncoder();
+
+/** Git's id for a file's content: sha1 of "blob <size>\0<content>". @param {Uint8Array} bytes */
+export async function blobId(bytes) {
+  return sha1(join([encoder.encode(`blob ${bytes.length}\0`), bytes]));
+}
+
+/** The mode git gives a folder in a tree (040000), as GitHub's GraphQL API gives modes: a number. */
+export const TREE_MODE = 0o40000;
+
+/**
+ * A folder's entries in git's order: by the names' bytes, a folder's as if it ended with "/".
+ * @template {{ name: string, mode: number }} E
+ * @param {E[]} entries
+ * @returns {E[]}
+ */
+export function sortTree(entries) {
+  const keyed = entries.map((e) => ({ e, key: encoder.encode(e.mode === TREE_MODE ? `${e.name}/` : e.name) }));
+  return keyed.sort((a, b) => compare(a.key, b.key)).map(({ e }) => e);
+}
+
+/**
+ * Git's id for a folder: sha1 of "tree <size>\0" and its entries in git's order, each "<mode in octal> <name>\0" and
+ * the 20 bytes of its id.
+ * @param {{ name: string, oid: string, mode: number }[]} entries
+ */
+export async function treeId(entries) {
+  const body = join(sortTree(entries).flatMap((e) => [encoder.encode(`${e.mode.toString(8)} ${e.name}\0`), hexBytes(e.oid)]));
+  return sha1(join([encoder.encode(`tree ${body.length}\0`), body]));
+}
+
+/** @param {Uint8Array} a @param {Uint8Array} b */
+function compare(a, b) {
+  for (let i = 0; i < Math.min(a.length, b.length); i++) if (a[i] !== b[i]) return a[i] - b[i];
+  return a.length - b.length;
+}
+
+/** @param {Uint8Array[]} parts */
+function join(parts) {
+  const all = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
+  let at = 0;
+  for (const p of parts) {
+    all.set(p, at);
+    at += p.length;
+  }
+  return all;
+}
+
+/** @param {string} hex */
+function hexBytes(hex) {
+  const bytes = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < bytes.length; i++) bytes[i] = parseInt(hex.slice(2 * i, 2 * i + 2), 16);
+  return bytes;
+}
+
+/** @param {Uint8Array} bytes */
+async function sha1(bytes) {
+  const hash = new Uint8Array(await crypto.subtle.digest('SHA-1', bytes));
+  return Array.from(hash, (b) => b.toString(16).padStart(2, '0')).join('');
+}

package/lib/hooks.ts

@@ -1,51 +1,51 @@
-// The places where an app may change how the site does something of its own, rather than add to it (a block, a kind,
-// a list, its code on every page): each a file in the app's folder, hooks/<place>.ts, whose default export the site's
-// build runs, while the app is installed, for every page. The site gives it what it needs to know and the tools it may
-// use, and keeps what it gives back only when it is right; an app reaches nothing of the site but that. Before an app
-// is installed, its page says what it changes ("Rettigheder", needsOf in src/store.ts, from the files in hooks/).
-//   page-colors  the colours of a page (PageColorsHook): given the page's colours so far (the site's, "Farver", or those
-//                of an app before it), its pictures and the app's settings, it gives the page other colours, or none.
-//                The site runs it in packages/editor/site/pageColors.ts, which a theme calls for every page (Base.astro).
-// No React, browser or Node here: the editor, the build and the check before it use it.
-import type { Colors } from './colors';
-import type { ColorRoles } from './dynamic-colors';
-
-/** The places an app may change the site, by the name of their file in its hooks/ (without .ts). */
-export const APP_HOOKS = ['page-colors'] as const;
-export type AppHook = (typeof APP_HOOKS)[number];
-
-/** The places an app changes, from the paths of the files in its folder (hooks/page-colors.ts: 'page-colors'), and
- * the files there that are no such place. */
-export function hooksOf(files: string[]): { hooks: AppHook[]; unknown: string[] } {
-  const there = files.filter((f) => f.startsWith('hooks/'));
-  const name = (f: string) => f.slice('hooks/'.length).replace(/\.ts$/, '');
-  return {
-    hooks: APP_HOOKS.filter((h) => there.includes(`hooks/${h}.ts`)),
-    unknown: there.filter((f) => !f.endsWith('.ts') || !(APP_HOOKS as readonly string[]).includes(name(f))),
-  };
-}
-
-/** What the site gives an app's hook for a page's colours. */
-export type PageColorsPage = {
-  /** The page's address on the site ("/om-mig/"). */
-  path: string;
-  /** The page's colours so far: the site's own, or those an app before it gave. */
-  colors: Colors;
-  /** The page's pictures, in the order they are on it (its own first, then those in its text and blocks), and last
-   * the one it is shared with; their addresses on the site. */
-  pictures: string[];
-  /** The app's settings, as saved in the editor over those it starts with. */
-  settings: Record<string, any>;
-  /** The role each of the site's colours takes in a Material 3 scheme (colorRoles), for dynamicColors. */
-  roles: ColorRoles;
-  /** A picture's pixels as RGBA bytes, made small (at most 128 px), as sourceColorsOf takes them; undefined for one
-   * that cannot be read. */
-  pixels: (picture: string) => Promise<Uint8ClampedArray | undefined>;
-  /** Whether the text in colours can be read on its background in both modes, as the site requires (WCAG AA). */
-  readable: (colors: Colors) => boolean;
-};
-
-/** An app's hook for a page's colours (hooks/page-colors.ts): other colours for the page, in both modes, each of the
- * site's by its name; or undefined to leave them. Colours that are not the site's, or hard to read, are not used. */
-export type PageColorsHook = (page: PageColorsPage) => Colors | undefined | Promise<Colors | undefined>;
-export const definePageColors = (hook: PageColorsHook) => hook;
+// The places where an app may change how the site does something of its own, rather than add to it (a block, a kind,
+// a list, its code on every page): each a file in the app's folder, hooks/<place>.ts, whose default export the site's
+// build runs, while the app is installed, for every page. The site gives it what it needs to know and the tools it may
+// use, and keeps what it gives back only when it is right; an app reaches nothing of the site but that. Before an app
+// is installed, its page says what it changes ("Rettigheder", needsOf in src/store.ts, from the files in hooks/).
+//   page-colors  the colours of a page (PageColorsHook): given the page's colours so far (the site's, "Farver", or those
+//                of an app before it), its pictures and the app's settings, it gives the page other colours, or none.
+//                The site runs it in packages/editor/site/pageColors.ts, which a theme calls for every page (Base.astro).
+// No React, browser or Node here: the editor, the build and the check before it use it.
+import type { Colors } from './colors';
+import type { ColorRoles } from './dynamic-colors';
+
+/** The places an app may change the site, by the name of their file in its hooks/ (without .ts). */
+export const APP_HOOKS = ['page-colors'] as const;
+export type AppHook = (typeof APP_HOOKS)[number];
+
+/** The places an app changes, from the paths of the files in its folder (hooks/page-colors.ts: 'page-colors'), and
+ * the files there that are no such place. */
+export function hooksOf(files: string[]): { hooks: AppHook[]; unknown: string[] } {
+  const there = files.filter((f) => f.startsWith('hooks/'));
+  const name = (f: string) => f.slice('hooks/'.length).replace(/\.ts$/, '');
+  return {
+    hooks: APP_HOOKS.filter((h) => there.includes(`hooks/${h}.ts`)),
+    unknown: there.filter((f) => !f.endsWith('.ts') || !(APP_HOOKS as readonly string[]).includes(name(f))),
+  };
+}
+
+/** What the site gives an app's hook for a page's colours. */
+export type PageColorsPage = {
+  /** The page's address on the site ("/om-mig/"). */
+  path: string;
+  /** The page's colours so far: the site's own, or those an app before it gave. */
+  colors: Colors;
+  /** The page's pictures, in the order they are on it (its own first, then those in its text and blocks), and last
+   * the one it is shared with; their addresses on the site. */
+  pictures: string[];
+  /** The app's settings, as saved in the editor over those it starts with. */
+  settings: Record<string, any>;
+  /** The role each of the site's colours takes in a Material 3 scheme (colorRoles), for dynamicColors. */
+  roles: ColorRoles;
+  /** A picture's pixels as RGBA bytes, made small (at most 128 px), as sourceColorsOf takes them; undefined for one
+   * that cannot be read. */
+  pixels: (picture: string) => Promise<Uint8ClampedArray | undefined>;
+  /** Whether the text in colours can be read on its background in both modes, as the site requires (WCAG AA). */
+  readable: (colors: Colors) => boolean;
+};
+
+/** An app's hook for a page's colours (hooks/page-colors.ts): other colours for the page, in both modes, each of the
+ * site's by its name; or undefined to leave them. Colours that are not the site's, or hard to read, are not used. */
+export type PageColorsHook = (page: PageColorsPage) => Colors | undefined | Promise<Colors | undefined>;
+export const definePageColors = (hook: PageColorsHook) => hook;

package/lib/inline.ts

@@ -1,20 +1,20 @@
-// A short text the site's owner writes as text in the editor (a page's introduction, the text under a section's
-// heading), for a component that shows it inside its own <p>: bold, italic and links as they were
-// written (Markdown, Astro's pipeline: typographic quotes too). Paragraphs are separated by a line break;
-// anything that cannot stand inside a <p> (a list, a picture) is shown as its text.
-import { createMarkdownProcessor } from '@astrojs/markdown-remark';
-import { inlineOf } from './markdown';
-
-let processor: ReturnType<typeof createMarkdownProcessor> | undefined;
-
-export async function inlineHtml(markdown: string): Promise<string> {
-  processor ??= createMarkdownProcessor();
-  return inlineOf((await (await processor).render(markdown)).code.trim());
-}
-
-/** A longer text the site's owner writes in the editor (an answer in "Spørgsmål og svar") as HTML: paragraphs,
- * lists, bold, italic and links. */
-export async function markdownHtml(markdown: string): Promise<string> {
-  processor ??= createMarkdownProcessor();
-  return (await (await processor).render(markdown)).code.trim();
-}
+// A short text the site's owner writes as text in the editor (a page's introduction, the text under a section's
+// heading), for a component that shows it inside its own <p>: bold, italic and links as they were
+// written (Markdown, Astro's pipeline: typographic quotes too). Paragraphs are separated by a line break;
+// anything that cannot stand inside a <p> (a list, a picture) is shown as its text.
+import { createMarkdownProcessor } from '@astrojs/markdown-remark';
+import { inlineOf } from './markdown';
+
+let processor: ReturnType<typeof createMarkdownProcessor> | undefined;
+
+export async function inlineHtml(markdown: string): Promise<string> {
+  processor ??= createMarkdownProcessor();
+  return inlineOf((await (await processor).render(markdown)).code.trim());
+}
+
+/** A longer text the site's owner writes in the editor (an answer in "Spørgsmål og svar") as HTML: paragraphs,
+ * lists, bold, italic and links. */
+export async function markdownHtml(markdown: string): Promise<string> {
+  processor ??= createMarkdownProcessor();
+  return (await (await processor).render(markdown)).code.trim();
+}