pandorga 1.2.1

data/studio-app/vite.config.js

@@ -0,0 +1,25 @@
+import { defineConfig } from "vite";
+import path from "node:path";
+
+export default defineConfig({
+  root: ".",
+  base: "/studio/",
+  publicDir: false,
+  build: {
+    outDir: path.resolve(__dirname, "../studio"),
+    emptyOutDir: false,
+    assetsDir: "assets",
+    rollupOptions: {
+      input: path.resolve(__dirname, "index.html"),
+    },
+  },
+  server: {
+    port: 5173,
+    proxy: {
+      "/api/studio": {
+        target: process.env.STUDIO_API_PROXY || "http://127.0.0.1:8788",
+        changeOrigin: true,
+      },
+    },
+  },
+});

data/templates/articles/README.md

@@ -0,0 +1,40 @@
+# Template: articles
+
+Writing collection rendered as a card grid with an optional featured item.
+Shares the writing contract with `blog`; only presentation differs.
+
+## Required registry keys
+
+| Key | Role |
+|---|---|
+| `key` | Page id |
+| `template` | Must be `articles` |
+| `collection` | Writing collection folder under `content/collections/` |
+| `path` | Listing URL |
+| `detail` | Detail route pattern, for example `/articles/:slug/` |
+
+Optional: `title`, `language`, `accent`, `nav`, `home`, `taxonomy`.
+
+## Collection contract
+
+`title`, `key`, `date`, `tags`, `language`, `thumbnail`, Markdown body.
+
+## Configuration
+
+```yaml
+- key: articles
+  template: articles
+  collection: articles
+  path: /pages/articles/
+  detail: /articles/:slug/
+```
+
+The same template may be registered twice with different `key`, `collection`,
+and `path` values. Each instance gets its own listing page.
+
+## Package layout
+
+- `template.yml` — slots, detail route, export fields
+- `studio.yml` — Studio field schema for the collection slot
+- `fixtures/` — minimal sample front matter
+- `screenshots/` — capture notes (manual or CI later)

data/templates/articles/fixtures/article.md

@@ -0,0 +1,9 @@
+---
+title: Welcome article
+key: welcome
+date: 2026-01-01
+tags: [Writing]
+language: en
+---
+
+Fictional sample for the articles template fixture.

data/templates/articles/screenshots/README.md

@@ -0,0 +1,6 @@
+# Screenshots
+
+Capture the articles listing (grid plus featured lead when present) manually
+or in CI visual inspection. PLT-AC-4 requires a screenshot for this template;
+place PNG or WebP files here when available. This directory fulfills the
+package contract until automated capture lands.

data/templates/articles/studio.yml

@@ -0,0 +1,73 @@
+# Studio fragment for the articles writing template.
+# Refs: PLT-AC-3, docs/spec.md §5.5
+group: writing
+group_label: Writing
+needs_media: true
+collection:
+  label: Articles
+  type: collection
+  format: yaml-frontmatter
+  filename: "{year}-{month}-{day}-{key}.md"
+  operations:
+    delete: false
+  view:
+    primary: title
+    fields: [thumbnail, title, date, published, language, key]
+    list_meta_fields: [date, language]
+  fields:
+    - name: layout
+      label: Layout
+      type: string
+      hidden: true
+      default: article
+    - name: key
+      label: Key
+      type: string
+      required: true
+      description: "URL slug and citation handle. Filename stem: YYYY-MM-DD-key.md."
+    - name: title
+      label: Title
+      type: string
+      required: true
+    - name: description
+      label: Description
+      type: text
+      description: "Deck under the title and link-preview text."
+    - name: date
+      label: Date
+      type: date
+      required: true
+      options:
+        format: yyyy-MM-dd
+        time: false
+    - name: tags
+      label: Tags
+      type: select
+      description: "Up to three. Empty is valid."
+      options:
+        multiple: true
+        max: 3
+        values: [Writing, Research, Notes]
+    - name: language
+      label: Language
+      type: select
+      options:
+        values: [enus, ptbr, frfr, eses]
+    - name: thumbnail
+      label: Thumbnail
+      type: image
+      description: "HTTPS URL or /media/… path."
+      options:
+        media: images
+        path: content/media/images/covers/articles
+        rename: safe
+    - name: published
+      label: Published
+      type: boolean
+      default: true
+    - name: redirects
+      label: Redirects
+      type: string
+      list: true
+    - name: body
+      component: markdown_body

data/templates/articles/template.yml

@@ -0,0 +1,21 @@
+name: articles
+collection_slots:
+  - name: collection
+    required: true
+    contract: writing
+detail: /articles/:slug/
+nav:
+  group: Writing
+home:
+  featured: true
+  limit: 3
+export_fields:
+  - title
+  - key
+  - date
+  - tags
+  - language
+  - thumbnail
+  - description
+  - author
+  - body

data/templates/bibliography/README.md

@@ -0,0 +1,41 @@
+# Template: bibliography
+
+Citation index built from a bibliography collection plus writings listed in
+`cited_by`. No per-item detail route; the listing is the page.
+
+## Required registry keys
+
+| Key | Role |
+|---|---|
+| `key` | Page id |
+| `template` | Must be `bibliography` |
+| `collection` | Bibliography folder under `content/collections/` |
+| `cited_by` | Array of writing page keys that cite entries |
+| `path` | Listing URL |
+
+Optional: `title`, `nav` (often `false`), `home` (default is a references
+index panel).
+
+## Collection contract
+
+Bibliography data as BibTeX or JSON under the collection folder; writings
+reference keys via includes such as `xcite`.
+
+## Configuration
+
+```yaml
+- key: bibliography
+  template: bibliography
+  title: Bibliography
+  collection: bibliography
+  cited_by: [articles, blog]
+  path: /pages/bibliography/
+  nav: false
+  home: { band: index, group: references }
+```
+
+## Package layout
+
+- `template.yml` — slots and home defaults
+- `fixtures/` — minimal sample bibliography JSON
+- `screenshots/` — capture notes (manual or CI later)

data/templates/bibliography/fixtures/references.json

@@ -0,0 +1,9 @@
+[
+  {
+    "key": "example2026",
+    "title": "Example Paper",
+    "year": "2026",
+    "author": "Ada Example",
+    "type": "article"
+  }
+]

data/templates/bibliography/screenshots/README.md

@@ -0,0 +1,6 @@
+# Screenshots
+
+Capture the bibliography listing manually or in CI visual inspection.
+PLT-AC-4 requires a screenshot for this template; place PNG or WebP files
+here when available. This directory fulfills the package contract until
+automated capture lands.

data/templates/bibliography/studio.yml

@@ -0,0 +1,66 @@
+# Studio fragment for the bibliography template.
+# Refs: PLT-AC-3, docs/spec.md §5.5
+group: references
+group_label: References
+collection:
+  label: Bibliography
+  type: collection
+  format: yaml
+  filename: "{primary}.yml"
+  operations:
+    delete: false
+  view:
+    primary: title
+    fields: [type, title, author, year]
+    list_meta_fields: [key]
+  fields:
+    - name: type
+      label: Type
+      type: select
+      default: misc
+      options:
+        values: [article, book, incollection, misc, techreport]
+    - name: title
+      label: Title
+      type: string
+    - name: author
+      label: Author
+      type: string
+      description: "Lastname, Firstname and Lastname2, Firstname2"
+    - name: year
+      label: Year
+      type: string
+    - name: url
+      label: URL
+      type: string
+    - name: doi
+      label: DOI
+      type: string
+      description: "Without URL prefix."
+    - name: journal
+      label: Journal
+      type: string
+    - name: publisher
+      label: Publisher
+      type: string
+    - name: institution
+      label: Institution
+      type: string
+    - name: howpublished
+      label: How published
+      type: string
+    - name: volume
+      label: Volume
+      type: string
+    - name: number
+      label: Number
+      type: string
+    - name: pages
+      label: Pages
+      type: string
+    - name: month
+      label: Month
+      type: string
+    - name: note
+      label: Note
+      type: text

data/templates/bibliography/template.yml

@@ -0,0 +1,18 @@
+name: bibliography
+collection_slots:
+  - name: collection
+    required: true
+    contract: bibliography
+cited_by:
+  required: true
+  description: Writing page keys whose citations feed this index
+nav: false
+home:
+  band: index
+  group: references
+export_fields:
+  - key
+  - title
+  - year
+  - author
+  - type

data/templates/blog/README.md

@@ -0,0 +1,38 @@
+# Template: blog
+
+Writing collection rendered as a dense ledger list with month bands and
+folio numbers. Shares the writing contract with `articles`; only
+presentation differs.
+
+## Required registry keys
+
+| Key | Role |
+|---|---|
+| `key` | Page id |
+| `template` | Must be `blog` |
+| `collection` | Writing collection folder under `content/collections/` |
+| `path` | Listing URL |
+| `detail` | Detail route pattern, for example `/posts/:slug/` |
+
+Optional: `title`, `language`, `accent`, `nav`, `home`, `taxonomy`.
+
+## Collection contract
+
+`title`, `key`, `date`, `tags`, `language`, `thumbnail`, Markdown body.
+
+## Configuration
+
+```yaml
+- key: blog
+  template: blog
+  title: Drafts
+  collection: posts
+  path: /pages/blog/
+  detail: /posts/:slug/
+```
+
+## Package layout
+
+- `template.yml` — slots, detail route, export fields
+- `fixtures/` — minimal sample front matter
+- `screenshots/` — capture notes (manual or CI later)

data/templates/blog/fixtures/post.md

@@ -0,0 +1,9 @@
+---
+title: A short draft note
+key: note
+date: 2026-01-02
+tags: [notes]
+language: en
+---
+
+Fictional draft for the blog template fixture.

data/templates/blog/screenshots/README.md

@@ -0,0 +1,6 @@
+# Screenshots
+
+Capture the blog ledger listing manually or in CI visual inspection.
+PLT-AC-4 requires a screenshot for this template; place PNG or WebP files
+here when available. This directory fulfills the package contract until
+automated capture lands.

data/templates/blog/studio.yml

@@ -0,0 +1,69 @@
+# Studio fragment for the blog writing template.
+# Refs: PLT-AC-3, docs/spec.md §5.5
+group: writing
+group_label: Writing
+needs_media: true
+collection:
+  label: Posts
+  type: collection
+  format: yaml-frontmatter
+  filename: "{year}-{month}-{day}-{key}.md"
+  operations:
+    delete: false
+  view:
+    primary: title
+    fields: [thumbnail, title, date, published, language, key]
+    list_meta_fields: [date, language]
+  fields:
+    - name: layout
+      label: Layout
+      type: string
+      hidden: true
+      default: post
+    - name: key
+      label: Key
+      type: string
+      required: true
+      description: "URL slug and citation handle. Filename stem: YYYY-MM-DD-key.md."
+    - name: title
+      label: Title
+      type: string
+      required: true
+    - name: date
+      label: Date
+      type: date
+      required: true
+      options:
+        format: yyyy-MM-dd
+        time: false
+    - name: tags
+      label: Tags
+      type: select
+      description: "Up to three. Empty is valid."
+      options:
+        multiple: true
+        max: 3
+        values: [Notes, Drafts, Ideas]
+    - name: language
+      label: Language
+      type: select
+      options:
+        values: [enus, ptbr, frfr, eses]
+    - name: thumbnail
+      label: Thumbnail
+      type: image
+      description: "HTTPS URL or /media/… path."
+      options:
+        media: images
+        path: content/media/images/covers/posts
+        rename: safe
+    - name: published
+      label: Published
+      type: boolean
+      default: true
+    - name: redirects
+      label: Redirects
+      type: string
+      list: true
+    - name: body
+      component: markdown_body

data/templates/blog/template.yml

@@ -0,0 +1,20 @@
+name: blog
+collection_slots:
+  - name: collection
+    required: true
+    contract: writing
+detail: /posts/:slug/
+nav:
+  group: Writing
+home:
+  limit: 4
+export_fields:
+  - title
+  - key
+  - date
+  - tags
+  - language
+  - thumbnail
+  - description
+  - author
+  - body

data/templates/cv/README.md

@@ -0,0 +1,34 @@
+# Template: cv
+
+Public curriculum page: jobs, products, skills, education, and contacts from
+data collections. Only fields listed in the contract leave the repository on
+export (`body_public` and the allowlisted job fields).
+
+## Required registry keys
+
+| Key | Role |
+|---|---|
+| `key` | Page id (nav, headers, Studio) |
+| `template` | Must be `cv` |
+| `path` | Listing URL, for example `/pages/cv/` |
+| `collections` | Map of slots: at least `jobs` and `products` (folder names under `content/collections/`) |
+
+Optional: `title`, `nav`, `home` (default band is `hero`).
+
+## Configuration
+
+```yaml
+- key: cv
+  template: cv
+  title: Curriculum Vitæ
+  path: /pages/cv/
+  collections: { jobs: jobs, products: products }
+  nav: { group: Profile, icon: article_person }
+  home: { band: hero }
+```
+
+## Package layout
+
+- `template.yml` — slots and home defaults
+- `fixtures/` — minimal sample front matter
+- `screenshots/` — capture notes (manual or CI later)

data/templates/cv/fixtures/job.md

@@ -0,0 +1,12 @@
+---
+title: Research Fellow
+key: research-fellow
+company: Example Labs
+role: Research Fellow
+start: 2024-01
+end: 2026-06
+location: Example City
+summary: Fictional public CV entry.
+---
+
+Public summary only.

data/templates/cv/screenshots/README.md

@@ -0,0 +1,6 @@
+# Screenshots
+
+Capture the CV listing (and optional print view) manually or in CI visual
+inspection. PLT-AC-4 requires a screenshot for this template; place PNG or
+WebP files here when available. This directory fulfills the package contract
+until automated capture lands.