Stone

Machine Programming Language

A language where punctuation becomes poetry, and every symbol carries the weight of intention.

Philosophy

Stone is built on the belief that programming languages should be as deliberate and meaningful as the problems they solve.

Intentional

Every mark serves a purpose. No syntax without meaning.

Expressive

Code that speaks its intent through careful punctuation.

Enduring

Built to last, like words carved in stone.

Elegant

Simplicity in form, power in expression.

Core Syntax

The fundamental structure of a Stone command, built with intention.

Command Blueprint

Understanding the anatomy of a Stone expression.

vS.cmnd(params);

vS.

The global Stone voice or namespace.

cmnd

An action; a capitalized verb.

params

Arguments or contextual whispers.

;

The Stone symbol; seals intent.

Key Symbols

Each punctuation mark carries semantic weight, transforming symbols into meaning.

;

Seal

Freeze context and persist state.

Bang

Execute immediately with high urgency.

Query

Soft conditional check or curiosity.

Inject

Add metadata or route channel.

Mark

Label a snapshot or milestone.

Drill

Access sub-context precisely.

Usage Examples

See how Stone transforms punctuation into expressive, meaningful code that tells a story.

Context Flow

Commands inherit context until sealed. No explicit state management needed.

Stone Code

vS.enter("build";
compile("main"
link("app"
export!

Example Output

[LOG] Entering 'build' context... [LOG] Compiling 'main' (inherits 'build')... [LOG] Linking 'app' (inherits 'build')... [ACTION!] Exporting immediately! [LOG] Context 'build' sealed.

Get Started with Stone

Begin your journey with Stone. Explore, learn, and contribute to a language built on clarity and intention.

Quick Start

1. Install Stone CLI

Get the command-line interface to start carving.

npm install -g stone-cli

2. Create your first file

Create a file named `hello.stone` and add:

vS.echo("Hello, Stone!";

3. Run your code

Execute your Stone script from the terminal.

stone hello.stone

Read the Docs

Dive into the comprehensive Stone documentation.

Explore Docs

Join the Community

Connect with other Stone developers, ask questions, and share your projects.

Join Discussion

Contribute on GitHub

Help shape the future of Stone. Report bugs, suggest features, or submit code.

View on GitHub