@tsonic/js 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tsoniclang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# @tsonic/js
+
+TypeScript type definitions for the JavaScript Runtime (JSRuntime) library.
+
+## Features
+
+- **JavaScript-like APIs for .NET** - Array, Map, Set, Date, Math, JSON, and more
+- **Global functions** - `parseInt`, `parseFloat`, `encodeURI`, etc. as top-level exports
+- **camelCase members** - TypeScript-friendly naming conventions
+- **Primitive aliases** - `int`, `long`, etc. via `@tsonic/core`
+- **Full type safety** - Complete TypeScript declarations
+
+## Installation
+
+```bash
+npm install @tsonic/js @tsonic/dotnet @tsonic/core
+```
+
+## Usage
+
+### Global Functions
+
+```typescript
+import { parseInt, parseFloat, isNaN, encodeURIComponent } from "@tsonic/js";
+
+const num = parseInt("42", 10);
+const float = parseFloat("3.14");
+const encoded = encodeURIComponent("hello world");
+```
+
+### Array Operations
+
+```typescript
+import { JSArray } from "@tsonic/js";
+
+const arr = new JSArray<number>();
+arr.push(1, 2, 3);
+const mapped = arr.map(x => x * 2);
+```
+
+### Map and Set
+
+```typescript
+import { Map, Set } from "@tsonic/js";
+
+const map = new Map<string, number>();
+map.set_("key", 42);
+
+const set = new Set<string>();
+set.add("value");
+```
+
+### Date and Math
+
+```typescript
+import { Date, Math } from "@tsonic/js";
+
+const now = new Date();
+const random = Math.random();
+const max = Math.max(1, 2, 3);
+```
+
+### JSON
+
+```typescript
+import { JSON } from "@tsonic/js";
+
+const obj = JSON.parse('{"key": "value"}');
+const str = JSON.stringify(obj);
+```
+
+## Naming Conventions
+
+- **Types**: PascalCase (matches .NET)
+- **Members**: camelCase (TypeScript convention)
+- **Global functions**: camelCase (JavaScript convention)
+
+Some members use a `_` suffix when they would otherwise conflict with a TypeScript keyword
+(for example: `Map.get_()` / `Map.set_()` / `Map.delete_()`).
+
+## Development
+
+### Regenerating Types
+
+To regenerate TypeScript declarations:
+
+```bash
+./__build/scripts/generate.sh
+```
+
+**Prerequisites:**
+- .NET 10 SDK installed
+- `tsbindgen` repository at `../tsbindgen`
+- `js-runtime` repository at `../js-runtime` (built with `dotnet build -c Release`)
+
+**Environment variables:**
+- `DOTNET_VERSION` - .NET runtime version (default: `10.0.0`)
+- `DOTNET_HOME` - .NET installation directory (default: `$HOME/.dotnet`)
+
+## License
+
+MIT

package/__build/scripts/generate.sh

@@ -0,0 +1,116 @@
+#!/bin/bash
+# Generate TypeScript declarations for @tsonic/js (JSRuntime library)
+#
+# This script regenerates all TypeScript type declarations from the
+# Tsonic.JSRuntime.dll assembly using tsbindgen.
+#
+# Prerequisites:
+#   - .NET 10 SDK installed
+#   - tsbindgen repository cloned at ../tsbindgen (sibling directory)
+#   - js-runtime repository cloned at ../js-runtime (sibling directory)
+#
+# Usage:
+#   ./__build/scripts/generate.sh
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+TSBINDGEN_DIR="$PROJECT_DIR/../tsbindgen"
+JS_RUNTIME_DIR="$PROJECT_DIR/../js-runtime"
+DOTNET_LIB="$PROJECT_DIR/../dotnet"
+CORE_LIB="$PROJECT_DIR/../core"
+
+# .NET runtime path (needed for BCL type resolution)
+DOTNET_VERSION="${DOTNET_VERSION:-10.0.0}"
+DOTNET_HOME="${DOTNET_HOME:-$HOME/.dotnet}"
+DOTNET_RUNTIME_PATH="$DOTNET_HOME/shared/Microsoft.NETCore.App/$DOTNET_VERSION"
+
+# Tsonic.JSRuntime.dll path
+JSRUNTIME_DLL="$JS_RUNTIME_DIR/artifacts/bin/Tsonic.JSRuntime/Release/net10.0/Tsonic.JSRuntime.dll"
+
+echo "================================================================"
+echo "Generating @tsonic/js TypeScript Declarations"
+echo "================================================================"
+echo ""
+echo "Configuration:"
+echo "  JSRuntime.dll: $JSRUNTIME_DLL"
+echo "  .NET Runtime:  $DOTNET_RUNTIME_PATH"
+echo "  BCL Library:   $DOTNET_LIB (external reference)"
+echo "  tsbindgen:     $TSBINDGEN_DIR"
+echo "  Output:        $PROJECT_DIR"
+echo "  Naming:        JS (camelCase)"
+echo ""
+
+# Verify prerequisites
+if [ ! -f "$JSRUNTIME_DLL" ]; then
+    echo "ERROR: Tsonic.JSRuntime.dll not found at $JSRUNTIME_DLL"
+    echo "Build it first: cd ../js-runtime && dotnet build -c Release"
+    exit 1
+fi
+
+if [ ! -d "$DOTNET_RUNTIME_PATH" ]; then
+    echo "ERROR: .NET runtime not found at $DOTNET_RUNTIME_PATH"
+    echo "Set DOTNET_HOME or DOTNET_VERSION environment variables"
+    exit 1
+fi
+
+if [ ! -d "$TSBINDGEN_DIR" ]; then
+    echo "ERROR: tsbindgen not found at $TSBINDGEN_DIR"
+    echo "Clone it: git clone https://github.com/tsoniclang/tsbindgen ../tsbindgen"
+    exit 1
+fi
+
+if [ ! -d "$DOTNET_LIB" ]; then
+    echo "ERROR: @tsonic/dotnet not found at $DOTNET_LIB"
+    echo "Clone it: git clone https://github.com/tsoniclang/dotnet ../dotnet"
+    exit 1
+fi
+
+if [ ! -d "$CORE_LIB" ]; then
+    echo "ERROR: @tsonic/core not found at $CORE_LIB"
+    echo "Clone it: git clone https://github.com/tsoniclang/core ../core"
+    exit 1
+fi
+
+# Clean output directory (keep config files)
+echo "[1/3] Cleaning output directory..."
+cd "$PROJECT_DIR"
+
+# Remove all namespace directories (but keep config files, __build, node_modules, .git)
+find . -maxdepth 1 -type d \
+    ! -name '.' \
+    ! -name '.git' \
+    ! -name '.tests' \
+    ! -name 'node_modules' \
+    ! -name '__build' \
+    -exec rm -rf {} \; 2>/dev/null || true
+
+# Remove generated files at root
+rm -f *.d.ts *.js 2>/dev/null || true
+
+echo "  Done"
+
+# Build tsbindgen
+echo "[2/3] Building tsbindgen..."
+cd "$TSBINDGEN_DIR"
+dotnet build src/tsbindgen/tsbindgen.csproj -c Release --verbosity quiet
+echo "  Done"
+
+# Generate types with JavaScript-style naming
+# Uses --lib to reference BCL types from @tsonic/dotnet instead of regenerating them
+# Uses --namespace-map to emit as index.d.ts/index.js for cleaner imports
+# Uses --flatten-class to export Globals methods as top-level functions
+echo "[3/3] Generating TypeScript declarations..."
+dotnet run --project src/tsbindgen/tsbindgen.csproj --no-build -c Release -- \
+    generate -a "$JSRUNTIME_DLL" -d "$DOTNET_RUNTIME_PATH" -o "$PROJECT_DIR" \
+    --lib "$DOTNET_LIB" \
+    --lib "$CORE_LIB" \
+    --naming js \
+    --namespace-map "Tsonic.JSRuntime=index" \
+    --flatten-class "Tsonic.JSRuntime.Globals"
+
+echo ""
+echo "================================================================"
+echo "Generation Complete"
+echo "================================================================"

package/families.json

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