@cogenta/starters 0.3.0 → 0.4.0

package/dist/blueprints/blog.d.ts

@@ -1,5 +1,6 @@
 import type { VocabularyBlock } from '@cogenta/blocks';
-import { type CollectionDefinition, type RichTextDocument, type TaxonomyDefinition } from '@cogenta/schema';
+import { type CollectionDefinition, type TaxonomyDefinition } from '@cogenta/schema';
+import type { BlogCopy, BlogDemoPost } from './blog-copy.js';
 import { type BlueprintContentPack, type RecommendedAgentHint } from './content-pack.js';
 import type { DemoMediaSpec } from './demo-media.js';
 import type { BlueprintMenus } from './menus.js';
@@ -7,12 +8,14 @@ import type { BlueprintWidget } from './widgets.js';
 /**
  * The `blog` blueprint: a personal publication of essays and letters about
  * reading, writing and walking (L9 task 3; richened by L25; rewritten to
- * studio level by L27).
+ * studio level by L27; written in French and in English by the template
+ * series of 2026-10).
  *
  * `post` reuses contract A's system fields for publish state and authorship
  * rather than declaring its own. `category`/`tag` are `defineTaxonomy()`
  * declarations (ADR-0022): `category` stays hierarchical (its default),
- * `tag` is flat.
+ * `tag` is flat. On a French site the taxonomies are named in French
+ * (`categorie`, `etiquette`), which is also their public path.
  *
  * The demo writing is written as the site of one writer, in the first
  * person, and names the site the person scaffolding it chose
@@ -20,202 +23,74 @@ import type { BlueprintWidget } from './widgets.js';
  * real scaffold. Only some essays carry a photograph, on purpose: an index
  * of writing reads better when pictures are the exception.
  */
-export declare const DEFAULT_PUBLICATION_NAME = "Field Notes";
+export type { BlogCopy, BlogCopyContext, BlogDemoCategory, BlogDemoPost, BlogDemoTag, BlogLocale, } from './blog-copy.js';
+export declare const DEFAULT_PUBLICATION_NAME: string;
+/** The copy for a site's default locale: French for any `fr*` locale, English otherwise. */
+export declare function blogCopyFor(locale: string): BlogCopy;
+export interface BlogSchema {
+    readonly category: TaxonomyDefinition;
+    readonly tag: TaxonomyDefinition;
+    readonly post: CollectionDefinition;
+    readonly page: CollectionDefinition;
+    readonly collections: readonly CollectionDefinition[];
+    readonly taxonomies: readonly TaxonomyDefinition[];
+}
+/** The content model, named in the copy's language. */
+export declare function blogSchema(copy: BlogCopy): BlogSchema;
 export declare const category: TaxonomyDefinition;
 export declare const tag: TaxonomyDefinition;
-export declare const post: {
-    readonly name: "post";
-    readonly labels: {
-        readonly singular: "Post";
-        readonly plural: "Posts";
-    };
-    readonly routing: {
-        readonly pattern: "/blog/:slug";
-    };
-    readonly versioning: {
-        readonly drafts: true;
-        readonly history: true;
-    };
-    readonly fields: {
-        readonly seoTitle: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "text";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly seoDescription: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "text";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly seoImage: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "media";
-            readonly options: {
-                accept: readonly ("audio" | "file" | "image" | "video")[];
-                many: boolean;
-            };
-        };
-        readonly seoNoindex: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "boolean";
-            readonly options: {};
-        };
-        readonly title: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "text";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly slug: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "slug";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly body: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "richText";
-            readonly options: {};
-        };
-        readonly excerpt: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "text";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly coverImage: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "media";
-            readonly options: {
-                accept: readonly ("audio" | "file" | "image" | "video")[];
-                many: boolean;
-            };
-        };
-        readonly category: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "taxonomy";
-            readonly options: {
-                of: string;
-                many: boolean;
-            };
-        };
-        readonly tags: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "taxonomy";
-            readonly options: {
-                of: string;
-                many: boolean;
-            };
-        };
-        readonly publishedAt: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "datetime";
-            readonly options: {};
-        };
-    };
-    readonly indexes: readonly [readonly ["publishedAt", "desc"], readonly ["slug"]];
-    readonly permissions: {
-        readonly read: readonly ["public"];
-        readonly create: readonly ["editor", "admin"];
-        readonly update: readonly ["editor", "admin"];
-        readonly delete: readonly ["admin"];
-        readonly publish: readonly ["admin"];
-    };
-};
-export declare const page: {
-    readonly name: "page";
-    readonly labels: {
-        readonly singular: "Page";
-        readonly plural: "Pages";
-    };
-    readonly routing: {
-        readonly pattern: "/:slug";
-    };
-    readonly fields: {
-        readonly seoTitle: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "text";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly seoDescription: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "text";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly seoImage: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "media";
-            readonly options: {
-                accept: readonly ("audio" | "file" | "image" | "video")[];
-                many: boolean;
-            };
-        };
-        readonly seoNoindex: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "boolean";
-            readonly options: {};
-        };
-        readonly title: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "text";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly slug: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "slug";
-            readonly options: Readonly<Record<string, unknown>>;
-        };
-        readonly blocks: import("@cogenta/schema").FieldDefinition & {
-            readonly kind: "blocks";
-            readonly options: {
-                allow: "*" | readonly string[];
-            };
-        };
-    };
-    readonly indexes: readonly [readonly ["slug"]];
-    readonly permissions: {
-        readonly read: readonly ["public"];
-        readonly create: readonly ["editor", "admin"];
-        readonly update: readonly ["editor", "admin"];
-        readonly delete: readonly ["admin"];
-    };
-};
+export declare const post: CollectionDefinition;
+export declare const page: CollectionDefinition;
 export declare const BLOG_COLLECTIONS: readonly CollectionDefinition[];
 export declare const BLOG_TAXONOMIES: readonly TaxonomyDefinition[];
-/** What a piece of demo writing may refer to: the site's own name and the ingested photographs. */
-export interface BlogCopyContext {
-    readonly siteName: string;
-    readonly media: Readonly<Record<string, string>>;
-}
-export interface BlogDemoCategory {
-    readonly name: string;
-    readonly slug: string;
-    readonly description: string;
-}
-export interface BlogDemoTag {
-    readonly name: string;
-    readonly slug: string;
-}
-export interface BlogDemoPost {
-    readonly title: string;
-    readonly slug: string;
-    readonly excerpt: string;
-    /** ISO 8601. Posts are listed oldest first here and inserted in this order. */
-    readonly publishedAt: string;
-    /** A `DemoMediaSpec.name` for the cover, when this piece has one. */
-    readonly cover?: string;
-    readonly categorySlug: string;
-    readonly tagSlugs: readonly string[];
-    readonly body: (copy: BlogCopyContext) => RichTextDocument;
-}
-export declare const BLOG_DEMO_CATEGORIES: readonly BlogDemoCategory[];
-export declare const BLOG_DEMO_TAGS: readonly BlogDemoTag[];
+export declare const BLOG_DEMO_CATEGORIES: readonly import("./blog-copy.js").BlogDemoCategory[];
+export declare const BLOG_DEMO_TAGS: readonly import("./blog-copy.js").BlogDemoTag[];
 export declare const BLOG_DEMO_POSTS: readonly BlogDemoPost[];
 export interface BlogDemoPage {
     readonly title: string;
     readonly slug: string;
+    readonly seoDescription?: string;
     readonly blocks: readonly VocabularyBlock[];
 }
 /**
- * `home`, `about`, `archive` and `newsletter`. A function of the ingested
- * media and of the site's name, for the same reason `store.ts`'s
- * `buildStoreDemoPages` is a function of `media`.
+ * `home`, `about`, `archive`, `newsletter` and `photo-credits`. A function of
+ * the ingested media and of the site's name, for the same reason
+ * `store.ts`'s `buildStoreDemoPages` is a function of `media`.
  *
  * The home page features an essay that is neither among the five newest
  * (the index right under it) nor among the three oldest (the shelf further
  * down), so no piece appears twice on the page.
  */
-export declare function buildBlogDemoPages(media: Readonly<Record<string, string>>, siteName?: string): readonly BlogDemoPage[];
+export declare function buildBlogDemoPages(media: Readonly<Record<string, string>>, siteName?: string, copy?: BlogCopy): readonly BlogDemoPage[];
 /**
- * Five photographs, all bundled (`assets/photos/blog/`), each cropped once
- * to remove anything a reader would try and fail to read. `spec` is the
- * procedural fallback `seedDemoMedia` would use if a file were ever missing;
- * with every file present it is never rendered.
+ * Seven photographs, all bundled, each cropped once to remove anything a
+ * reader would try and fail to read. `spec` is the procedural fallback
+ * `seedDemoMedia` would use if a file were ever missing; with every file
+ * present it is never rendered.
+ *
+ * One per essay (a "Letter" stays text-only by design — a personal letter is
+ * not a produced piece the way an essay is), so the front of the site is
+ * never carrying the same photograph in three places at once.
  */
+export declare function blogMediaSpecs(copy: BlogCopy): readonly DemoMediaSpec[];
 export declare const BLOG_MEDIA_SPECS: readonly DemoMediaSpec[];
 /** Header, footer and the header's call to action. Every path is a page this blueprint seeds or a route the server provides. */
 export declare const BLOG_MENUS: BlueprintMenus;
+export declare function blogSiteSettings(copy: BlogCopy): Readonly<Record<string, unknown>>;
 export declare const BLOG_SITE_SETTINGS: Readonly<Record<string, unknown>>;
+/**
+ * The sidebar a reader of a personal blog expects beside an essay, a subject
+ * or tag archive and search results: who writes it, a way to search, the
+ * latest pieces, the four subjects with their counts, the tags, and the years.
+ * Never on the home page, which already opens on a featured essay and the
+ * index, nor on About, Archive and the letter page, which say the same things
+ * at length. Under an essay, the related pieces carry the reader on.
+ */
+export declare function blogWidgets(copy: BlogCopy): readonly BlueprintWidget[];
 export declare const BLOG_WIDGETS: readonly BlueprintWidget[];
 export declare const BLOG_RECOMMENDED_AGENTS: readonly RecommendedAgentHint[];
+/** The whole blueprint, in one language. */
+export declare function createBlogContentPack(locale: string): BlueprintContentPack;
+/** The English pack, which `BLUEPRINT_CONTENT_PACKS` lists; `contentPackFor` picks by locale. */
 export declare const blogContentPack: BlueprintContentPack;
 //# sourceMappingURL=blog.d.ts.map

package/dist/blueprints/blog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../src/blueprints/blog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../src/blueprints/blog.ts"],"names":[],"mappings":"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"}