{"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,"search_vec":"'18':44 '7':22 'activ':14 'browser':55 'check':52 'code':11 'command':26 'compil':7,64 'develop':15 'dialect':9,24 'differenti':20 'distribut':30 'dsl':65 'error':28 'flemish':8,23,62 'includ':46 'interact':47 'javascript':59 'key':19 'keyword':10 'messag':29 'month':17 'node.js':43 'npm':40 'packag':34 'platskript':2,60 'playground':56 'project':49 'pyodid':58 'pypi':36 'python':13,33,66 'releas':18 'repl':48 'scaffold':50 'support':21 'syntax':51 'thin':39 'toolchain':4 'transpil':3,63 'user':45 'v0.2.5':5 'via':35,57 'vlaam':61 'vlaamscodex':1 'wrapper':41","created_at":"2026-05-01T13:50:51.813166+00:00","updated_at":"2026-05-01T13:50:51.813166+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"vlaamscodex","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/brentishere41848/Vlaams-Codex","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/vlaamscodex","openapi_spec":null,"status_page":null,"smithery":null,"categories":["serialization"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-05-01","next_check":"2026-07-30","install_tag":null}}