vlaamscodex

library0.2.5jsnpmunverified

Platskript transpiler toolchain (v0.2.5) that compiles Flemish dialect keyword code to Python. Active development with monthly releases. Key differentiator: supports 7 Flemish dialects for commands and error messages. Distributed as a Python package via PyPI, with a thin npm wrapper for Node.js (>=18) users. Includes interactive REPL, project scaffolding, syntax checking, and a browser playground via Pyodide.

serialization

npm install vlaamscodex

github ↗package ↗

INSTALL

IMPORT

SIG · VLAAMSCODEX

vlaamscodex

serializationjavascriptv0.2.5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

PlatsCompiler

✓ import { PlatsCompiler } from 'vlaamscodex'

✗ const PlatsCompiler = require('vlaamscodex')

The npm wrapper is ESM-only as of v0.2.0. The Python package is the primary distribution.

plats

✓ import plats from 'vlaamscodex'

✗ const plats = require('vlaamscodex')

Default export provides the CLI programmatically.

runPlatsScript

✓ import { runPlatsScript } from 'vlaamscodex/utils'

✗ import { runPlatsScript } from 'vlaamscodex'

Utility function is in a subpath export, not at the package root.

Demonstrates using the PlatsCompiler to compile and execute Platskript code from a string, with a function definition and invocation.

// Initialize and run a Platskript program programmatically import { PlatsCompiler } from 'vlaamscodex'; const compiler = new PlatsCompiler(); const platsCode = ` maak funksie groet(d) doe klap "gdag " + d doen groet("Alix") `; const output = await compiler.runString(platsCode); console.log(output); // Expected: "gdag Alix" // Or run a file: // await compiler.runFile('hello.plats');

vlaamscodex --version

Debug

Known issues

breakingThe npm wrapper vlaamscodex has limited support compared to the Python package; many features (e.g., multi-dialect CLI commands) are only available in Python.

fix

Install the Python package via pip for full CLI functionality: pip install vlaamscodex

affects: >=0.2.0

gotchaThe package uses a Python runtime under the hood (via child process or Pyodide). Ensure Python 3.10+ is installed when using Node.js wrapper without browser playground.

fix

Install Python 3.10+ and add to PATH, or use the browser playground via Pyodide.

affects: >=0.1.0

deprecatedCalling the CLI via 'plats voertuut' (West-Vlaams) or other dialect aliases is not available in the npm wrapper; use the standard 'plats run' command.

fix

Use English command 'plats run' or install the Python package.

affects: >=0.2.0

gotchaThe package version in npm may lag behind PyPI. Check for latest Python release for new features.

fix

Monitor PyPI for updates; the npm wrapper is a thin mirror.

affects: >=0.1.0

breakingFrom v0.2.0, the package changed from a mono-dialect to multi-dialect, breaking scripts that relied on old dialect-specific syntax.

fix

Update Platskript source to use new keyword mappings or check release notes for dialect changes.

affects: <0.2.0

gotchaThe 'plats fortune' and other easter egg commands may not work in the npm wrapper if Python is not available.

fix

Ensure Python 3.10+ is installed and accessible.

affects: >=0.2.0

Errors

Common errors & fixes

Error: Python not found. Install Python 3.10 or higher and ensure it is in your PATH.

The npm wrapper spawns a Python child process but cannot locate the Python executable.

fix

Install Python 3.10+ from python.org and add to PATH, or use the browser playground.

SyntaxError: Expected 'maak funksie' but found 'maak functie' on line 1

Typo in keyword: 'functie' instead of 'funktie' or 'funksie' depending on dialect.

fix

Use correct spelling: 'maak funksie' for function definition. Check dialect mappings.

TypeError: compiler.runString is not a function

Using an older version of the npm package (<0.2.0) that did not expose runString.

fix

Upgrade to >=0.2.0 or use compiler.transpile() instead.

Upgrade

Version history

0.2.5latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/brentishere41848/Vlaams-Codex ↗

packagehttps://www.npmjs.com/package/vlaamscodex ↗