@mnstry/atelier 0.2.0-alpha.15 → 0.2.0-alpha.17

package/src/graph-workspace/browser/workspace.mjs

@@ -1,5 +1,5 @@
-// Default graph workspace shell: one graph, three rooms (constellation, workbench,
-// review), chosen by a work recipe. Coaches can use it as is, restyle it through a
+// Default graph workspace shell: one graph, three rooms (map, workbench,
+// review), chosen by a work recipe. Distributions can use it as is, restyle it through a
 // theme, change its recipes, or build their own shell from the same rooms.
 //
 //   const workspace = mountGraphWorkspace(element, {
@@ -15,13 +15,13 @@
 //
 // One workspace per document (it uses fixed element ids). The host decides what
 // the model contains; nothing here fetches, grants or saves to a source.
-import { createConstellation } from './constellation.mjs'
+import { createMap } from './map.mjs'
 import { createWorkbench } from './workbench.mjs'
 import { renderReview } from './review.mjs'
 import { injectGraphWorkspaceStyles } from './styles.mjs'
 import { h, clear } from './dom.mjs'
 import { createDraftStore, readiness, memoryStorage } from '../authoring.mjs'
-import { composeRecipes, availableRecipes } from '../recipes.mjs'
+import { composeRecipes, availableRecipes, currentRoom } from '../recipes.mjs'
 import { DEFAULT_THEME, validateTheme } from '../theme.mjs'
 
 const fmt = n => n.toLocaleString('en-US')
@@ -56,16 +56,18 @@ export function mountGraphWorkspace(root, options) {
     model, deps = null, theme = DEFAULT_THEME, profile = {}, initialRecipe = null, intro = true,
     webgl = hasWebGL() && !!deps,
   } = options
-  const recipesAll = options.recipes ?? composeRecipes().recipes
+  // Recipes may arrive already composed (possibly by alpha.15 code): read their
+  // room names as this release does, keeping everything else, provenance included.
+  const recipesAll = (options.recipes ?? composeRecipes().recipes).map(r => (r && typeof r === 'object' && !Array.isArray(r) && 'room' in r ? { ...r, room: currentRoom(r.room) } : r))
   const recipes = availableRecipes(recipesAll, model)
   const byRecipe = new Map(recipes.map(r => [r.id, r]))
   const vocab = { record: 'record', records: 'records', zone: 'zone', concept: 'concept', model: 'Concepts', ...(profile.vocabulary ?? {}) }
   injectGraphWorkspaceStyles(root.ownerDocument)
 
   const byNode = new Map(model.nodes.map(n => [n.id, n]))
-  const state = { recipe: null, room: 'constellation', selected: null, lens: null, questionId: null, conceptId: null, zoneId: null, textView: !webgl, scheme: options.scheme ?? theme.defaultScheme, zonesOn: true, linksOn: true, labelBoost: 1, savedCamera: null }
+  const state = { recipe: null, room: 'map', selected: null, lens: null, questionId: null, conceptId: null, zoneId: null, textView: !webgl, scheme: options.scheme ?? theme.defaultScheme, zonesOn: true, linksOn: true, labelBoost: 1, savedCamera: null }
   const counters = { dives: 0 }
-  let palette = null, constellation = null
+  let palette = null, mapView = null
 
   // ── DOM ──
   const el = {}
@@ -74,7 +76,7 @@ export function mountGraphWorkspace(root, options) {
   root.classList.add('atelier-gw')
   const stage = h('div', { class: 'stage' })
   stage.append(
-    make('constellation', 'div', { class: 'constellation', role: 'img', 'aria-label': 'Constellation of every record you can read. Use search, the selection card or Text view to move through it by keyboard.' }),
+    make('map', 'div', { class: 'map constellation', role: 'img', 'aria-label': 'Map of every record you can read. Use search, the selection card or Text view to move through it by keyboard.' }),
     h('header', { class: 'top' },
       h('div', { class: 'menu-wrap', 'data-graph-reserve': '' },
         make('recipeBtn', 'button', { class: 'pill', type: 'button', 'aria-haspopup': 'menu', 'aria-expanded': 'false' }, h('span', { class: 'emblem', 'aria-hidden': 'true', text: profile.emblem ?? '◌' }), make('recipeLabel', 'span', { text: '' }), h('span', { class: 'caret', 'aria-hidden': 'true', text: '▾' })),
@@ -116,7 +118,7 @@ export function mountGraphWorkspace(root, options) {
 
   function applyAppearance() {
     palette = applyTheme(theme, state.scheme, root)
-    constellation?.setPalette(palette)
+    mapView?.setPalette(palette)
     el.schemeBtn.textContent = state.scheme === 'dark' ? 'Light appearance' : 'Dark appearance'
   }
   applyAppearance()
@@ -126,10 +128,10 @@ export function mountGraphWorkspace(root, options) {
 
   const font = getComputedStyle(root).getPropertyValue('--font-sans').trim() || 'system-ui'
   if (webgl) {
-    constellation = createConstellation({ container: el.constellation, model, palette, font, deps, onSelect: id => select(id), onOpen: id => openWorkbench({ kind: 'record', id }) })
-    if (intro) constellation.intro()
+    mapView = createMap({ container: el.map, model, palette, font, deps, onSelect: id => select(id), onOpen: id => openWorkbench({ kind: 'record', id }) })
+    if (intro) mapView.intro()
   }
-  const workbench = createWorkbench({ root: el.workbench, model, palette, store, vocab, onBack: backToConstellation, onReview: () => openReview({ from: 'workbench' }), onShowOnMap: id => backToConstellation().then(() => { select(id); constellation?.showNode(id) }) })
+  const workbench = createWorkbench({ root: el.workbench, model, palette, store, vocab, onBack: backToMap, onReview: () => openReview({ from: 'workbench' }), onShowOnMap: id => backToMap().then(() => { select(id); mapView?.showNode(id) }) })
   el.workbench.hidden = true
 
   // ── Recipes ──
@@ -142,7 +144,7 @@ export function mountGraphWorkspace(root, options) {
     root.dataset.recipe = recipe.id
     root.dataset.primary = recipe.primary
     closeMenus()
-    state.lens = recipe.room === 'constellation' ? recipe.lens : null
+    state.lens = recipe.room === 'map' ? recipe.lens : null
     renderLensCard()
     if (recipe.room === 'workbench') {
       // In the workbench the primary action is where focus lands (the top bar sits behind it).
@@ -152,17 +154,17 @@ export function mountGraphWorkspace(root, options) {
       const opened = openWorkbench(subject)
       if (mounted) opened.then(() => focusPrimary(recipe.primary))
     } else if (recipe.room === 'review') openReview({ from: 'recipe' })
-    else if (state.room !== 'constellation') backToConstellation()
+    else if (state.room !== 'map') backToMap()
     announce(`${recipe.label}. ${recipe.description}`)
   }
   function renderLensCard() {
     el.questionCard.hidden = !state.lens
     el.questionCard.dataset.lens = state.lens ?? ''
-    if (state.lens !== 'zone') constellation?.setFocusZone(null)
+    if (state.lens !== 'zone') mapView?.setFocusZone(null)
     if (state.lens === 'question') renderQuestionCard()
     else if (state.lens === 'concept') renderConceptLens()
     else if (state.lens === 'zone') renderZoneLens()
-    else { clear(el.questionCard); constellation?.setLens(null) }
+    else { clear(el.questionCard); mapView?.setLens(null) }
   }
   function renderConceptLens() {
     clear(el.questionCard)
@@ -170,7 +172,7 @@ export function mountGraphWorkspace(root, options) {
     const c = plan.concepts.find(x => x.id === state.conceptId) ?? plan.concepts[0]
     state.conceptId = c.id
     const ids = c.declaredBy.filter(id => byNode.has(id))
-    constellation?.setLens(ids)
+    mapView?.setLens(ids)
     el.questionCard.append(h('p', { class: 'eyebrow', text: `The ${vocab.concept} in view` }),
       h('select', { 'aria-label': vocab.concept, onchange: e => { state.conceptId = e.target.value; renderConceptLens() } }, plan.concepts.map(x => h('option', { value: x.id, selected: x.id === c.id, text: x.title }))),
       h('p', { class: 'q-lit', 'data-gw': 'lens-lit', text: ids.length ? `${fmt(ids.length)} ${ids.length === 1 ? vocab.record : vocab.records} declare it.` : 'No record you can read declares it yet.' }),
@@ -181,8 +183,8 @@ export function mountGraphWorkspace(root, options) {
     const z = model.zones.find(x => x.id === state.zoneId) ?? model.zones[0]
     if (!z) return
     state.zoneId = z.id
-    constellation?.setLens(null)
-    constellation?.setFocusZone(z.id)
+    mapView?.setLens(null)
+    mapView?.setFocusZone(z.id)
     el.questionCard.append(h('p', { class: 'eyebrow', text: `The ${vocab.zone} in view` }),
       h('select', { 'aria-label': vocab.zone, onchange: e => { state.zoneId = e.target.value; renderZoneLens() } }, model.zones.map(x => h('option', { value: x.id, selected: x.id === z.id, text: x.label }))),
       h('p', { class: 'q-lit', 'data-gw': 'lens-lit', text: `${fmt(z.count)} ${z.count === 1 ? vocab.record : vocab.records}. Others are dimmed, not removed.` }))
@@ -219,7 +221,7 @@ export function mountGraphWorkspace(root, options) {
     const q = plan.questions.find(x => x.id === state.questionId) ?? plan.questions[0]
     state.questionId = q.id
     const ids = new Set(questionLit())
-    constellation?.setLens([...ids])
+    mapView?.setLens([...ids])
     const zones = new Set([...ids].map(id => byNode.get(id).zoneLabel))
     el.questionCard.append(h('p', { class: 'eyebrow', text: 'The question on the table' }),
       h('select', { 'aria-label': 'Question', onchange: e => { state.questionId = e.target.value; renderQuestionCard() } }, plan.questions.map(x => h('option', { value: x.id, selected: x.id === q.id, text: x.question }))),
@@ -231,7 +233,7 @@ export function mountGraphWorkspace(root, options) {
   // ── Selection and rooms ──
   function select(id) {
     state.selected = id
-    constellation?.select(id)
+    mapView?.select(id)
     renderCard()
     if (id) announce(`Selected ${model.nodes.find(n => n.id === id)?.title}.`)
   }
@@ -253,20 +255,20 @@ export function mountGraphWorkspace(root, options) {
       h('p', { class: 'card-meta', text: `${n.degree} links · ${n.relationDegree} declared${n.concepts.length ? ' · declares ' + n.concepts.join(', ') : ''}` }),
       h('div', { class: 'card-actions' },
         h('button', { class: 'primary', type: 'button', 'data-gw': 'open-selected', onclick: () => openWorkbench({ kind: 'record', id: n.id }) }, 'Open in the workbench'),
-        constellation ? h('button', { class: 'quiet', type: 'button', onclick: () => constellation.showNode(n.id) }, 'Show on map') : null),
+        mapView ? h('button', { class: 'quiet', type: 'button', onclick: () => mapView.showNode(n.id) }, 'Show on map') : null),
       near.length ? h('details', { class: 'card-neighbours' }, h('summary', { text: `Walk to a neighbour (${near.length})` }),
         h('ul', {}, near.slice(0, 12).map(x => h('li', {}, h('button', { class: 'link-row', type: 'button', onclick: () => { select(x.id); root.querySelector('#card-title')?.focus() } }, model.nodes.find(m => m.id === x.id).title))))) : null)
   }
   async function openWorkbench(subject) {
     closeMenus()
     let from = null
-    if (state.room === 'constellation' && constellation) {
-      state.savedCamera = constellation.camera.getState()
+    if (state.room === 'map' && mapView) {
+      state.savedCamera = mapView.camera.getState()
       if (subject.kind === 'record') {
-        const p = constellation.nodeViewport(subject.id), r = el.constellation.getBoundingClientRect()
+        const p = mapView.nodeViewport(subject.id), r = el.map.getBoundingClientRect()
         from = p ? { x: r.left + p.x, y: r.top + p.y } : null
         root.classList.add('diving')
-        await constellation.dive(subject.id)
+        await mapView.dive(subject.id)
       }
     }
     counters.dives++
@@ -276,13 +278,13 @@ export function mountGraphWorkspace(root, options) {
     el.review.hidden = true
     workbench.open(subject, { from })
   }
-  async function backToConstellation() {
+  async function backToMap() {
     workbench.close()
     el.review.hidden = true
-    state.room = 'constellation'
-    root.dataset.room = 'constellation'
-    if (constellation && state.savedCamera) await constellation.restore(state.savedCamera)
-    constellation?.refresh()
+    state.room = 'map'
+    root.dataset.room = 'map'
+    if (mapView && state.savedCamera) await mapView.restore(state.savedCamera)
+    mapView?.refresh()
   }
   function openReview({ from = 'workbench' } = {}) {
     closeMenus()
@@ -292,8 +294,8 @@ export function mountGraphWorkspace(root, options) {
     const toWorkbench = () => { el.review.hidden = true; state.room = 'workbench'; root.dataset.room = 'workbench' }
     renderReview(el.review, {
       model: { ...model, systemId: profile.id ?? 'workspace' }, store,
-      backLabel: from === 'workbench' ? '← Back to the workbench' : '← Back to the constellation',
-      onBack: () => { if (from === 'workbench') { toWorkbench(); workbench.refresh() } else { el.review.hidden = true; backToConstellation() } },
+      backLabel: from === 'workbench' ? '← Back to the workbench' : '← Back to the map',
+      onBack: () => { if (from === 'workbench') { toWorkbench(); workbench.refresh() } else { el.review.hidden = true; backToMap() } },
       onOpen: s => { toWorkbench(); workbench.open(s) },
     })
   }
@@ -303,9 +305,9 @@ export function mountGraphWorkspace(root, options) {
     const q = query.trim().toLowerCase()
     const commands = [
       ...recipes.map(r => ({ kind: 'recipe', id: r.id, label: r.label, hint: r.description })),
-      ...(webgl ? [{ kind: 'command', id: 'text', label: state.textView ? 'Show the constellation' : 'Text view', hint: 'Every record as a structured list' }] : []),
+      ...(webgl ? [{ kind: 'command', id: 'text', label: state.textView ? 'Show the map' : 'Text view', hint: 'Every record as a structured list' }] : []),
       { kind: 'command', id: 'scheme', label: state.scheme === 'dark' ? 'Light appearance' : 'Dark appearance', hint: 'Switch appearance' },
-      ...(constellation ? [{ kind: 'command', id: 'fit', label: 'Fit the whole graph', hint: 'Zoom out to everything' }] : []),
+      ...(mapView ? [{ kind: 'command', id: 'fit', label: 'Fit the whole graph', hint: 'Zoom out to everything' }] : []),
     ]
     if (!q) return commands.slice(0, 6)
     const out = commands.filter(c => c.label.toLowerCase().includes(q))
@@ -331,10 +333,10 @@ export function mountGraphWorkspace(root, options) {
     else if (r.kind === 'concept') openWorkbench({ kind: 'concept', id: r.id })
     else if (r.kind === 'question') { state.questionId = r.id; const q = recipes.find(x => x.lens === 'question'); if (q) setRecipe(q.id) }
     else if (r.kind === 'zone') { state.zoneId = r.id; const z = recipes.find(x => x.lens === 'zone'); if (z) setRecipe(z.id) }
-    else if (r.kind === 'record') { if (state.room !== 'constellation') backToConstellation().then(() => select(r.id)); else select(r.id); root.querySelector('#card-title')?.focus() }
+    else if (r.kind === 'record') { if (state.room !== 'map') backToMap().then(() => select(r.id)); else select(r.id); root.querySelector('#card-title')?.focus() }
     else if (r.id === 'text') toggleText()
     else if (r.id === 'scheme') toggleScheme()
-    else if (r.id === 'fit') constellation?.fit()
+    else if (r.id === 'fit') mapView?.fit()
   }
 
   // ── Text view ──
@@ -366,7 +368,7 @@ export function mountGraphWorkspace(root, options) {
     state.textView = !state.textView
     root.classList.toggle('text-mode', state.textView)
     el.textToggle.setAttribute('aria-pressed', String(state.textView))
-    if (state.textView) el.textView.querySelector('input')?.focus(); else constellation?.refresh()
+    if (state.textView) el.textView.querySelector('input')?.focus(); else mapView?.refresh()
   }
   function toggleScheme() { state.scheme = state.scheme === 'dark' ? 'light' : 'dark'; applyAppearance(); renderTextView(); renderCard(); if (state.room === 'workbench') workbench.refresh() }
 
@@ -384,13 +386,13 @@ export function mountGraphWorkspace(root, options) {
   on(el.displayBtn, 'click', () => toggle(el.display, el.displayBtn))
   on(el.textToggle, 'click', toggleText)
   on(el.schemeBtn, 'click', toggleScheme)
-  on(el.zonesToggle, 'change', e => { state.zonesOn = e.target.checked; constellation?.setOption('zonesOn', state.zonesOn) })
-  on(el.linksToggle, 'change', e => { state.linksOn = e.target.checked; constellation?.setOption('linksOn', state.linksOn) })
-  on(el.labelsRange, 'input', e => { state.labelBoost = +e.target.value; constellation?.setOption('labelBoost', state.labelBoost) })
-  on(el.physicsToggle, 'change', e => { e.target.checked = !!constellation?.setPhysics(e.target.checked) })
-  on(el.fit, 'click', () => constellation?.fit())
-  on(el.zoomIn, 'click', () => constellation?.zoom(1.5))
-  on(el.zoomOut, 'click', () => constellation?.zoom(1 / 1.5))
+  on(el.zonesToggle, 'change', e => { state.zonesOn = e.target.checked; mapView?.setOption('zonesOn', state.zonesOn) })
+  on(el.linksToggle, 'change', e => { state.linksOn = e.target.checked; mapView?.setOption('linksOn', state.linksOn) })
+  on(el.labelsRange, 'input', e => { state.labelBoost = +e.target.value; mapView?.setOption('labelBoost', state.labelBoost) })
+  on(el.physicsToggle, 'change', e => { e.target.checked = !!mapView?.setPhysics(e.target.checked) })
+  on(el.fit, 'click', () => mapView?.fit())
+  on(el.zoomIn, 'click', () => mapView?.zoom(1.5))
+  on(el.zoomOut, 'click', () => mapView?.zoom(1 / 1.5))
   on(el.command, 'focus', renderCommand)
   on(el.command, 'input', renderCommand)
   on(el.command, 'keydown', e => {
@@ -410,9 +412,9 @@ export function mountGraphWorkspace(root, options) {
     if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k') { e.preventDefault(); el.command.focus(); return }
     if (e.target.closest?.('input, textarea, select') || e.metaKey || e.ctrlKey || e.altKey) return
     if (e.key === '/') { e.preventDefault(); el.command.focus() }
-    else if (e.key === 'Escape') { if (!el.recipeMenu.hidden || !el.display.hidden) closeMenus(); else if (state.room === 'review') root.querySelector('#review-back')?.click(); else if (state.room === 'workbench') backToConstellation(); else select(null) }
+    else if (e.key === 'Escape') { if (!el.recipeMenu.hidden || !el.display.hidden) closeMenus(); else if (state.room === 'review') root.querySelector('#review-back')?.click(); else if (state.room === 'workbench') backToMap(); else select(null) }
     else if (e.key === 't') { e.preventDefault(); toggleText() }
-    else if (e.key === 'o' && state.selected && state.room === 'constellation') openWorkbench({ kind: 'record', id: state.selected })
+    else if (e.key === 'o' && state.selected && state.room === 'map') openWorkbench({ kind: 'record', id: state.selected })
   })
 
   let mounted = false
@@ -421,11 +423,11 @@ export function mountGraphWorkspace(root, options) {
   mounted = true
 
   return {
-    get state() { return { ...state, savedCamera: undefined, counters: { ...counters }, webgl, records: model.nodes.length, links: model.edges.length, workbench: workbench.subject, camera: constellation ? constellation.camera.getState() : null, draftStatus: store.status, draftPersistence: store.persistence } },
-    recipes, store, constellation, workbench,
-    select, openWorkbench, openReview, setRecipe, runPrimary, backToConstellation, toggleText,
+    get state() { return { ...state, savedCamera: undefined, counters: { ...counters }, webgl, records: model.nodes.length, links: model.edges.length, workbench: workbench.subject, camera: mapView ? mapView.camera.getState() : null, draftStatus: store.status, draftPersistence: store.persistence } },
+    recipes, store, map: mapView, constellation: mapView, workbench,
+    select, openWorkbench, openReview, setRecipe, runPrimary, backToMap, backToConstellation: backToMap, toggleText,
     setScheme(scheme) { state.scheme = scheme; applyAppearance() },
     readiness: () => readiness(model.plan, store, new Set(model.nodes.map(n => n.id))).status,
-    destroy() { for (const fn of cleanups.splice(0)) fn(); constellation?.kill(); clear(root); root.classList.remove('atelier-gw') },
+    destroy() { for (const fn of cleanups.splice(0)) fn(); mapView?.kill(); clear(root); root.classList.remove('atelier-gw') },
   }
 }

package/src/graph-workspace/disclosure.mjs

@@ -1,4 +1,4 @@
-// Shippable-content gate for layered systems. When a coach or owner builds on top of
+// Shippable-content gate for layered systems. When a distribution or owner builds on top of
 // private workspaces, the shareable layer must not carry anything from them.
 // fingerprintsFrom() derives distinctive strings from a private knowledge graph and
 // plan (ids, paths, long titles, summary openings, plan wording, names);

package/src/graph-workspace/geometry.mjs

@@ -1,4 +1,4 @@
-// Presentation geometry for the constellation. Positions are presentation only:
+// Presentation geometry for the map. Positions are presentation only:
 // distance never asserts a relation. The force layout itself is injected so this
 // package carries no layout dependency; any ForceAtlas2-compatible function works.
 

package/src/graph-workspace/index.mjs

@@ -3,9 +3,9 @@
 // Pure modules only; browser rooms live under ./browser/index.mjs.
 export { buildWorkspaceModel, zoneOf, ROOT_ZONE, validateZoneRule, edgeClass, EDGE_CLASSES, neighbours } from './model.mjs'
 export { seedPositions, layoutWorkspace, normalizePositions, zoneGeometry, LAYOUT_WEIGHTS } from './geometry.mjs'
-export { planConstellation, aggregateZones, zoneSlice, rankRecords, DEFAULT_BUDGET } from './scale.mjs'
+export { planMap, planConstellation, aggregateZones, zoneSlice, rankRecords, DEFAULT_BUDGET } from './scale.mjs'
 export { placeLabels, labelThreshold, labelBudget, overlaps } from './labels.mjs'
-export { DEFAULT_RECIPES, composeRecipes, validateRecipe, availableRecipes, ROOMS, LENSES, SUBJECTS, LAYERS, PRIMARY_ACTIONS, primaryActionsFor } from './recipes.mjs'
+export { DEFAULT_RECIPES, composeRecipes, validateRecipe, availableRecipes, ROOMS, DEPRECATED_ROOMS, currentRoom, LENSES, SUBJECTS, LAYERS, PRIMARY_ACTIONS, primaryActionsFor } from './recipes.mjs'
 export { DEFAULT_THEME, composeTheme, validateTheme, contrastRatio } from './theme.mjs'
 export { conceptSteps, relationSteps, guideConcept, guideRelation, stepState, createDraftStore, memoryStorage, readiness } from './authoring.mjs'
 export { fingerprintsFrom, scanForFingerprints } from './disclosure.mjs'

package/src/graph-workspace/recipes.mjs

@@ -1,11 +1,14 @@
-// Work recipes, layered: Atelier ships defaults, a cohort coach adds or adjusts,
-// and the owner has the final say. A recipe is data that chooses the room, the lens
+// Work recipes, layered: Atelier ships defaults, a distribution (the tier that
+// adapts Atelier for a programme or cohort) adds or adjusts, and the owner has the
+// final say. A recipe is data that chooses the room, the lens
 // and the one primary action. Every resolved field records which layer set it.
 
-export const ROOMS = Object.freeze(['constellation', 'workbench', 'review'])
+export const ROOMS = Object.freeze(['map', 'workbench', 'review'])
+/** Names accepted for one release and read as their replacements. */
+export const DEPRECATED_ROOMS = Object.freeze({ constellation: 'map' })
 export const LENSES = Object.freeze([null, 'question', 'concept', 'zone'])
 export const SUBJECTS = Object.freeze([null, 'record', 'concept', 'relation'])
-export const LAYERS = Object.freeze(['atelier', 'coach', 'owner'])
+export const LAYERS = Object.freeze(['atelier', 'distribution', 'owner'])
 /** The single emphasised action of a recipe. The default shell implements each one. */
 export const PRIMARY_ACTIONS = Object.freeze(['search', 'open-evidence', 'next-step', 'walk', 'review', 'pick'])
 
@@ -19,14 +22,16 @@ export function primaryActionsFor({ room, lens = null, subject = null }) {
 }
 
 export const DEFAULT_RECIPES = Object.freeze([
-  { id: 'explore', label: 'Explore', room: 'constellation', lens: null, subject: null, primary: 'search', description: 'Wander the whole graph. Zones on, search ready.' },
-  { id: 'question', label: 'Answer a question', room: 'constellation', lens: 'question', subject: null, primary: 'open-evidence', description: 'Light the records that declare a question’s concepts.' },
+  { id: 'explore', label: 'Explore', room: 'map', lens: null, subject: null, primary: 'search', description: 'Wander the whole graph. Zones on, search ready.' },
+  { id: 'question', label: 'Answer a question', room: 'map', lens: 'question', subject: null, primary: 'open-evidence', description: 'Light the records that declare a question’s concepts.' },
   { id: 'refine', label: 'Refine a concept', room: 'workbench', lens: null, subject: 'concept', primary: 'next-step', description: 'One concept, one step at a time.' },
   { id: 'inspect', label: 'Inspect a record', room: 'workbench', lens: null, subject: 'record', primary: 'walk', description: 'A record and its closest links, with room to read.' },
 ].map(Object.freeze))
 
 const FIELDS = ['label', 'room', 'lens', 'subject', 'primary', 'description']
 const text = (v, max) => typeof v === 'string' && v.trim().length > 0 && v.length <= max
+/** A room name as this release reads it: deprecated names map to their replacements. */
+export const currentRoom = room => (typeof room === 'string' && Object.hasOwn(DEPRECATED_ROOMS, room) ? DEPRECATED_ROOMS[room] : room)
 
 export function validateRecipe(recipe, { partial = false } = {}) {
   const problems = []
@@ -36,7 +41,7 @@ export function validateRecipe(recipe, { partial = false } = {}) {
   const need = !partial
   if ((need || 'label' in recipe) && !text(recipe.label, 60)) problems.push('label must be 1–60 characters')
   if ((need || 'description' in recipe) && !text(recipe.description, 200)) problems.push('description must be 1–200 characters')
-  if ((need || 'room' in recipe) && !ROOMS.includes(recipe.room)) problems.push(`room must be one of ${ROOMS.join(', ')}`)
+  if ((need || 'room' in recipe) && !ROOMS.includes(currentRoom(recipe.room))) problems.push(`room must be one of ${ROOMS.join(', ')}`)
   if ('lens' in recipe && !LENSES.includes(recipe.lens)) problems.push('unknown lens')
   if ('subject' in recipe && !SUBJECTS.includes(recipe.subject)) problems.push('unknown subject')
   if ((need || 'primary' in recipe) && !PRIMARY_ACTIONS.includes(recipe.primary)) problems.push(`primary must be one of ${PRIMARY_ACTIONS.join(', ')}`)
@@ -48,22 +53,29 @@ export function validateRecipe(recipe, { partial = false } = {}) {
  * Compose recipe layers. Each layer is a list; an entry with an existing id adjusts
  * it (partial), a new id adds a complete recipe, and `hidden: true` removes it from
  * what the owner sees. Later layers win. Throws on any invalid entry.
+ * `coach` is the alpha.15 name of the distribution layer, accepted for one release;
+ * the room `constellation` is likewise read as `map`.
  */
-export function composeRecipes({ atelier = DEFAULT_RECIPES, coach = [], owner = [] } = {}) {
+export function composeRecipes({ atelier = DEFAULT_RECIPES, distribution, coach, owner = [] } = {}) {
+  if (distribution !== undefined && coach !== undefined) throw new TypeError('Give the distribution layer once: `coach` is its deprecated name')
+  // Only an omitted layer defaults; anything supplied (null included) is validated below.
+  const middle = distribution !== undefined ? distribution : coach !== undefined ? coach : []
   const resolved = new Map()
   const provenance = new Map()
-  for (const [layer, list] of [['atelier', atelier], ['coach', coach], ['owner', owner]]) {
+  for (const [layer, list] of [['atelier', atelier], ['distribution', middle], ['owner', owner]]) {
     if (!Array.isArray(list)) throw new TypeError(`${layer} recipes must be a list`)
-    for (const entry of list) {
+    for (const raw of list) {
+      // Only plain recipe objects are normalised; anything else reaches validation unchanged.
+      const entry = raw && typeof raw === 'object' && !Array.isArray(raw) && 'room' in raw ? { ...raw, room: currentRoom(raw.room) } : raw
       const existing = resolved.get(entry?.id)
       const problems = validateRecipe(entry, { partial: !!existing })
       if (problems.length) throw new TypeError(`${layer} recipe ${entry?.id ?? '(no id)'}: ${problems.join('; ')}`)
       const next = { lens: null, subject: null, hidden: false, ...(existing ?? {}), ...entry }
-      // Only combinations a shell can honour: lenses belong to the constellation,
+      // Only combinations a shell can honour: lenses belong to the map,
       // subjects to the workbench, and the review room takes neither.
       if (next.room === 'workbench' && !next.subject) throw new TypeError(`${layer} recipe ${entry.id}: a workbench recipe needs a subject`)
       if (next.room !== 'workbench' && next.subject) throw new TypeError(`${layer} recipe ${entry.id}: only a workbench recipe takes a subject`)
-      if (next.room !== 'constellation' && next.lens) throw new TypeError(`${layer} recipe ${entry.id}: only a constellation recipe takes a lens`)
+      if (next.room !== 'map' && next.lens) throw new TypeError(`${layer} recipe ${entry.id}: only a map recipe takes a lens`)
       const actions = primaryActionsFor(next)
       if (!actions.includes(next.primary)) throw new TypeError(`${layer} recipe ${entry.id}: primary ${next.primary} is not available here; use ${actions.join(' or ')}`)
       resolved.set(entry.id, next)

package/src/graph-workspace/scale.mjs

@@ -1,6 +1,6 @@
 // Scale primitives for workspaces with tens of thousands of records.
 //
-// A constellation draws every readable record while that stays legible and fast.
+// The map draws every readable record while that stays legible and fast.
 // Beyond a budget, the whole is shown as zones (with honest counts and directed
 // bundles between them) and a person opens one zone at a time. Nothing here hides
 // a record silently: every bounded result states what it left out.
@@ -8,7 +8,7 @@
 export const DEFAULT_BUDGET = Object.freeze({ records: 12000, links: 60000 })
 
 /** Decide how the whole should be drawn for this model and budget. */
-export function planConstellation(model, budget = DEFAULT_BUDGET) {
+export function planMap(model, budget = DEFAULT_BUDGET) {
   const records = model.nodes.length, links = model.edges.length
   if (records <= budget.records && links <= budget.links) return { mode: 'records', records, links }
   return { mode: 'zones', records, links, reason: records > budget.records ? 'records-over-budget' : 'links-over-budget', budget: { ...budget } }
@@ -93,3 +93,6 @@ export function zoneSlice(model, zoneId, { limit = DEFAULT_BUDGET.records } = {}
     },
   }
 }
+
+/** Deprecated alpha.15 name of `planMap`, kept for one release. */
+export const planConstellation = planMap

package/src/graph-workspace/theme.mjs

@@ -1,5 +1,5 @@
 // Graph-workspace themes: resolved token data, never stylesheets.
-// Atelier ships two neutral defaults, `night` (the default) and `paper`. A coach or
+// Atelier ships two neutral defaults, `night` (the default) and `paper`. A distribution or
 // owner theme overrides values by name; the result is validated, including text
 // contrast, before any room applies it as CSS custom properties.
 
@@ -126,7 +126,7 @@ export function validateTheme(theme) {
   return problems
 }
 
-/** Override a base theme by layer (coach, then owner). Each layer is validated before it is applied. */
+/** Override a base theme by layer (distribution, then owner). Each layer is validated before it is applied. */
 export function composeTheme(base = DEFAULT_THEME, ...layers) {
   const baseProblems = validateTheme(base)
   if (baseProblems.length) throw new TypeError('Base theme refused: ' + baseProblems.join('; '))

package/src/ui/primitives/browser.mjs

@@ -0,0 +1,6 @@
+/** Atelier UI primitives for the browser. */
+export { enhanceCarousels, enhanceCarousel } from './carousel.mjs'
+export { enhanceDisclosures } from './disclosure.mjs'
+export { lockScroll, unlockScroll, scrollLocked } from './scroll-lock.mjs'
+export { animate, animationAllowed, onMotionChange, startMotionWatch } from './motion.mjs'
+export * from './state.mjs'