@emulsify/core 4.2.1 → 4.3.1

package/src/storybook/twig/setup.js

@@ -3,7 +3,8 @@
  */
 
 import { registerTwigExtensions } from '../../extensions/twig/index.js';
-import twigInclude from './include.js';
+import { createTwigIncludeFunction } from './include-function.js';
+import resolveTemplate from './resolver.js';
 import twigSource from './source.js';
 
 /**
@@ -35,5 +36,14 @@ export function setupTwig(twig, options = {}) {
   return twig;
 }
 
-export { default as twigInclude } from './include.js';
+/**
+ * Twig `include()` runtime helper.
+ *
+ * @param {Object} Twig - Twig.js module.
+ * @returns {undefined}
+ */
+export function twigInclude(Twig) {
+  Twig.extendFunction('include', createTwigIncludeFunction(resolveTemplate));
+}
+
 export { default as twigSource } from './source.js';

package/src/storybook/twig/source-function.js

@@ -8,8 +8,11 @@ import {
   isAssetTextLoading,
   whenAssetTextLoaded,
 } from 'virtual:emulsify-twig-asset-sources';
-import { IMAGE_ASSET_EXTS, INLINE_ASSET_EXTS } from './source-extensions.js';
-import { TWIG_SOURCE_LOADED_EVENT } from './source-events.js';
+import {
+  IMAGE_ASSET_EXTS,
+  INLINE_ASSET_EXTS,
+  TWIG_SOURCE_LOADED_EVENT,
+} from './constants.js';
 
 const DEFAULT_ENV =
   (typeof __EMULSIFY_ENV__ !== 'undefined' && __EMULSIFY_ENV__) || {};

package/config/vite/plugins/copy-src-assets.js

@@ -1,76 +0,0 @@
-/**
- * @file Static source asset copy plugin.
- *
- * Copies non-code source assets beside the JS/CSS/Twig output that references
- * them, preserving component and global routing semantics.
- */
-
-import { copyFileSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
-
-import {
-  copiedComponentOutputPath,
-  copiedGlobalOutputPath,
-  findSourceRoot,
-} from '../project-structure.js';
-import {
-  createSourceFileIndex,
-  isStaticSourceAsset,
-} from './source-file-index.js';
-
-/**
- * Copy non-code assets from source roots to `dist/`.
- *
- * @param {{ structure: object, sourceFileIndex?: object }} opts - Plugin options.
- * @returns {import('vite').PluginOption} Copy plugin.
- */
-export function copyAllSrcAssetsPlugin({
-  structure,
-  sourceFileIndex = createSourceFileIndex(structure),
-}) {
-  let outDir = 'dist';
-
-  const copyToOutDir = (absPath, relDest) => {
-    if (!relDest) return;
-    const destPath = join(outDir, relDest);
-    mkdirSync(dirname(destPath), { recursive: true });
-    try {
-      copyFileSync(absPath, destPath);
-    } catch {
-      /* noop */
-    }
-  };
-
-  return {
-    name: 'emulsify-copy-all-src-assets',
-    apply: 'build',
-    enforce: 'post',
-
-    /** Capture outDir. */
-    configResolved(cfg) {
-      outDir = cfg.build?.outDir || 'dist';
-    },
-
-    /** Copy before the mirror plugin moves dist/components to the project root. */
-    writeBundle() {
-      for (const file of sourceFileIndex.componentFiles()) {
-        if (!isStaticSourceAsset(file.absPath)) continue;
-        copyToOutDir(
-          file.absPath,
-          copiedComponentOutputPath(file.absPath, structure),
-        );
-      }
-
-      for (const file of sourceFileIndex.globalFiles()) {
-        if (!isStaticSourceAsset(file.absPath)) continue;
-        if (findSourceRoot(file.absPath, structure.componentRootRecords)) {
-          continue;
-        }
-        copyToOutDir(
-          file.absPath,
-          copiedGlobalOutputPath(file.absPath, structure),
-        );
-      }
-    },
-  };
-}

package/config/vite/plugins/copy-twig-files.js

@@ -1,84 +0,0 @@
-/**
- * @file Twig template and component metadata copy plugin.
- *
- * Copies canonical source Twig files and component metadata to the emitted dist
- * structure using the same routing rules as compiled JS and CSS entries.
- */
-
-import { copyFileSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
-
-import {
-  copiedComponentOutputPath,
-  copiedGlobalOutputPath,
-} from '../project-structure.js';
-import {
-  createSourceFileIndex,
-  isComponentMetadataFile,
-} from './source-file-index.js';
-
-/** Determine whether a Twig file is a partial (filename starts with `_`). */
-const isPartial = (filePath) =>
-  (filePath.split('/')?.pop() || '').trim().startsWith('_');
-
-/**
- * Copy Twig templates and component metadata to `dist/`.
- *
- * @param {{ structure: object, sourceFileIndex?: object }} opts - Plugin options.
- * @returns {import('vite').PluginOption} Copy plugin.
- */
-export function copyTwigFilesPlugin({
-  structure,
-  sourceFileIndex = createSourceFileIndex(structure),
-}) {
-  let outDir = 'dist';
-
-  const copyToOutDir = (absPath, relDest) => {
-    if (!relDest) return;
-    const destPath = join(outDir, relDest);
-    mkdirSync(dirname(destPath), { recursive: true });
-    try {
-      copyFileSync(absPath, destPath);
-    } catch {
-      /* noop */
-    }
-  };
-
-  return {
-    name: 'emulsify-copy-twig-files',
-    apply: 'build',
-    enforce: 'post',
-
-    /** Capture the final outDir. */
-    configResolved(cfg) {
-      outDir = cfg.build?.outDir || 'dist';
-    },
-
-    /** Copy before the mirror plugin moves dist/components to the project root. */
-    writeBundle() {
-      for (const file of sourceFileIndex.componentFiles()) {
-        if (file.absPath.endsWith('.twig')) {
-          if (isPartial(file.relPath)) continue;
-          copyToOutDir(
-            file.absPath,
-            copiedComponentOutputPath(file.absPath, structure),
-          );
-        } else if (isComponentMetadataFile(file.absPath)) {
-          copyToOutDir(
-            file.absPath,
-            copiedComponentOutputPath(file.absPath, structure),
-          );
-        }
-      }
-
-      for (const file of sourceFileIndex.globalFiles()) {
-        if (!file.absPath.endsWith('.twig')) continue;
-        if (isPartial(file.relPath)) continue;
-        copyToOutDir(
-          file.absPath,
-          copiedGlobalOutputPath(file.absPath, structure),
-        );
-      }
-    },
-  };
-}

package/config/vite/utils/unique.js

@@ -1,36 +0,0 @@
-/**
- * @file Shared array de-duplication helpers.
- */
-
-/**
- * Return values in first-seen order with duplicates removed.
- *
- * @template T
- * @param {T[]} values - Values to deduplicate.
- * @returns {T[]} Unique values.
- */
-export function unique(values = []) {
-  return Array.from(new Set(values));
-}
-
-/**
- * Return values in first-seen order with duplicates removed by key.
- *
- * @template T
- * @param {T[]} values - Values to deduplicate.
- * @param {(value: T) => *} keyFn - Function that returns a comparable key.
- * @returns {T[]} Unique values.
- */
-export function uniqueBy(values = [], keyFn) {
-  const seen = new Set();
-  const result = [];
-
-  for (const value of values) {
-    const key = keyFn(value);
-    if (seen.has(key)) continue;
-    seen.add(key);
-    result.push(value);
-  }
-
-  return result;
-}

package/src/storybook/twig/include.js

@@ -1,28 +0,0 @@
-/**
- * @file Twig include() runtime helper for Storybook-rendered templates.
- */
-
-import { createTwigIncludeFunction as createIncludeFunction } from './include-function.js';
-import resolveTemplate from './resolver.js';
-
-/**
- * Create a Twig.js `include()` function with the Storybook template resolver.
- *
- * @param {Function} resolver - Template resolver.
- * @returns {Function} Twig.js function implementation.
- */
-export function createTwigIncludeFunction(resolver = resolveTemplate) {
-  return createIncludeFunction(resolver);
-}
-
-/**
- * Twig `include()` runtime helper.
- *
- * @param {Object} Twig - Twig.js module.
- * @returns {undefined}
- */
-function twigInclude(Twig) {
-  Twig.extendFunction('include', createIncludeFunction(resolveTemplate));
-}
-
-export default twigInclude;

package/src/storybook/twig/source-events.js

@@ -1,5 +0,0 @@
-/**
- * @file Shared events for lazy Twig source loading.
- */
-
-export const TWIG_SOURCE_LOADED_EVENT = 'emulsify:twig-source-loaded';