tjs-lang 0.6.26 → 0.6.27

package/demo/docs.json

@@ -115,7 +115,7 @@
     "type": "example",
     "group": "basics",
     "order": 15,
-    "code": "TjsEquals\n\n/*#\n## The Problem with JavaScript ==\n\nJavaScript's `==` does type coercion, producing surprises:\n\n    0 == ''          // true in JS (!)\n    false == []      // true in JS (!)\n    '' == false      // true in JS (!)\n    null == 0        // false in JS (but null == undefined is true)\n\nJavaScript's `===` fixes coercion but can't compare values:\n\n    new String('hi') === 'hi'    // false in JS (different types)\n    new Boolean(false) === false // false in JS (object vs primitive)\n\n## TJS Equality (TjsEquals)\n\n`==` becomes **honest equality**: no coercion, but unwraps\nboxed primitives. Fast O(1) — no deep comparison.\n\n`Is` / `IsNot` are **structural equality**: deep comparison\nfor when you explicitly need it. O(n) cost is visible.\n*/\n\n// --- Honest equality (==) fixes coercion ---\nconsole.log('== fixes JS coercion:')\nconsole.log('  0 == \"\":', 0 == '')             // false (JS: true)\nconsole.log('  false == []:', false == [])      // false (JS: true)\nconsole.log('  false == \"\":', false == '')      // false (JS: true)\nconsole.log('  1 == \"1\":', 1 == '1')           // false (JS: true)\n\n// --- Boxed primitives unwrap ---\nconsole.log('')\nconsole.log('== unwraps boxed primitives:')\nconsole.log('  new String(\"hi\") == \"hi\":', new String('hi') == 'hi')   // true\nconsole.log('  new Boolean(false) == false:', new Boolean(false) == false)  // true\nconsole.log('  new Number(42) == 42:', new Number(42) == 42)           // true\n\n// --- Nullish equality preserved ---\nconsole.log('')\nconsole.log('Nullish equality (useful pattern preserved):')\nconsole.log('  null == undefined:', null == undefined)   // true\nconsole.log('  null == 0:', null == 0)                   // false\nconsole.log('  null == \"\":', null == '')                  // false\n\n// --- Objects/arrays: reference equality (fast, O(1)) ---\nconsole.log('')\nconsole.log('== on objects/arrays is reference equality (fast):')\nconst obj = {x: 1}\nconsole.log('  obj == obj:', obj == obj)                   // true (same ref)\nconsole.log('  {x:1} == {x:1}:', {x: 1} == {x: 1})       // false (different refs)\nconsole.log('  [1,2] == [1,2]:', [1, 2] == [1, 2])        // false (different refs)\n\n// --- Is/IsNot: explicit deep structural comparison ---\nconsole.log('')\nconsole.log('Is/IsNot for deep structural comparison (explicit):')\nconsole.log('  {x:1} Is {x:1}:', Is({x: 1}, {x: 1}))          // true\nconsole.log('  [1,2,3] Is [1,2,3]:', Is([1,2,3], [1,2,3]))    // true\nconsole.log('  [1,2] Is [2,1]:', Is([1,2], [2,1]))             // false (order matters)\n\n// Sets compare by membership, not order\nconsole.log('  Set([1,2]) Is Set([2,1]):', Is(new Set([1,2]), new Set([2,1])))  // true\n\n// --- === unchanged: identity comparison ---\nconsole.log('')\nconsole.log('=== is unchanged (identity):')\nconsole.log('  obj === obj:', obj === obj)               // true\nconsole.log('  {x:1} === {x:1}:', {x: 1} === {x: 1})   // false\n\ntest 'Eq fixes coercion' {\n  expect(Eq(0, '')).toBe(false)\n  expect(Eq(false, [])).toBe(false)\n  expect(Eq('', false)).toBe(false)\n}\n\ntest 'Eq unwraps boxed primitives' {\n  expect(Eq(new String('hi'), 'hi')).toBe(true)\n  expect(Eq(new Boolean(false), false)).toBe(true)\n  expect(Eq(new Number(42), 42)).toBe(true)\n}\n\ntest 'Eq preserves nullish equality' {\n  expect(Eq(null, undefined)).toBe(true)\n  expect(Eq(null, 0)).toBe(false)\n}\n\ntest 'Is does deep structural comparison' {\n  expect(Is({a: 1, b: 2}, {a: 1, b: 2})).toBe(true)\n  expect(Is([1, 2, 3], [1, 2, 3])).toBe(true)\n  expect(Is([1, 2], [2, 1])).toBe(false)\n}",
+    "code": "TjsEquals\n\n/*#\n## The Problem with JavaScript ==\n\nJavaScript's `==` does type coercion, producing surprises:\n\n    0 == ''          // true in JS (!)\n    false == []      // true in JS (!)\n    '' == false      // true in JS (!)\n    null == 0        // false in JS (but null == undefined is true)\n\nJavaScript's `===` fixes coercion but can't compare values:\n\n    new String('hi') === 'hi'    // false in JS (different types)\n    new Boolean(false) === false // false in JS (object vs primitive)\n\n## TJS Equality (TjsEquals)\n\n`==` becomes **honest equality**: no coercion, but unwraps\nboxed primitives. Fast O(1) — no deep comparison.\n\n`Is` / `IsNot` are **structural equality**: deep comparison\nfor when you explicitly need it. O(n) cost is visible.\n*/\n\n// --- Honest equality (==) fixes coercion ---\nconsole.log('== fixes JS coercion:')\nconsole.log('  0 == \"\":', 0 == '')             // false (JS: true)\nconsole.log('  false == []:', false == [])      // false (JS: true)\nconsole.log('  false == \"\":', false == '')      // false (JS: true)\nconsole.log('  1 == \"1\":', 1 == '1')           // false (JS: true)\n\n// --- Boxed primitives unwrap ---\nconsole.log('')\nconsole.log('== unwraps boxed primitives:')\nconsole.log('  new String(\"hi\") == \"hi\":', new String('hi') == 'hi')   // true\nconsole.log('  new Boolean(false) == false:', new Boolean(false) == false)  // true\nconsole.log('  new Number(42) == 42:', new Number(42) == 42)           // true\n\n// --- Nullish equality preserved ---\nconsole.log('')\nconsole.log('Nullish equality (useful pattern preserved):')\nconsole.log('  null == undefined:', null == undefined)   // true\nconsole.log('  null == 0:', null == 0)                   // false\nconsole.log('  null == \"\":', null == '')                  // false\n\n// --- Objects/arrays: reference equality (fast, O(1)) ---\nconsole.log('')\nconsole.log('== on objects/arrays is reference equality (fast):')\nconst obj = {x: 1}\nconsole.log('  obj == obj:', obj == obj)                   // true (same ref)\nconsole.log('  {x:1} == {x:1}:', {x: 1} == {x: 1})       // false (different refs)\nconsole.log('  [1,2] == [1,2]:', [1, 2] == [1, 2])        // false (different refs)\n\n// --- Is/IsNot: explicit deep structural comparison ---\nconsole.log('')\nconsole.log('Is/IsNot for deep structural comparison (explicit):')\nconsole.log('  {x:1} Is {x:1}:', Is({x: 1}, {x: 1}))          // true\nconsole.log('  [1,2,3] Is [1,2,3]:', Is([1,2,3], [1,2,3]))    // true\nconsole.log('  [1,2] Is [2,1]:', Is([1,2], [2,1]))             // false (order matters)\n\n// Sets compare by membership, not order\nconsole.log('  Set([1,2]) Is Set([2,1]):', Is(new Set([1,2]), new Set([2,1])))  // true\n\n// --- typeof null fixed ---\nconsole.log('')\nconsole.log('typeof null fixed:')\nconsole.log('  typeof null:', typeof null)                 // 'null' (JS: 'object')\nconsole.log('  typeof undefined:', typeof undefined)       // 'undefined'\nconsole.log('  typeof 42:', typeof 42)                     // 'number' (unchanged)\n\n// --- === unchanged: identity comparison ---\nconsole.log('')\nconsole.log('=== is unchanged (identity):')\nconsole.log('  obj === obj:', obj === obj)               // true\nconsole.log('  {x:1} === {x:1}:', {x: 1} === {x: 1})   // false\n\ntest 'typeof null is null, not object' {\n  expect(TypeOf(null)).toBe('null')\n  expect(TypeOf(undefined)).toBe('undefined')\n  expect(TypeOf(42)).toBe('number')\n  expect(TypeOf('hi')).toBe('string')\n  expect(TypeOf(true)).toBe('boolean')\n  expect(TypeOf({})).toBe('object')\n}\n\ntest 'Eq fixes coercion' {\n  expect(Eq(0, '')).toBe(false)\n  expect(Eq(false, [])).toBe(false)\n  expect(Eq('', false)).toBe(false)\n}\n\ntest 'Eq unwraps boxed primitives' {\n  expect(Eq(new String('hi'), 'hi')).toBe(true)\n  expect(Eq(new Boolean(false), false)).toBe(true)\n  expect(Eq(new Number(42), 42)).toBe(true)\n}\n\ntest 'Eq preserves nullish equality' {\n  expect(Eq(null, undefined)).toBe(true)\n  expect(Eq(null, 0)).toBe(false)\n}\n\ntest 'Is does deep structural comparison' {\n  expect(Is({a: 1, b: 2}, {a: 1, b: 2})).toBe(true)\n  expect(Is([1, 2, 3], [1, 2, 3])).toBe(true)\n  expect(Is([1, 2], [2, 1])).toBe(false)\n}",
     "language": "tjs",
     "description": "JavaScript `==` is broken. TJS fixes it without breaking anything."
   },

package/dist/bin/benchmarks.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env bun
+/**
+ * TJS Benchmark Runner
+ *
+ * Runs performance benchmarks and generates benchmarks.md
+ *
+ * Usage: bun bin/benchmarks.ts
+ */
+export {};

package/dist/bin/dev.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/bin/docs.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/bin/select-local-models.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/examples/modules/dist/main.d.ts

@@ -0,0 +1,34 @@
+export function calculate(x?: number, y?: number): any;
+export namespace calculate {
+    namespace __tjs {
+        namespace params {
+            namespace x {
+                export namespace type {
+                    let kind: string;
+                }
+                export let required: boolean;
+                let _default: null;
+                export { _default as default };
+            }
+            namespace y {
+                export namespace type_1 {
+                    let kind_1: string;
+                    export { kind_1 as kind };
+                }
+                export { type_1 as type };
+                let required_1: boolean;
+                export { required_1 as required };
+                let _default_1: null;
+                export { _default_1 as default };
+            }
+        }
+        namespace returns {
+            export namespace type_2 {
+                let kind_2: string;
+                export { kind_2 as kind };
+            }
+            export { type_2 as type };
+        }
+        let source: string;
+    }
+}

package/dist/examples/modules/dist/math.d.ts

@@ -0,0 +1,120 @@
+export function add(a?: number, b?: number): any;
+export namespace add {
+    namespace __tjs {
+        namespace params {
+            namespace a {
+                export namespace type {
+                    let kind: string;
+                }
+                export let required: boolean;
+                let _default: null;
+                export { _default as default };
+            }
+            namespace b {
+                export namespace type_1 {
+                    let kind_1: string;
+                    export { kind_1 as kind };
+                }
+                export { type_1 as type };
+                let required_1: boolean;
+                export { required_1 as required };
+                let _default_1: null;
+                export { _default_1 as default };
+            }
+        }
+        namespace returns {
+            export namespace type_2 {
+                let kind_2: string;
+                export { kind_2 as kind };
+            }
+            export { type_2 as type };
+        }
+        let source: string;
+    }
+}
+export function subtract(a?: number, b?: number): any;
+export namespace subtract {
+    export namespace __tjs_1 {
+        export namespace params_1 {
+            export namespace a_1 {
+                export namespace type_3 {
+                    let kind_3: string;
+                    export { kind_3 as kind };
+                }
+                export { type_3 as type };
+                let required_2: boolean;
+                export { required_2 as required };
+                let _default_2: null;
+                export { _default_2 as default };
+            }
+            export { a_1 as a };
+            export namespace b_1 {
+                export namespace type_4 {
+                    let kind_4: string;
+                    export { kind_4 as kind };
+                }
+                export { type_4 as type };
+                let required_3: boolean;
+                export { required_3 as required };
+                let _default_3: null;
+                export { _default_3 as default };
+            }
+            export { b_1 as b };
+        }
+        export { params_1 as params };
+        export namespace returns_1 {
+            export namespace type_5 {
+                let kind_5: string;
+                export { kind_5 as kind };
+            }
+            export { type_5 as type };
+        }
+        export { returns_1 as returns };
+        let source_1: string;
+        export { source_1 as source };
+    }
+    export { __tjs_1 as __tjs };
+}
+export function multiply(a?: number, b?: number): any;
+export namespace multiply {
+    export namespace __tjs_2 {
+        export namespace params_2 {
+            export namespace a_2 {
+                export namespace type_6 {
+                    let kind_6: string;
+                    export { kind_6 as kind };
+                }
+                export { type_6 as type };
+                let required_4: boolean;
+                export { required_4 as required };
+                let _default_4: null;
+                export { _default_4 as default };
+            }
+            export { a_2 as a };
+            export namespace b_2 {
+                export namespace type_7 {
+                    let kind_7: string;
+                    export { kind_7 as kind };
+                }
+                export { type_7 as type };
+                let required_5: boolean;
+                export { required_5 as required };
+                let _default_5: null;
+                export { _default_5 as default };
+            }
+            export { b_2 as b };
+        }
+        export { params_2 as params };
+        export namespace returns_2 {
+            export namespace type_8 {
+                let kind_8: string;
+                export { kind_8 as kind };
+            }
+            export { type_8 as type };
+        }
+        export { returns_2 as returns };
+        let source_2: string;
+        export { source_2 as source };
+    }
+    export { __tjs_2 as __tjs };
+}