gram-lang/gram
Watch
1
0
Fork
You've already forked gram
 0
Code Issues 10 Pull requests Projects 1 Releases 17 Packages Wiki Activity Actions
17 releases 17 tags
  • v.1.0.0-beta.0 0d3452652a

    v.1.0.0-beta.0 Pre-release

    abiwab released this 2026-06-29 12:13:00 +02:00 | 333 commits to main since this release

    Release Notes - v1.0.0-beta.0

    The Missing Piece: Gram CLI and the Road to V1

    The whole ecosystem is finally coming to life. I'm introducing the official Gram CLI—the final piece of the puzzle that connects the language syntax, parser, kitchen analyzer, and ingredient database all together.

    Gram has finally reached a state that feels truly functional—at least, I hope so! All the core components are talking to each other, hopefully creating a unified recipe management system without too many hiccups. Hitting this milestone marks the transition into the beta phase. From here on out, my focus will shift to hunting down the inevitable bugs, fine-tuning the current features, and polishing the overall experience to get everything ready for the final v1.0.0 release.

    Say Hello to the Official Gram CLI (@gram/cli)

    The new CLI is, for now, the most practical tool for managing, compiling, and interacting with your recipes straight from the terminal.

    Project & Recipe Management

    • gram init: Scaffold a workspace (including AI provider setup).
    • gram import: Scrape and translate recipes from any URL into native .gram syntax.
    • gram build / scale / diff: Compile, scale (with visual diffs), or view a semantic "git diff" of your recipes.
    • gram format & watch: Auto-format your code and run a real-time validation daemon.
    • gram print & export: Generate print-ready HTML or markdown versions.

    Interactive Cooking & Search

    • gram cook: Your terminal cooking assistant, complete with a step-by-step interface and live background timers.
    • gram shop: Generate smart shopping lists sorted by supermarket aisles.
    • gram view: Render recipes beautifully right in your terminal.
    • gram suggest: Find recipes based on your fridge's contents using an alias-aware search engine.

    AI-Powered Database

    • gram db sync & merge: Automatically track new ingredients or integrate external community databases.
    • gram db lint: Clean up semantic duplicates and plural mistakes.
    • gram db enrich: Use AI to fetch missing nutrition facts, densities, tags, and categories.

    The Next-Gen VS Code Experience & Language Server

    I've completely overhauled the VS Code Extension, which now ships with a full Language Server (LSP) built right in.

    • Dynamic Live Preview & Macros: A real-time WebView panel renders your recipe as you type. It also integrates a Macros panel, and hovering over any ingredient reveals its complete nutritional table.
    • Smart Autocompletion & Navigation: You'll get contextual suggestions for ingredients, intermediate declarations, and canonical units. I've also added advanced navigation features like Go to Definition, Find All References, and Rename Symbol (fingers crossed they work smoothly on your projects).
    • Intelligent Assistance: The extension now provides real-time diagnostics, CodeLens actions, and Quick Fixes. It even uses fuzzy matching to suggest corrections for misspelled ingredients based on your database.

    What's New & What's Changed

    Language Evolution (Breaking Changes)

    The core grammar has gotten some updates to be a bit more intuitive and permissive.

    • Syntax Adjustments: I've made a few symbol changes to make the grammar cleaner and easier to read. Here is a quick before/after comparison:
    Feature Before (v0.10.0) Now (v1.0.0-beta)
    Single-word ingredients, cookware & intermediates @salt{} @salt (braces are optional)
    Temperatures !{200°C} °{200°C}
    Async Timers ~{10min}& ~&{10min}
    Retroplanning {T-2d} ~{-2d}
    Aliases [alias] :alias
    • Top-Level Support: You can now write comments and recipe steps globally, anywhere in the document (even before the first ## Section).
    • Identity Refinement: The @gram/compiler package has been renamed to @gram/kitchen to better fit the Gram language vibe. Visual tooling, documentation, and example recipes have all been updated to match these new grammar rules.

    Under the Hood Improvements

    • Architecture & Performance: I've wrapped up a major architecture refactoring and ESM migration, which brings some nice performance bumps and cleaner code across the monorepo.
    • Nutrition Standardization: The salt output field in NutritionMetrics has been renamed to sodium to align perfectly with the ingredient database schema.
    • General Polish: I've also pushed a ton of smaller fixes, tweaks, and overall improvements across the board to ensure everything runs as smoothly as possible.

    A Personal Note

    Reaching this beta is a pretty big deal for me. After all these months of thinking, designing, and coding, seeing everything click together into something somewhat functional is incredibly rewarding. Gram started as an idea, and now it's a real tool that actually works! I know there's still a lot to improve and refine (and probably quite a few edge cases I haven't thought of yet), but this is a huge step forward, and I'm genuinely excited to see where it goes from here. Cheers 🤙

    Downloads