@frontfriend/tailwind 3.0.3 → 4.0.0

package/scripts/build.js

@@ -2,6 +2,9 @@ const esbuild = require('esbuild');
 const fs = require('fs');
 const path = require('path');
 const { glob } = require('glob');
+const { writeDefaultConfigData } = require('./update-default-config-data');
+
+writeDefaultConfigData();
 
 // Clean dist directory
 const distDir = path.join(__dirname, '..', 'dist');
@@ -72,7 +75,14 @@ export default function frontfriend(): Plugin;`
  * @param config - Design configuration object
  * @returns Processed configuration
  */
-export function ffdc(config: Record<string, any> | null | undefined): Record<string, any>;`
+export function ffdc(config: Record<string, any> | null | undefined): Record<string, any>;
+export const componentsConfigSchema: Record<string, any>;
+export function isCSSClassString(value: string): boolean;`
+  },
+  {
+    path: 'components-config-schema.d.ts',
+    content: `export const componentsConfigSchema: Record<string, any>;
+export function isCSSClassString(value: string): boolean;`
   },
   {
     path: 'lib/react/utils.d.ts',
@@ -149,11 +159,15 @@ const filesToBundle = [
   { input: 'lib/core/token-processor.js', output: 'lib/core/token-processor.js' },
   { input: 'lib/core/errors.js', output: 'lib/core/errors.js' },
   { input: 'lib/core/constants.js', output: 'lib/core/constants.js' },
+  { input: 'lib/core/credentials.js', output: 'lib/core/credentials.js' },
   { input: 'lib/core/component-downloader.js', output: 'lib/core/component-downloader.js' },
   { input: 'lib/core/local-token-reader.js', output: 'lib/core/local-token-reader.js' },
   { input: 'lib/core/file-utils.js', output: 'lib/core/file-utils.js' },
   { input: 'lib/core/path-utils.js', output: 'lib/core/path-utils.js' },
   { input: 'lib/core/env-utils.js', output: 'lib/core/env-utils.js' },
+  { input: 'lib/core/components-config-schema.js', output: 'lib/core/components-config-schema.js' },
+  { input: 'lib/core/default-config-data.js', output: 'lib/core/default-config-data.js' },
+  { input: 'lib/core/default-config.js', output: 'lib/core/default-config.js' },
   
   // React/Vue utilities
   { input: 'lib/react/utils.mjs', output: 'lib/react/utils.mjs', format: 'esm' },
@@ -161,11 +175,13 @@ const filesToBundle = [
   
   // Main files
   { input: 'ffdc.js', output: 'ffdc.js' },
+  { input: 'lib/core/components-config-schema.js', output: 'components-config-schema.js' },
   { input: 'runtime.js', output: 'runtime.js' },
   // CLI will be handled separately to preserve shebang
   { input: 'next.js', output: 'next.js' },
   { input: 'vite.js', output: 'vite.js' },
   { input: 'vite.mjs', output: 'vite.mjs', format: 'esm' },
+  { input: 'browser.mjs', output: 'browser.mjs', format: 'esm', platform: 'browser' },
 ];
 
 // Files to copy without bundling (dynamic loaders)
@@ -190,7 +206,7 @@ async function build() {
         minify: true,
         sourcemap: true,
         format: file.format || 'cjs',
-        platform: 'node',
+        platform: file.platform || 'node',
         target: 'node14',
         outfile: path.join(distDir, file.output),
         external: [
@@ -268,7 +284,8 @@ async function build() {
       './lib/core/errors',
       './lib/core/env-utils',
       './lib/core/file-utils',
-      './lib/core/path-utils'
+      './lib/core/path-utils',
+      './lib/core/default-config'
     ],
   });
   
@@ -355,4 +372,4 @@ async function build() {
 build().catch(error => {
   console.error('Build failed:', error);
   process.exit(1);
-});
+});

package/scripts/update-default-config-data.js

@@ -0,0 +1,589 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+const packageRoot = path.join(__dirname, '..');
+const repoRoot = path.join(packageRoot, '..', '..');
+const sourcePath = path.join(repoRoot, 'apps', 'saas', 'components', 'code-editor', 'setup', 'components-config.json');
+const outputPath = path.join(packageRoot, 'lib', 'core', 'default-config-data.js');
+const SYSTEM_WORKSPACE_SLUG = 'system-templates';
+const MASTER_DS_NAME = 'Master Design System';
+
+const REGISTRY_ALIASES = {
+  alertDialog: ['alertdialog'],
+  avatarGroup: ['avatargroup'],
+  checkboxField: ['checkboxfield'],
+  datePicker: ['datepicker'],
+  dateInput: ['dateinput'],
+  dropdown: ['dropdownmenu'],
+  fileuploader: ['fileupload'],
+  multiSelect: ['multiselect'],
+  pdfViewer: ['pdfviewer'],
+  radiogroupeField: ['radiogroupfield'],
+  timePicker: ['timepicker'],
+  inputOTP: ['inputotp'],
+};
+
+const DERIVED_FROM_MASTER = {
+  phoneInput: 'input',
+  phoneinput: 'input',
+  inputNumber: 'input',
+  inputnumber: 'input',
+  dateSlider: 'calendar',
+  dateslider: 'calendar',
+  tabBar: 'actionbar',
+  tabbar: 'actionbar',
+};
+
+const SUPPLEMENTAL_CONFIG = {
+  multiSelect: {
+    createNew: 'flex flex-col gap-2 items-center',
+    createNewButton: 'w-fit',
+    error: 'px-3 py-1.5 text-destructive text-xs',
+    empty: 'px-2 py-1.5 text-xs text-muted-foreground',
+  },
+  multiselect: {
+    createNew: 'flex flex-col gap-2 items-center',
+    createNewButton: 'w-fit',
+    error: 'px-3 py-1.5 text-destructive text-xs',
+    empty: 'px-2 py-1.5 text-xs text-muted-foreground',
+  },
+  phoneInput: {
+    wrapper: 'flex gap-4',
+    selectorWrapper: 'flex items-center',
+    nativeSelect: 'base-select',
+    trigger: { layout: 'flex items-center' },
+    dialCode: 'ml-2',
+    triggerIcon: 'ml-2 h-4 w-4',
+    flagIcon: '-mr-2 h-5 w-5',
+    content: 'w-[300px] p-0',
+    item: 'gap-2',
+    itemLabel: 'flex-1 text-sm',
+    input: 'w-full',
+    flag: 'bg-muted flex h-4 w-6 overflow-hidden rounded-sm',
+  },
+  phoneinput: {
+    wrapper: 'flex gap-4',
+    selectorWrapper: 'flex items-center',
+    nativeSelect: 'base-select',
+    trigger: { layout: 'flex items-center' },
+    dialCode: 'ml-2',
+    triggerIcon: 'ml-2 h-4 w-4',
+    flagIcon: '-mr-2 h-5 w-5',
+    content: 'w-[300px] p-0',
+    item: 'gap-2',
+    itemLabel: 'flex-1 text-sm',
+    input: 'w-full',
+    flag: 'bg-muted flex h-4 w-6 overflow-hidden rounded-sm',
+  },
+  spinner: {
+    root: 'animate-spin',
+    track: 'opacity-20',
+  },
+  tabs: {
+    list: { solidRoot: 'relative' },
+  },
+  table: {
+    container: 'w-full',
+  },
+  sheet: {
+    srOnly: 'sr-only',
+  },
+  themepicker: {
+    icon: {
+      light: 'h-[1.2rem] w-[1.2rem] scale-100 rotate-0 transition-all dark:scale-0 dark:-rotate-90',
+      dark: 'absolute h-[1.2rem] w-[1.2rem] scale-0 rotate-90 transition-all dark:scale-100 dark:rotate-0',
+    },
+    srOnly: 'sr-only',
+  },
+  themeprovider: {
+    themePicker: { srOnly: 'sr-only' },
+  },
+  toast: {
+    toaster: 'toaster group',
+  },
+  textarea: {
+    noResize: 'resize-none',
+  },
+  input: {
+    textCenter: 'text-center',
+  },
+  inputNumber: {
+    textCenter: 'text-center',
+  },
+  inputnumber: {
+    textCenter: 'text-center',
+  },
+  datePicker: {
+    selectContent: 'z-50',
+    fullWidth: 'w-full',
+  },
+  datepicker: {
+    selectContent: 'z-50',
+    fullWidth: 'w-full',
+  },
+  fileuploader: {
+    cursor: 'cursor-pointer',
+    borderless: 'border-0',
+  },
+  fileupload: {
+    cursor: 'cursor-pointer',
+    borderless: 'border-0',
+  },
+  sidebar: {
+    srOnly: 'sr-only',
+    root: { foreground: 'text-sidebar-foreground' },
+  },
+  segmented: {
+    trigger: 'tab-trigger',
+    activeTrigger: 'tab-trigger-active',
+    disabled: 'pointer-events-none opacity-50',
+  },
+  calendar: {
+    customRoot: 'p-3 rounded-md font-primary',
+    header: 'flex justify-center pt-1 relative items-center',
+    content: 'grid grid-cols-3 gap-2',
+    options: 'cursor-pointer',
+    selectGroup: 'flex items-center gap-2',
+    nativeSelect: 'h-8 rounded-md border border-input bg-background px-2 text-sm',
+    range: {
+      root: 'p-3 rounded-md font-primary',
+      container: 'flex flex-col gap-4 sm:flex-row',
+      row: 'flex w-full mt-2',
+      navSpacer: 'h-7 w-7',
+    },
+  },
+  dateSlider: {
+    customRootSlider: 'w-full',
+    header: 'flex justify-center pt-1 relative items-center',
+    cell: 'text-center text-sm p-0 relative',
+    selectContent: 'z-50',
+    buttons: { props: { variant: 'ghost' } },
+    dialog: {
+      false: 'hidden',
+      content: 'grid gap-4',
+      body: 'grid gap-4',
+      range: 'grid gap-4',
+    },
+  },
+  dateslider: {
+    customRootSlider: 'w-full',
+    header: 'flex justify-center pt-1 relative items-center',
+    cell: 'text-center text-sm p-0 relative',
+    selectContent: 'z-50',
+    buttons: { props: { variant: 'ghost' } },
+    dialog: {
+      false: 'hidden',
+      content: 'grid gap-4',
+      body: 'grid gap-4',
+      range: 'grid gap-4',
+    },
+  },
+};
+
+const MINIMAL_V4_FALLBACKS = {
+  avatarGroup: {
+    root: 'flex flex-row relative h-10 w-full font-primary',
+    avatar: 'relative -ml-2 first:ml-0',
+  },
+  avatargroup: {
+    root: 'flex flex-row relative h-10 w-full font-primary',
+    avatar: 'relative -ml-2 first:ml-0',
+  },
+  timePicker: {
+    trigger: 'w-full',
+    input: 'w-full',
+    wrapper: 'grid gap-4',
+    popover: {
+      content: 'w-auto p-4',
+    },
+    select: {
+      root: 'grid gap-2',
+      label: 'text-sm font-medium text-foreground',
+      container: 'flex flex-col gap-2',
+      content: 'max-h-48 overflow-y-auto',
+    },
+  },
+  timepicker: {
+    trigger: 'w-full',
+    input: 'w-full',
+    wrapper: 'grid gap-4',
+    popover: {
+      content: 'w-auto p-4',
+    },
+    select: {
+      root: 'grid gap-2',
+      label: 'text-sm font-medium text-foreground',
+      container: 'flex flex-col gap-2',
+      content: 'max-h-48 overflow-y-auto',
+    },
+  },
+  collapsible: {
+    root: 'w-full',
+    trigger: 'inline-flex items-center justify-between gap-2',
+    content: 'overflow-hidden',
+  },
+  icon: { root: 'shrink-0' },
+  resizable: {
+    root: 'flex',
+    panel: 'relative',
+    handle: 'bg-border focus-visible:ring-ring relative flex w-px items-center justify-center',
+  },
+  stepper: {
+    root: 'flex gap-2',
+    item: 'flex items-center gap-2',
+    trigger: 'inline-flex items-center gap-2',
+    indicator: 'flex size-8 items-center justify-center rounded-full border border-border',
+    separator: 'bg-border h-px flex-1',
+    title: 'font-medium text-foreground',
+    description: 'text-muted-foreground text-sm',
+  },
+  themeprovider: { root: 'contents' },
+  themepicker: {
+    root: 'inline-flex items-center gap-2 rounded-md border border-border bg-background p-1',
+  },
+  toggle: {
+    root: 'inline-flex items-center justify-center rounded-md text-sm font-medium hover:bg-accent hover:text-accent-foreground',
+    variant: {
+      default: 'bg-transparent',
+      outline: 'border border-input bg-transparent',
+    },
+    size: {
+      default: 'h-9 px-3',
+      sm: 'h-8 px-2',
+      lg: 'h-10 px-4',
+    },
+  },
+};
+
+const DIRECT_CLASS_MAP = {
+  'border-transperent': 'border-transparent',
+  'hover:interactive-brand-mid-hover': 'hover:text-primary/90',
+
+  'bg-white/10': 'bg-background',
+  'bg-transparent': 'bg-transparent',
+  'border-transparent': 'border-transparent',
+
+  'bg-overlay': 'bg-black/80',
+  'bg-overlay-mid': 'bg-black/80',
+  'bg-overlay-strong': 'bg-black/80',
+
+  'bg-layer-control': 'bg-background',
+  'bg-layer-below': 'bg-background',
+  'bg-layer-raised': 'bg-card',
+  'bg-layer-surface': 'bg-card',
+  'bg-layer-dialog': 'bg-background',
+  'bg-layer-popover': 'bg-popover',
+
+  'bg-disabled': 'opacity-50',
+  'text-disabled': 'opacity-50',
+  'fill-disabled': 'opacity-50',
+  'border-disabled': 'opacity-50',
+};
+
+const COLOR_FAMILIES = new Set([
+  'brand',
+  'interactive',
+  'neutral',
+  'negative',
+  'positive',
+  'warning',
+  'info',
+  'highlight',
+  'inverse',
+]);
+
+const ON_COLOR_FAMILIES = new Set([
+  'onbrand',
+  'oninteractive',
+  'onnegative',
+  'onpositive',
+  'onwarning',
+  'oninfo',
+  'onhighlight',
+]);
+
+const FORBIDDEN_DEFAULT_CLASS_PATTERNS = [
+  /(?:^|:)bg-brand(?:-|$)/,
+  /(?:^|:)text-brand(?:-|$)/,
+  /(?:^|:)text-onbrand(?:-|$)/,
+  /(?:^|:)(?:text|fill)-icon-(?:brand|onbrand)(?:-|$)/,
+  /(?:^|:)border-brand(?:-|$)/,
+  /(?:^|:)bg-layer(?:-|$)/,
+  /(?:^|:)bg-disabled$/,
+  /(?:^|:)text-disabled$/,
+  /(?:^|:)fill-disabled$/,
+  /(?:^|:)border-disabled$/,
+  /transperent/,
+];
+
+function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
+function isPlainObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function deepMerge(base, override) {
+  if (!isPlainObject(base) || !isPlainObject(override)) {
+    return clone(override);
+  }
+
+  const merged = clone(base);
+  for (const [key, value] of Object.entries(override)) {
+    merged[key] = key in merged ? deepMerge(merged[key], value) : clone(value);
+  }
+  return merged;
+}
+
+function splitVariants(token) {
+  let depth = 0;
+  let lastColon = -1;
+  for (let index = 0; index < token.length; index += 1) {
+    const char = token[index];
+    if (char === '[') depth += 1;
+    if (char === ']') depth = Math.max(0, depth - 1);
+    if (char === ':' && depth === 0) lastColon = index;
+  }
+
+  if (lastColon === -1) {
+    return { prefix: '', base: token };
+  }
+  return {
+    prefix: token.slice(0, lastColon + 1),
+    base: token.slice(lastColon + 1),
+  };
+}
+
+function withVariantTone(prefix, baseClass) {
+  const variants = prefix.split(':').filter(Boolean);
+  const isActiveLike = variants.some((variant) =>
+    variant === 'hover' ||
+    variant === 'active' ||
+    variant.includes('hover') ||
+    variant.includes('active') ||
+    variant.includes('selected') ||
+    variant.includes('checked') ||
+    variant.includes('highlighted') ||
+    variant.includes('expanded')
+  );
+  const isDisabled = variants.some((variant) => variant.includes('disabled'));
+
+  if (isDisabled) return baseClass;
+  if (!isActiveLike) return baseClass;
+  if (baseClass === 'bg-primary') return 'bg-primary/90';
+  if (baseClass === 'bg-secondary') return 'bg-secondary/80';
+  if (baseClass === 'bg-muted') return 'bg-muted/80';
+  if (baseClass === 'bg-accent') return 'bg-accent/80';
+  if (baseClass === 'bg-destructive') return 'bg-destructive/90';
+  if (baseClass === 'text-primary') return 'text-primary/90';
+  if (baseClass === 'border-primary') return 'border-primary/80';
+  return baseClass;
+}
+
+function mapBgClass(base, prefix) {
+  const match = base.match(/^!?bg-([a-z]+)(?:-[a-z]+)*(?:-(hover|active|selected|disabled))?$/);
+  if (!match) return null;
+  const important = base.startsWith('!') ? '!' : '';
+  const family = match[1];
+  if (!COLOR_FAMILIES.has(family)) return null;
+
+  let mapped;
+  if (family === 'brand' || family === 'interactive') mapped = 'bg-primary';
+  else if (family === 'neutral') mapped = base.includes('-low') || base.includes('-subtle') ? 'bg-muted' : 'bg-accent';
+  else if (family === 'negative') mapped = 'bg-destructive';
+  else mapped = 'bg-primary';
+
+  return important + withVariantTone(prefix, mapped);
+}
+
+function mapTextClass(base, prefix) {
+  const match = base.match(/^!?(?:text|fill)-(?:(icon)-)?([a-z]+)(?:-[a-z]+)*(?:-(hover|active|selected|disabled))?$/);
+  if (!match) return null;
+  const important = base.startsWith('!') ? '!' : '';
+  const family = match[2];
+  if (!COLOR_FAMILIES.has(family) && !ON_COLOR_FAMILIES.has(family)) return null;
+
+  let mapped;
+  if (family === 'brand' || family === 'interactive') mapped = 'text-primary';
+  else if (family === 'neutral' || family === 'inverse') mapped = base.includes('-mid') || base.includes('-strong') ? 'text-foreground' : 'text-muted-foreground';
+  else if (family === 'negative') mapped = 'text-destructive';
+  else if (ON_COLOR_FAMILIES.has(family)) mapped = family === 'onnegative' ? 'text-destructive-foreground' : 'text-primary-foreground';
+  else mapped = 'text-primary';
+
+  return important + withVariantTone(prefix, mapped);
+}
+
+function mapBorderClass(base, prefix) {
+  const match = base.match(/^!?border-([a-z]+)(?:-[a-z]+)*(?:-(hover|active|selected|disabled))?$/);
+  if (!match) return null;
+  const important = base.startsWith('!') ? '!' : '';
+  const family = match[1];
+  if (!COLOR_FAMILIES.has(family)) return null;
+
+  let mapped;
+  if (family === 'brand' || family === 'interactive') mapped = 'border-primary';
+  else if (family === 'negative') mapped = 'border-destructive';
+  else mapped = 'border-border';
+  return important + withVariantTone(prefix, mapped);
+}
+
+function neutralizeClassToken(token) {
+  if (!token) return token;
+  if (DIRECT_CLASS_MAP[token]) return DIRECT_CLASS_MAP[token];
+
+  const { prefix, base } = splitVariants(token);
+  const mappedBase = DIRECT_CLASS_MAP[base]
+    || mapBgClass(base, prefix)
+    || mapTextClass(base, prefix)
+    || mapBorderClass(base, prefix)
+    || base;
+
+  return `${prefix}${mappedBase}`;
+}
+
+function neutralizeClassString(value) {
+  return value
+    .split(/\s+/)
+    .filter(Boolean)
+    .map(neutralizeClassToken)
+    .join(' ');
+}
+
+function neutralizeComponentsConfig(value) {
+  if (typeof value === 'string') return neutralizeClassString(value);
+  if (Array.isArray(value)) return value.map(neutralizeComponentsConfig);
+  if (isPlainObject(value)) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [key, neutralizeComponentsConfig(nested)])
+    );
+  }
+  return value;
+}
+
+function collectClassTokens(value, tokens = []) {
+  if (typeof value === 'string') {
+    tokens.push(...value.split(/\s+/).filter(Boolean));
+  } else if (Array.isArray(value)) {
+    value.forEach((item) => collectClassTokens(item, tokens));
+  } else if (isPlainObject(value)) {
+    Object.values(value).forEach((item) => collectClassTokens(item, tokens));
+  }
+  return tokens;
+}
+
+function findForbiddenDefaultClasses(config) {
+  return [...new Set(
+    collectClassTokens(config).filter((token) =>
+      FORBIDDEN_DEFAULT_CLASS_PATTERNS.some((pattern) => pattern.test(token))
+    )
+  )].sort();
+}
+
+function buildDefaultConfigData(rawMasterConfig) {
+  const masterConfig = neutralizeComponentsConfig(rawMasterConfig);
+  const generated = clone(masterConfig);
+
+  for (const [sourceKey, aliases] of Object.entries(REGISTRY_ALIASES)) {
+    if (!masterConfig[sourceKey]) continue;
+    for (const alias of aliases) {
+      generated[alias] = clone(masterConfig[sourceKey]);
+    }
+  }
+
+  for (const [targetKey, sourceKey] of Object.entries(DERIVED_FROM_MASTER)) {
+    if (masterConfig[sourceKey]) {
+      generated[targetKey] = clone(masterConfig[sourceKey]);
+    }
+  }
+
+  for (const [key, config] of Object.entries(MINIMAL_V4_FALLBACKS)) {
+    generated[key] = clone(config);
+  }
+
+  for (const [key, config] of Object.entries(SUPPLEMENTAL_CONFIG)) {
+    generated[key] = key in generated ? deepMerge(generated[key], config) : clone(config);
+  }
+
+  const forbidden = findForbiddenDefaultClasses(generated);
+  if (forbidden.length > 0) {
+    throw new Error(`Default config still contains FrontFriend-only classes: ${forbidden.join(', ')}`);
+  }
+
+  return generated;
+}
+
+function generateDefaultConfigData() {
+  const masterConfig = JSON.parse(fs.readFileSync(sourcePath, 'utf8'));
+  return buildDefaultConfigData(masterConfig);
+}
+
+function formatModule(config) {
+  return `// Generated from apps/saas/components/code-editor/setup/components-config.json as the neutral bundled\n` +
+    `// Master Design System fallback for Tailwind v4 registry components.\n` +
+    `// Run \`node packages/frontfriend-tailwind/scripts/update-default-config-data.js\` after Master DS changes.\n` +
+    `// Do not edit this file by hand.\n\n` +
+    `module.exports = ${JSON.stringify(config, null, 2)};\n`;
+}
+
+function writeDefaultConfigData() {
+  const config = generateDefaultConfigData();
+  fs.writeFileSync(outputPath, formatModule(config));
+  return config;
+}
+
+async function readMasterComponentsConfigFromDb() {
+  const { PrismaClient } = require('@prisma/client');
+  const prisma = new PrismaClient();
+  try {
+    const master = await prisma.designSystem.findFirst({
+      where: {
+        name: MASTER_DS_NAME,
+        workspace: { slug: SYSTEM_WORKSPACE_SLUG },
+      },
+      include: { latestVersion: true },
+    });
+
+    const componentsConfig = master?.latestVersion?.componentsConfig || master?.componentsConfig;
+    if (!componentsConfig) {
+      throw new Error('Master Design System componentsConfig not found. Run apps/saas/scripts/init-master-design-system.js first.');
+    }
+    return componentsConfig;
+  } finally {
+    await prisma.$disconnect();
+  }
+}
+
+async function writeDefaultConfigDataFromMasterDb() {
+  const masterConfig = await readMasterComponentsConfigFromDb();
+  const config = buildDefaultConfigData(masterConfig);
+  fs.writeFileSync(outputPath, formatModule(config));
+  return config;
+}
+
+if (require.main === module) {
+  (async () => {
+    const fromMasterDb = process.argv.includes('--from-master-db');
+    const config = fromMasterDb ? await writeDefaultConfigDataFromMasterDb() : writeDefaultConfigData();
+    const source = fromMasterDb ? 'Master Design System DB' : path.relative(repoRoot, sourcePath);
+    console.log(`Wrote ${path.relative(repoRoot, outputPath)} (${Object.keys(config).length} component keys) from ${source}`);
+  })().catch((error) => {
+    console.error(error.message);
+    process.exit(1);
+  });
+}
+
+module.exports = {
+  FORBIDDEN_DEFAULT_CLASS_PATTERNS,
+  buildDefaultConfigData,
+  collectClassTokens,
+  findForbiddenDefaultClasses,
+  generateDefaultConfigData,
+  readMasterComponentsConfigFromDb,
+  neutralizeClassString,
+  neutralizeClassToken,
+  neutralizeComponentsConfig,
+  writeDefaultConfigData,
+  writeDefaultConfigDataFromMasterDb,
+};

package/src/theme.css

@@ -0,0 +1,13 @@
+/*
+ * Frontfriend Tailwind v4 Theme Placeholder
+ *
+ * `frontfriend init` generates the real CSS-first theme at:
+ *   node_modules/.cache/frontfriend/theme.css
+ *
+ * The Frontfriend Next.js and Vite integrations alias this package entrypoint
+ * to the generated cache file so apps can import a stable path:
+ *   @import "@frontfriend/tailwind/theme.css";
+ *
+ * If this placeholder appears in your compiled CSS, run `npx frontfriend init`
+ * and make sure the Frontfriend Next.js/Vite integration is enabled.
+ */