@mosetta/content 0.0.0-stage → 0.0.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mosetta contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,6 @@
-# Temporary Holding Version
+# @mosetta/content
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The content domain of mosetta: blueprints (pages and prefabs as JSON trees), their drafts and
+revisions, the schemas they are checked against, the editing session, published markers and the
+site's manifest of roots, translations (the i18n value references), media addresses and article
+lists. Shared by the editor, the factory and the tools that write content.

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@mosetta/content",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.10",
+  "license": "MIT",
+  "description": "mosetta content domain: revisioned pages/prefabs model, zod schema factories, content transport (dev HTTP / prod S3 seam) and the revision state-machine repository. Web-API clean.",
+  "type": "module",
+  "files": [
+    "src"
+  ],
+  "exports": {
+    ".": "./src/content.ts",
+    "./paths": "./src/paths.ts",
+    "./policy": "./src/policy.ts",
+    "./editing": "./src/editing.ts",
+    "./units": "./src/units.ts",
+    "./articleLists": "./src/articleLists.ts",
+    "./media": "./src/media.ts",
+    "./i18n": "./src/i18n.ts",
+    "./roots": "./src/roots.ts",
+    "./queryPolicy": "./src/queryPolicy.ts",
+    "./versions": "./src/versions.ts"
+  },
+  "dependencies": {
+    "@mosetta/core": "0.0.10",
+    "@mosetta/di": "0.0.10",
+    "@mosetta/server-action": "0.0.10",
+    "@mosetta/stores": "0.0.10"
+  },
+  "devDependencies": {
+    "zod": "^3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  }
 }

package/src/articleLists.ts

@@ -0,0 +1,91 @@
+// An ARTICLE LIST is a block whose data the server supplies: the page's tree names the block
+// with a route prefix, and before a render the strategy fills its `entries` from the route table
+// and the pages' own meta — no request from the browser, nothing the client has to fetch through
+// a foreign proxy. The block itself only renders what it was given. A blog-kit thing by origin,
+// a generic "settings enriched on the server" seam by shape.
+import type { IBlueprintNodeDoc, IPageMeta } from './model';
+
+export type { IPageMeta } from './model';
+import { textDigest, UNIT_ID_SEPARATOR } from './units';
+
+/** the block any distribution ships under this name receives entries */
+export const isArticleListReference = (reference: string): boolean => /_t_component_n_articleList_v_/.test(reference);
+
+/** pages under this prefix are never articles (layouts) */
+export const LAYOUTS_PREFIX = '/_layouts/';
+
+export interface IArticleEntry {
+  readonly pattern: string;
+  readonly name: string;
+  readonly title: string;
+  readonly description: string;
+  readonly image: string;
+  readonly date: string;
+  readonly category: string;
+  /** the title and description in the project's other languages — the block shows the reader's */
+  readonly i18n?: IPageMeta['i18n'];
+}
+
+export interface IArticleSource {
+  routes(): Promise<readonly { pattern: string; name: string; rev: number }[]>;
+  meta(name: string, rev: number): Promise<IPageMeta | null>;
+}
+
+// the block filters by the reader's category and caps at render; the server hands it everything
+// under the prefix up to this bound
+const MAX_ENTRIES = 500;
+
+/** the entries a list with these settings may show: under the prefix, newest first */
+export async function articleEntries(settings: Record<string, unknown> | undefined, source: IArticleSource): Promise<IArticleEntry[]> {
+  // the prefix is a FOLDER: `/blog/` holds the articles, `/blog` itself is the index and is not one
+  const raw = typeof settings?.prefix === 'string' && settings.prefix.startsWith('/') ? settings.prefix : '/';
+  const prefix = raw.endsWith('/') ? raw : `${raw}/`;
+  const routes = (await source.routes())
+    .filter((r) => r.pattern.startsWith(prefix) && !r.pattern.startsWith(LAYOUTS_PREFIX));
+  // the metas are read side by side — a revision's is immutable, a source may keep it
+  const metas = await Promise.all(routes.map((route) => source.meta(route.name, route.rev)));
+  const entries: IArticleEntry[] = [];
+  for (const [i, route] of routes.entries()) {
+    const meta = metas[i] ?? {};
+    entries.push({
+      pattern: route.pattern,
+      name: route.name,
+      title: meta.title ?? route.name,
+      description: meta.description ?? '',
+      image: meta.image ?? '',
+      date: meta.date ?? '',
+      category: meta.category ?? '',
+      ...(meta.i18n && typeof meta.i18n === 'object' && Object.keys(meta.i18n).length ? { i18n: meta.i18n } : {}),
+    });
+  }
+  entries.sort((a, b) => (a.date === b.date ? a.title.localeCompare(b.title) : b.date.localeCompare(a.date)));
+  return entries.slice(0, MAX_ENTRIES);
+}
+
+/** every article-list block in the tree gets its entries — the page's own blocks and a layout's chrome alike */
+export async function enrichArticleLists(doc: IBlueprintNodeDoc, source: IArticleSource): Promise<IBlueprintNodeDoc> {
+  const walk = async (node: IBlueprintNodeDoc): Promise<IBlueprintNodeDoc> => {
+    const children = await Promise.all((node.children ?? []).map(walk));
+    if (!isArticleListReference(node.reference)) return { ...node, children };
+    return { ...node, children, settings: { ...(node.settings ?? {}), entries: await articleEntries(node.settings, source) } };
+  };
+  return walk(doc);
+}
+
+/**
+ * What the tree's article lists were given, as a cache-key suffix (`~l<digest>`), '' without a
+ * list: a render keyed by its page's revision alone would keep showing yesterday's articles.
+ */
+export function articleListsCacheSuffix(doc: IBlueprintNodeDoc): string {
+  const given: unknown[] = [];
+  const walk = (node: IBlueprintNodeDoc) => {
+    if (isArticleListReference(node.reference)) given.push(node.settings?.entries ?? []);
+    for (const child of node.children ?? []) walk(child);
+  };
+  walk(doc);
+  return given.length ? `~l${textDigest(JSON.stringify(given)).toString(36)}` : '';
+}
+
+// keeps the separator import honest: entries never carry chrome ids, but a list inside a layout
+// is addressed through one — the block reads settings, not ids, so nothing here depends on it
+void UNIT_ID_SEPARATOR;

package/src/content.ts

@@ -0,0 +1,16 @@
+// @mosetta/content — the content domain: revisioned pages/prefabs model, zod schema
+// factories (zod injected — zero runtime deps), the content transport seam (dev HTTP / prod S3) and
+// the revision state-machine repository. Web-API clean: safe to import from an isolate, node, or the browser.
+export * from './model';
+export * from './paths';
+export * from './schemas';
+export * from './transport';
+export * from './repository';
+export * from './editing';
+export * from './units';
+export * from './articleLists';
+export * from './media';
+export * from './i18n';
+export * from './versions';
+export * from './names';
+export * from './roots';