@pie-element/cli 0.1.1

package/dist/lib/upstream/sync-externals.js

@@ -0,0 +1,164 @@
+/**
+ * Shared external dependency configuration for Vite builds
+ *
+ * These dependencies should NOT be bundled into library outputs.
+ * Instead, they are resolved at runtime from the consuming application.
+ */
+/**
+ * Check if a module ID should be treated as external (not bundled)
+ *
+ * Categories of externals:
+ * 1. Framework peer dependencies (React, MUI, Emotion) - MUST be external to avoid duplicate instances
+ * 2. Internal monorepo packages (@pie-lib, @pie-element, @pie-element) - External for separate resolution
+ * 3. Utility libraries (prop-types, classnames, debug) - External to reduce duplication across packages
+ * 4. Specialized UI libraries (@dnd-kit, react-transition-group, styled-components) - External to avoid version conflicts
+ * 5. Lodash variants (lodash/lodash-es) - External for runtime resolution via import maps
+ * 6. D3 modules - External as they're commonly shared
+ */
+export function isExternal(id, variant) {
+    // React and React DOM - always external (peer dependencies)
+    if (/^react($|\/)/.test(id))
+        return true;
+    if (/^react-dom($|\/)/.test(id))
+        return true;
+    // Internal monorepo packages - always external
+    if (/^@pie-lib\//.test(id))
+        return true;
+    if (/^@pie-element\//.test(id))
+        return true;
+    if (/^@pie-element\//.test(id))
+        return true;
+    if (/^@pie-framework\//.test(id))
+        return true;
+    // UI framework packages - always external (peer dependencies)
+    if (/^@mui\//.test(id))
+        return true;
+    if (/^@emotion\//.test(id))
+        return true;
+    // D3 visualization modules - always external
+    if (/^d3-/.test(id))
+        return true;
+    // Recharts charting library - external for fraction-model
+    if (id === 'recharts' || /^recharts\//.test(id))
+        return true;
+    // Testing libraries - always external
+    if (/^@testing-library\//.test(id))
+        return true;
+    // Lodash - variant-specific (elements use lodash, pie-lib uses lodash-es)
+    if (variant === 'element') {
+        if (id === 'lodash')
+            return true;
+        if (/^lodash\//.test(id))
+            return true;
+    }
+    else {
+        if (id === 'lodash-es')
+            return true;
+        if (/^lodash-es\//.test(id))
+            return true;
+    }
+    // Styled-components - external to avoid multiple instances
+    if (/^styled-components/.test(id))
+        return true;
+    // Konva visualization library - external for hotspot/drawing-response
+    if (id === 'konva' || id.startsWith('konva/'))
+        return true;
+    if (id === 'react-konva' || id.startsWith('react-konva/'))
+        return true;
+    // DnD Kit libraries - external for drag and drop functionality
+    if (/^@dnd-kit\//.test(id))
+        return true;
+    // Common utility and UI libraries - always external
+    const commonExternals = [
+        'prop-types', // React prop validation
+        'classnames', // CSS class utility
+        'debug', // Debug logging
+        'i18next', // Internationalization
+        'humps', // String case conversion
+        'mathjs', // Math expression evaluation
+        'react-jss', // JSS styling for React
+        'js-combinatorics', // Combinatorics library
+        '@mapbox/point-geometry', // Graphing utils dependency
+        '@dnd-kit/core', // Drag and drop
+        'react-transition-group', // Animations
+        'nested-property', // Object property access (placement-ordering)
+        'pluralize', // Word pluralization (placement-ordering)
+        'decimal.js', // Decimal math (placement-ordering)
+    ];
+    return commonExternals.includes(id);
+}
+/**
+ * Generate external function for Vite rollupOptions
+ * Use this in vite.config.ts generation
+ */
+export function createExternalFunction(variant) {
+    const lodashCheck = variant === 'element'
+        ? `id === 'lodash' ||
+          /^lodash\\//.test(id) ||`
+        : `id === 'lodash-es' ||
+          /^lodash-es\\//.test(id) ||`;
+    return `(id) => {
+        return (
+          /^react($|\\/)/.test(id) ||
+          /^react-dom($|\\/)/.test(id) ||
+          /^@pie-lib\\//.test(id) ||
+          /^@pie-element\\//.test(id) ||
+          /^@pie-element\\//.test(id) ||
+          /^@pie-framework\\//.test(id) ||
+          /^@mui\\//.test(id) ||
+          /^@emotion\\//.test(id) ||
+          /^d3-/.test(id) ||
+          /^@testing-library\\//.test(id) ||
+          ${lodashCheck}
+          /^styled-components/.test(id) ||
+          id === 'konva' || /^konva\\//.test(id) ||
+          id === 'react-konva' || /^react-konva\\//.test(id) ||
+          /^@dnd-kit\\//.test(id) ||
+          id === '@mdi/react' || /^@mdi\\/react\\//.test(id) ||
+          id === '@mdi/js' || /^@mdi\\/js\\//.test(id) ||
+          id === 'recharts' || /^recharts\\//.test(id) ||
+          ['prop-types', 'classnames', 'debug', 'i18next', 'humps', 'mathjs', 'react-jss', 'js-combinatorics', '@mapbox/point-geometry', 'react-transition-group', 'nested-property', 'pluralize', 'decimal.js'].includes(id)
+        );
+      }`;
+}
+/**
+ * Generate external function for Konva-based elements (preserveModules: false)
+ * These bundle konva, react-konva, scheduler, and react-reconciler to avoid runtime resolution issues
+ */
+export function createKonvaExternalFunction() {
+    return `(id) => {
+        // Bundle konva, react-konva, scheduler, and react-reconciler
+        // Check these FIRST before other react checks
+        if (id === 'konva' || id.startsWith('konva/')) return false;
+        if (id === 'react-konva' || id.startsWith('react-konva/')) return false;
+        if (id === 'scheduler' || id.startsWith('scheduler/')) return false;
+        if (id === 'react-reconciler' || id.startsWith('react-reconciler/')) return false;
+
+        // Always external: base package names
+        if (id === 'react' || id.startsWith('react/')) return true;
+        if (id === 'react-dom' || id.startsWith('react-dom/')) return true;
+        if (id.startsWith('@pie-lib/')) return true;
+        if (id.startsWith('@pie-element/')) return true;
+        if (id.startsWith('@pie-element/')) return true;
+        if (id.startsWith('@pie-framework/')) return true;
+        if (id.startsWith('@mui/')) return true;
+        if (id.startsWith('@emotion/')) return true;
+        if (id.startsWith('d3-')) return true;
+        // Keep recharts external
+        if (id === 'recharts' || id.startsWith('recharts/')) return true;
+        // Keep lodash external even with preserveModules: false
+        // It will be resolved via import map in demo HTML
+        if (id === 'lodash' || id.startsWith('lodash/')) return true;
+        if (id === 'styled-components' || id.startsWith('styled-components/')) return true;
+        // DnD Kit libraries
+        if (id.startsWith('@dnd-kit/')) return true;
+        // Material Design Icons for drawing-response
+        if (id === '@mdi/react' || id.startsWith('@mdi/react/')) return true;
+        if (id === '@mdi/js' || id.startsWith('@mdi/js/')) return true;
+        if (['prop-types', 'classnames', 'debug', 'i18next', 'humps', 'mathjs', 'react-jss', 'js-combinatorics', '@mapbox/point-geometry', 'react-transition-group', 'nested-property', 'pluralize', 'decimal.js'].includes(id)) return true;
+
+        // Everything else gets bundled (including dependencies of konva/react-konva)
+        return false;
+      }`;
+}
+//# sourceMappingURL=sync-externals.js.map

package/dist/lib/upstream/sync-externals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-externals.js","sourceRoot":"","sources":["../../../src/lib/upstream/sync-externals.ts"],"names":[],"mappings":"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"}

package/dist/lib/upstream/sync-filesystem.d.ts

@@ -0,0 +1,21 @@
+export interface CleanOptions {
+    dryRun?: boolean;
+    verbose?: boolean;
+    preserve?: string[];
+}
+export interface Logger {
+    info(message: string): void;
+}
+/**
+ * Clean a directory, optionally preserving subdirectories
+ */
+export declare function cleanDirectory(targetDir: string, label: string, options?: CleanOptions, logger?: Logger): Promise<void>;
+/**
+ * Check if any of the given paths exist
+ */
+export declare function existsAny(paths: string[]): boolean;
+/**
+ * Safe wrapper around readdir that sorts results
+ */
+export declare function readdir(path: string): Promise<string[]>;
+//# sourceMappingURL=sync-filesystem.d.ts.map

package/dist/lib/upstream/sync-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-filesystem.d.ts","sourceRoot":"","sources":["../../../src/lib/upstream/sync-filesystem.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,EAC1B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU7D"}

package/dist/lib/upstream/sync-filesystem.js

@@ -0,0 +1,64 @@
+/**
+ * File system utilities for sync operations
+ */
+import { existsSync } from 'node:fs';
+import { readdir as fsReaddir, rm as fsRm } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Clean a directory, optionally preserving subdirectories
+ */
+export async function cleanDirectory(targetDir, label, options = {}, logger) {
+    const { dryRun = false, verbose = false, preserve = [] } = options;
+    if (!existsSync(targetDir)) {
+        return;
+    }
+    if (dryRun) {
+        if (verbose && logger) {
+            const preserveMsg = preserve.length > 0 ? ` (preserving: ${preserve.join(', ')})` : '';
+            logger.info(`  🧹 Would clean ${label}${preserveMsg}`);
+        }
+        return;
+    }
+    // If no directories to preserve, delete everything
+    if (preserve.length === 0) {
+        await fsRm(targetDir, { recursive: true, force: true });
+        if (verbose && logger) {
+            logger.info(`  🧹 Cleaned ${label}`);
+        }
+        return;
+    }
+    // Selectively delete entries, preserving specified directories
+    const entries = await fsReaddir(targetDir);
+    for (const entry of entries) {
+        if (preserve.includes(entry)) {
+            continue;
+        }
+        const entryPath = join(targetDir, entry);
+        await fsRm(entryPath, { recursive: true, force: true });
+    }
+    if (verbose && logger) {
+        logger.info(`  🧹 Cleaned ${label} (preserved: ${preserve.join(', ')})`);
+    }
+}
+/**
+ * Check if any of the given paths exist
+ */
+export function existsAny(paths) {
+    return paths.some((p) => existsSync(p));
+}
+/**
+ * Safe wrapper around readdir that sorts results
+ */
+export async function readdir(path) {
+    try {
+        const entries = await fsReaddir(path);
+        return entries.sort();
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=sync-filesystem.js.map

package/dist/lib/upstream/sync-filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-filesystem.js","sourceRoot":"","sources":["../../../src/lib/upstream/sync-filesystem.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYjC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,KAAa,EACb,UAAwB,EAAE,EAC1B,MAAe;IAEf,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEnE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,MAAM,CAAC,IAAI,CAAC,oBAAoB,KAAK,GAAG,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO;IACT,CAAC;IAED,mDAAmD;IACnD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,OAAO;IACT,CAAC;IAED,+DAA+D;IAC/D,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,gBAAgB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAe;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/upstream/sync-imports.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Fix import statements in a file to handle default export conversions
+ *
+ * When converting JS files with default exports to TS, we need to update
+ * imports in consuming files to use named imports instead.
+ */
+export declare function fixImportsInFile(filePath: string, defaultExportFiles: Set<string>): Promise<boolean>;
+/**
+ * Check if code contains JSX syntax
+ */
+export declare function containsJsx(code: string): boolean;
+/**
+ * Replace editable-html imports with inlined constants
+ *
+ * editable-html is not ESM-compatible (depends on Slate v0.x), but some packages
+ * only import constants from it. We inline these constants to avoid the dependency.
+ */
+export declare function inlineEditableHtmlConstants(code: string): string;
+/**
+ * Fix missing re-export of TokenTypes in text-select token-select/index.jsx
+ * The upstream imports TokenTypes from ./token but doesn't re-export it,
+ * causing build failures when parent index.js tries to import it.
+ */
+export declare function reexportTokenTypes(code: string, filePath: string): string;
+/**
+ * Replace configure/lib/defaults import with an empty defaults object
+ * when configure directory is not synced (ESM-incompatible due to Slate v0.x)
+ */
+export declare function inlineConfigureDefaults(code: string): string;
+/**
+ * Determine if a file should have .tsx extension based on content
+ */
+export declare function shouldUseTsxExtension(content: string, originalPath: string): boolean;
+/**
+ * Convert CommonJS module.exports to ES module exports
+ *
+ * Handles patterns like:
+ * module.exports = { foo: ..., bar: ... }
+ *
+ * Converts to:
+ * export const foo = ...;
+ * export const bar = ...;
+ */
+export declare function convertModuleExportsToEsm(content: string): string;
+/**
+ * Transform lodash imports to lodash-es for ESM compatibility
+ *
+ * Handles all lodash import patterns:
+ * - Individual module imports: import isEmpty from 'lodash/isEmpty'
+ * - Named imports: import { isEmpty, isEqual } from 'lodash'
+ * - Default import: import _ from 'lodash'
+ * - Namespace import: import * as _ from 'lodash'
+ *
+ * Converts them to use lodash-es which is a pure ESM package.
+ */
+export declare function transformLodashToLodashEs(content: string): string;
+/**
+ * Transform package.json dependencies from lodash to lodash-es
+ *
+ * Replaces lodash with lodash-es version 4.17.22 (latest ESM version)
+ * Also removes @types/lodash as lodash-es includes built-in TypeScript types
+ */
+export declare function transformPackageJsonLodash<T extends Record<string, any>>(packageJson: T): T;
+/**
+ * Transform recharts version in package.json
+ *
+ * Upgrades recharts from 2.x to 3.x for ESM compatibility.
+ * Recharts 3.x removes the lodash dependency and is fully ESM-compatible.
+ */
+export declare function transformPackageJsonRecharts<T extends Record<string, any>>(packageJson: T): T;
+/**
+ * Transform @pie-framework event package imports to internal packages
+ *
+ * Handles:
+ * - @pie-framework/pie-player-events → @pie-element/shared-player-events
+ * - @pie-framework/pie-configure-events → @pie-element/shared-configure-events
+ */
+export declare function transformPieFrameworkEventImports(content: string): string;
+/**
+ * Transform @pie-lib/controller-utils imports to internal @pie-element/shared-controller-utils
+ *
+ * Handles:
+ * - @pie-lib/controller-utils → @pie-element/shared-controller-utils
+ *
+ * Our internal controller-utils package has the same API but with modernized TypeScript
+ * and no lodash/debug dependencies.
+ */
+export declare function transformControllerUtilsImports(content: string): string;
+/**
+ * Transform @pie-lib shared package imports to internal @pie-element/shared-* packages
+ *
+ * Handles:
+ * - @pie-lib/math-rendering → @pie-element/shared-math-rendering-mathjax
+ *
+ * These packages have been moved to shared/ for better version control and consistency.
+ */
+export declare function transformSharedPackageImports(content: string): string;
+/**
+ * Transform @pie-framework/mathquill imports to internal @pie-element/shared-mathquill
+ *
+ * Handles:
+ * - @pie-framework/mathquill → @pie-element/shared-mathquill
+ *
+ * Our internal mathquill package is a fork from the PIE org with matrix support,
+ * accessibility features, and modernized ESM code.
+ */
+export declare function transformMathquillImports(content: string): string;
+/**
+ * Transform package.json dependencies for PIE Framework event packages
+ *
+ * Replaces external @pie-framework event packages with internal workspace packages
+ */
+export declare function transformPackageJsonPieEvents<T extends Record<string, any>>(packageJson: T): T;
+/**
+ * Transform package.json dependencies for @pie-lib/controller-utils
+ *
+ * Replaces @pie-lib/controller-utils with internal @pie-element/shared-controller-utils
+ */
+export declare function transformPackageJsonControllerUtils<T extends Record<string, any>>(packageJson: T): T;
+/**
+ * Transform package.json dependencies for shared packages
+ *
+ * Replaces @pie-lib shared packages with internal @pie-element/shared-* packages
+ */
+export declare function transformPackageJsonSharedPackages<T extends Record<string, any>>(packageJson: T): T;
+/**
+ * Transform package.json dependencies for @pie-framework/mathquill
+ *
+ * Replaces @pie-framework/mathquill with internal @pie-element/shared-mathquill
+ */
+export declare function transformPackageJsonMathquill<T extends Record<string, any>>(packageJson: T): T;
+/**
+ * Transform direct property assignment patterns to use assignProps utility
+ *
+ * Replaces patterns like:
+ *   Object.entries(props).forEach(([key, value]) => { element[key] = value; });
+ * With:
+ *   assignProps(element, props);
+ *
+ * And adds the import if not present.
+ *
+ * NOTE: This transform is available but NOT enabled in the sync pipeline by default.
+ * Only enable it if this pattern appears frequently in upstream code and needs
+ * to be refactored automatically. For one-off cases, manual refactoring is preferred.
+ *
+ * To enable: Import and call this in sync-pielib-strategy.ts after other transforms.
+ */
+export declare function transformToAssignProps(content: string): string;
+/**
+ * Transform configure utility imports for flattened directory structure
+ *
+ * In upstream pie-elements, configure utility files live at configure/utils.js
+ * and are imported from configure/src/ files using '../utils'.
+ *
+ * In the synced structure, both configure/src/ files and configure/utils.js
+ * are synced to src/configure/, so the import path needs to change from
+ * '../utils' to './utils'.
+ *
+ * This transform handles:
+ * - import { x } from '../utils' → import { x } from './utils'
+ * - Only applies to files directly in configure/src/, not subdirectories
+ * - Only when the import is '../utils' (not '../utils/something')
+ */
+export declare function transformConfigureUtilsImports(content: string, relativePath: string): string;
+/**
+ * Transform SSR-unsafe require() calls to standard ESM imports
+ *
+ * Upstream pie-lib code uses this pattern for SSR compatibility with MathQuill:
+ *
+ * ```js
+ * // - mathquill error window not defined
+ * let EditableHtml;
+ * let StyledEditableHTML;
+ * if (typeof window !== 'undefined') {
+ *   EditableHtml = require('@pie-lib/editable-html-tip-tap')['default'];
+ *   StyledEditableHTML = styled(EditableHtml)(({ theme }) => ({
+ *     fontFamily: theme.typography.fontFamily,
+ *   }));
+ * }
+ * ```
+ *
+ * This doesn't work in browser ESM (require is not defined). Transform to:
+ *
+ * ```tsx
+ * import EditableHtmlImport from '@pie-lib/editable-html-tip-tap';
+ *
+ * const EditableHtml = EditableHtmlImport;
+ * const StyledEditableHTML = styled(EditableHtml)(({ theme }) => ({
+ *   fontFamily: theme.typography.fontFamily,
+ * }));
+ * ```
+ *
+ * We use direct imports instead of React.lazy because:
+ * - Simpler code (no Suspense wrapper needed)
+ * - No loading flicker
+ * - Modern bundlers handle ESM imports correctly for SSR
+ * - The component is always needed (no code-splitting benefit)
+ */
+export declare function transformSsrRequireToReactLazy(content: string): string;
+/**
+ * Fix TypeScript type inference errors for styled components
+ *
+ * TypeScript can't infer types for some MUI styled components, causing errors like:
+ * "The inferred type of 'X' cannot be named without a reference to '@emotion/styled'"
+ *
+ * This transform adds explicit type annotations to fix these errors.
+ */
+export declare function fixStyledComponentTypes(content: string): string;
+/**
+ * Transform self-referential package imports to relative imports
+ *
+ * In upstream pie-elements, configure files sometimes import from their own package
+ * using the package name (e.g., import { X } from '@pie-element/fraction-model').
+ * This creates circular dependency issues in the build.
+ *
+ * This transform converts these self-referential imports to relative paths based on
+ * the package structure:
+ * - @pie-element/{name} → relative path to delivery component
+ *
+ * Example:
+ * In configure/src/main.jsx:
+ *   import { FractionModelChart } from '@pie-element/fraction-model'
+ * Becomes:
+ *   import FractionModelChart from '../delivery/fraction-model-chart'
+ *
+ * @param content - The file content
+ * @param packageName - The current package name (e.g., '@pie-element/fraction-model')
+ * @param sourceFilePath - The source file path relative to package root
+ * @returns Transformed content with relative imports
+ */
+export declare function transformSelfReferentialImports(content: string, packageName: string, sourceFilePath: string): string;
+/**
+ * Fix type inference errors for exported functions with complex return types
+ *
+ * TypeScript can't infer types for some exported functions that have complex dependencies,
+ * causing errors like: "The inferred type of 'X' cannot be named without a reference to 'Y'"
+ *
+ * This transform adds explicit `: any` type annotations to fix these portability errors.
+ */
+export declare function fixExportedFunctionTypes(content: string, sourcePath?: string): string;
+/**
+ * Transform MUI Menu imports to use InlineMenu from @pie-lib/render-ui
+ *
+ * Replaces direct imports of Menu from '@mui/material/Menu' with InlineMenu
+ * from '@pie-lib/render-ui', which includes fixes for the backdrop overlay issue.
+ *
+ * This addresses a common issue where MUI's Menu component covers the entire screen
+ * with a white background when used in inline contexts (dropdowns within text).
+ *
+ * Transformations:
+ * - import Menu from '@mui/material/Menu' → import { InlineMenu as Menu } from '@pie-lib/render-ui'
+ * - import Menu, { MenuProps } from '@mui/material/Menu' → import { InlineMenu as Menu } from '@pie-lib/render-ui'; import type { MenuProps } from '@mui/material/Menu'
+ * - styled(Menu) continues to work as Menu is aliased to InlineMenu
+ *
+ * @param content - Source code content
+ * @returns Transformed content with Menu imports replaced
+ */
+export declare function transformMenuToInlineMenu(content: string): string;
+/**
+ * Add InlineMenu export to render-ui index file
+ *
+ * The InlineMenu component is a pie-elements-ng specific component that wraps
+ * MUI's Menu to fix the backdrop overlay issue. Since it doesn't exist in the
+ * upstream pie-lib, we need to add its export after the sync completes.
+ *
+ * This transform adds the InlineMenu export to the end of the render-ui index
+ * file if it's not already present.
+ *
+ * @param content - Source code content
+ * @param sourcePath - Path to the source file (to identify render-ui index)
+ * @returns Transformed content with InlineMenu export added if needed
+ */
+export declare function addInlineMenuExport(content: string, sourcePath?: string): string;
+/**
+ * Transform MathQuill.getInterface(2) to getInterface(3)
+ *
+ * Interface version 2 requires jQuery, but pie-elements-ng uses interface version 3
+ * which has a jQuery-free API. This transform updates calls to use version 3.
+ *
+ * @param content - Source code content
+ * @returns Transformed content with getInterface(3) instead of getInterface(2)
+ */
+export declare function transformMathQuillInterface(content: string): string;
+//# sourceMappingURL=sync-imports.d.ts.map

package/dist/lib/upstream/sync-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-imports.d.ts","sourceRoot":"","sources":["../../../src/lib/upstream/sync-imports.ts"],"names":[],"mappings":"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"}