promptslide 0.3.4 → 0.3.5

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.3.5](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.4...promptslide-v0.3.5) (2026-03-08)
+
+
+### Features
+
+* bundle shared sources with deck publish and fix deck-config parsing ([5f7fd1d](https://github.com/prompticeu/promptslide/commit/5f7fd1de6e5fc58a0568bd87830094dd40c9eca7))
+* persist deck and item metadata to lockfile for publish defaults ([#68](https://github.com/prompticeu/promptslide/issues/68)) ([0dc8ca3](https://github.com/prompticeu/promptslide/commit/0dc8ca3f52b86214eb42dacd9e1ead4d05928242))
+
 ## [0.3.4](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.3...promptslide-v0.3.4) (2026-03-07)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptslide",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "CLI and slide engine for PromptSlide presentations",
   "type": "module",
   "main": "./dist/index.js",

package/src/commands/publish.mjs

@@ -5,7 +5,7 @@ import { fileURLToPath } from "node:url"
 import { bold, green, cyan, red, dim } from "../utils/ansi.mjs"
 import { requireAuth } from "../utils/auth.mjs"
 import { captureSlideAsDataUri, isPlaywrightAvailable, createCaptureSession } from "../utils/export.mjs"
-import { publishToRegistry, registryItemExists, searchRegistry, updateLockfileItem, updateLockfilePublishConfig, readLockfile, writeLockfile, hashContent, detectPackageManager, requestUploadTokens, uploadBinaryToBlob, assetFileToSlug, detectAssetDepsInContent } from "../utils/registry.mjs"
+import { publishToRegistry, registryItemExists, searchRegistry, updateLockfileItem, updateLockfilePublishConfig, readLockfile, writeLockfile, hashContent, detectPackageManager, requestUploadTokens, uploadBinaryToBlob, assetFileToSlug, detectAssetDepsInContent, readDeckMeta, updateDeckMeta, readItemMeta, updateItemMeta } from "../utils/registry.mjs"
 import { prompt, confirm, select, closePrompts } from "../utils/prompts.mjs"
 import { parseDeckConfig } from "../utils/deck-config.mjs"
 
@@ -91,6 +91,57 @@ function detectRegistryDeps(content) {
   return deps
 }
 
+/**
+ * Discover shared source files under src/ that aren't slides, layouts, or theme.
+ * These are files in directories like src/components/, src/lib/, src/hooks/, etc.
+ * Returns an array of { relativePath, fullPath, target } objects.
+ */
+function discoverSharedSources(cwd) {
+  const srcDir = join(cwd, "src")
+  if (!existsSync(srcDir)) return []
+
+  // Top-level dirs whose top-level files are published as individual items
+  // (slides/*.tsx → slide items, layouts/*.tsx → layout items).
+  // Subdirectories within these ARE included as shared sources (e.g. slides/commercial/slide1.tsx).
+  const ITEM_DIRS = new Set(["slides", "layouts"])
+  // Top-level files already handled (theme.ts, globals.css, deck-config.ts, App.tsx)
+  const SKIP_FILES = new Set(["theme.ts", "globals.css", "deck-config.ts", "App.tsx", "vite-env.d.ts"])
+  const SOURCE_EXTS = new Set([".tsx", ".ts", ".jsx", ".js"])
+
+  const results = []
+
+  function walk(dir, relativeDir, skipTopLevelFiles) {
+    if (!existsSync(dir)) return
+    for (const entry of readdirSync(dir)) {
+      if (entry.startsWith(".")) continue
+      const full = join(dir, entry)
+      const s = statSync(full)
+      if (s.isDirectory()) {
+        // Enter slides/ and layouts/ but mark that top-level files are handled elsewhere
+        if (!relativeDir && ITEM_DIRS.has(entry)) {
+          walk(full, entry, true)
+        } else {
+          walk(full, relativeDir ? `${relativeDir}/${entry}` : entry, false)
+        }
+      } else if (s.isFile()) {
+        // Skip known top-level files in src/
+        if (!relativeDir && SKIP_FILES.has(entry)) continue
+        // Skip top-level files in slides/ and layouts/ (published as individual items)
+        if (skipTopLevelFiles) continue
+        const ext = extname(entry).toLowerCase()
+        if (!SOURCE_EXTS.has(ext)) continue
+        const relativePath = relativeDir ? `${relativeDir}/${entry}` : entry
+        // target mirrors the src/ directory structure for @/ import resolution
+        const target = relativeDir ? `src/${relativeDir}/` : "src/"
+        results.push({ relativePath, fullPath: full, fileName: entry, target })
+      }
+    }
+  }
+
+  walk(srcDir, "", false)
+  return results
+}
+
 const IMAGE_EXTS = new Set([".png", ".jpg", ".jpeg", ".webp"])
 const MAX_IMAGE_SIZE = 2 * 1024 * 1024 // 2MB
 
@@ -254,11 +305,13 @@ async function publishItem({ filePath, cwd, auth, typeOverride, interactive = tr
   let title, description, tags, section, releaseNotes, previewImage
 
   if (interactive) {
-    title = await prompt("Title:", titleCase(baseSlug))
-    description = await prompt("Description:", "")
-    const tagsInput = await prompt("Tags (comma-separated):", "")
+    const storedMeta = readItemMeta(cwd, slug)
+    title = await prompt("Title:", storedMeta.title || titleCase(baseSlug))
+    description = await prompt("Description:", storedMeta.description || "")
+    const storedTagsDefault = storedMeta.tags?.length ? storedMeta.tags.join(", ") : ""
+    const tagsInput = await prompt("Tags (comma-separated):", storedTagsDefault)
     tags = tagsInput ? tagsInput.split(",").map(t => t.trim()).filter(Boolean) : []
-    section = await prompt("Section:", "")
+    section = await prompt("Section:", storedMeta.section || "")
     releaseNotes = await prompt("Release notes:", "")
     const imagePath = await prompt("Preview image path (leave empty to auto-generate):", "")
     if (imagePath) {
@@ -307,6 +360,13 @@ async function publishItem({ filePath, cwd, auth, typeOverride, interactive = tr
   // Track in lockfile
   const fileHashes = { [target + fileName]: hashContent(content) }
   updateLockfileItem(cwd, slug, result.version ?? 0, fileHashes)
+  // Persist item metadata for next publish
+  updateItemMeta(cwd, slug, {
+    title,
+    description: description || undefined,
+    tags,
+    section: section || undefined
+  })
 
   return { slug, status: result.status || "published", version: result.version }
 }
@@ -423,6 +483,9 @@ export async function publish(args) {
       ? readdirSync(slidesDir).filter(f => f.endsWith(".tsx") || f.endsWith(".ts"))
       : []
 
+    // Discover shared source files (src/components/, src/lib/, etc.)
+    const sharedSources = discoverSharedSources(cwd)
+
     const totalItems = publicAssets.length + (hasTheme ? 1 : 0) + layoutEntries.length + slideEntries.length + 1
 
     // Display summary
@@ -431,16 +494,26 @@ export async function publish(args) {
     if (hasTheme) console.log(`    Theme:   1`)
     if (layoutEntries.length) console.log(`    Layouts: ${layoutEntries.length}`)
     console.log(`    Slides:  ${slideEntries.length}`)
+    if (sharedSources.length) console.log(`    Shared:  ${sharedSources.length} ${dim("(bundled with deck)")}`)
     console.log(`    Total:   ${totalItems} items`)
+    // Info if there are slide files on disk not referenced in deck-config.ts
+    const deckConfigSlideCount = deckConfig.slides.length
+    if (deckConfigSlideCount !== slideEntries.length) {
+      console.log()
+      console.log(`  ${dim("ℹ")} deck-config.ts has ${deckConfigSlideCount} slides, ${slideEntries.length} slide files on disk`)
+      console.log(`    ${dim("All slides are published. Only deck-config slides appear in the deck preview.")}`)
+    }
     if (deckConfig.transition) {
       console.log(`    Transition: ${deckConfig.transition}${deckConfig.directionalTransition ? " (directional)" : ""}`)
     }
     console.log()
 
-    // Collect deck metadata
-    const title = await prompt("Title:", titleCase(deckSlug))
-    const description = await prompt("Description:", "")
-    const tagsInput = await prompt("Tags (comma-separated):", "")
+    // Collect deck metadata (use stored values as defaults)
+    const storedDeckMeta = readDeckMeta(cwd)
+    const title = await prompt("Title:", storedDeckMeta.title || titleCase(deckSlug))
+    const description = await prompt("Description:", storedDeckMeta.description || "")
+    const storedTagsDefault = storedDeckMeta.tags?.length ? storedDeckMeta.tags.join(", ") : ""
+    const tagsInput = await prompt("Tags (comma-separated):", storedTagsDefault)
     const tags = tagsInput ? tagsInput.split(",").map(t => t.trim()).filter(Boolean) : []
     const releaseNotes = await prompt("Release notes:", "")
 
@@ -692,12 +765,28 @@ export async function publish(args) {
 
     if (captureSession) await captureSession.close()
 
-    // ── Phase 5: Deck manifest ──
+    // ── Phase 5: Deck manifest (includes shared source modules) ──
     itemIndex++
     const slideSlugs = slideEntries.map(f => `${deckSlug}/${f.replace(/\.tsx?$/, "")}`)
     const assetSlugs = publicAssets.map(a => assetFileToSlug(deckSlug, a.relativePath))
     const allDeckDeps = [...slideSlugs, ...assetSlugs]
 
+    // Bundle shared source files with the deck item so preview/install can resolve @/ imports
+    const sharedFiles = sharedSources.map(s => ({
+      path: s.fileName,
+      target: s.target,
+      content: readFileSync(s.fullPath, "utf-8")
+    }))
+    if (sharedFiles.length) {
+      console.log(`  ${dim(`Bundling ${sharedFiles.length} shared source file(s) with deck`)}`)
+    }
+
+    // Collect npm deps from shared source files
+    const sharedNpmDeps = {}
+    for (const f of sharedFiles) {
+      Object.assign(sharedNpmDeps, detectNpmDeps(f.content))
+    }
+
     let deckItemId = null
     try {
       const result = await publishToRegistry({
@@ -707,7 +796,8 @@ export async function publish(args) {
         description: description || undefined,
         tags,
         deckConfig,
-        files: [],
+        files: sharedFiles,
+        npmDependencies: Object.keys(sharedNpmDeps).length ? sharedNpmDeps : undefined,
         registryDependencies: allDeckDeps.length ? allDeckDeps : undefined,
         releaseNotes: releaseNotes || undefined,
         previewImage: previewImage || undefined,
@@ -717,6 +807,8 @@ export async function publish(args) {
       lockfileUpdates.push({ slug: deckSlug, version: result.version ?? 0, fileHashes: {} })
       deckItemId = result.id
       published++
+      // Persist deck metadata for next publish
+      updateDeckMeta(cwd, { title, description: description || undefined, tags })
     } catch (err) {
       console.log(`  [${itemIndex}/${totalItems}] ${red("✗")} deck ${dim(deckSlug)}: ${err.message}`)
       failed++
@@ -725,7 +817,9 @@ export async function publish(args) {
     // Batch-write all lockfile updates at once
     const finalLock = readLockfile(cwd)
     for (const update of lockfileUpdates) {
+      const existing = finalLock.items[update.slug] || {}
       finalLock.items[update.slug] = {
+        ...existing,
         version: update.version,
         installedAt: new Date().toISOString().split("T")[0],
         files: update.fileHashes
@@ -864,12 +958,14 @@ export async function publish(args) {
     }
   }
 
-  // Collect metadata for main item
-  const title = await prompt("Title:", titleCase(baseSlug))
-  const description = await prompt("Description:", "")
-  const tagsInput = await prompt("Tags (comma-separated):", "")
+  // Collect metadata for main item (use stored values as defaults)
+  const storedMeta = readItemMeta(cwd, slug)
+  const title = await prompt("Title:", storedMeta.title || titleCase(baseSlug))
+  const description = await prompt("Description:", storedMeta.description || "")
+  const storedTagsDefault = storedMeta.tags?.length ? storedMeta.tags.join(", ") : ""
+  const tagsInput = await prompt("Tags (comma-separated):", storedTagsDefault)
   const tags = tagsInput ? tagsInput.split(",").map(t => t.trim()).filter(Boolean) : []
-  const section = await prompt("Section:", "")
+  const section = await prompt("Section:", storedMeta.section || "")
   const releaseNotes = await prompt("Release notes:", "")
   const previewImagePath = await prompt("Preview image path (leave empty to auto-generate):", "")
   let previewImage = null
@@ -927,6 +1023,13 @@ export async function publish(args) {
     // Track in lockfile
     const fileHashes = { [target + fileName]: hashContent(content) }
     updateLockfileItem(cwd, slug, result.version ?? 0, fileHashes)
+    // Persist item metadata for next publish
+    updateItemMeta(cwd, slug, {
+      title,
+      description: description || undefined,
+      tags,
+      section: section || undefined
+    })
   } catch (err) {
     console.error(`  ${red("Error:")} ${err.message}`)
     process.exit(1)

package/src/utils/deck-config.mjs

@@ -6,13 +6,16 @@ const DECK_CONFIG_PATH = "src/deck-config.ts"
 /**
  * Convert a kebab-case filename to PascalCase component name.
  * e.g. "slide-hero-gradient" → "SlideHeroGradient"
+ * e.g. "01-title" → "Slide01Title" (prefixed to ensure valid JS identifier)
  */
 export function toPascalCase(kebab) {
-  return kebab
+  const raw = kebab
     .replace(/\.tsx?$/, "")
     .split("-")
     .map(part => part.charAt(0).toUpperCase() + part.slice(1))
     .join("")
+  // JS identifiers cannot start with a digit — prefix with "Slide"
+  return /^\d/.test(raw) ? `Slide${raw}` : raw
 }
 
 /**
@@ -222,11 +225,20 @@ export function parseDeckConfig(cwd) {
   const content = readFileSync(configPath, "utf-8")
 
   // 1. Parse imports to build componentName -> slug map
-  //    Pattern: import { SlideTitle } from "@/slides/slide-title"
+  //    Handles: import { SlideTitle } from "@/slides/slide-title"
+  //    Handles: import { default as SlideTitle } from "@/slides/slide-title"
+  //    Handles: import { SlideTitle as Alias } from "@/slides/slide-title"
   const componentToSlug = {}
-  const importRegex = /import\s*\{\s*(\w+)\s*\}\s*from\s*["']@\/slides\/([^"']+)["']/g
+  const importRegex = /import\s*\{([^}]+)\}\s*from\s*["']@\/slides\/([^"']+)["']/g
   for (const match of content.matchAll(importRegex)) {
-    componentToSlug[match[1]] = match[2].replace(/\.tsx?$/, "")
+    const importClause = match[1].trim()
+    const slug = match[2].replace(/\.tsx?$/, "")
+    // Handle "X", "X as Y" (use Y), "default as Y" (use Y)
+    const asMatch = importClause.match(/(?:\w+\s+)?as\s+(\w+)/)
+    const componentName = asMatch ? asMatch[1] : importClause.match(/(\w+)/)?.[1]
+    if (componentName) {
+      componentToSlug[componentName] = slug
+    }
   }
 
   // 2. Parse transition exports
@@ -238,20 +250,38 @@ export function parseDeckConfig(cwd) {
   const dirMatch = content.match(/export\s+const\s+directionalTransition\s*=\s*(true|false)/)
   if (dirMatch) directionalTransition = dirMatch[1] === "true"
 
-  // 3. Parse slides array entries (order-independent matching)
+  // 3. Extract slides array content, then parse entries within it
   const slides = []
-  const entryRegex = /\{([^}]+)\}/g
-  for (const match of content.matchAll(entryRegex)) {
-    const body = match[1]
-    const componentMatch = body.match(/component:\s*(\w+)/)
-    const stepsMatch = body.match(/steps:\s*(\d+)/)
-    if (!componentMatch || !stepsMatch) continue
-    const slug = componentToSlug[componentMatch[1]]
-    if (!slug) continue // layout or unknown import — skip
-    const entry = { slug, steps: parseInt(stepsMatch[1], 10) }
-    const sectionMatch = body.match(/section:\s*["']([^"']+)["']/)
-    if (sectionMatch) entry.section = sectionMatch[1]
-    slides.push(entry)
+  const slidesArrayMatch = content.match(/export\s+const\s+slides\s*:\s*SlideConfig\[\]\s*=\s*\[/)
+  if (slidesArrayMatch) {
+    const arrayStartIdx = content.indexOf(slidesArrayMatch[0]) + slidesArrayMatch[0].length
+    // Find matching closing bracket
+    let bracketDepth = 1
+    let arrayEndIdx = arrayStartIdx
+    for (let i = arrayStartIdx; i < content.length; i++) {
+      if (content[i] === "[") bracketDepth++
+      if (content[i] === "]") bracketDepth--
+      if (bracketDepth === 0) {
+        arrayEndIdx = i
+        break
+      }
+    }
+    const arrayContent = content.slice(arrayStartIdx, arrayEndIdx)
+
+    // Match entries within the slides array only
+    const entryRegex = /\{([^}]+)\}/g
+    for (const match of arrayContent.matchAll(entryRegex)) {
+      const body = match[1]
+      const componentMatch = body.match(/component:\s*(\w+)/)
+      if (!componentMatch) continue
+      const slug = componentToSlug[componentMatch[1]]
+      if (!slug) continue // layout or unknown import — skip
+      const stepsMatch = body.match(/steps:\s*(\d+)/)
+      const entry = { slug, steps: stepsMatch ? parseInt(stepsMatch[1], 10) : 0 }
+      const sectionMatch = body.match(/section:\s*["']([^"']+)["']/)
+      if (sectionMatch) entry.section = sectionMatch[1]
+      slides.push(entry)
+    }
   }
 
   if (slides.length === 0) return null

package/src/utils/registry.mjs

@@ -71,7 +71,9 @@ export function isFileDirty(cwd, relativePath, storedHash) {
  */
 export function updateLockfileItem(cwd, slug, version, files) {
   const lock = readLockfile(cwd)
+  const existing = lock.items[slug] || {}
   lock.items[slug] = {
+    ...existing,
     version,
     installedAt: new Date().toISOString().split("T")[0],
     files
@@ -92,6 +94,51 @@ export function updateLockfilePublishConfig(cwd, config) {
   writeLockfile(cwd, lock)
 }
 
+/**
+ * Read stored deck-level publish metadata (title, description, tags).
+ * @param {string} cwd
+ * @returns {{ title?: string, description?: string, tags?: string[] }}
+ */
+export function readDeckMeta(cwd) {
+  const lock = readLockfile(cwd)
+  return lock.deckMeta || {}
+}
+
+/**
+ * Persist deck-level publish metadata so it can be reused as defaults.
+ * @param {string} cwd
+ * @param {{ title?: string, description?: string, tags?: string[] }} meta
+ */
+export function updateDeckMeta(cwd, meta) {
+  const lock = readLockfile(cwd)
+  lock.deckMeta = { ...lock.deckMeta, ...meta }
+  writeLockfile(cwd, lock)
+}
+
+/**
+ * Read stored per-item publish metadata (title, description, tags, section).
+ * @param {string} cwd
+ * @param {string} slug
+ * @returns {{ title?: string, description?: string, tags?: string[], section?: string }}
+ */
+export function readItemMeta(cwd, slug) {
+  const lock = readLockfile(cwd)
+  return lock.items[slug]?.meta || {}
+}
+
+/**
+ * Persist per-item publish metadata alongside the version/files entry.
+ * @param {string} cwd
+ * @param {string} slug
+ * @param {{ title?: string, description?: string, tags?: string[], section?: string }} meta
+ */
+export function updateItemMeta(cwd, slug, meta) {
+  const lock = readLockfile(cwd)
+  if (!lock.items[slug]) lock.items[slug] = {}
+  lock.items[slug].meta = meta
+  writeLockfile(cwd, lock)
+}
+
 /**
  * Remove a single item from the lockfile.
  * @param {string} cwd