@pie-element/cli 0.1.1

package/.turbo/turbo-build.log

@@ -0,0 +1 @@
+$ tsc

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# @pie-element/cli
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [e131840]
+  - @pie-element/bundler-shared@0.1.1

package/README.md

@@ -0,0 +1,240 @@
+# @pie-element/cli
+
+CLI tools for managing PIE Elements NG - synchronization, package generation, and verification.
+
+## Installation
+
+From the root of the monorepo:
+
+```bash
+bun install
+cd tools/cli
+bun run build
+```
+
+## Usage
+
+From the root of the monorepo:
+
+```bash
+# Show help
+bun run cli --help
+
+# Show command help
+bun run cli upstream:sync --help
+```
+
+## Commands
+
+### Development
+
+#### `dev:demo`
+
+Start a demo server for an element using `apps/element-demo`.
+
+```bash
+# Start demo for an element
+bun run cli dev:demo hotspot
+
+# Custom port, skip builds, and don't auto-open browser
+bun run cli dev:demo multiple-choice --port 5180 --skip-build --no-open
+```
+
+### Upstream Synchronization
+
+#### `upstream:sync`
+
+Synchronize code from upstream pie-elements repository.
+
+```bash
+# Dry run to preview changes
+bun run cli upstream:sync --dry-run
+
+# Sync specific element
+bun run cli upstream:sync --element multiple-choice
+
+# Sync all compatible elements (controllers + React UI + demos)
+bun run cli upstream:sync
+
+# Verbose output
+bun run cli upstream:sync --verbose
+```
+
+#### `upstream:check`
+
+Check for changes in upstream repositories.
+
+```bash
+# Check all elements
+bun run cli upstream:check
+
+# Check specific element
+bun run cli upstream:check --element multiple-choice
+
+# Verbose output
+bun run cli upstream:check --verbose
+```
+
+#### `upstream:track`
+
+Track upstream repository changes.
+
+```bash
+# Show new commits since last check
+bun run cli upstream:track show
+
+# Record current upstream state
+bun run cli upstream:track record
+
+# Compare with specific commit
+bun run cli upstream:track compare <commit-sha>
+```
+
+#### `upstream:deps`
+
+Compare dependencies with upstream repositories.
+
+```bash
+bun run cli upstream:deps
+```
+
+#### `upstream:analyze-esm`
+
+Analyze ESM compatibility of elements and packages.
+
+```bash
+# Analyze and generate report
+bun run cli upstream:analyze-esm
+
+# Verbose output
+bun run cli upstream:analyze-esm --verbose
+
+# Custom output path
+bun run cli upstream:analyze-esm --output ./my-report.json
+```
+
+#### `upstream:update`
+
+Recommended wrapper that runs analyze + sync.
+
+```bash
+bun run cli upstream:update
+```
+
+#### `upstream:sync-mathquill`
+
+Sync the MathQuill fork used by the project.
+
+```bash
+bun run cli upstream:sync-mathquill
+```
+
+### Package Management
+
+#### `packages:enable-publishing`
+
+Enable React package publishing (remove private flags).
+
+```bash
+# Dry run
+bun run cli packages:enable-publishing --dry-run
+
+# Enable publishing
+bun run cli packages:enable-publishing
+```
+
+#### `packages:create-controllers`
+
+Generate package.json files for controller packages.
+
+```bash
+bun run cli packages:create-controllers
+```
+
+#### `packages:create-lib-react`
+
+Generate configuration files for @pie-lib React packages.
+
+```bash
+# Dry run
+bun run cli packages:create-lib-react --dry-run
+
+# Generate files
+bun run cli packages:create-lib-react
+```
+
+#### `packages:create-react-elements`
+
+Generate configuration files for React element packages.
+
+```bash
+bun run cli packages:create-react-elements
+```
+
+#### `packages:init-synced-elements`
+
+Initialize package scaffolding for synced elements.
+
+```bash
+bun run cli packages:init-synced-elements
+```
+
+### Verification
+
+#### `verify:controllers`
+
+Verify controller package exports before publishing.
+
+```bash
+bun run cli verify:controllers
+```
+
+#### `verify:react-build`
+
+Verify that all React elements build successfully.
+
+```bash
+bun run cli verify:react-build
+```
+
+## CLI Development
+
+```bash
+# Build the CLI
+bun run build
+
+# Run in development mode (with source maps)
+bun run dev upstream:sync --help
+
+# Lint
+bun run lint
+```
+
+## Architecture
+
+The CLI is built with [oclif](https://oclif.io/), following the same architecture as the pie-qti CLI.
+
+- **Commands**: Located in `src/commands/` organized by topic
+- **Utilities**: Shared utilities in `src/utils/`
+- **Topics**: Commands are grouped into topics (upstream, packages, verify)
+
+## Migration from Scripts
+
+This CLI replaces the scripts in `./scripts` directory:
+
+| Old Script                                  | New CLI Command                              |
+| ------------------------------------------- | -------------------------------------------- |
+| `bun scripts/sync-upstream.ts`              | `bun run cli upstream:sync`                  |
+| `bun scripts/check-upstream.ts`             | `bun run cli upstream:check`                 |
+| `bun scripts/track-upstream.ts show`        | `bun run cli upstream:track show`            |
+| `bun scripts/check-deps.ts`                 | `bun run cli upstream:deps`                  |
+| `bun scripts/analyze-esm-compatibility.ts`  | `bun run cli upstream:analyze-esm`           |
+| `bun scripts/enable-react-publishing.ts`    | `bun run cli packages:enable-publishing`     |
+| `bun scripts/create-controller-packages.ts` | `bun run cli packages:create-controllers`    |
+| `bun scripts/create-lib-react-packages.ts`  | `bun run cli packages:create-lib-react`      |
+| `bun scripts/create-react-packages.ts`      | `bun run cli packages:create-react-elements` |
+| `bun scripts/verify-react-build.ts`         | `bun run cli verify:react-build`             |
+
+## License
+
+Same as parent project.

package/REFACTORING.md

@@ -0,0 +1,131 @@
+# Sync Command Refactoring
+
+## Summary
+
+The sync command has been refactored to extract reusable utilities and reduce code duplication.
+
+## Changes Made
+
+### 1. Extracted File System Utilities
+**File**: `src/commands/upstream/sync-filesystem.ts`
+
+Extracted functions:
+- `cleanDirectory()` - Clean a directory with optional subdirectory preservation
+- `existsAny()` - Check if any paths in a list exist
+- `readdir()` - Safe directory reading with error handling
+
+**Impact**: Removed ~30 lines from main file, improved testability
+
+### 2. Extracted Package.json Utilities
+**File**: `src/commands/upstream/sync-package-json.ts`
+
+Extracted functions:
+- `getAllDeps()` - Get all dependencies from package.json
+- `extractPieLibDeps()` - Extract @pie-lib/* dependencies
+- `extractPieElementDeps()` - Extract @pie-element/* dependencies
+- `generateElementExports()` - Generate ESM exports for elements
+- `generatePieLibExports()` - Generate ESM exports for pie-lib packages
+
+**Impact**: Improved reusability, prepared for future use
+
+### 3. Extracted Vite Config Utilities
+**File**: `src/commands/upstream/sync-vite-config.ts`
+
+Extracted functions:
+- `detectElementEntryPoints()` - Detect available entry points for elements
+- `generateElementViteConfig()` - Generate Vite config for element packages
+- `generatePieLibViteConfig()` - Generate Vite config for pie-lib packages
+
+**Impact**: Improved reusability for build configuration
+
+### 4. Extracted Import Utilities
+**File**: `src/commands/upstream/sync-imports.ts`
+
+Extracted functions:
+- `fixImportsInFile()` - Handle default export conversions
+- `containsJsx()` - Detect JSX syntax in code
+- `shouldUseTsxExtension()` - Determine file extension based on content
+
+**Impact**: Improved code organization and testability
+
+### 6. Implemented Strategy Pattern
+**Files**: `sync-strategy.ts`, `sync-controllers-strategy.ts`, `sync-react-strategy.ts`, `sync-pielib-strategy.ts`
+
+Created strategy pattern for sync operations:
+- `SyncStrategy` interface defining contract for sync strategies
+- `ControllersStrategy` - Handles controller file synchronization (455 lines)
+- `ReactComponentsStrategy` - Handles React component synchronization (536 lines)
+- `PieLibStrategy` - Handles @pie-lib package synchronization (322 lines)
+
+Each strategy is:
+- Self-contained with all related logic and helper methods
+- Independently executable and testable
+- Responsible for one specific sync type
+
+**Impact**: Major code organization improvement, true separation of concerns
+
+### 7. Updated sync.ts
+- Removed duplicate utility methods
+- Replaced inline demo generation with utility calls
+- Extracted three large sync methods into strategies
+- Removed 9 helper methods that moved to strategies
+- Now focuses purely on orchestration and coordination
+
+**Result**:
+- File size reduced from 1,571 to 644 lines (927 lines removed, ~59% reduction)
+- Better separation of concerns
+- Each strategy independently testable
+- Cleaner, more focused main command file
+- No breaking changes to CLI interface
+
+**Total extraction across all files:**
+- 5 utility modules (filesystem, package-json, vite-config, demo, imports)
+- 3 strategy modules (controllers, react, pie-lib)
+- 1 strategy interface (strategy)
+- Main file reduced by 59%
+
+## Benefits
+
+1. **Testability**: Utilities can be unit tested independently
+2. **Reusability**: Functions available for other commands
+3. **Maintainability**: Clearer responsibilities, less duplication
+4. **No Breaking Changes**: Internal refactor only, CLI works the same
+
+## Completed Improvements
+
+All planned refactoring has been completed:
+
+1. ✅ **Extracted utilities**:
+   - Vite config generation (sync-vite-config.ts)
+   - Demo generation (sync-demo.ts)
+   - Import rewriting logic (sync-imports.ts)
+   - File system operations (sync-filesystem.ts)
+   - Package.json manipulation (sync-package-json.ts)
+
+2. ✅ **Implemented strategy pattern**:
+   - ControllersStrategy (sync-controllers-strategy.ts)
+   - ReactComponentsStrategy (sync-react-strategy.ts)
+   - PieLibStrategy (sync-pielib-strategy.ts)
+
+3. ✅ **Refactored main sync.ts**:
+   - Reduced from 1,571 to 644 lines (59% reduction)
+   - Focuses on orchestration only
+   - All sync logic extracted to strategies
+
+## Next Steps (Optional)
+
+To further improve the codebase:
+
+1. **Add unit tests** for extracted utilities and strategies
+
+2. **Extract long methods** in remaining code (>100 lines) into smaller, focused functions
+
+3. **Consider extracting demo sync** into its own strategy if it grows in complexity
+
+## Testing
+
+All existing functionality verified:
+- ✅ Controllers sync correctly
+- ✅ React components sync correctly
+- ✅ ESM analysis works correctly
+- ✅ Build completes successfully

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from '@oclif/core';
+
+await execute({ development: true, dir: import.meta.url });

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from '@oclif/core';
+
+await execute({ development: false, dir: import.meta.url });

package/dist/commands/dev/demo/index.d.ts

@@ -0,0 +1,33 @@
+import { Command } from '@oclif/core';
+/**
+ * Start unified demo application for all PIE elements.
+ *
+ * This command starts the apps/element-demo SvelteKit application which provides
+ * a unified demo experience for all 27 PIE elements with multiple demo configurations.
+ */
+export default class DevDemo extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        build: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {};
+    private viteProcess;
+    private lockFilePath;
+    private bundlerInstanceDir;
+    run(): Promise<void>;
+    private buildAllElements;
+    private startVite;
+    private openBrowser;
+    private installDependencies;
+    private cleanup;
+    private sleep;
+    private acquireLock;
+    private getLockFilePath;
+    private createBundlerInstanceDir;
+    private releaseLock;
+    private isProcessRunning;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/dev/demo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/dev/demo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAM7C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,OAAO;IAC1C,OAAgB,WAAW,SAAqE;IAEhG,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,KAAK;;;;MAiBnB;IAEF,OAAgB,IAAI,KAAM;IAE1B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,kBAAkB,CAAM;IAEnB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YAyFnB,gBAAgB;YAiChB,SAAS;YAsBT,WAAW;YAUX,mBAAmB;IAmBjC,OAAO,CAAC,OAAO;IAsBf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,gBAAgB;CAQzB"}