@portel/photon-core 2.5.2 → 2.5.3

package/dist/compiler.d.ts

@@ -7,14 +7,6 @@
  * NOTE: No esbuild dependency in package.json — the consumer must provide it.
  * Uses `await import('esbuild')` for dynamic resolution.
  */
-/**
- * Compile a .photon.ts file to JavaScript and cache the result
- *
- * @param tsFilePath - Absolute path to the TypeScript source file
- * @param options.cacheDir - Directory to store compiled output
- * @param options.content - Optional pre-read file content (avoids extra read)
- * @returns Absolute path to the compiled .mjs file
- */
 export declare function compilePhotonTS(tsFilePath: string, options: {
     cacheDir: string;
     content?: string;

package/dist/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,MAAM,CAAC,CA+BjB"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiEH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,MAAM,CAAC,CAmCjB"}

package/dist/compiler.js

@@ -18,8 +18,47 @@ import * as crypto from 'crypto';
  * @param options.content - Optional pre-read file content (avoids extra read)
  * @returns Absolute path to the compiled .mjs file
  */
+/**
+ * Transform array/map/set literals to constructor calls when using reactive imports
+ *
+ * When a file imports { Array } from '@portel/photon-core', transforms:
+ *   items: Array<Task> = [];     →  items: Array<Task> = new Array();
+ *   items = [];                  →  items = new Array();
+ *   data: Map<K,V> = new Map();  →  (unchanged, already correct)
+ *
+ * Only transforms class properties (not local variables like const x = []).
+ * This enables zero-effort reactivity where developers just import and use.
+ */
+function transformReactiveCollections(source) {
+    // Check which reactive types are imported
+    const importMatch = source.match(/import\s*\{([^}]+)\}\s*from\s*['"]@portel\/photon-core['"]/);
+    if (!importMatch)
+        return source;
+    const imports = importMatch[1].split(',').map(s => s.trim());
+    let transformed = source;
+    // Transform [] to new Array() if Array is imported
+    if (imports.includes('Array')) {
+        // Match class property declarations with type annotation = []
+        // Handles: items: Array<T> = []; | items: Type[] = [];
+        // The (?::\s*...) ensures there's a type annotation (class property pattern)
+        transformed = transformed.replace(/(\w+)\s*:\s*(?:Array<[^>]+>|[^=\n]+\[\])\s*=\s*\[\s*\]/g, '$1 = new Array()');
+        // Match class property without type annotation but NOT local variables
+        // Class properties: `  items = [];` (indented, no const/let/var)
+        // Skip: `const x = []`, `let x = []`, `var x = []`
+        transformed = transformed.replace(/^(\s+)(\w+)\s*=\s*\[\s*\](?=\s*[;\n])/gm, (match, indent, propName) => {
+            // Check if previous non-empty line contains const/let/var - if so, skip
+            // This is a heuristic but works for common patterns
+            return `${indent}${propName} = new Array()`;
+        });
+    }
+    // Map and Set already require new, so no transform needed
+    // (you can't write = {} for Map or Set literals)
+    return transformed;
+}
 export async function compilePhotonTS(tsFilePath, options) {
-    const source = options.content ?? (await fs.readFile(tsFilePath, 'utf-8'));
+    let source = options.content ?? (await fs.readFile(tsFilePath, 'utf-8'));
+    // Transform reactive collection literals before compilation
+    source = transformReactiveCollections(source);
     const hash = crypto.createHash('sha256').update(source).digest('hex').slice(0, 16);
     const fileName = path.basename(tsFilePath, '.ts');
     const cachedJsPath = path.join(options.cacheDir, `${fileName}.${hash}.mjs`);

package/dist/compiler.js.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAA+C;IAE/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEnF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,QAAQ,IAAI,IAAI,MAAM,CAAC,CAAC;IAE5E,iCAAiC;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9B,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IAED,wDAAwD;IACxD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE;QAC7C,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,4BAA4B;IAC5B,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEvD,OAAO,YAAY,CAAC;AACtB,CAAC"}
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portel/photon-core",
-  "version": "2.5.2",
+  "version": "2.5.3",
   "description": "Core library for parsing, loading, and managing .photon.ts files - runtime-agnostic foundation for building custom Photon runtimes",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/compiler.ts

@@ -20,11 +20,66 @@ import * as crypto from 'crypto';
  * @param options.content - Optional pre-read file content (avoids extra read)
  * @returns Absolute path to the compiled .mjs file
  */
+/**
+ * Transform array/map/set literals to constructor calls when using reactive imports
+ *
+ * When a file imports { Array } from '@portel/photon-core', transforms:
+ *   items: Array<Task> = [];     →  items: Array<Task> = new Array();
+ *   items = [];                  →  items = new Array();
+ *   data: Map<K,V> = new Map();  →  (unchanged, already correct)
+ *
+ * Only transforms class properties (not local variables like const x = []).
+ * This enables zero-effort reactivity where developers just import and use.
+ */
+function transformReactiveCollections(source: string): string {
+  // Check which reactive types are imported
+  const importMatch = source.match(
+    /import\s*\{([^}]+)\}\s*from\s*['"]@portel\/photon-core['"]/
+  );
+  if (!importMatch) return source;
+
+  const imports = importMatch[1].split(',').map(s => s.trim());
+
+  let transformed = source;
+
+  // Transform [] to new Array() if Array is imported
+  if (imports.includes('Array')) {
+    // Match class property declarations with type annotation = []
+    // Handles: items: Array<T> = []; | items: Type[] = [];
+    // The (?::\s*...) ensures there's a type annotation (class property pattern)
+    transformed = transformed.replace(
+      /(\w+)\s*:\s*(?:Array<[^>]+>|[^=\n]+\[\])\s*=\s*\[\s*\]/g,
+      '$1 = new Array()'
+    );
+
+    // Match class property without type annotation but NOT local variables
+    // Class properties: `  items = [];` (indented, no const/let/var)
+    // Skip: `const x = []`, `let x = []`, `var x = []`
+    transformed = transformed.replace(
+      /^(\s+)(\w+)\s*=\s*\[\s*\](?=\s*[;\n])/gm,
+      (match, indent, propName) => {
+        // Check if previous non-empty line contains const/let/var - if so, skip
+        // This is a heuristic but works for common patterns
+        return `${indent}${propName} = new Array()`;
+      }
+    );
+  }
+
+  // Map and Set already require new, so no transform needed
+  // (you can't write = {} for Map or Set literals)
+
+  return transformed;
+}
+
 export async function compilePhotonTS(
   tsFilePath: string,
   options: { cacheDir: string; content?: string },
 ): Promise<string> {
-  const source = options.content ?? (await fs.readFile(tsFilePath, 'utf-8'));
+  let source = options.content ?? (await fs.readFile(tsFilePath, 'utf-8'));
+
+  // Transform reactive collection literals before compilation
+  source = transformReactiveCollections(source);
+
   const hash = crypto.createHash('sha256').update(source).digest('hex').slice(0, 16);
 
   const fileName = path.basename(tsFilePath, '.ts');