Core Concepts

Syntax Fundamentals

Learn the fundamental syntax structure where punctuation carries meaning and commands become rituals.

Command Structure

Basic command formvscript
1
2
3
4
5
6
7
8
// Basic command form
vS.command(parameters);
// With parameters
vS.enter(mode:collaborative);
// Chained with colon
vS.set(key:value);

All vScript commands follow the pattern: vS. (namespace prefix) + command + () (parameter container) + punctuation operator.

Punctuation Semantics

In vScript, each punctuation mark carries functional meaning. Punctuation is not decorative—it's operational.

.Dot

Soft execution, ambient context

vS.enter().
;Semicolon

Commit action, link to next

vS.plan("x");
!Exclamation

Force execution, ignite

vS.run()!
:Colon

Bind, associate, chain

vS.set(mode:creative)
#Hash

Lane/channel identifier

vS.route(#core)
@At

Address/position marker

vS.route(@0.73)
*Asterisk

Wildcard/all selector

vS.reservoir(taps:*)
~Tilde

Approximate/fuzzy match

vS+.sense(~)
-Dash

Range/connection

vS.grid(3x3)
--Double-dash

Force flag

vS.command--f

Chaining & Composition

Commands can be chained together for complex operations using punctuation operators.

Chaining examplevscript
1
2
3
4
5
6
7
vS.bootstrap!
  : vS.grid(3x3, carriers:*, symbols:*)
  : vS.reservoir(size:27, feedback:0.33, taps:all)
  : vS.clock(2kHz)#core
  : vS.route(@0.73 #7)
  ; vS.speak(out:[dac0,leds,webserial,audio])
  ;

: binds commands in sequence

; commits and continues

. creates ambient flow

! forces immediate execution

Data Types

Strings
Text content in double quotes or raw blocks
1
2
3
vS.inject("Hello, world");
vS.inject{Multi-line
raw content};
Numbers & Booleans
Standard numeric and boolean values
1
2
3
vS.setState(level: 42);
vS.unlock(force: true);
vS.adjust(ratio: 0.75);
Lists & Records
Collections and structured data
1
2
vS.process([1, 2, 3]);
vS.configure({ mode: "creative", level: 3 });

Naming Conventions

Commands & Keys

Use lowerCamelCase for commands and parameter keys

1
vS.setState(currentMode: "explorer");

Constants

UPPER_SNAKE_CASE allowed for constants

1
vS.configure(MAX_RETRIES: 5);

Comments

1
2
3
4
5
6
// Single line comment
vS.enter(mode: "creative");
/* Multi-line comment
   for longer explanations */
vS.inject("content");

Whitespace & Formatting

Whitespace is significant for readability but not semantic. Commands can be chained or separated for clarity.

Formatting examplesvscript
1
2
3
4
5
6
7
8
// Chained execution
vS.unlock(); vS.enter(); vS.setState("wild"); vS.run(full);
// Separated for clarity
vS.unlock();
vS.enter(mode: "creative");
vS.setState("focused");
vS.run(full);
← Quick Start GuideCore Commands →