@generaltranslation/compiler 1.0.0-alpha.0 → 1.0.1

package/README.md

@@ -10,7 +10,7 @@ This plugin performs two main functions during the build process:
 
 Detects and prevents invalid usage patterns in GT translation components:
 
-#### JSX Component Violations:
+#### JSX Component Violations
 
 ```jsx
 // ❌ Unwrapped expressions
@@ -27,31 +27,31 @@ Detects and prevents invalid usage patterns in GT translation components:
 <T><Var>{greeting}</Var> world</T>
 ```
 
-#### Function Call Violations:
+#### Function Call Violations
 
 ```js
 // ❌ Template literals
-const msg = t(`Hello ${name}!`);
-const error = t(`Error: ${code} - ${message}`);
+const msg = gt(`Hello ${name}!`);
+const error = gt(`Error: ${code} - ${message}`);
 
 // ❌ String concatenation
-const welcome = t('Welcome ' + username);
-const path = t('Go to ' + destination + ' page');
+const welcome = gt('Welcome ' + username);
+const path = gt('Go to ' + destination + ' page');
 
 // ❌ Dynamic expressions
-const dynamic = t(isError ? errorMsg : successMsg);
+const dynamic = gt(isError ? errorMsg : successMsg);
 
 // ✅ Correct usage
-const msg = t('Hello world!');
-const welcome = t('Welcome to our app');
-const error = t('Something went wrong', { context: 'error' });
+const msg = gt('Hello world!');
+const welcome = gt('Welcome to our app');
+const error = gt('Something went wrong', { context: 'error' });
 ```
 
 ### 2. Compile-Time Hash Generation
 
 Pre-computes translation keys at build time for better performance:
 
-- Generates stable hashes for `<T>` components and `t()` function calls
+- Generates stable hashes for `<T>` components and `gt()` function calls
 - Injects hash attributes (`_hash`) into components
 - Creates content arrays for translation functions
 
@@ -71,15 +71,10 @@ If you're using `gt-next`, the plugin is automatically configured for you. No ad
 
 ```js
 // webpack.config.js
-const gtCompiler = require('@generaltranslation/compiler/webpack');
+const { webpack: gtCompiler } = require('@generaltranslation/compiler');
 
 module.exports = {
-  plugins: [
-    gtCompiler({
-      compileTimeHash: true,
-      logLevel: 'warn',
-    }),
-  ],
+  plugins: [gtCompiler()],
 };
 ```
 
@@ -88,15 +83,10 @@ module.exports = {
 ```js
 // vite.config.js
 import { defineConfig } from 'vite';
-import gtCompiler from '@generaltranslation/compiler/vite';
+import { vite as gtCompiler } from '@generaltranslation/compiler';
 
 export default defineConfig({
-  plugins: [
-    gtCompiler({
-      compileTimeHash: true,
-      logLevel: 'warn',
-    }),
-  ],
+  plugins: [gtCompiler()],
 });
 ```
 
@@ -104,15 +94,10 @@ export default defineConfig({
 
 ```js
 // rollup.config.js
-import gtCompiler from '@generaltranslation/compiler/rollup';
+import { rollup as gtCompiler } from '@generaltranslation/compiler';
 
 export default {
-  plugins: [
-    gtCompiler({
-      compileTimeHash: true,
-      logLevel: 'warn',
-    }),
-  ],
+  plugins: [gtCompiler()],
 };
 ```
 
@@ -121,16 +106,11 @@ export default {
 ```js
 // esbuild.config.js
 const { build } = require('esbuild');
-const gtCompiler = require('@generaltranslation/compiler/esbuild');
+const { esbuild: gtCompiler } = require('@generaltranslation/compiler');
 
 build({
-  plugins: [
-    gtCompiler({
-      compileTimeHash: true,
-      logLevel: 'warn',
-    }),
-  ],
-};
+  plugins: [gtCompiler()],
+});
 ```
 
 ## Configuration Options
@@ -147,128 +127,3 @@ interface GTCompilerOptions {
   disableBuildChecks?: boolean;
 }
 ```
-
-## How It Works
-
-The plugin uses the [unplugin](https://unplugin.unjs.io/) framework to provide universal bundler support. It analyzes your code using Babel's parser and transformer to:
-
-### String Collector
-
-Manages translation content across the two-pass transformation:
-
-- **Pass 1**: Collects translation strings, JSX content, and hash data
-- **Pass 2**: Injects collected data back into `useGT()`/`getGT()` calls
-- Associates content with function calls using deterministic counter IDs
-- Supports multiple `t()` calls per translation function
-
-### Scope Tracker
-
-Handles variable scoping and import tracking:
-
-- Tracks `useGT`/`getGT` variable assignments across nested scopes
-- Manages variable shadowing (`const t = useGT()` in different scopes)
-- Maps component names to their original GT imports (`T`, `Var`, etc.)
-- Handles both named imports and namespace imports (`GT.T`)
-
-### AST Traversal
-
-Converts JSX components into sanitized hash-able objects:
-
-- Recursively processes JSX elements and their children
-- Identifies GT components vs regular HTML elements
-- Extracts content from `Branch`/`Plural` component attributes
-- Generates stable hash representations for consistent builds
-
-## Two-Pass Traversal System
-
-The plugin uses a two-pass approach to handle the circular dependency between translation functions and their usage:
-
-### Pass 1: Collection
-
-- **Discover translation functions**: Find `useGT()` and `getGT()` calls, assign unique counter IDs
-- **Track variable assignments**: Follow `const t = useGT()` patterns using scope tracker
-- **Collect content**: Gather `t()` calls and `<T>` components, associate with counter IDs
-- **Generate hashes**: Calculate stable hashes for JSX content using AST traversal
-- **Validate usage**: Check for dynamic content violations and report errors
-
-### Pass 2: Transformation
-
-- **Inject content arrays**: Add collected `t()` strings to `useGT()`/`getGT()` calls
-- **Add hash attributes**: Insert `_hash` props into `<T>` components
-- **Preserve order**: Use the same counter sequence to match content with functions
-
-This approach solves the "chicken-and-egg" problem: we need to know what `t()` calls exist before we can inject content into the `useGT()` function that creates `t()`.
-
-## Supported Bundlers
-
-This plugin works with:
-
-- ✅ **Webpack** 4, 5
-- ✅ **Vite** 2, 3, 4, 5
-- ✅ **Rollup** 2, 3, 4
-- ✅ **esbuild** 0.15+
-- ✅ **Next.js** (via gt-next)
-- ✅ **Nuxt** (via unplugin auto-detection)
-
-## Components Tracked
-
-- **Translation**: `T`
-- **Variables**: `Var`, `Num`, `Currency`, `DateTime`
-- **Branching**: `Branch`, `Plural`
-- **Functions**: `useGT()`, `getGT()`, and their callbacks
-
-## Development Status
-
-Files ported from Rust SWC plugin with their implementation status:
-
-### ✅ Core Framework
-
-- **`src/index.ts`** - Universal plugin entry point with unplugin integration
-
-### ✅ Completed (with tests)
-
-- **`src/visitor/analysis.ts`** - Component identification functions
-- **`src/visitor/string-collector.ts`** - Two-pass transformation system
-- **`src/logging.ts`** - Logger implementation
-- **`src/visitor/errors.ts`** - Error message creation
-
-### 🚧 Implemented (needs integration)
-
-- **`src/visitor/scope-tracker.ts`** - Scope tracking and variable management
-- **`src/visitor/import-tracker.ts`** - Import tracking and component resolution
-
-### ❌ Not Yet Implemented
-
-- **`src/ast/traversal.ts`** - JSX to sanitized objects conversion
-- **`src/ast/utilities.ts`** - AST utility functions
-- **`src/hash.ts`** - Hash generation utilities
-- **`src/whitespace.ts`** - Whitespace handling utilities
-- **`src/visitor/transform.ts`** - Main transformation logic
-- **`src/visitor/jsx-utils.ts`** - JSX processing utilities
-- **`src/visitor/expr-utils.ts`** - Expression analysis utilities
-
-## Contributing
-
-This plugin is part of the General Translation ecosystem. The transformation logic is gradually being ported from the existing Rust SWC plugin to provide broader bundler support.
-
-### Test Files Structure
-
-```
-src/
-├── __tests__/
-│   ├── index.test.ts (unplugin integration tests)
-├── visitor/
-│   └── __tests__/
-│       ├── string-collector.test.ts ✅
-│       ├── analysis.test.ts (pending)
-│       ├── scope-tracker.test.ts (pending)
-│       └── import-tracker.test.ts (pending)
-├── logging.test.ts (pending)
-└── ast/
-    └── __tests__/
-        └── traversal.test.ts (pending)
-```
-
-## License
-
-MIT - General Translation, Inc.

package/dist/index.d.ts

@@ -61,7 +61,7 @@ export interface GTUnpluginOptions extends PluginConfig {
  */
 declare const gtUnplugin: import("unplugin").UnpluginInstance<GTUnpluginOptions | undefined, boolean>;
 export default gtUnplugin;
-export declare const webpack: (options?: GTUnpluginOptions | undefined) => import("unplugin").WebpackPluginInstance;
+export declare const webpack: (options?: GTUnpluginOptions | undefined) => WebpackPluginInstance;
 export declare const vite: (options?: GTUnpluginOptions | undefined) => import("vite").Plugin<any> | import("vite").Plugin<any>[];
 export declare const rollup: (options?: GTUnpluginOptions | undefined) => import("rollup").Plugin<any> | import("rollup").Plugin<any>[];
 export declare const esbuild: (options?: GTUnpluginOptions | undefined) => import("unplugin").EsbuildPlugin;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAcxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY;CAEtD;AAED;;;;;;;;GAQG;AACH,QAAA,MAAM,UAAU,6EAgFf,CAAC;AAGF,eAAe,UAAU,CAAC;AAC1B,eAAO,MAAM,OAAO,uFAAqB,CAAC;AAC1C,eAAO,MAAM,IAAI,wGAAkB,CAAC;AACpC,eAAO,MAAM,MAAM,4GAAoB,CAAC;AACxC,eAAO,MAAM,OAAO,+EAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAcxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY;CAEtD;AAED;;;;;;;;GAQG;AACH,QAAA,MAAM,UAAU,6EAgFf,CAAC;AAGF,eAAe,UAAU,CAAC;AAC1B,eAAO,MAAM,OAAO,oEAAqB,CAAC;AAC1C,eAAO,MAAM,IAAI,wGAAkB,CAAC;AACpC,eAAO,MAAM,MAAM,4GAAoB,CAAC;AACxC,eAAO,MAAM,OAAO,+EAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@generaltranslation/compiler",
-  "version": "1.0.0-alpha.0",
+  "version": "1.0.1",
   "description": "Universal plugin for compile-time optimization of GT translation components",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -52,8 +52,8 @@
     "release:alpha": "pnpm run build:clean && pnpm publish --tag alpha",
     "release:beta": "pnpm run build:clean && pnpm publish --tag beta",
     "release:latest": "pnpm run build:clean && pnpm publish --tag latest",
-    "lint": "eslint \"src/**/*.{js,ts,tsx}\" \"__tests__/**/*.{js,ts,tsx}\"",
-    "lint:fix": "eslint \"src/**/*.{js,ts,tsx}\" \"__tests__/**/*.{js,ts,tsx}\" --fix",
+    "lint": "eslint \"src/**/*.{js,ts,tsx}\"",
+    "lint:fix": "eslint \"src/**/*.{js,ts,tsx}\" --fix",
     "test": "vitest run",
     "test:watch": "vitest"
   }