create-portfoliable 1.2.12 → 1.2.14

package/cli/portfoliable.mjs

@@ -26,6 +26,7 @@ import {
   isInteractiveTerminal,
   readProjectUiPreferences
 } from '../scripts/terminal-ui.mjs';
+import { resolveConsumerRuntimeAliases } from '../scripts/consumer-runtime-aliases.mjs';
 
 // MARK: TERMINAL STYLES
 // ANSI color code used for success-status text.
@@ -562,8 +563,13 @@ async function runDevServer(flags, options = {}) {
     process.env.PORTFOLIABLE_PHP_API_PROXY = phpRuntime.proxyTarget;
   }
 
+  const runtimeAliases = resolveConsumerRuntimeAliases(process.cwd());
+
   // Creates Vite development server instance.
   const server = await createServer({
+    resolve: runtimeAliases.length > 0
+      ? { alias: runtimeAliases }
+      : undefined,
     optimizeDeps: {
       exclude: ['create-portfoliable']
     },
@@ -642,7 +648,10 @@ async function runBuild() {
   printRailSegment();
   printRailSegment({ dot: true, label: `${cyan}${bold}Starting build...${reset}` });
   console.log(`${cyan}${bold}Building Portfoliable...${reset}`);
-  await viteBuild();
+  const runtimeAliases = resolveConsumerRuntimeAliases(process.cwd());
+  await viteBuild(runtimeAliases.length > 0
+    ? { resolve: { alias: runtimeAliases } }
+    : undefined);
   console.log(`${green}Build complete.${reset}`);
   printRailSegment({ dot: true, label: `${green}${bold}Build complete.${reset}` });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-portfoliable",
-  "version": "1.2.12",
+  "version": "1.2.14",
   "description": "Unified Portfoliable package with initializer and runtime CLI",
   "private": false,
   "type": "module",

package/scripts/consumer-runtime-aliases.mjs

@@ -0,0 +1,41 @@
+// File: scripts/consumer-runtime-aliases.mjs
+// Purpose: Resolve consumer-local runtime aliases that override template defaults when files exist.
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+const TEMPLATE_TO_CONSUMER_TARGETS = [
+  ['../templates/src/cases/index.js', 'src/cases/index.js'],
+  ['../templates/src/content/about/ABOUTME.md', 'src/content/about/ABOUTME.md'],
+  ['../templates/configs/portfoliable.design.config.js', 'configs/portfoliable.design.config.js'],
+  ['../templates/configs/portfoliable.a11y.config.js', 'configs/portfoliable.a11y.config.js'],
+  ['../templates/configs/i18n/i18n.config.js', 'configs/i18n/i18n.config.js'],
+  ['../templates/configs/i18n/i18n.labels.js', 'configs/i18n/i18n.labels.js']
+];
+
+// Builds Vite resolve.alias entries for consumer files that are present in the current project.
+export function resolveConsumerRuntimeAliases(projectRoot = process.cwd()) {
+  const aliases = [];
+
+  for (const [templateSpecifier, consumerRelativePath] of TEMPLATE_TO_CONSUMER_TARGETS) {
+    const consumerAbsolutePath = path.resolve(projectRoot, consumerRelativePath);
+    if (!fs.existsSync(consumerAbsolutePath)) {
+      continue;
+    }
+
+    aliases.push({
+      find: templateSpecifier,
+      replacement: consumerAbsolutePath
+    });
+
+    // Keep raw markdown imports in sync with consumer content overrides.
+    if (templateSpecifier.endsWith('.md')) {
+      aliases.push({
+        find: `${templateSpecifier}?raw`,
+        replacement: `${consumerAbsolutePath}?raw`
+      });
+    }
+  }
+
+  return aliases;
+}

package/vite.config.js

@@ -6,6 +6,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { defineConfig } from 'vite';
+import { resolveConsumerRuntimeAliases } from './scripts/consumer-runtime-aliases.mjs';
 
 // Detects when @portfoliablejs/valence is installed as a local symlink.
 function isLocalLinkedValence() {
@@ -63,6 +64,7 @@ function getManualChunk(id) {
 export default defineConfig(({ command }) => {
   const usingLocalValence = isLocalLinkedValence();
   const phpApiProxy = String(process.env.PORTFOLIABLE_PHP_API_PROXY || '').trim();
+  const runtimeAliases = resolveConsumerRuntimeAliases(process.cwd());
 
   const serverConfig = (command === 'serve' && usingLocalValence)
     ? {
@@ -88,6 +90,10 @@ export default defineConfig(({ command }) => {
   }
 
   return {
+    resolve: runtimeAliases.length > 0
+      ? { alias: runtimeAliases }
+      : undefined,
+
     // In local-link mode, avoid prebundling Valence so edits in the linked package
     // are reflected immediately during development.
     optimizeDeps: (command === 'serve' && usingLocalValence)