{"id":26607,"library":"vlaamscodex","title":"VlaamsCodex","description":"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.","status":"active","version":"0.2.5","language":"javascript","source_language":"en","source_url":"https://github.com/brentishere41848/Vlaams-Codex","tags":["javascript","platskript","vlaams","flemish","transpiler","compiler","dsl","python"],"install":[{"cmd":"npm install vlaamscodex","lang":"bash","label":"npm"},{"cmd":"yarn add vlaamscodex","lang":"bash","label":"yarn"},{"cmd":"pnpm add vlaamscodex","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The npm wrapper is ESM-only as of v0.2.0. The Python package is the primary distribution.","wrong":"const PlatsCompiler = require('vlaamscodex')","symbol":"PlatsCompiler","correct":"import { PlatsCompiler } from 'vlaamscodex'"},{"note":"Default export provides the CLI programmatically.","wrong":"const plats = require('vlaamscodex')","symbol":"plats","correct":"import plats from 'vlaamscodex'"},{"note":"Utility function is in a subpath export, not at the package root.","wrong":"import { runPlatsScript } from 'vlaamscodex'","symbol":"runPlatsScript","correct":"import { runPlatsScript } from 'vlaamscodex/utils'"}],"quickstart":{"code":"// Initialize and run a Platskript program programmatically\nimport { PlatsCompiler } from 'vlaamscodex';\nconst compiler = new PlatsCompiler();\nconst platsCode = `\nmaak funksie groet(d) doe\n  klap \"gdag \" + d\ndoen\ngroet(\"Alix\")\n`;\nconst output = await compiler.runString(platsCode);\nconsole.log(output); // Expected: \"gdag Alix\"\n// Or run a file:\n// await compiler.runFile('hello.plats');","lang":"typescript","description":"Demonstrates using the PlatsCompiler to compile and execute Platskript code from a string, with a function definition and invocation."},"warnings":[{"fix":"Install the Python package via pip for full CLI functionality: pip install vlaamscodex","message":"The npm wrapper vlaamscodex has limited support compared to the Python package; many features (e.g., multi-dialect CLI commands) are only available in Python.","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Install Python 3.10+ and add to PATH, or use the browser playground via Pyodide.","message":"The 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.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use English command 'plats run' or install the Python package.","message":"Calling the CLI via 'plats voertuut' (West-Vlaams) or other dialect aliases is not available in the npm wrapper; use the standard 'plats run' command.","severity":"deprecated","affected_versions":">=0.2.0"},{"fix":"Monitor PyPI for updates; the npm wrapper is a thin mirror.","message":"The package version in npm may lag behind PyPI. Check for latest Python release for new features.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Update Platskript source to use new keyword mappings or check release notes for dialect changes.","message":"From v0.2.0, the package changed from a mono-dialect to multi-dialect, breaking scripts that relied on old dialect-specific syntax.","severity":"breaking","affected_versions":"<0.2.0"},{"fix":"Ensure Python 3.10+ is installed and accessible.","message":"The 'plats fortune' and other easter egg commands may not work in the npm wrapper if Python is not available.","severity":"gotcha","affected_versions":">=0.2.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install Python 3.10+ from python.org and add to PATH, or use the browser playground.","cause":"The npm wrapper spawns a Python child process but cannot locate the Python executable.","error":"Error: Python not found. Install Python 3.10 or higher and ensure it is in your PATH."},{"fix":"Use correct spelling: 'maak funksie' for function definition. Check dialect mappings.","cause":"Typo in keyword: 'functie' instead of 'funktie' or 'funksie' depending on dialect.","error":"SyntaxError: Expected 'maak funksie' but found 'maak functie' on line 1"},{"fix":"Upgrade to >=0.2.0 or use compiler.transpile() instead.","cause":"Using an older version of the npm package (<0.2.0) that did not expose runString.","error":"TypeError: compiler.runString is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}