added cli fix for compilation and help

.gitea/workflows/publish.yml

@@ -3,7 +3,8 @@ name: Publish
 on:
   push:
     tags:
-      - "v*"
+      - "foreignthon-v*"
+      - "foreignthon-*-v*"
 
 jobs:
   publish:
@@ -20,57 +21,67 @@ jobs:
       - name: Install build tools
         run: pip install build twine
 
-      - name: Build core package
+      - name: Determine what to build
-        run: python -m build packages/foreignthon
+        id: target
+        run: |
+          TAG=${GITHUB_REF#refs/tags/}
+          echo "Full tag: $TAG"
 
-      - name: Build Spanish pack
+          if [[ "$TAG" == "foreignthon-v"* ]]; then
-        run: python -m build packages/langs/es
+            # Core package: foreignthon-v0.2.0
+            echo "type=core" >> $GITHUB_OUTPUT
+            echo "path=packages/foreignthon" >> $GITHUB_OUTPUT
+            echo "name=foreignthon" >> $GITHUB_OUTPUT
+          elif [[ "$TAG" == "foreignthon-"*"-v"* ]]; then
+            # Lang pack: foreignthon-es-v0.1.0 → lang code is "es"
+            LANG=$(echo $TAG | sed 's/foreignthon-\(.*\)-v.*/\1/')
+            echo "type=lang" >> $GITHUB_OUTPUT
+            echo "path=packages/langs/$LANG" >> $GITHUB_OUTPUT
+            echo "name=foreignthon-$LANG" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Build package
+        run: python -m build ${{ steps.target.outputs.path }}
 
       - name: Publish to PyPI
         env:
           TWINE_USERNAME: __token__
           TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
-        run: |
+        run: twine upload --skip-existing ${{ steps.target.outputs.path }}/dist/*
-          twine upload --skip-existing packages/foreignthon/dist/*
-          twine upload --skip-existing packages/langs/es/dist/*
 
       - name: Create Gitea release with assets
         env:
           GIT_RELEASE_TOKEN: ${{ secrets.GIT_RELEASE_TOKEN }}
         run: |
           TAG=${GITHUB_REF#refs/tags/}
-          echo "Tag: $TAG"
 
-          # Delete existing release if any
           EXISTING=$(curl -s \
             -H "Authorization: token $GIT_RELEASE_TOKEN" \
             "${{ github.server_url }}/api/v1/repos/${{ github.repository }}/releases/tags/$TAG")
-          EXISTING_ID=$(echo $EXISTING | python -c "import sys,json; d=json.load(sys.stdin); print(d.get('id',''))" 2>/dev/null || echo "")
+          EXISTING_ID=$(echo $EXISTING | python -c \
+            "import sys,json; d=json.load(sys.stdin); print(d.get('id',''))" 2>/dev/null || echo "")
 
           if [ -n "$EXISTING_ID" ]; then
-            echo "Deleting existing release $EXISTING_ID"
             curl -s -X DELETE \
               -H "Authorization: token $GIT_RELEASE_TOKEN" \
               "${{ github.server_url }}/api/v1/repos/${{ github.repository }}/releases/$EXISTING_ID"
           fi
 
-          # Create fresh release
           RELEASE=$(curl -s -X POST \
             -H "Authorization: token $GIT_RELEASE_TOKEN" \
             -H "Content-Type: application/json" \
             -d "{
               \"tag_name\": \"$TAG\",
-              \"name\": \"$TAG\",
+              \"name\": \"${{ steps.target.outputs.name }} ${TAG##*-v}\",
-              \"body\": \"Release $TAG\",
+              \"body\": \"Release of ${{ steps.target.outputs.name }} ${TAG##*-v}\",
               \"draft\": false,
               \"prerelease\": false
             }" \
             "${{ github.server_url }}/api/v1/repos/${{ github.repository }}/releases")
 
-          echo "Release response: $RELEASE"
           RELEASE_ID=$(echo $RELEASE | python -c "import sys,json; print(json.load(sys.stdin)['id'])")
 
-          for FILE in packages/foreignthon/dist/* packages/langs/es/dist/*; do
+          for FILE in ${{ steps.target.outputs.path }}/dist/*; do
             echo "Uploading $FILE"
             curl -s -X POST \
               -H "Authorization: token $GIT_RELEASE_TOKEN" \

CONTRIBUTING.md

@@ -1,51 +0,0 @@
-# Contributing to ForeignThon
-
-## Project structure
-foreignthon/
-├── packages/
-│   ├── foreignthon/          # core engine + fpy CLI
-│   │   ├── src/foreignthon/
-│   │   │   ├── cli.py        # fpy commands
-│   │   │   ├── transpiler.py # tokenizer-based transpiler
-│   │   │   ├── pack.py       # language pack loader
-│   │   │   └── errors.py     # bilingual error hook
-│   │   └── tests/
-│   └── langs/
-│       └── es/               # Spanish language pack
-│           └── src/foreignthon_es/es.json
-
-## Setting up
-
-```bash
-python -m venv .venv && source .venv/bin/activate
-pip install -e "packages/foreignthon[dev]"
-pip install -e packages/langs/es
-```
-
-## Running tests
-
-```bash
-pytest packages/foreignthon/tests/ -v
-```
-
-## Adding a new language pack
-
-1. Copy `packages/langs/es/` to `packages/langs/<code>/`
-2. Rename `foreignthon_es` → `foreignthon_<code>` throughout
-3. Fill in `<code>.json` following the same schema as `es.json`
-4. Validate it: `fpy pack packages/langs/<code>/src/foreignthon_<code>/<code>.json`
-5. Add tests if the language has tricky characters or edge cases
-6. Open a PR or publish independently as `foreignthon-<code>` on PyPI
-
-## Language pack schema
-
-Every pack must have these top-level keys:
-`meta`, `keywords`, `builtins`, `exceptions`, `error_messages`, `stdlib`
-
-See `packages/langs/es/src/foreignthon_es/es.json` as the reference.
-
-## Code style
-
-```bash
-ruff check packages/foreignthon/src
-```

README.md

@@ -1,7 +1,8 @@
-DME.md << 'EOF'
 # ForeignThon
 
-Write Python in any human language. ForeignThon transpiles `.es.py`, `.ta.py` (and more) files into standard Python — keywords, builtins, exceptions, all of it.
+Write Python in any human language.
+
+ForeignThon transpiles `.es.py`, `.ta.py` (and more) into standard Python. Keywords, builtins, exceptions — all translated. Errors come back in your language too.
 
 ```python
 # hola.es.py
@@ -19,7 +20,7 @@ fpy run hola.es.py
 # Hola, mundo 2!
 ```
 
-## Installation
+## Install
 
 ```bash
 pip install foreignthon
@@ -27,62 +28,13 @@ pip install foreignthon-es   # Spanish
 pip install foreignthon-ta   # Tamil
 ```
 
-## Usage
+## Docs
 
-```bash
+- [Getting Started](docs/getting-started.md)
-fpy run script.es.py            # transpile and run
+- [Language Packs](docs/language-packs.md)
-fpy compile script.es.py        # output a .compiled.py file
+- [Postfix Syntax](docs/postfix-syntax.md)
-fpy check script.es.py          # validate without running
+- [Contributing](docs/contributing.md)
-fpy pack mylang.json            # validate a language pack
+- [Releasing](docs/releasing.md)
-```
-
-### Language override
-
-```python
-# foreignthon: es
-# ^ overrides the file extension
-```
-
-Or via CLI flag:
-
-```bash
-fpy run script.py --lang es
-```
-
-## Errors
-
-Errors are shown in your language first, English below:
-[ES] ErrorDeDivisionCero: Error: división por cero
-[EN] ZeroDivisionError: division by zero
-
-## Language Packs
-
-A language pack is a JSON file + a tiny Python wrapper published as `foreignthon-xx` on PyPI.
-See `packages/langs/es/` for the reference implementation.
-
-The JSON covers:
-- **keywords** — `si → if`, `para → for`, `definir → def` …
-- **builtins** — `imprimir → print`, `rango → range` …
-- **exceptions** — `ErrorDeValor → ValueError` …
-- **error_messages** — bilingual error output
-- **stdlib** — `matematicas → math` …
-
-Validate your pack before publishing:
-
-```bash
-fpy pack mylang.json
-```
-
-## Development
-
-```bash
-git clone <your-repo>
-cd foreignthon
-python -m venv .venv && source .venv/bin/activate
-pip install -e "packages/foreignthon[dev]"
-pip install -e packages/langs/es
-pytest packages/foreignthon/tests/ -v
-```
 
 ## License
 

docs/contributing.md

@@ -0,0 +1,63 @@
+# Contributing
+
+## Project structure
+```
+foreignthon/
+├── packages/
+│   ├── foreignthon/               # core engine + fpy CLI
+│   │   ├── src/foreignthon/
+│   │   │   ├── cli.py             # fpy commands
+│   │   │   ├── transpiler.py      # tokenizer-based transpiler + @@ pre-pass
+│   │   │   ├── pack.py            # language pack loader + entry point discovery
+│   │   │   └── errors.py          # bilingual error hook
+│   │   └── tests/
+│   └── langs/
+│       ├── es/                    # foreignthon-es (Spanish)
+│       └── ta/                    # foreignthon-ta (Tamil)
+├── docs/
+└── .gitea/workflows/
+├── ci.yml                     # runs tests + lint on every push
+└── publish.yml                # builds + publishes to PyPI on git tag
+```
+
+## How the transpiler works
+
+1. **Pre-pass** — scans for `@@keyword` postfix syntax and rewrites lines to prefix form
+2. **Tokenizer** — uses Python's `tokenize` module to swap `NAME` tokens. Strings and comments are never touched.
+3. **Runner** — compiles with the original filename so tracebacks point to your `.es.py` file, not a temp file
+
+## Setup
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e "packages/foreignthon[dev]"
+pip install -e packages/langs/es
+pip install -e packages/langs/ta
+```
+
+## Running tests
+
+```bash
+pytest packages/foreignthon/tests/ -v
+```
+
+## Linting
+
+```bash
+ruff check packages/foreignthon/src
+```
+
+## Adding a language pack
+
+See [language-packs.md](language-packs.md) for the full guide.
+
+## CI
+
+Every push to `main` runs tests and lint (non-blocking). Releases are triggered by pushing a git tag — see [releasing.md](releasing.md).
+
+## Submitting changes
+
+1. Fork the repo
+2. Create a branch
+3. Make your changes + add tests if relevant
+4. Open a pull request against `main`

docs/getting-started.md

@@ -0,0 +1,80 @@
+# Getting Started
+
+## Installation
+
+```bash
+pip install foreignthon
+pip install foreignthon-es   # add Spanish
+pip install foreignthon-ta   # add Tamil
+```
+
+For CLI use across projects, prefer pipx:
+
+```bash
+pipx install foreignthon
+```
+
+## Writing a file
+
+Name your file `script.<lang>.py` — the extension tells ForeignThon which language pack to use.
+
+```python
+# script.es.py
+definir sumar(a, b):
+    retornar a + b
+
+para i en rango(5):
+    imprimir(sumar(i, 1))
+```
+
+## Running
+
+```bash
+fpy run script.es.py        # transpile and run
+fpy compile script.es.py    # output a .compiled.py file
+fpy check script.es.py      # validate without running
+```
+
+## Overriding the language
+
+Via shebang comment at the top of the file:
+
+```python
+# foreignthon: es
+```
+
+Or via CLI flag:
+
+```bash
+fpy run script.py --lang es
+```
+
+## Errors
+
+Errors are shown in your language first, English below:
+[ES] ErrorDeDivisionCero: Error: división por cero
+[EN] ZeroDivisionError: division by zero
+File "script.es.py", line 3
+
+## Variable names
+
+Variable names are optional — you can use English or your language freely:
+
+```python
+# both work fine in the same file
+definir calculate(anchura, altura):
+    area = anchura * altura
+    retornar area
+```
+
+## Local dev setup
+
+```bash
+git clone <repo>
+cd foreignthon
+python -m venv .venv && source .venv/bin/activate
+pip install -e "packages/foreignthon[dev]"
+pip install -e packages/langs/es
+pip install -e packages/langs/ta
+pytest packages/foreignthon/tests/ -v
+```

docs/language-packs.md

@@ -0,0 +1,69 @@
+# Language Packs
+
+A language pack is a JSON file that maps foreign tokens to Python equivalents, published as `foreignthon-<code>` on PyPI.
+
+## Available packs
+
+| Package | Language | Install |
+|---|---|---|
+| `foreignthon-es` | Spanish | `pip install foreignthon-es` |
+| `foreignthon-ta` | Tamil | `pip install foreignthon-ta` |
+
+## JSON schema
+
+Every pack must have these top-level keys:
+
+```json
+{
+  "meta": {
+    "name": "Spanish",
+    "native_name": "Español",
+    "code": "es",
+    "version": "0.1.0",
+    "authors": []
+  },
+  "keywords":      { "si": "if", "para": "for", ... },
+  "builtins":      { "imprimir": "print", "rango": "range", ... },
+  "exceptions":    { "ErrorDeValor": "ValueError", ... },
+  "error_messages":{ "ValueError": "Error de valor", ... },
+  "stdlib":        { "matematicas": "math", ... }
+}
+```
+
+- **keywords** — Python reserved words (`if`, `for`, `def`, `class` …)
+- **builtins** — built-in functions (`print`, `range`, `len` …)
+- **exceptions** — built-in exception names (`ValueError`, `TypeError` …)
+- **error_messages** — translations for bilingual error output
+- **stdlib** — common standard library module names (`math`, `sys` …)
+
+Third-party library names (numpy, pandas etc.) are out of scope.
+
+## Creating a pack
+
+1. Copy `packages/langs/es/` to `packages/langs/<code>/`
+2. Rename every `foreignthon_es` → `foreignthon_<code>`
+3. Fill in `<code>.json` following the schema above
+4. Validate: `fpy pack packages/langs/<code>/src/foreignthon_<code>/<code>.json`
+5. Install locally: `pip install -e packages/langs/<code>`
+6. Test: `fpy run myscript.<code>.py`
+
+## Publishing a pack
+
+```bash
+python -m build packages/langs/<code>
+twine upload packages/langs/<code>/dist/*
+```
+
+Anyone can publish an independent `foreignthon-<code>` pack — you don't need to be a core maintainer.
+
+## How discovery works
+
+Packs register themselves via Python entry points:
+
+```toml
+# in the pack's pyproject.toml
+[project.entry-points."foreignthon.langs"]
+es = "foreignthon_es"
+```
+
+The core finds all installed packs automatically — no config needed.

docs/postfix-syntax.md

@@ -0,0 +1,49 @@
+# Postfix Syntax
+
+Some languages (like Tamil) are grammatically SOV — the condition comes before the keyword, not after. ForeignThon supports this with the `@@` operator.
+
+## How it works
+
+```python
+# Standard prefix (works in every language)
+si x > 0:
+    imprimir(x)
+
+# Postfix with @@
+x > 0 @@si:
+    imprimir(x)
+```
+
+Both produce identical Python: `if x > 0:`. The `@@` means "take whatever is to my left, put the keyword first".
+
+## Rules
+
+- `@@` only rewrites the line it appears on — nothing else changes
+- Indentation rules are identical to normal Python
+- Prefix and postfix can be mixed freely in the same file
+- Works for any keyword in any language pack
+
+## Examples
+
+```python
+# if / else
+x > 0 @@si:
+    imprimir(x)
+sino:
+    pasar
+
+# while
+contador < 10 @@mientras:
+    contador += 1
+
+# inside a function — indentation unchanged
+definir comprobar(x):
+    x > 0 @@si:
+        imprimir("positivo")
+    sino:
+        imprimir("negativo")
+```
+
+## Why @@
+
+`@@` is not valid Python syntax so it never conflicts with existing code. Single `@` is used for decorators and matrix multiplication, so it was ruled out.

packages/foreignthon/pyproject.toml

@@ -4,18 +4,18 @@ build-backend = "hatchling.build"
 
 [project]
 name = "foreignthon"
-version = "0.1.0"
+version = "0.3.0"
 description = "Write Python in any language. Transpiles foreign-language .xx.py files to standard Python."
-license = { text = "MIT" }
+license = { text = "GPL v3" }
 requires-python = ">=3.9"
 authors = [
-  { name = "Your Name", email = "you@example.com" }
+  { name = "Keshav Anand", email = "keshavanand.dev@gmail.com" }
 ]
 keywords = ["python", "transpiler", "i18n", "localization", "language"]
 classifiers = [
   "Development Status :: 3 - Alpha",
   "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
+  "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",

packages/foreignthon/src/foreignthon/cli.py

@@ -9,15 +9,17 @@ from . import __version__
 from .errors import activate
 from .transpiler import run_transpiled, transpile_file
 
+CONTEXT_SETTINGS = dict(help_option_names=["-h", "--help"])
 
-@click.group()
+
+@click.group(context_settings=CONTEXT_SETTINGS)
 @click.version_option(__version__, prog_name="fpy")
 def main():
     """ForeignThon — write Python in any language."""
     pass
 
 
-@main.command()
+@main.command(context_settings=CONTEXT_SETTINGS)
 @click.argument("file", type=click.Path(exists=True, path_type=Path))
 @click.option("--lang", "-l", default=None, help="Override language code (e.g. es, ta)")
 @click.option("--keep", is_flag=True, help="Keep the compiled .py alongside the source")
@@ -29,11 +31,11 @@ def run(file: Path, lang: str | None, keep: bool):
             source = f"# foreignthon: {lang}\n" + source
             file.write_text(source, encoding="utf-8")
 
-    transpiled = transpile_file(file)
-
     detected_lang = lang or _lang_from_file(file)
     activate(detected_lang)
 
+    transpiled = transpile_file(file)
+
     if keep:
         out_path = file.with_suffix("").with_suffix(".compiled.py")
         out_path.write_text(transpiled, encoding="utf-8")
@@ -42,22 +44,41 @@ def run(file: Path, lang: str | None, keep: bool):
     run_transpiled(file, transpiled)
 
 
-@main.command()
+@main.command(context_settings=CONTEXT_SETTINGS)
 @click.argument("file", type=click.Path(exists=True, path_type=Path))
-@click.option("--output", "-o", default=None, help="Output path (default: beside source)")
+@click.option(
+    "--output", "-o", default=None,
+    help="Output file or directory. Defaults to same directory as source."
+)
 def compile(file: Path, output: str | None):
-    """Transpile a file to standard Python without running it."""
+    """
+    Transpile a foreign-language file to standard Python.
+
+    Output can be a file path or a directory:
+
+    \b
+    fpy compile script.es.py              # → script.compiled.py
+    fpy compile script.es.py -o out/      # → out/script.compiled.py
+    fpy compile script.es.py -o out.py    # → out.py
+    """
     transpiled = transpile_file(file)
 
-    out_path = (
+    if output is None:
-        Path(output) if output
+        out_path = file.with_suffix("").with_suffix(".compiled.py")
-        else file.with_suffix("").with_suffix(".compiled.py")
+    else:
-    )
+        out = Path(output)
+        if out.is_dir() or str(output).endswith("/"):
+            out.mkdir(parents=True, exist_ok=True)
+            out_path = out / file.with_suffix("").with_suffix(".compiled.py").name
+        else:
+            out_path = out
+
+    out_path.parent.mkdir(parents=True, exist_ok=True)
     out_path.write_text(transpiled, encoding="utf-8")
     click.echo(f"Compiled: {out_path}")
 
 
-@main.command()
+@main.command(context_settings=CONTEXT_SETTINGS)
 @click.argument("file", type=click.Path(exists=True, path_type=Path))
 def check(file: Path):
     """Validate a foreign-language file without running it."""
@@ -75,7 +96,7 @@ def check(file: Path):
         sys.exit(1)
 
 
-@main.command("pack")
+@main.command("pack", context_settings=CONTEXT_SETTINGS)
 @click.argument("json_file", type=click.Path(exists=True, path_type=Path))
 def validate_pack(json_file: Path):
     """Validate a language pack JSON file."""

packages/foreignthon/src/foreignthon/transpiler.py

@@ -1,12 +1,50 @@
 from __future__ import annotations
 
 import io
+import re
 import tokenize
 from pathlib import Path
 
 from .pack import load_pack
 
 
+def _apply_postfix_syntax(source: str, mapping: dict) -> str:
+    """
+    Pre-tokenizer pass: handle postfix @@ keyword syntax.
+    x > 0 @@ஆனால்:  →  ஆனால் x > 0:
+    Indentation is preserved by separating it before rewriting.
+    """
+    if "@@" not in source:
+        return source
+
+    kw_pattern = "|".join(re.escape(k) for k in sorted(mapping, key=len, reverse=True))
+    postfix_re = re.compile(rf"(.+?)@@({kw_pattern})")
+
+    lines = source.splitlines(keepends=True)
+    result = []
+
+    for line in lines:
+        if "@@" not in line:
+            result.append(line)
+            continue
+
+        # Separate indentation from content so we never lose it
+        stripped = line.lstrip()
+        indent = line[: len(line) - len(stripped)]
+        ending = "\n" if stripped.endswith("\n") else ""
+        content = stripped.rstrip("\n")
+
+        def _replace(m: re.Match) -> str:
+            expr = m.group(1).strip()
+            kw = m.group(2)
+            return f"{kw} {expr}"
+
+        rewritten = indent + postfix_re.sub(_replace, content) + ending
+        result.append(rewritten)
+
+    return "".join(result)
+
+
 def transpile(source: str, lang_code: str) -> str:
     """
     Transpile foreign-language Python source to standard Python.
@@ -14,22 +52,21 @@ def transpile(source: str, lang_code: str) -> str:
     """
     pack = load_pack(lang_code)
 
-    # Build a single flat lookup: foreign token -> English token
     mapping: dict[str, str] = {}
     mapping.update(pack["keywords"])
     mapping.update(pack["builtins"])
     mapping.update(pack["exceptions"])
     mapping.update(pack["stdlib"])
 
+    source = _apply_postfix_syntax(source, mapping)
+
     tokens_in = tokenize.generate_tokens(io.StringIO(source).readline)
     result: list[str] = []
-
     prev_end = (1, 0)
 
     for tok in tokens_in:
         tok_type, tok_string, tok_start, tok_end, _ = tok
 
-        # Preserve original whitespace/indentation between tokens
         start_row, start_col = tok_start
         end_row, end_col = prev_end
 
@@ -39,7 +76,6 @@ def transpile(source: str, lang_code: str) -> str:
             result.append("\n" * (start_row - end_row))
             result.append(" " * start_col)
 
-        # Only swap NAME tokens — leaves strings, comments, ops untouched
         if tok_type == tokenize.NAME and tok_string in mapping:
             result.append(mapping[tok_string])
         else:
@@ -51,47 +87,26 @@ def transpile(source: str, lang_code: str) -> str:
 
 
 def transpile_file(path: Path) -> str:
-    """
-    Detect language from file extension (.es.py -> es),
-    read the file, and return transpiled Python source.
-    """
     lang_code = _detect_lang(path)
     source = path.read_text(encoding="utf-8")
-
-    # Allow shebang-style override: # foreignthon: fr
     lang_code = _check_shebang(source, lang_code)
-
     return transpile(source, lang_code)
 
 
 def run_transpiled(original_path: Path, transpiled: str) -> None:
-    """
-    Execute transpiled source while making tracebacks point
-    to the original .es.py file, not a temp file.
-    """
     import linecache
 
     filename = str(original_path.resolve())
-
-    # Register original source lines so traceback displays them correctly
     original_lines = original_path.read_text(encoding="utf-8").splitlines(keepends=True)
-    linecache.cache[filename] = (
+    linecache.cache[filename] = (len(original_lines), None, original_lines, filename)
-        len(original_lines),
-        None,
-        original_lines,
-        filename,
-    )
 
-    # Compile with original filename — this is what sets it in the traceback
     code = compile(transpiled, filename, "exec")
-
     glob = {"__file__": filename, "__name__": "__main__"}
     exec(code, glob)
 
 
 def _detect_lang(path: Path) -> str:
-    """Extract lang code from extension, e.g. script.es.py -> es."""
+    suffixes = path.suffixes
-    suffixes = path.suffixes  # e.g. ['.es', '.py']
     if len(suffixes) >= 2 and suffixes[-1] == ".py":
         return suffixes[-2].lstrip(".")
     raise ValueError(
@@ -101,7 +116,6 @@ def _detect_lang(path: Path) -> str:
 
 
 def _check_shebang(source: str, default: str) -> str:
-    """Check first line for # foreignthon: <lang> override."""
     first_line = source.splitlines()[0] if source else ""
     if first_line.startswith("# foreignthon:"):
         return first_line.split(":", 1)[1].strip()

packages/foreignthon/tests/test_transpiler.py

@@ -102,3 +102,35 @@ def test_shebang_override():
 
 def test_shebang_default_when_absent():
     assert _check_shebang("si x:\n    pasar", "es") == "es"
+
+
+# ---------------------------------------------------------------------------
+# Postfix @@ syntax
+# ---------------------------------------------------------------------------
+
+def test_postfix_if():
+    out = es("x = 5\nx > 0 @@si:\n    imprimir(x)")
+    assert "if" in out
+    assert "@@" not in out
+
+def test_postfix_preserves_indentation():
+    src = (
+        "definir comprobar(x):\n"
+        "    x > 0 @@si:\n"
+        "        imprimir(x)\n"
+        "    sino:\n"
+        "        pasar\n"
+    )
+    out = es(src)
+    ast.parse(out)  # fails if indentation is broken
+
+def test_prefix_still_works_alongside_postfix():
+    src = (
+        "si x > 0:\n"
+        "    imprimir(x)\n"
+        "y < 0 @@si:\n"
+        "    imprimir(y)\n"
+    )
+    out = es(src)
+    assert out.count("if") == 2
+    assert "@@" not in out

packages/langs/es/pyproject.toml

@@ -4,19 +4,15 @@ build-backend = "hatchling.build"
 
 [project]
 name = "foreignthon-es"
-version = "0.1.0"
+version = "0.1.1"
 description = "Spanish language pack for ForeignThon."
-license = { text = "MIT" }
+license = { text = "GPL v3" }
 requires-python = ">=3.9"
 authors = [
-  { name = "Your Name", email = "you@example.com" }
+  { name = "Keshav Anand", email = "keshavanand.dev@gmail.com" }
 ]
 keywords = ["foreignthon", "spanish", "español"]
-classifiers = [
+
-  "Development Status :: 3 - Alpha",
-  "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
-]
 dependencies = [
   "foreignthon>=0.1.0",
 ]

packages/langs/ta/README.md

@@ -0,0 +1 @@
+# foreignthon-ta

packages/langs/ta/pyproject.toml

@@ -4,23 +4,15 @@ build-backend = "hatchling.build"
 
 [project]
 name = "foreignthon-ta"
-version = "0.1.0"
+version = "0.1.1"
 description = "Tamil language pack for ForeignThon."
-readme = "README.md"
+license = { text = "GPL v3" }
-license = { text = "MIT" }
 requires-python = ">=3.9"
 authors = [
-  { name = "Your Name", email = "you@example.com" }
+  { name = "Keshav Anand", email = "keshavanand.dev@gmail.com" }
 ]
 keywords = ["foreignthon", "tamil", "தமிழ்"]
-classifiers = [
+dependencies = ["foreignthon>=0.1.0"]
-  "Development Status :: 3 - Alpha",
-  "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
-]
-dependencies = [
-  "foreignthon>=0.1.0",
-]
 
 [project.entry-points."foreignthon.langs"]
 ta = "foreignthon_ta"

packages/langs/ta/src/foreignthon_ta/__init__.py

@@ -0,0 +1,4 @@
+from importlib.resources import files
+
+def get_pack_path():
+    return files(__name__) / "ta.json"

packages/langs/ta/src/foreignthon_ta/ta.json

@@ -0,0 +1,130 @@
+{
+  "meta": {
+    "name": "Tamil",
+    "native_name": "தமிழ்",
+    "code": "ta",
+    "version": "0.1.0",
+    "authors": []
+  },
+  "keywords": {
+    "ஆனால்": "if",
+    "இல்லையெனில்": "else",
+    "இல்லெனில்": "elif",
+    "ஒவ்வொன்றும்": "for",
+    "தொடர்": "while",
+    "வரையறு": "def",
+    "வகுப்பு": "class",
+    "திரும்ப": "return",
+    "நிறுத்து": "break",
+    "தொடரவும்": "continue",
+    "கடந்துசெல்": "pass",
+    "முயற்சி": "try",
+    "தவிர": "except",
+    "இறுதியில்": "finally",
+    "எழுப்பு": "raise",
+    "உடன்": "with",
+    "இறக்கு": "import",
+    "இருந்து": "from",
+    "என": "as",
+    "உள்ளே": "in",
+    "ஆகும்": "is",
+    "மற்றும்": "and",
+    "அல்லது": "or",
+    "இல்லை": "not",
+    "நீக்கு": "del",
+    "உலகளாவிய": "global",
+    "உள்ளூர்சாரா": "nonlocal",
+    "உறுதிப்படுத்து": "assert",
+    "வழங்கு": "yield",
+    "காத்திரு": "await",
+    "ஒத்திசைவற்ற": "async",
+    "சிறுசார்பு": "lambda",
+    "உண்மை": "True",
+    "பொய்": "False",
+    "ஒன்றுமில்லை": "None"
+  },
+  "builtins": {
+    "அச்சிடு": "print",
+    "உள்ளீடு": "input",
+    "நீளம்": "len",
+    "வரம்பு": "range",
+    "வகை": "type",
+    "முழுஎண்": "int",
+    "மிதவை": "float",
+    "சரம்": "str",
+    "பட்டியல்": "list",
+    "அகராதி": "dict",
+    "கணம்": "set",
+    "தொகுப்பு": "tuple",
+    "உண்மைவகை": "bool",
+    "திற": "open",
+    "எண்ணிட": "enumerate",
+    "மேப்": "map",
+    "வடிகட்டு": "filter",
+    "வரிசைப்படுத்து": "sorted",
+    "கூட்டுத்தொகை": "sum",
+    "குறைந்தபட்சம்": "min",
+    "அதிகபட்சம்": "max",
+    "தனிமதிப்பு": "abs",
+    "சுற்று": "round",
+    "அனைத்தும்": "all",
+    "ஏதாவது": "any",
+    "அடுத்தது": "next",
+    "எண்": "id",
+    "எழுத்து": "chr",
+    "தலைகீழ்": "reversed"
+  },
+  "exceptions": {
+    "விதிவிலக்கு": "Exception",
+    "அடிப்படைவிதிவிலக்கு": "BaseException",
+    "மதிப்புபிழை": "ValueError",
+    "வகைபிழை": "TypeError",
+    "திறவுகோல்பிழை": "KeyError",
+    "குறியீட்டுபிழை": "IndexError",
+    "பண்புபிழை": "AttributeError",
+    "பெயர்பிழை": "NameError",
+    "இறக்குமதிபிழை": "ImportError",
+    "கோப்புகிடைக்கவில்லை": "FileNotFoundError",
+    "இயக்கநேரபிழை": "RuntimeError",
+    "பூஜ்யபிரிவுபிழை": "ZeroDivisionError",
+    "தொடரியல்பிழை": "SyntaxError",
+    "உறுதிப்பாட்டுபிழை": "AssertionError",
+    "நினைவகபிழை": "MemoryError",
+    "மிகைபிழை": "OverflowError",
+    "சுழல்பிழை": "RecursionError",
+    "அனுமதிபிழை": "PermissionError",
+    "நேரமுடிந்தது": "TimeoutError",
+    "கணினிவெளியேறு": "SystemExit",
+    "விசைகுறுக்கீடு": "KeyboardInterrupt"
+  },
+  "error_messages": {
+    "SyntaxError": "தொடரியல் பிழை",
+    "ValueError": "மதிப்பு பிழை",
+    "TypeError": "வகை பிழை",
+    "KeyError": "திறவுகோல் பிழை",
+    "IndexError": "குறியீட்டு பிழை",
+    "AttributeError": "பண்பு பிழை",
+    "NameError": "பெயர் பிழை",
+    "ImportError": "இறக்குமதி பிழை",
+    "FileNotFoundError": "கோப்பு கிடைக்கவில்லை",
+    "ZeroDivisionError": "பூஜ்யத்தால் வகுக்க முடியாது",
+    "RecursionError": "சுழல் பிழை",
+    "RuntimeError": "இயக்க நேர பிழை",
+    "MemoryError": "நினைவக பிழை",
+    "OverflowError": "மிகை பிழை",
+    "AssertionError": "உறுதிப்பாட்டு பிழை",
+    "PermissionError": "அனுமதி பிழை",
+    "TimeoutError": "நேரம் முடிந்தது",
+    "KeyboardInterrupt": "விசை குறுக்கீடு"
+  },
+  "stdlib": {
+    "கணிதம்": "math",
+    "கணினி": "sys",
+    "தேதிநேரம்": "datetime",
+    "நேரம்": "time",
+    "சீரற்ற": "random",
+    "தொகுப்புகள்": "collections",
+    "பாதை": "pathlib",
+    "வழக்கமொழி": "re"
+  }
+}