@tishlang/tish-format 1.0.12 → 1.0.13

package/Cargo.toml

@@ -0,0 +1,49 @@
+[workspace]
+members = [
+    "crates/tish_build_utils",
+    "crates/tish_cranelift",
+    "crates/tish_cranelift_runtime",
+    "crates/tish_wasm_runtime",
+    "crates/tish_core",
+    "crates/tish_builtins",
+    "crates/tish_lexer",
+    "crates/tish_ast",
+    "crates/tish_parser",
+    "crates/tish_opt",
+    "crates/tish_eval",
+    "crates/tish_runtime",
+    "crates/tish_pg",
+    "crates/tish_compile",
+    "crates/tish_ui",
+    "crates/tish_jsx_web",
+    "crates/tish_compile_js",
+    "crates/tish_bytecode",
+    "crates/tish_compiler_wasm",
+    "crates/tish_vm",
+    "crates/tish_llvm",
+
+    "crates/tish_native",
+    "crates/tish_wasm",
+    "crates/tish",
+    "crates/js_to_tish",
+    "crates/tish_fmt",
+    "crates/tish_lint",
+    "crates/tish_lsp",
+    "crates/tish_resolve",
+    "crates/tishlang_cargo_bindgen",
+]
+resolver = "2"
+
+[workspace.package]
+version = "1.0.0"
+license-file = "LICENSE"
+repository = "https://github.com/tishlang/tish"
+
+[profile.release]
+lto = "thin"
+codegen-units = 1
+opt-level = 3
+
+[profile.bench]
+inherits = "release"
+debug = true

package/LICENSE

@@ -0,0 +1,13 @@
+Pay It Forward License (PIF)
+
+Copyright (c) 2025-present The Tish Project Authors
+
+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.
+
+This license includes a perpetual, worldwide, non-exclusive, royalty-free, irrevocable (except as stated below) grant for patent claims necessarily infringed by the use of the Software or any contributions submitted to it; terminating automatically when an entity initiates patent litigation (including a cross-claim or counterclaim) alleging that the Software or any portion thereof infringes a patent.
+
+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 non-infringement. 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.
+
+Recipients of the Software should pay it forward by contributing to the open-source community through actions including but not limited to providing code, documentation, tutorials, guides, support, feedback, or promoting open-source projects through advocacy or related efforts that advance innovation and community growth.

package/README.md

@@ -0,0 +1,138 @@
+<picture>
+  <img alt="Tishlang" src="https://tishlang.com/banner.png">
+</picture>
+
+# Tish
+
+<p>
+  <a href="https://npmjs.com/package/@tishlang/tish?activeTab=readme"><img src="https://img.shields.io/npm/v/@tishlang/tish?style=flat-square&colorA=1C1C1C&colorB=B688FF" alt="npm version" /></a>
+  <a href="https://npmcharts.com/compare/@tishlang/tish"><img src="https://img.shields.io/npm/dm/@tishlang/tish.svg?style=flat-square&colorA=1C1C1C&colorB=B688FF" alt="downloads" /></a>
+  <a href="https://nodejs.org/en/about/previous-releases"><img src="https://img.shields.io/node/v/@tishlang/tish.svg?style=flat-square&colorA=1C1C1C&colorB=B688FF" alt="node version"></a>
+  <a href="https://crates.io/crates/tishlang"><img src="https://img.shields.io/crates/v/tishlang?style=flat-square&colorA=1C1C1C&colorB=B688FF" alt="crate version" /></a>
+  <a href="https://github.com/tishlang/tish/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-PIF-blue.svg?style=flat-square&colorA=1C1C1C&colorB=B688FF" alt="license" /></a>
+
+</p>
+
+Tish is a TypeScript- and JavaScript-compatible language implemented in Rust. It is aimed at teams who want a familiar surface syntax, predictable semantics, and the option to ship either interpreted scripts or runtime free **native binaries**.
+
+The same source can run on a tree-walking interpreter, a bytecode VM, or compiled targets (native, WASM/WASI, and others). Network, filesystem, and process APIs are **feature-gated** so defaults stay safe. For the full syntax and semantics, see the canonical spec in-repo; for tutorials and reference, see [tishlang.com/docs](https://tishlang.com/docs).
+
+## 🔥 Features
+
+- **JS-like surface** — `let` / `const`, `fn`, arrows, template literals, async/await, modules, and a large slice of familiar builtins (`console`, `Math`, `JSON`, arrays, strings, objects).
+- **Two ways to run** — interpret for fast iteration (`tish run`, REPL); compile to native or WASM for distribution and performance (`tish build`).
+- **Memory-safe implementation** — Rust-hosted runtime and compiler pipeline; no GC in the host language for the toolchain itself.
+- **Secure by default** — I/O and platform APIs (`http`, `fs`, `process`, etc.) are opt-in via features.
+- **No `undefined`** — `null` only where JS would use undefined; strict equality (`===` / `!==`) without loose coercion.
+- **Optional types** — TypeScript-style annotations are parsed for tooling and future checking; see the language reference for status.
+
+Full specification: [docs/LANGUAGE.md](docs/LANGUAGE.md). Implementation status, gaps, and JS compatibility: [docs/plan-gap-analysis.md](docs/plan-gap-analysis.md).
+
+## 📚 Documentation
+
+User-facing guides and reference:
+
+| Section | Description |
+|---------|-------------|
+| [Getting started](https://tishlang.com/docs/getting-started/installation/) | Install Tish, build your first app |
+| [First app](https://tishlang.com/docs/getting-started/first-app/) | Run and build workflows, targets |
+| [Editor & IDE](https://tishlang.com/docs/getting-started/editor/) | VS Code, LSP, tasks, Neovim |
+| [Language server](https://tishlang.com/docs/reference/language-server/) | `tish-lsp` capabilities |
+| [Formatting](https://tishlang.com/docs/reference/formatting/) | `tish-fmt` |
+| [Linting](https://tishlang.com/docs/reference/linting/) | `tish-lint` |
+| [Interactive REPL](https://tishlang.com/docs/getting-started/repl/) | Multi-line input, completion, history |
+| [Language overview](https://tishlang.com/docs/language/overview/) | Syntax, keywords, semantics |
+| [Tish vs JavaScript](https://tishlang.com/docs/language/vs-javascript/) | Differences and additions from JS |
+| [Builtins](https://tishlang.com/docs/builtins/overview/) | Console, Math, JSON, Array, String, Object |
+| [Features (APIs)](https://tishlang.com/docs/features/http/) | `http`, `fs`, `process`, `regex` — feature-gated |
+| [Native backend](https://tishlang.com/docs/reference/native-backend/) | Rust, Cranelift, LLVM compilation |
+| [WASM targets](https://tishlang.com/docs/reference/wasm-targets/) | Web and WASI |
+| [Deploy](https://tishlang.com/docs/deploy/overview/) | Platform and hosting |
+
+### In-repo docs
+
+Contributor- and spec-oriented material in [docs/](docs/):
+
+| File | Purpose |
+|------|---------|
+| [LANGUAGE.md](docs/LANGUAGE.md) | Canonical language reference (syntax, semantics, builtins) |
+| [ecma-alignment.md](docs/ecma-alignment.md) | ECMA-262 / test262 mapping |
+| [plan-gap-analysis.md](docs/plan-gap-analysis.md) | Implementation audit, MVP checklist |
+| [architecture-next-steps.md](docs/architecture-next-steps.md) | Crate layout, design decisions |
+| [builtins-gap-analysis.md](docs/builtins-gap-analysis.md) | Builtins across Rust vs bytecode VM (Cranelift/WASI) |
+
+## 🛠️ Toolchain
+
+| Tool | Purpose |
+|------|---------|
+| **`tish`** | CLI — `run`, `repl`, `build`, `dump-ast` |
+| **`tish-fmt`** | Formatter |
+| **`tish-lint`** | Linter (`--format sarif` for code scanning) |
+| **`tish-lsp`** | Language server; uses `tish_fmt` / `tish_lint` as libraries |
+| **`tish-security/`** (sibling repo) | Rules & CI examples — clone next to `tish/` as `../tish-security` ([OpenGrep](https://github.com/opengrep/opengrep), ast-grep, Comby, Codacy scaffold, fixtures) |
+| **`tree-sitter-tish/`** | Tree-sitter grammar (editors, ast-grep, future OpenGrep integration) |
+| **VS Code extension** | [tish-vscode](https://github.com/tishlang/tish-vscode) — grammar, snippets, LSP client, tasks |
+
+Related docs on [tishlang.com](https://tishlang.com/docs): [Editor & IDE](https://tishlang.com/docs/getting-started/editor/), [Language server](https://tishlang.com/docs/reference/language-server/), [Formatting](https://tishlang.com/docs/reference/formatting/), [Linting](https://tishlang.com/docs/reference/linting/).
+
+## 📦 Installation
+
+Install globally:
+
+```sh
+brew tap tishlang/tish https://github.com/tishlang/tish
+brew install tish
+```
+
+Or locally with npm:
+
+```sh
+npm install @tishlang/tish
+```
+
+More options: [Installation](https://tishlang.com/docs/getting-started/installation/).
+
+## ⚡ Quick start
+
+```sh
+npx @tishlang/create-tish-app my-app
+cd my-app
+npx @tishlang/tish run src/main.tish
+```
+
+## ▶️ Run and build
+
+```tish
+// hello.tish
+fn greeting(name) = `Hello, ${name}!`
+console.log(greeting("World"))
+```
+
+```bash
+tish run hello.tish
+# Hello, World!
+
+tish build hello.tish -o hello
+./hello
+# Hello, World!
+```
+
+Native binaries are standalone (no Tish or Rust runtime required on the machine that runs them). Backends, flags, and WASM are covered in [First app](https://tishlang.com/docs/getting-started/first-app/), [Native backend](https://tishlang.com/docs/reference/native-backend/), and [WASM targets](https://tishlang.com/docs/reference/wasm-targets/).
+
+## 🤝 Contribution
+
+Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for building, testing, and code style. Tish is licensed under the [Pay It Forward License (PIF)](https://payitforwardlicense.com/).
+
+## 💪 Performance
+
+JavaScript equivalents live in `tests/core/*.js`. Compare Tish with Node.js or Bun:
+
+```bash
+./scripts/run_performance_manual.sh
+```
+
+Details: [docs/perf.md](docs/perf.md).
+
+## 📝 License
+
+Tish is licensed under the [Pay It Forward License (PIF)](https://payitforwardlicense.com/). See [LICENSE](LICENSE).

package/crates/js_to_tish/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "tishlang_js_to_tish"
+version = "0.1.0"
+edition = "2021"
+description = "Vanilla JavaScript to Tish AST converter"
+
+license-file = { workspace = true }
+repository = { workspace = true }
+[dependencies]
+oxc = { version = "0.121", features = ["semantic"] }
+tishlang_ast = { path = "../tish_ast", version = ">=0.1" }

package/crates/js_to_tish/README.md

@@ -0,0 +1,18 @@
+# js_to_tish
+
+Vanilla JavaScript to Tish AST converter. Parses JavaScript with OXC, runs semantic analysis, normalizes to Tish's model, and emits `tish_ast::Program`.
+
+## Usage
+
+```rust
+use js_to_tish;
+use tish_compile_js;
+
+let program = js_to_tish::convert(js_source)?;
+let js = tish_compile_js::compile(&program)?;  // output as JavaScript
+```
+
+## Output options
+
+- **JavaScript**: `tish_compile_js::compile(&program)` → `String`
+- **Bytecode (run)**: `tish_bytecode::compile(&program)` → `Chunk`, then `tish_vm::run(&chunk)`

package/crates/js_to_tish/src/error.rs

@@ -0,0 +1,55 @@
+//! Conversion error types.
+
+use std::fmt;
+
+/// Error returned when JS cannot be converted to Tish.
+#[derive(Debug)]
+pub struct ConvertError {
+    pub kind: ConvertErrorKind,
+}
+
+impl ConvertError {
+    pub fn new(kind: ConvertErrorKind) -> Self {
+        Self { kind }
+    }
+}
+
+impl fmt::Display for ConvertError {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.kind)
+    }
+}
+
+impl std::error::Error for ConvertError {}
+
+/// Categorizes conversion failures.
+#[derive(Debug)]
+pub enum ConvertErrorKind {
+    /// Parse error from OXC.
+    Parse(String),
+    /// Semantic analysis error from OXC.
+    Semantic(String),
+    /// Unsupported construct (class, this, for-in, etc.).
+    Unsupported { what: String, hint: Option<String> },
+    /// JS feature that cannot be expressed in Tish.
+    Incompatible { what: String, reason: String },
+}
+
+impl fmt::Display for ConvertErrorKind {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        match self {
+            ConvertErrorKind::Parse(s) => write!(f, "parse error: {s}"),
+            ConvertErrorKind::Semantic(s) => write!(f, "semantic error: {s}"),
+            ConvertErrorKind::Unsupported { what, hint } => {
+                write!(f, "unsupported: {what}")?;
+                if let Some(h) = hint {
+                    write!(f, " ({h})")?;
+                }
+                Ok(())
+            }
+            ConvertErrorKind::Incompatible { what, reason } => {
+                write!(f, "incompatible: {what} — {reason}")
+            }
+        }
+    }
+}

package/crates/js_to_tish/src/lib.rs

@@ -0,0 +1,11 @@
+//! Vanilla JavaScript to Tish AST converter.
+//!
+//! Parses JavaScript with OXC, runs semantic analysis for scope/hoisting,
+//! normalizes to Tish's simpler model, and emits Tish AST.
+
+mod error;
+mod span_util;
+mod transform;
+
+pub use error::{ConvertError, ConvertErrorKind};
+pub use transform::convert;

package/crates/js_to_tish/src/span_util.rs

@@ -0,0 +1,35 @@
+//! Span conversion from OXC offsets to Tish (line, col).
+
+use oxc::span::GetSpan;
+use tishlang_ast::Span;
+
+/// Convert OXC span (byte start/end) to Tish Span (line, col).
+/// Uses source text to compute line/column from offsets.
+pub fn oxc_span_to_tish<T: GetSpan>(source: &str, oxc_span: &T) -> Span {
+    let s = oxc_span.span();
+    let start = offset_to_line_col(source, s.start);
+    let end = offset_to_line_col(source, s.end);
+    Span { start, end }
+}
+
+/// Compute (line, col) for byte offset. Lines and columns are 0-based.
+fn offset_to_line_col(source: &str, offset: u32) -> (usize, usize) {
+    let offset = offset as usize;
+    if offset >= source.len() {
+        let lines = source.lines().count();
+        let last_line_len = source.lines().last().map(str::len).unwrap_or(0);
+        return (lines.saturating_sub(1), last_line_len);
+    }
+    let prefix = &source[..offset];
+    let line = prefix.lines().count().saturating_sub(1);
+    let col = prefix.lines().last().map(str::len).unwrap_or(0);
+    (line, col)
+}
+
+/// Stub span when source is not available (e.g. synthetic nodes).
+pub fn stub_span() -> Span {
+    Span {
+        start: (0, 0),
+        end: (0, 0),
+    }
+}