DeltaScript 1.0.0 Stable

DeltaScript 1.0.0 — Initial Stable Release

• Date: 2025-10-31
• Package: deltascript@1.0.0
• CLI: dsc

Install

You can install globally or locally.

npm

Global:

npm install -g deltascript

Project:

npm install deltascript

Highlights

• Stable initial release of the language, CLI, and tooling.
• Comprehensive documentation and practical examples included.

Features

• CLI

  • dsc init: creates dsk.config.ds and ensures src/ exists.
  • dsc build: compiles all .ds to ESM .js in outDir.
  • dsc dev: watch mode with per-file debounce and concise output.
  • dsc <file.ds>: transpiles and runs a single .ds using a temporary .mjs (supports top‑level await and full interactivity).
  • -v / --version: prints DeltaScript version.
  • Flags:
    • --no-builtins: disable SpectralLogs integration and console tips.
    • --migrate-to-spec: rewrite console.* to spec.* automatically.
    • --spectral-cdn: force CDN imports for SpectralLogs.

• Language

  • Typed annotations with ::.
  • Types: num, str, mbool (true/false/maybe).
  • Arrays: arr, arr<T>.
  • Objects: obj.
  • Interfaces and classes.
  • func instead of function.
  • Default parameters; return types inferred.
  • Clear errors with code frames (file:line:col), colorized.

• Runner (single-file)

  • Outputs to a temporary .mjs to ensure ESM and top‑level await.
  • Interactive I/O preserved (e.g., await spec.input(...)).
  • Proper Ctrl+C forwarding and cleanup of temp files.

• SpectralLogs Integration

  • Auto integration:
    • Prefer package imports when available.
    • --spectral-cdn to use CDN.
    • No‑await shim fallback with spec.* (includes async spec.input).
  • Gentle warnings:
    • Concise, yellow warning per session/file for console.*.
    • Tip to use --migrate-to-spec when frequent.

• Documentation

  • README with logo and quick start.
  • docs/: CLI, language, types, config, SpectralLogs, examples.
  • Examples demonstrating functions, classes, control flow, interfaces, arrays, and structured logging.

Installation

• npm: npm i -g deltascript or npm i -D deltascript
• bun: bun add -g deltascript or bun add -d deltascript
• pnpm: pnpm add -g deltascript or pnpm add -D deltascript

Getting Started

• Initialize: dsc init
• Build: dsc build
• Watch: dsc dev
• Run single file: dsc ./src/main.ds

Status: release notes prepared for 1.0.0 (initial stable).