@commonpub/layer 0.70.0 → 0.71.0

package/components/contest/ContestEntries.vue

@@ -78,6 +78,14 @@ function confirmWithdraw(entryId: string): void {
     emit('withdraw', entryId);
   }
 }
+
+// Cards link to the entry detail page (content summary + per-stage artifacts)
+// when we know the contest slug; otherwise straight to the content item.
+function entryLink(entry: Serialized<ContestEntryItem>): string {
+  return props.contestSlug
+    ? `/contests/${props.contestSlug}/entries/${entry.id}`
+    : `/u/${entry.authorUsername}/${entry.contentType}/${entry.contentSlug}`;
+}
 </script>
 
 <template>
@@ -104,7 +112,7 @@ function confirmWithdraw(entryId: string): void {
           <span v-else-if="entry.stageState && entry.stageState.some((s) => s.status === 'advanced')" class="cpub-entry-cohort cpub-cohort-in"><i class="fa-solid fa-circle-check"></i> Advanced</span>
         </div>
         <div class="cpub-entry-body">
-          <NuxtLink :to="`/u/${entry.authorUsername}/${entry.contentType}/${entry.contentSlug}`" class="cpub-entry-title">{{ entry.contentTitle || `Entry #${i + 1}` }}</NuxtLink>
+          <NuxtLink :to="entryLink(entry)" class="cpub-entry-title">{{ entry.contentTitle || `Entry #${i + 1}` }}</NuxtLink>
           <div class="cpub-entry-author">
             <div class="cpub-entry-av">
               <img v-if="entry.authorAvatarUrl" :src="entry.authorAvatarUrl" :alt="entry.authorName || entry.authorUsername" class="cpub-entry-av-img" />

package/components/contest/ContestStageSubmission.vue

@@ -0,0 +1,173 @@
+<script setup lang="ts">
+import type { ContestStage, ContestStageSubmission } from '@commonpub/schema';
+
+// Per-stage artifact form: an entrant with an entry fills the CURRENT
+// submission stage's template fields (a proposal, a prototype's links, ...).
+// Driven entirely by `stage.submissionTemplate`; saving PUTs the artifact and
+// the server re-validates ownership, stage state, the cohort gate, and fields.
+
+interface EntryLite {
+  id: string;
+  contentTitle: string;
+  eliminated: boolean;
+  stageSubmissions?: ContestStageSubmission[];
+}
+
+const props = defineProps<{
+  contestSlug: string;
+  /** The contest's current `submission` stage (must carry a template). */
+  stage: ContestStage;
+  /** The viewer's OWN entries (parent filters by userId). */
+  entries: EntryLite[];
+}>();
+
+const emit = defineEmits<{ (e: 'saved'): void }>();
+
+const toast = useToast();
+const { extract: extractError } = useApiError();
+
+const template = computed(() => props.stage.submissionTemplate ?? []);
+// Eliminated entries are out of later rounds; don't offer the form for them.
+const eligibleEntries = computed(() => props.entries.filter((e) => !e.eliminated));
+const selectedEntryId = ref<string>('');
+watch(eligibleEntries, (list) => {
+  if (!list.some((e) => e.id === selectedEntryId.value)) selectedEntryId.value = list[0]?.id ?? '';
+}, { immediate: true });
+const selectedEntry = computed(() => eligibleEntries.value.find((e) => e.id === selectedEntryId.value) ?? null);
+
+const existing = computed<ContestStageSubmission | null>(
+  () => selectedEntry.value?.stageSubmissions?.find((s) => s.stageId === props.stage.id) ?? null,
+);
+
+// Field values, seeded from the already-submitted artifact (if any) so the
+// entrant edits in place rather than retyping.
+const values = ref<Record<string, string>>({});
+watch([existing, template], () => {
+  const next: Record<string, string> = {};
+  for (const f of template.value) next[f.key] = existing.value?.fields[f.key] ?? '';
+  values.value = next;
+}, { immediate: true });
+
+const dirty = computed(() =>
+  template.value.some((f) => (values.value[f.key] ?? '') !== (existing.value?.fields[f.key] ?? '')),
+);
+const missingRequired = computed(() =>
+  template.value.filter((f) => f.required && !(values.value[f.key] ?? '').trim()).map((f) => f.label),
+);
+
+const saving = ref(false);
+async function save(): Promise<void> {
+  if (!selectedEntryId.value || saving.value) return;
+  if (missingRequired.value.length) {
+    toast.error(`Please fill: ${missingRequired.value.join(', ')}`);
+    return;
+  }
+  saving.value = true;
+  try {
+    const fields: Record<string, string> = {};
+    for (const f of template.value) {
+      const v = (values.value[f.key] ?? '').trim();
+      if (v) fields[f.key] = v;
+    }
+    await $fetch(`/api/contests/${props.contestSlug}/entries/${selectedEntryId.value}/submission`, {
+      method: 'PUT',
+      body: { stageId: props.stage.id, fields },
+    });
+    toast.success(existing.value ? `${props.stage.name} submission updated` : `${props.stage.name} submission received`);
+    emit('saved');
+  } catch (err: unknown) {
+    toast.error(extractError(err));
+  } finally {
+    saving.value = false;
+  }
+}
+
+function submittedAtLabel(iso: string): string {
+  return new Date(iso).toLocaleString('en-US', { month: 'short', day: 'numeric', hour: 'numeric', minute: '2-digit' });
+}
+</script>
+
+<template>
+  <section v-if="eligibleEntries.length && template.length" class="cpub-stagesub" :aria-label="`${stage.name} submission form`">
+    <div class="cpub-stagesub-head">
+      <h3 class="cpub-stagesub-title"><i class="fa-solid fa-file-pen"></i> {{ stage.name }}: your submission</h3>
+      <span v-if="existing" class="cpub-stagesub-badge cpub-stagesub-done">
+        <i class="fa-solid fa-circle-check"></i> Submitted {{ submittedAtLabel(existing.submittedAt) }}
+      </span>
+      <span v-else class="cpub-stagesub-badge cpub-stagesub-todo">
+        <i class="fa-solid fa-circle-exclamation"></i> Not submitted yet
+      </span>
+    </div>
+    <p v-if="stage.description" class="cpub-stagesub-desc">{{ stage.description }}</p>
+
+    <div v-if="eligibleEntries.length > 1" class="cpub-stagesub-field">
+      <label class="cpub-stagesub-label" for="cpub-stagesub-entry">Entry</label>
+      <select id="cpub-stagesub-entry" v-model="selectedEntryId" class="cpub-stagesub-input">
+        <option v-for="e in eligibleEntries" :key="e.id" :value="e.id">{{ e.contentTitle }}</option>
+      </select>
+    </div>
+
+    <div v-for="f in template" :key="f.key" class="cpub-stagesub-field">
+      <label class="cpub-stagesub-label" :for="`cpub-stagesub-${f.key}`">
+        {{ f.label }} <span v-if="f.required" class="cpub-stagesub-req" aria-hidden="true">*</span>
+        <span v-if="f.required" class="cpub-sr-only">(required)</span>
+      </label>
+      <textarea
+        v-if="f.type === 'textarea'"
+        :id="`cpub-stagesub-${f.key}`"
+        v-model="values[f.key]"
+        class="cpub-stagesub-input cpub-stagesub-textarea"
+        rows="4"
+        maxlength="4000"
+        :required="f.required"
+        :aria-describedby="f.help ? `cpub-stagesub-${f.key}-help` : undefined"
+      ></textarea>
+      <input
+        v-else
+        :id="`cpub-stagesub-${f.key}`"
+        v-model="values[f.key]"
+        :type="f.type === 'url' ? 'url' : 'text'"
+        class="cpub-stagesub-input"
+        maxlength="4000"
+        :placeholder="f.type === 'url' ? 'https://' : undefined"
+        :required="f.required"
+        :aria-describedby="f.help ? `cpub-stagesub-${f.key}-help` : undefined"
+      />
+      <p v-if="f.help" :id="`cpub-stagesub-${f.key}-help`" class="cpub-stagesub-help">{{ f.help }}</p>
+    </div>
+
+    <div class="cpub-stagesub-actions">
+      <button
+        type="button"
+        class="cpub-btn cpub-btn-primary"
+        :disabled="saving || !dirty || !selectedEntryId"
+        @click="save"
+      >
+        <i class="fa-solid fa-paper-plane"></i>
+        {{ saving ? 'Saving...' : existing ? 'Update submission' : 'Submit' }}
+      </button>
+      <span v-if="dirty && existing" class="cpub-stagesub-unsaved">Unsaved changes</span>
+    </div>
+  </section>
+</template>
+
+<style scoped>
+.cpub-stagesub { border: var(--border-width-default) solid var(--accent-border); background: var(--accent-bg); padding: 16px 20px; margin-bottom: 18px; }
+.cpub-stagesub-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin-bottom: 6px; }
+.cpub-stagesub-title { font-size: 14px; font-weight: 700; display: flex; align-items: center; gap: 8px; margin: 0; }
+.cpub-stagesub-title i { color: var(--accent); }
+.cpub-stagesub-badge { margin-left: auto; display: inline-flex; align-items: center; gap: 5px; font-size: 10px; font-family: var(--font-mono); text-transform: uppercase; letter-spacing: .05em; padding: 3px 8px; border: var(--border-width-default) solid; }
+.cpub-stagesub-done { color: var(--green); border-color: var(--green-border); background: var(--green-bg); }
+.cpub-stagesub-todo { color: var(--text-dim); border-color: var(--border2); background: var(--surface2); }
+.cpub-stagesub-desc { font-size: 12px; color: var(--text-dim); margin: 0 0 12px; line-height: 1.6; }
+.cpub-stagesub-field { display: flex; flex-direction: column; gap: 4px; margin-bottom: 12px; }
+.cpub-stagesub-label { font-size: 11px; font-weight: 600; font-family: var(--font-mono); text-transform: uppercase; letter-spacing: .05em; color: var(--text-dim); }
+.cpub-stagesub-req { color: var(--red); }
+.cpub-stagesub-input { width: 100%; padding: var(--space-2) var(--space-3); border: var(--border-width-default) solid var(--border); background: var(--surface); color: var(--text); font-size: var(--text-sm); font-family: var(--font-sans); }
+.cpub-stagesub-input:focus { border-color: var(--accent); outline: none; box-shadow: var(--shadow-accent); }
+.cpub-stagesub-textarea { resize: vertical; }
+.cpub-stagesub-help { font-size: 11px; color: var(--text-faint); margin: 0; }
+.cpub-stagesub-actions { display: flex; align-items: center; gap: 10px; }
+.cpub-stagesub-unsaved { font-size: 11px; color: var(--text-faint); font-family: var(--font-mono); }
+.cpub-sr-only { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; border: 0; }
+</style>

package/components/contest/ContestStagesEditor.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import type { ContestStage } from '@commonpub/schema';
+import type { ContestStage, ContestSubmissionTemplateField } from '@commonpub/schema';
 
 // Phase B1 — define an arbitrary, ordered stage timeline for a contest. Empty ⇒
 // the contest uses the synthesized standard flow (Submissions → Judging → Results),
@@ -68,6 +68,26 @@ function advanceCountInput(i: number, e: Event): void {
   setField(i, { advanceCount: v === '' ? undefined : Math.max(1, Math.round(Number(v))) });
 }
 
+// Per-stage submission template (submission stages): what entrants fill for
+// THIS stage's artifact (proposal vs prototype). Array ops live as pure
+// functions in utils/contestStages.ts (unit-tested). Flag-gated (rule #2).
+const { features } = useFeatures();
+const templatesEnabled = computed(() => features.value.contestStageSubmissions !== false);
+const FIELD_TYPES: ContestSubmissionTemplateField['type'][] = ['text', 'textarea', 'url'];
+
+function addTemplateField(i: number): void {
+  commit(withTemplateFieldAdded(stages.value, i));
+}
+function setTemplateField(i: number, fi: number, patch: Partial<ContestSubmissionTemplateField>): void {
+  commit(withTemplateFieldSet(stages.value, i, fi, patch));
+}
+function templateFieldLabelInput(i: number, fi: number, e: Event): void {
+  commit(withTemplateFieldLabelChanged(stages.value, i, fi, (e.target as HTMLInputElement).value));
+}
+function removeTemplateField(i: number, fi: number): void {
+  commit(withTemplateFieldRemoved(stages.value, i, fi));
+}
+
 // Array operations live as pure functions in utils/contestStages.ts (unit-tested).
 function addStage(): void {
   commit(withStageAdded(stages.value));
@@ -212,6 +232,54 @@ const missingSubmission = computed(() => stages.value.length > 0 && !stages.valu
             </div>
           </div>
 
+          <!-- Per-stage submission template (submission stages): the artifact
+               fields entrants fill for THIS stage (proposal vs prototype). -->
+          <div v-if="stage.kind === 'submission' && templatesEnabled" class="cpub-stage-criteria">
+            <div class="cpub-stage-criteria-head">
+              <span class="cpub-form-label" style="margin: 0;">Submission form, this stage</span>
+              <button type="button" class="cpub-btn cpub-btn-sm" @click="addTemplateField(i)"><i class="fa-solid fa-plus"></i> Add field</button>
+            </div>
+            <p class="cpub-form-hint" style="margin: 4px 0;">Optional. Add fields entrants must fill for this stage (e.g. a proposal summary, or a repository link for a prototype round). Leave empty if entering a project is enough.</p>
+            <div v-for="(tf, fi) in (stage.submissionTemplate ?? [])" :key="fi" class="cpub-stage-tfield">
+              <div class="cpub-stage-tfield-main">
+                <input
+                  :value="tf.label"
+                  type="text"
+                  class="cpub-form-input"
+                  placeholder="Field label (e.g. Repository URL)"
+                  :aria-label="`Field ${fi + 1} label`"
+                  @input="templateFieldLabelInput(i, fi, $event)"
+                />
+                <select
+                  :value="tf.type"
+                  class="cpub-form-input cpub-stage-tfield-type"
+                  :aria-label="`Field ${fi + 1} type`"
+                  @change="setTemplateField(i, fi, { type: ($event.target as HTMLSelectElement).value as ContestSubmissionTemplateField['type'] })"
+                >
+                  <option v-for="t in FIELD_TYPES" :key="t" :value="t">{{ TEMPLATE_FIELD_TYPE_LABEL[t] }}</option>
+                </select>
+                <label class="cpub-stage-tfield-req">
+                  <input
+                    type="checkbox"
+                    :checked="tf.required"
+                    :aria-label="`Field ${fi + 1} required`"
+                    @change="setTemplateField(i, fi, { required: ($event.target as HTMLInputElement).checked })"
+                  />
+                  <span>Required</span>
+                </label>
+                <button type="button" class="cpub-stage-iconbtn cpub-stage-del" aria-label="Remove field" @click="removeTemplateField(i, fi)"><i class="fa-solid fa-xmark"></i></button>
+              </div>
+              <input
+                :value="tf.help ?? ''"
+                type="text"
+                class="cpub-form-input cpub-stage-tfield-help"
+                placeholder="Hint shown under the input (optional)"
+                :aria-label="`Field ${fi + 1} hint`"
+                @input="setTemplateField(i, fi, { help: ($event.target as HTMLInputElement).value || undefined })"
+              />
+            </div>
+          </div>
+
           <div v-if="stage.kind === 'event'" class="cpub-form-row">
             <div class="cpub-form-field">
               <label class="cpub-form-label">Location</label>
@@ -267,4 +335,12 @@ const missingSubmission = computed(() => stages.value.length > 0 && !stages.valu
 .cpub-stage-crit-row .cpub-form-input { margin: 0; }
 .cpub-stage-crit-pts { max-width: 70px; flex-shrink: 0; }
 .cpub-stage-advn { max-width: 320px; }
+.cpub-stage-tfield { margin-top: 8px; padding-top: 8px; border-top: var(--border-width-default) dashed var(--border2); }
+.cpub-stage-tfield:first-of-type { border-top: 0; padding-top: 0; }
+.cpub-stage-tfield-main { display: flex; align-items: center; gap: 6px; flex-wrap: wrap; }
+.cpub-stage-tfield-main .cpub-form-input { flex: 2; min-width: 140px; margin: 0; }
+.cpub-stage-tfield-type { flex: 1 !important; min-width: 110px !important; max-width: 150px; }
+.cpub-stage-tfield-req { display: inline-flex; align-items: center; gap: 5px; font-size: 10px; font-family: var(--font-mono); text-transform: uppercase; letter-spacing: .06em; color: var(--text-faint); cursor: pointer; flex-shrink: 0; }
+.cpub-stage-tfield-req input { width: 13px; height: 13px; }
+.cpub-stage-tfield-help { margin-top: 6px !important; font-size: var(--text-xs) !important; }
 </style>

package/composables/useFeatures.ts

@@ -17,6 +17,9 @@ export interface FeatureFlags {
   docs: boolean;
   video: boolean;
   contests: boolean;
+  /** Per-stage submission artifacts for multi-round contests. Default ON;
+   *  inert until a stage defines a submissionTemplate. */
+  contestStageSubmissions: boolean;
   events: boolean;
   learning: boolean;
   explainers: boolean;
@@ -65,7 +68,7 @@ let hydrated = false;
 // `flags.value.X` access would crash at runtime.
 export const DEFAULT_FLAGS: FeatureFlags = {
   content: true, social: true, hubs: true, docs: true, video: true,
-  contests: false, events: false, learning: true, explainers: true,
+  contests: false, contestStageSubmissions: true, events: false, learning: true, explainers: true,
   editorial: true, federation: false, admin: false, themeStudio: true, emailNotifications: false,
   publicApi: false, contentImport: true,
   layoutEngine: false,
@@ -165,6 +168,7 @@ export function useFeatures() {
     docs: computed(() => flags.value.docs),
     video: computed(() => flags.value.video),
     contests: computed(() => flags.value.contests),
+    contestStageSubmissions: computed(() => flags.value.contestStageSubmissions),
     events: computed(() => flags.value.events),
     learning: computed(() => flags.value.learning),
     explainers: computed(() => flags.value.explainers),

package/nuxt.config.ts

@@ -99,6 +99,7 @@ export default defineNuxtConfig({
         docs: true,
         video: true,
         contests: false,
+        contestStageSubmissions: true,
         events: false,
         learning: true,
         explainers: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commonpub/layer",
-  "version": "0.70.0",
+  "version": "0.71.0",
   "type": "module",
   "main": "./nuxt.config.ts",
   "files": [
@@ -53,17 +53,17 @@
     "vue": "^3.4.0",
     "vue-router": "^4.3.0",
     "zod": "^4.3.6",
-    "@commonpub/config": "0.20.0",
     "@commonpub/auth": "0.8.0",
+    "@commonpub/config": "0.21.0",
     "@commonpub/docs": "0.6.3",
+    "@commonpub/editor": "0.7.11",
     "@commonpub/protocol": "0.13.0",
-    "@commonpub/learning": "0.5.2",
     "@commonpub/explainer": "0.7.15",
-    "@commonpub/schema": "0.38.0",
-    "@commonpub/server": "2.83.0",
-    "@commonpub/theme-studio": "0.5.0",
-    "@commonpub/ui": "0.12.1",
-    "@commonpub/editor": "0.7.11"
+    "@commonpub/server": "2.84.0",
+    "@commonpub/schema": "0.39.0",
+    "@commonpub/theme-studio": "0.5.1",
+    "@commonpub/learning": "0.5.2",
+    "@commonpub/ui": "0.12.2"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",

package/pages/admin/features.vue

@@ -24,6 +24,7 @@ const flagMeta: Record<string, { label: string; description: string; icon: strin
   docs: { label: 'Docs', description: 'Documentation sites with versioning', icon: 'fa-solid fa-book' },
   video: { label: 'Video', description: 'Video content and categories', icon: 'fa-solid fa-video' },
   contests: { label: 'Contests', description: 'Contest system with judging', icon: 'fa-solid fa-trophy' },
+  contestStageSubmissions: { label: 'Contest Stage Submissions', description: 'Per-stage submission forms for multi-round contests', icon: 'fa-solid fa-file-pen' },
   learning: { label: 'Learning', description: 'Learning paths and courses', icon: 'fa-solid fa-graduation-cap' },
   explainers: { label: 'Explainers', description: 'Interactive explainer modules', icon: 'fa-solid fa-lightbulb' },
   editorial: { label: 'Editorial', description: 'Staff picks and content categories', icon: 'fa-solid fa-pen-fancy' },

package/pages/contests/[slug]/entries/[entryId].vue

@@ -0,0 +1,171 @@
+<script setup lang="ts">
+import type { Serialized, ContestDetail, ContestEntryItem } from '@commonpub/server';
+import type { ContestStage } from '@commonpub/schema';
+
+// Entry detail: the content summary plus the entry's per-stage artifacts in a
+// stage timeline (the proposal, then the prototype, ...), with scores when the
+// viewer is privileged. Artifacts are server-gated: judges/owner/admin and the
+// entrant get them; everyone else sees the content card only.
+
+const route = useRoute();
+const slug = route.params.slug as string;
+const entryId = route.params.entryId as string;
+
+const { data: contest } = useLazyFetch<Serialized<ContestDetail>>(`/api/contests/${slug}`);
+const { data: entry, error } = useLazyFetch<Serialized<ContestEntryItem>>(`/api/contests/${slug}/entries/${entryId}`);
+
+useSeoMeta({
+  title: () => `${entry.value?.contentTitle || 'Entry'}, ${contest.value?.title || 'Contest'}, ${useSiteName()}`,
+});
+
+const stages = computed<ContestStage[]>(() => {
+  const c = contest.value;
+  if (!c) return [];
+  return normalizeStages({
+    status: c.status,
+    startDate: c.startDate,
+    endDate: c.endDate,
+    judgingEndDate: c.judgingEndDate ?? null,
+    stages: c.stages,
+    currentStageId: c.currentStageId,
+  });
+});
+
+// One timeline item per stage the entry has an artifact for, in stage order
+// (artifacts for stages no longer in the timeline trail at the end, just in case).
+const artifactTimeline = computed(() => {
+  const subs = entry.value?.stageSubmissions ?? [];
+  if (!subs.length) return [];
+  const order = new Map(stages.value.map((s, i) => [s.id, i]));
+  return [...subs]
+    .sort((a, b) => (order.get(a.stageId) ?? 999) - (order.get(b.stageId) ?? 999))
+    .map((sub) => {
+      const stage = stages.value.find((s) => s.id === sub.stageId);
+      const template = stage?.submissionTemplate ?? [];
+      const known = new Set(template.map((f) => f.key));
+      // Label values via the template; values whose field was later removed
+      // from the template still render (key as the label) — never drop data.
+      const rows = [
+        ...template.filter((f) => sub.fields[f.key]).map((f) => ({ key: f.key, label: f.label, type: f.type, value: sub.fields[f.key]! })),
+        ...Object.entries(sub.fields).filter(([k]) => !known.has(k)).map(([k, v]) => ({ key: k, label: k, type: 'text' as const, value: v })),
+      ];
+      return { stageId: sub.stageId, stageName: stage?.name ?? sub.stageId, submittedAt: sub.submittedAt, rows };
+    });
+});
+
+const contentLink = computed(() =>
+  entry.value ? `/u/${entry.value.authorUsername}/${entry.value.contentType}/${entry.value.contentSlug}` : '#',
+);
+
+function fmtDate(iso: string): string {
+  return new Date(iso).toLocaleString('en-US', { month: 'short', day: 'numeric', year: 'numeric', hour: 'numeric', minute: '2-digit' });
+}
+</script>
+
+<template>
+  <div class="cpub-entry-detail">
+    <NuxtLink :to="`/contests/${slug}`" class="cpub-ed-back">
+      <i class="fa-solid fa-arrow-left"></i> Back to {{ contest?.title || 'contest' }}
+    </NuxtLink>
+
+    <div v-if="error" class="cpub-ed-empty">
+      <i class="fa-solid fa-circle-exclamation"></i>
+      <p>Entry not found.</p>
+    </div>
+    <div v-else-if="!entry" class="cpub-ed-empty"><p>Loading...</p></div>
+
+    <template v-else>
+      <!-- Content summary card -->
+      <header class="cpub-ed-head">
+        <div class="cpub-ed-thumb">
+          <img v-if="entry.contentCoverImageUrl" :src="entry.contentCoverImageUrl" :alt="entry.contentTitle" />
+          <i v-else class="fa-solid fa-microchip"></i>
+        </div>
+        <div class="cpub-ed-headinfo">
+          <h1 class="cpub-ed-title">{{ entry.contentTitle }}</h1>
+          <div class="cpub-ed-meta">
+            <NuxtLink :to="`/u/${entry.authorUsername}`" class="cpub-ed-author">
+              <img v-if="entry.authorAvatarUrl" :src="entry.authorAvatarUrl" :alt="entry.authorName" class="cpub-ed-av" />
+              <span v-else class="cpub-ed-av cpub-ed-av-init">{{ (entry.authorName || '?').charAt(0).toUpperCase() }}</span>
+              {{ entry.authorName }}
+            </NuxtLink>
+            <span class="cpub-ed-date">Entered {{ fmtDate(entry.submittedAt) }}</span>
+            <span v-if="entry.eliminated" class="cpub-ed-badge cpub-ed-out"><i class="fa-solid fa-circle-minus"></i> Not advanced</span>
+            <span v-else-if="entry.stageState?.some((s) => s.status === 'advanced')" class="cpub-ed-badge cpub-ed-in"><i class="fa-solid fa-circle-check"></i> Advanced</span>
+            <span v-if="entry.rank" class="cpub-ed-badge cpub-ed-rank">#{{ entry.rank }}</span>
+            <span v-if="entry.score != null" class="cpub-ed-badge cpub-ed-score">Score {{ entry.score }}</span>
+          </div>
+          <NuxtLink :to="contentLink" class="cpub-btn cpub-btn-sm" style="margin-top: 10px;">
+            <i class="fa-solid fa-arrow-up-right-from-square"></i> View the project
+          </NuxtLink>
+        </div>
+      </header>
+
+      <!-- Per-stage artifact timeline -->
+      <section v-if="artifactTimeline.length" class="cpub-ed-stages" aria-label="Stage submissions">
+        <h2 class="cpub-ed-sechead"><i class="fa-solid fa-file-pen"></i> Stage submissions</h2>
+        <ol class="cpub-ed-timeline">
+          <li v-for="item in artifactTimeline" :key="item.stageId" class="cpub-ed-stage">
+            <div class="cpub-ed-stagehead">
+              <span class="cpub-ed-stagename">{{ item.stageName }}</span>
+              <span class="cpub-ed-stagedate">{{ fmtDate(item.submittedAt) }}</span>
+            </div>
+            <dl class="cpub-ed-fields">
+              <template v-for="row in item.rows" :key="row.key">
+                <dt>{{ row.label }}</dt>
+                <dd>
+                  <a v-if="row.type === 'url'" :href="row.value" target="_blank" rel="noopener noreferrer nofollow">{{ row.value }}</a>
+                  <span v-else>{{ row.value }}</span>
+                </dd>
+              </template>
+            </dl>
+          </li>
+        </ol>
+      </section>
+    </template>
+  </div>
+</template>
+
+<style scoped>
+.cpub-entry-detail { max-width: 800px; margin: 0 auto; padding: 32px 24px; }
+.cpub-ed-back { font-size: 12px; color: var(--text-faint); text-decoration: none; display: inline-flex; align-items: center; gap: 6px; margin-bottom: 16px; }
+.cpub-ed-back:hover { color: var(--accent); }
+.cpub-ed-empty { text-align: center; padding: 48px 0; color: var(--text-faint); font-size: 13px; display: flex; flex-direction: column; align-items: center; gap: 8px; }
+.cpub-ed-empty i { font-size: 24px; }
+
+.cpub-ed-head { display: flex; gap: 18px; align-items: flex-start; padding: 18px; background: var(--surface); border: var(--border-width-default) solid var(--border); box-shadow: var(--shadow-md); margin-bottom: 22px; }
+.cpub-ed-thumb { width: 160px; aspect-ratio: 4 / 3; flex-shrink: 0; background: var(--surface2); border: var(--border-width-default) solid var(--border); display: flex; align-items: center; justify-content: center; color: var(--text-faint); font-size: 22px; overflow: hidden; }
+.cpub-ed-thumb img { width: 100%; height: 100%; object-fit: cover; }
+.cpub-ed-headinfo { min-width: 0; }
+.cpub-ed-title { font-size: 18px; font-weight: 700; margin: 0 0 6px; line-height: 1.3; }
+.cpub-ed-meta { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; font-size: 11px; color: var(--text-dim); font-family: var(--font-mono); }
+.cpub-ed-author { display: inline-flex; align-items: center; gap: 6px; color: var(--text-dim); text-decoration: none; }
+.cpub-ed-author:hover { color: var(--accent); }
+.cpub-ed-av { width: 18px; height: 18px; border-radius: 50%; border: var(--border-width-default) solid var(--border); object-fit: cover; }
+.cpub-ed-av-init { display: inline-flex; align-items: center; justify-content: center; background: var(--surface3); color: var(--text-faint); font-size: 8px; }
+.cpub-ed-date { color: var(--text-faint); }
+.cpub-ed-badge { display: inline-flex; align-items: center; gap: 4px; font-size: 9px; text-transform: uppercase; letter-spacing: .05em; padding: 2px 7px; border: var(--border-width-default) solid var(--border2); background: var(--surface2); color: var(--text-dim); }
+.cpub-ed-in { color: var(--green); border-color: var(--green-border); background: var(--green-bg); }
+.cpub-ed-out { color: var(--text-faint); }
+.cpub-ed-rank { color: var(--yellow); border-color: var(--yellow); background: var(--yellow-bg); }
+.cpub-ed-score { color: var(--accent); border-color: var(--accent-border); background: var(--accent-bg); }
+
+.cpub-ed-sechead { font-size: 15px; font-weight: 700; display: flex; align-items: center; gap: 8px; margin: 0 0 14px; }
+.cpub-ed-sechead i { color: var(--accent); }
+.cpub-ed-timeline { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 14px; }
+.cpub-ed-stage { border: var(--border-width-default) solid var(--border); background: var(--surface); box-shadow: var(--shadow-md); }
+.cpub-ed-stagehead { display: flex; align-items: center; justify-content: space-between; gap: 10px; padding: 10px 16px; border-bottom: var(--border-width-default) solid var(--border); background: var(--surface2); }
+.cpub-ed-stagename { font-size: 12px; font-weight: 700; font-family: var(--font-mono); text-transform: uppercase; letter-spacing: .05em; color: var(--accent); }
+.cpub-ed-stagedate { font-size: 10px; color: var(--text-faint); font-family: var(--font-mono); }
+.cpub-ed-fields { margin: 0; padding: 14px 16px; display: grid; grid-template-columns: minmax(120px, 180px) 1fr; gap: 8px 16px; }
+.cpub-ed-fields dt { font-size: 11px; font-weight: 600; font-family: var(--font-mono); text-transform: uppercase; letter-spacing: .05em; color: var(--text-dim); }
+.cpub-ed-fields dd { margin: 0; font-size: 13px; color: var(--text); line-height: 1.6; white-space: pre-line; overflow-wrap: anywhere; }
+.cpub-ed-fields dd a { color: var(--accent); }
+
+@media (max-width: 600px) {
+  .cpub-ed-head { flex-direction: column; }
+  .cpub-ed-thumb { width: 100%; }
+  .cpub-ed-fields { grid-template-columns: 1fr; gap: 2px 0; }
+  .cpub-ed-fields dd { margin-bottom: 8px; }
+}
+</style>

package/pages/contests/[slug]/entries/__tests__/entryDetail.test.ts

@@ -0,0 +1,150 @@
+/**
+ * Component tests for the contest entry-detail page (artifact timeline).
+ *
+ * Locks: the content summary card, the stage-ordered artifact timeline with
+ * template-labelled fields, url fields rendered as safe links, orphaned values
+ * (template field later removed) still rendering, artifact section hidden when
+ * the server stripped artifacts (unprivileged viewer), and an axe scan.
+ *
+ * Page uses Nuxt auto-imports (useRoute, useLazyFetch, useSeoMeta, useSiteName,
+ * plus the auto-imported contestStages utils) — stub them on globalThis.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { render } from '@testing-library/vue';
+import { defineComponent, h, ref } from 'vue';
+import axe from 'axe-core';
+import EntryDetailPage from '../[entryId].vue';
+import { normalizeStages, currentStageId } from '../../../../../utils/contestStages';
+
+const NuxtLink = defineComponent({
+  name: 'NuxtLink',
+  props: { to: String },
+  setup(props, { slots }) {
+    return () => h('a', { href: props.to }, slots.default?.());
+  },
+});
+const stubs = { NuxtLink };
+
+const STAGES = [
+  { id: 'prop', name: 'Proposals', kind: 'submission', submissionTemplate: [
+    { key: 'summary', label: 'Summary', type: 'textarea', required: true },
+  ] },
+  { id: 'rev1', name: 'Screening', kind: 'review' },
+  { id: 'proto', name: 'Prototype', kind: 'submission', submissionTemplate: [
+    { key: 'repo_url', label: 'Repository URL', type: 'url', required: true },
+  ] },
+];
+
+function makeContest(overrides: Record<string, unknown> = {}) {
+  return {
+    title: 'Resilient America',
+    status: 'active',
+    startDate: '2026-04-01T00:00:00.000Z',
+    endDate: '2026-08-01T00:00:00.000Z',
+    judgingEndDate: null,
+    stages: STAGES,
+    currentStageId: 'proto',
+    ...overrides,
+  };
+}
+
+function makeEntry(overrides: Record<string, unknown> = {}) {
+  return {
+    id: 'e1',
+    contestId: 'c1',
+    contentId: 'ct1',
+    userId: 'u1',
+    score: 88,
+    rank: 2,
+    stageState: [{ stageId: 'rev1', status: 'advanced' }],
+    eliminated: false,
+    stageSubmissions: [
+      // Deliberately out of stage order — the timeline must sort by stage.
+      { stageId: 'proto', fields: { repo_url: 'https://github.com/x/y' }, submittedAt: '2026-07-01T12:00:00.000Z' },
+      { stageId: 'prop', fields: { summary: 'A mesh network.', legacy_field: 'kept' }, submittedAt: '2026-05-01T12:00:00.000Z' },
+    ],
+    submittedAt: '2026-04-20T12:00:00.000Z',
+    contentTitle: 'Solar Mesh Node',
+    contentSlug: 'solar-mesh-node',
+    contentType: 'project',
+    contentCoverImageUrl: null,
+    authorName: 'Ada Maker',
+    authorUsername: 'ada',
+    authorAvatarUrl: null,
+  };
+}
+
+let contestData: Record<string, unknown> | null = makeContest();
+let entryData: Record<string, unknown> | null = makeEntry();
+
+Object.assign(globalThis, {
+  useRoute: () => ({ params: { slug: 'resilient', entryId: 'e1' } }),
+  useLazyFetch: vi.fn((url: string) => ({
+    data: ref(String(url).includes('/entries/') ? entryData : contestData),
+    error: ref(null),
+  })),
+  useSeoMeta: () => {},
+  useSiteName: () => 'Test',
+  normalizeStages,
+  currentStageId,
+});
+
+function mount() {
+  return render(EntryDetailPage, { global: { stubs } });
+}
+
+beforeEach(() => {
+  contestData = makeContest();
+  entryData = makeEntry();
+});
+
+describe('entry detail page', () => {
+  it('shows the content summary with author, status badges, and a project link', () => {
+    const { container } = mount();
+    expect(container.querySelector('.cpub-ed-title')?.textContent).toBe('Solar Mesh Node');
+    expect(container.textContent).toContain('Ada Maker');
+    expect(container.textContent).toContain('Advanced');
+    expect(container.textContent).toContain('#2');
+    expect(container.textContent).toContain('Score 88');
+    const projectLink = Array.from(container.querySelectorAll('a')).find((a) => a.textContent?.includes('View the project'));
+    expect(projectLink?.getAttribute('href')).toBe('/u/ada/project/solar-mesh-node');
+  });
+
+  it('renders the artifact timeline in stage order with template labels', () => {
+    const { container } = mount();
+    const names = Array.from(container.querySelectorAll('.cpub-ed-stagename')).map((n) => n.textContent);
+    expect(names).toEqual(['Proposals', 'Prototype']); // stage order, not submit order
+    expect(container.textContent).toContain('Summary');
+    expect(container.textContent).toContain('A mesh network.');
+  });
+
+  it('renders url fields as hardened external links', () => {
+    const { container } = mount();
+    const link = Array.from(container.querySelectorAll('.cpub-ed-fields a')).find((a) => a.textContent === 'https://github.com/x/y');
+    expect(link).toBeTruthy();
+    expect(link!.getAttribute('rel')).toContain('noopener');
+  });
+
+  it('still renders values whose template field was later removed (never drop data)', () => {
+    const { container } = mount();
+    expect(container.textContent).toContain('legacy_field');
+    expect(container.textContent).toContain('kept');
+  });
+
+  it('hides the artifact section entirely when the server stripped artifacts', () => {
+    // The route handler `delete`s the key for unprivileged viewers — mirror that.
+    const stripped = makeEntry();
+    delete (stripped as Record<string, unknown>).stageSubmissions;
+    entryData = stripped;
+    const { container } = mount();
+    expect(container.querySelector('.cpub-ed-stages')).toBeNull();
+    // The content card still shows — the page is useful to the public.
+    expect(container.querySelector('.cpub-ed-title')?.textContent).toBe('Solar Mesh Node');
+  });
+
+  it('passes an axe scan', async () => {
+    const { container } = mount();
+    const results = await axe.run(container);
+    expect(results.violations).toEqual([]);
+  });
+});

package/pages/contests/[slug]/index.vue

@@ -127,6 +127,27 @@ const { data: userContent } = useFetch('/api/content', {
 });
 const enteredContentIds = computed(() => new Set(entries.value.map((e) => e.contentId)));
 
+// Per-stage submission artifact (proposal/prototype). When the CURRENT stage
+// is a submission stage carrying a template, entrants with a live entry get
+// the fill-in form on the Entries tab. Flag-gated (rule #2).
+const { features } = useFeatures();
+const currentSubmissionStage = computed(() => {
+  if (!c.value || features.value.contestStageSubmissions === false) return null;
+  if (c.value.status !== 'active') return null;
+  const source = {
+    status: c.value.status,
+    startDate: c.value.startDate,
+    endDate: c.value.endDate,
+    judgingEndDate: c.value.judgingEndDate ?? null,
+    stages: c.value.stages,
+    currentStageId: c.value.currentStageId,
+  };
+  const cid = currentStageId(source);
+  const stage = normalizeStages(source).find((s) => s.id === cid);
+  return stage && stage.kind === 'submission' && stage.submissionTemplate?.length ? stage : null;
+});
+const myEntries = computed(() => entries.value.filter((e) => e.userId === user.value?.id));
+
 // Restrict the submit picker to the contest's eligible content types (if set).
 const eligibleTypes = computed<string[]>(() => (c.value?.eligibleContentTypes as string[] | undefined) ?? []);
 const submittableContent = computed(() => {
@@ -308,6 +329,13 @@ async function withdrawEntry(entryId: string): Promise<void> {
 
           <!-- ENTRIES -->
           <div v-show="activeTab === 'entries'" id="cpub-panel-entries" role="tabpanel" aria-labelledby="cpub-tab-entries" tabindex="0">
+            <ContestStageSubmission
+              v-if="currentSubmissionStage && myEntries.length"
+              :contest-slug="slug"
+              :stage="currentSubmissionStage"
+              :entries="myEntries"
+              @saved="refreshEntries"
+            />
             <div v-if="c?.status === 'active'" class="cpub-entries-cta">
               <div class="cpub-entries-cta-text">
                 <p class="cpub-entries-cta-title"><i class="fa-solid fa-trophy"></i> Enter this contest</p>

package/pages/contests/[slug]/judge.vue

@@ -37,6 +37,22 @@ const currentRoundId = computed<string | null>(() => {
   return st && st.kind === 'review' ? st.id : null;
 });
 
+// The artifact judges review THIS round: the nearest `submission` stage (with a
+// template) preceding the current review stage — round 1 reviews the proposal,
+// round 2 the prototype. Null for classic contests (no templates), which keeps
+// the page byte-identical to pre-artifact behaviour.
+const artifactStage = computed(() => {
+  const c = contest.value;
+  if (!c || !currentRoundId.value) return null;
+  const stages = normalizeStages(c);
+  const idx = stages.findIndex((s) => s.id === currentRoundId.value);
+  for (let i = idx - 1; i >= 0; i--) {
+    const s = stages[i]!;
+    if (s.kind === 'submission' && s.submissionTemplate?.length) return s;
+  }
+  return null;
+});
+
 // Judging rubric: per-round criteria if the current review stage defines them,
 // else the contest-level rubric. Judges score each criterion (0..max); the overall
 // is the normalized weighted sum (computed server-side).
@@ -79,6 +95,16 @@ const entryList = computed(() => {
   const items = (entriesData.value?.items ?? []).filter((e) => !e.eliminated);
   return items.map((entry) => {
     const myScore = entry.judgeScores?.find((s) => s.judgeId === user.value?.id && (s.roundId ?? null) === currentRoundId.value);
+    // This round's artifact, labelled via the stage template (missing optional
+    // fields simply don't appear).
+    const sub = artifactStage.value
+      ? entry.stageSubmissions?.find((s) => s.stageId === artifactStage.value!.id) ?? null
+      : null;
+    const artifactRows = sub
+      ? (artifactStage.value!.submissionTemplate ?? [])
+          .filter((f) => sub.fields[f.key])
+          .map((f) => ({ key: f.key, label: f.label, type: f.type, value: sub.fields[f.key]! }))
+      : [];
     return {
       id: entry.id,
       contentId: entry.contentId,
@@ -92,6 +118,8 @@ const entryList = computed(() => {
       myScore: myScore?.score ?? null,
       myFeedback: myScore?.feedback ?? '',
       myCriteriaScores: myScore?.criteriaScores ?? null,
+      artifactRows,
+      hasArtifact: !!sub,
     };
   });
 });
@@ -263,6 +291,24 @@ async function submitScore(entryId: string): Promise<void> {
             <NuxtLink :to="`/u/${entry.authorUsername}/${entry.contentType}/${entry.contentSlug}`" class="cpub-judge-entry-link" target="_blank">
               <i class="fa-solid fa-arrow-up-right-from-square"></i> View entry
             </NuxtLink>
+            <NuxtLink :to="`/contests/${slug}/entries/${entry.id}`" class="cpub-judge-entry-link" target="_blank" style="margin-left: 10px;">
+              <i class="fa-solid fa-file-lines"></i> All submissions
+            </NuxtLink>
+
+            <!-- This round's artifact (the proposal / prototype fields) -->
+            <div v-if="artifactStage" class="cpub-judge-artifact">
+              <div class="cpub-judge-artifact-head">{{ artifactStage.name }} submission</div>
+              <dl v-if="entry.hasArtifact && entry.artifactRows.length" class="cpub-judge-artifact-fields">
+                <template v-for="row in entry.artifactRows" :key="row.key">
+                  <dt>{{ row.label }}</dt>
+                  <dd>
+                    <a v-if="row.type === 'url'" :href="row.value" target="_blank" rel="noopener noreferrer nofollow">{{ row.value }}</a>
+                    <span v-else>{{ row.value }}</span>
+                  </dd>
+                </template>
+              </dl>
+              <p v-else class="cpub-judge-artifact-none">Nothing submitted for this stage.</p>
+            </div>
           </div>
           <div class="cpub-judge-entry-scoring">
             <div v-if="entry.myScore !== null" class="cpub-judge-current-score">
@@ -364,6 +410,14 @@ async function submitScore(entryId: string): Promise<void> {
 .cpub-judge-entry-link { font-size: 10px; color: var(--accent); text-decoration: none; display: inline-flex; align-items: center; gap: 4px; margin-top: 4px; }
 .cpub-judge-entry-link:hover { text-decoration: underline; }
 
+.cpub-judge-artifact { margin-top: 10px; border: var(--border-width-default) dashed var(--border2); background: var(--surface2); }
+.cpub-judge-artifact-head { font-size: 9px; font-family: var(--font-mono); font-weight: 700; text-transform: uppercase; letter-spacing: .06em; color: var(--accent); padding: 6px 10px; border-bottom: var(--border-width-default) dashed var(--border2); }
+.cpub-judge-artifact-fields { margin: 0; padding: 8px 10px; display: grid; grid-template-columns: minmax(90px, 130px) 1fr; gap: 4px 10px; }
+.cpub-judge-artifact-fields dt { font-size: 10px; font-family: var(--font-mono); text-transform: uppercase; letter-spacing: .05em; color: var(--text-faint); }
+.cpub-judge-artifact-fields dd { margin: 0; font-size: 12px; color: var(--text); line-height: 1.5; white-space: pre-line; overflow-wrap: anywhere; }
+.cpub-judge-artifact-fields dd a { color: var(--accent); }
+.cpub-judge-artifact-none { font-size: 11px; color: var(--text-faint); margin: 0; padding: 8px 10px; }
+
 .cpub-judge-entry-scoring { display: flex; flex-direction: column; gap: 8px; flex-shrink: 0; min-width: 220px; }
 .cpub-judge-current-score { text-align: center; }
 .cpub-judge-score-label { display: block; font-family: var(--font-mono); font-size: 9px; color: var(--text-faint); text-transform: uppercase; }

package/server/api/contests/[slug]/entries/[entryId]/index.get.ts

@@ -0,0 +1,49 @@
+import { getContestBySlug, getContestEntry, canViewContest, isContestJudge, shouldRevealScores } from '@commonpub/server';
+import type { ContestEntryItem } from '@commonpub/server';
+
+/**
+ * GET /api/contests/:slug/entries/:entryId
+ * One enriched entry for the detail / judge views. Per-stage artifacts and
+ * per-judge scores are privilege-gated (owner / admin / panel judge), with the
+ * entrant always able to see their own artifacts. Aggregate score visibility
+ * honours the contest's judgingVisibility, same as the entries listing.
+ */
+export default defineEventHandler(async (event): Promise<ContestEntryItem> => {
+  requireFeature('contests');
+  const db = useDB();
+  const { slug, entryId } = parseParams(event, { slug: 'string', entryId: 'uuid' });
+
+  const contest = await getContestBySlug(db, slug);
+  if (!contest) throw createError({ statusCode: 404, statusMessage: 'Contest not found' });
+  const user = getOptionalUser(event);
+  if (!(await canViewContest(db, contest, user))) {
+    throw createError({ statusCode: 404, statusMessage: 'Contest not found' });
+  }
+
+  const entry = await getContestEntry(db, entryId);
+  if (!entry || entry.contestId !== contest.id) {
+    throw createError({ statusCode: 404, statusMessage: 'Entry not found' });
+  }
+
+  let privileged = false;
+  if (user) {
+    privileged =
+      user.id === contest.createdById ||
+      hasPermission(event, 'contest.manage') ||
+      (await isContestJudge(db, contest.id, user.id));
+  }
+  const isEntrant = !!user && user.id === entry.userId;
+  const config = useConfig();
+  const artifactsOn = (config.features as unknown as Record<string, boolean>).contestStageSubmissions !== false;
+
+  if (!shouldRevealScores(contest.judgingVisibility, contest.status, privileged)) {
+    entry.score = null;
+  }
+  if (!privileged) {
+    delete entry.judgeScores;
+  }
+  if (!artifactsOn || !(privileged || isEntrant)) {
+    delete entry.stageSubmissions;
+  }
+  return entry;
+});

package/server/api/contests/[slug]/entries/[entryId]/submission.put.ts

@@ -0,0 +1,35 @@
+import { submitStageArtifact, getContestBySlug, getContestEntry, canViewContest } from '@commonpub/server';
+import type { ContestStageSubmission } from '@commonpub/schema';
+import { stageSubmissionSchema } from '@commonpub/schema';
+
+/**
+ * PUT /api/contests/:slug/entries/:entryId/submission
+ * Submit (or update) the entrant's per-stage artifact for the contest's
+ * current submission stage. Owner-only; the server re-validates ownership,
+ * stage state, the cohort gate, and the fields against the stage template.
+ */
+export default defineEventHandler(async (event): Promise<{ submitted: boolean; stageSubmissions: ContestStageSubmission[] }> => {
+  requireFeature('contests');
+  requireFeature('contestStageSubmissions');
+  const user = requireAuth(event);
+  const db = useDB();
+  const { slug, entryId } = parseParams(event, { slug: 'string', entryId: 'uuid' });
+
+  const contest = await getContestBySlug(db, slug);
+  if (!contest) throw createError({ statusCode: 404, statusMessage: 'Contest not found' });
+  if (!(await canViewContest(db, contest, user))) {
+    throw createError({ statusCode: 404, statusMessage: 'Contest not found' });
+  }
+  // The entry must belong to THIS contest — gates were checked against this slug.
+  const entry = await getContestEntry(db, entryId);
+  if (!entry || entry.contestId !== contest.id) {
+    throw createError({ statusCode: 404, statusMessage: 'Entry not found' });
+  }
+
+  const input = await parseBody(event, stageSubmissionSchema);
+  const result = await submitStageArtifact(db, entryId, input.stageId, input.fields, user.id);
+  if (!result.submitted) {
+    throw createError({ statusCode: 400, statusMessage: result.error ?? 'Could not submit' });
+  }
+  return { submitted: true, stageSubmissions: result.stageSubmissions ?? [] };
+});

package/server/api/contests/[slug]/entries.get.ts

@@ -34,11 +34,19 @@ export default defineEventHandler(async (event): Promise<{ items: ContestEntryIt
       (await isContestJudge(db, contest.id, user.id));
   }
 
+  // Per-stage artifacts ride along for privileged viewers (judge/owner views)
+  // and for the entrant's OWN entries (pre-filling their submit form). Gated
+  // by the contestStageSubmissions flag (rule #2).
+  const config = useConfig();
+  const artifactsOn = (config.features as unknown as Record<string, boolean>).contestStageSubmissions !== false;
+
   return listContestEntries(db, contest.id, {
     limit: query.limit,
     offset: query.offset,
     orderBy: query.order,
     includeJudgeScores: privileged && query.includeJudgeScores,
+    includeStageSubmissions: privileged && artifactsOn,
+    stageSubmissionsViewerId: artifactsOn ? user?.id : undefined,
     revealScores: shouldRevealScores(contest.judgingVisibility, contest.status, privileged),
   });
 });

package/theme/base.css

@@ -209,6 +209,12 @@
   --shadow-lg: 6px 6px 0 var(--border);
   --shadow-xl: 8px 8px 0 var(--border);
   --shadow-accent: 4px 4px 0 var(--accent);
+  /* Component surface shadow. Built-in themes deliberately do NOT override these
+   * (only --shadow-* above), so buttons/cards keep the offset-block signature.
+   * Theme Studio emits them per the recipe's shadowStyle so a custom theme's
+   * buttons/cards reflect its archetype (neumorphic relief, soft blur, etc.). */
+  --shadow-block: 4px 4px 0 var(--border);
+  --shadow-block-sm: 2px 2px 0 var(--border);
 
   /* === TRANSITIONS === */
   --transition-fast: 0.1s ease;

package/theme/components.css

@@ -27,11 +27,11 @@
 .cpub-btn-primary {
   background: var(--accent);
   color: var(--color-text-inverse);
-  box-shadow: 4px 4px 0 var(--border);
+  box-shadow: var(--shadow-block);
 }
 
 .cpub-btn-primary:hover {
-  box-shadow: 2px 2px 0 var(--border);
+  box-shadow: var(--shadow-block-sm);
 }
 
 .cpub-btn-primary:disabled { opacity: 0.5; cursor: not-allowed; }
@@ -40,9 +40,9 @@
   background: var(--secondary);
   color: var(--color-on-secondary);
   border-color: var(--secondary);
-  box-shadow: 4px 4px 0 var(--border);
+  box-shadow: var(--shadow-block);
 }
-.cpub-btn-secondary:hover { background: var(--secondary-hover); box-shadow: 2px 2px 0 var(--border); }
+.cpub-btn-secondary:hover { background: var(--secondary-hover); box-shadow: var(--shadow-block-sm); }
 .cpub-btn-secondary:disabled { opacity: 0.5; cursor: not-allowed; }
 
 .cpub-btn-sm { padding: 4px 10px; font-size: 11px; min-height: 44px; }
@@ -89,7 +89,7 @@
   border: var(--border-width-default) solid var(--border);
   padding: 16px;
   margin-bottom: 12px;
-  box-shadow: 4px 4px 0 var(--border);
+  box-shadow: var(--shadow-block);
 }
 
 .cpub-sb-title {
@@ -164,7 +164,7 @@
   border-color: var(--accent);
   background: var(--accent-bg);
   color: var(--accent);
-  box-shadow: 2px 2px 0 var(--border);
+  box-shadow: var(--shadow-block-sm);
 }
 
 .cpub-page-ellipsis {

package/utils/contestStages.ts

@@ -1,4 +1,4 @@
-import type { ContestStage } from '@commonpub/schema';
+import type { ContestStage, ContestSubmissionTemplateField } from '@commonpub/schema';
 
 // Client mirror of the pure stage helpers in @commonpub/server `contest.ts`
 // (synthesizeStages / normalizeStages / currentStage). Deliberately duplicated —
@@ -93,6 +93,74 @@ export function withStageMoved(stages: ContestStage[], i: number, dir: -1 | 1):
   return next;
 }
 
+// ─── Submission-template field operations (per-stage artifacts) ───
+
+/** Derive a stable machine key (`^[a-z0-9_]+$`, max 40) from a human label. */
+export function fieldKeyFromLabel(label: string): string {
+  const key = label
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '_')
+    .replace(/^_+|_+$/g, '')
+    .slice(0, 40);
+  return key || 'field';
+}
+
+export function blankTemplateField(): ContestSubmissionTemplateField {
+  return { key: '', label: '', type: 'text', required: false };
+}
+
+function withTemplate(stages: ContestStage[], i: number, template: ContestSubmissionTemplateField[]): ContestStage[] {
+  return stages.map((s, idx) => (idx === i ? { ...s, submissionTemplate: template.length ? template : undefined } : s));
+}
+
+export function withTemplateFieldAdded(stages: ContestStage[], i: number): ContestStage[] {
+  const cur = stages[i]?.submissionTemplate ?? [];
+  return withTemplate(stages, i, [...cur, blankTemplateField()]);
+}
+
+export function withTemplateFieldSet(
+  stages: ContestStage[],
+  i: number,
+  fi: number,
+  patch: Partial<ContestSubmissionTemplateField>,
+): ContestStage[] {
+  const cur = (stages[i]?.submissionTemplate ?? []).map((f, idx) => (idx === fi ? { ...f, ...patch } : f));
+  return withTemplate(stages, i, cur);
+}
+
+/**
+ * Set a field's label, keeping the machine key in sync while it still "tracks"
+ * the label (empty, or equal to the auto-key of the previous label). A key the
+ * organizer edited by hand is left alone — once entrants have submitted, keys
+ * are what artifact values hang off, so they must stay stable.
+ */
+export function withTemplateFieldLabelChanged(
+  stages: ContestStage[],
+  i: number,
+  fi: number,
+  label: string,
+): ContestStage[] {
+  const field = stages[i]?.submissionTemplate?.[fi];
+  if (!field) return stages;
+  const tracksLabel = !field.key || field.key === fieldKeyFromLabel(field.label);
+  const patch: Partial<ContestSubmissionTemplateField> = tracksLabel
+    ? { label, key: fieldKeyFromLabel(label) }
+    : { label };
+  return withTemplateFieldSet(stages, i, fi, patch);
+}
+
+export function withTemplateFieldRemoved(stages: ContestStage[], i: number, fi: number): ContestStage[] {
+  const cur = (stages[i]?.submissionTemplate ?? []).filter((_, idx) => idx !== fi);
+  return withTemplate(stages, i, cur);
+}
+
+/** Human label for each template field type (for the editor dropdown). */
+export const TEMPLATE_FIELD_TYPE_LABEL: Record<ContestSubmissionTemplateField['type'], string> = {
+  text: 'Short text',
+  textarea: 'Long text',
+  url: 'Link (URL)',
+};
+
 /** FontAwesome icon (no `fa-solid` prefix) for each stage kind. */
 export const STAGE_KIND_ICON: Record<ContestStage['kind'], string> = {
   submission: 'fa-pen-to-square',