ludic/tools/docgen/inventory.json
Orkuncakilkaya b205dd8dfd
All checks were successful
docs / build-and-deploy (push) Successful in 2s
feat(stdlib): add Os.* — the OS/environment interface (#21)
An Os.* namespace, Go-flavored and game-scoped, for the environment *around*
the game: the command line, environment variables, standard streams, process
exit, the host platform, and the per-user known folders a game writes into.
Rounds the bare System.* builtins (arg/getenv/exit) into one coherent surface.

  - args / arg_count / arg     the argument vector (args() -> []string)
  - env / env_or / has_env     read env vars (null-safe via env_or)
  - set_env / unset_env        mutate this process's environment
  - exit(code)                 terminate with a status code
  - platform() / arch()        host facts (uname sysname/machine)
  - stdout_write / stderr_write  raw writes to the standard streams
  - save_dir / config_dir / cache_dir / temp_dir   per-user known folders

Pure libc over NUL-terminated strings; C-free, no new runtime. arg_count/arg/
exit stay light (no prelude) as thin aliases of the existing intrinsics; the
rest share one Os runtime prelude emitted on demand (g_uses_osrt). platform()
is portable (uname system name is field 0 on every Unix); arch() and the
known-folder layout follow the macOS/BSD conventions — the fully supported
native target today. Linux/Windows/wasm folder resolution and a target-aware
arch() are documented follow-ups.

- examples/library/os.ludic: asserts the invariants that hold regardless of
  host — env round-trip, env_or fallback, unset, args()==arg_count(), non-empty
  platform/arch and known dirs. Wired into `x test` (now 54 passed).
- docs: a new Os section + 17 per-symbol pages; inventory updated; every fence
  passes check-docs (--fmt) and the site builds via docgen.
- seed regenerated; `x bootstrap-cfree` fixpoint holds.

Closes #21

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-30 22:19:11 +03:00

461 lines
8 KiB
JSON

{
"annotations": [
"annot-queries",
"annot-computed",
"annot-onstart",
"annot-onquit",
"annot-onspawn",
"annot-ondespawn",
"annot-onattach",
"annot-ondetach",
"annot-onenable",
"annot-ondisable",
"annot-on",
"annot-public",
"annot-handles",
"annot-export",
"annot-reads",
"annot-writes",
"annot-sync",
"annot-owned",
"annot-server",
"annot-predicted",
"annot-toserver",
"annot-toclients"
],
"builtins": [
"fn-print",
"fn-string",
"fn-quit",
"fn-save",
"fn-load",
"fn-len",
"fn-push",
"fn-min",
"fn-max",
"fn-abs",
"fn-clamp",
"fn-fixed",
"fn-floor",
"fn-bytes",
"fn-words",
"fn-ui_build",
"fn-arg_count",
"fn-arg",
"fn-exit",
"fn-run",
"fn-getenv",
"fn-read_char",
"fn-file_write",
"fn-file_stdout",
"fn-file_stderr"
],
"collision": [
"collision-rects",
"collision-point_rect",
"collision-circles",
"collision-rect_circle"
],
"color": [
"color-rgb",
"color-rgba",
"color-lerp",
"color-darken",
"color-lighten",
"color-with_alpha"
],
"control": [
"kw-if",
"kw-while",
"kw-for",
"kw-in",
"kw-match",
"kw-machine",
"kw-state",
"kw-become"
],
"ease": [
"ease-in",
"ease-out",
"ease-in_out",
"ease-back",
"ease-bounce"
],
"ecs": [
"kw-spawn",
"kw-despawn",
"kw-query",
"kw-self",
"kw-enable",
"kw-disable",
"kw-attach",
"kw-detach",
"fn-world_get",
"fn-world_set",
"fn-world_has",
"fn-world_count",
"fn-world_spawn",
"fn-world_size",
"fn-world_save",
"fn-world_load",
"fn-world_field_id",
"fn-world_prop_id",
"fn-world_model_id",
"fn-world_kind",
"fn-world_register_prop",
"fn-world_attach_dyn",
"fn-world_detach_dyn",
"fn-world_query_next"
],
"events": [
"kw-event",
"kw-emit",
"kw-cancel",
"kw-cancellable"
],
"input": [
"input-key"
],
"list": [
"list-len",
"list-push",
"list-clear",
"list-first",
"list-last",
"list-pop",
"list-swap",
"list-contains",
"list-index_of",
"list-reverse",
"list-insert",
"list-remove_at",
"list-remove",
"list-sort"
],
"map": [
"map-size",
"map-row",
"map-tile"
],
"math": [
"math-min",
"math-max",
"math-abs",
"math-clamp",
"math-sign",
"math-floor",
"math-ceil",
"math-round",
"math-lerp",
"math-inverse_lerp",
"math-remap",
"math-sqrt",
"math-sin",
"math-cos",
"math-tan",
"math-hypot",
"math-dist",
"math-dist2",
"math-deg_to_rad",
"math-rad_to_deg",
"math-posmod",
"math-wrap",
"math-ping_pong",
"math-snapped",
"math-move_toward",
"math-smoothstep",
"math-atan2",
"math-asin",
"math-acos"
],
"memory": [
"memory-bytes",
"memory-words",
"memory-copy",
"memory-fill",
"memory-peek",
"memory-poke"
],
"network": [
"network-send",
"network-poll",
"network-serialize",
"network-apply",
"network-owner",
"network-set_owner",
"network-is_server",
"network-is_owner",
"network-local_id"
],
"operators": [
"op-arith",
"op-compare",
"op-logical",
"op-bitwise",
"op-range",
"op-assign",
"op-access",
"op-interp",
"op-literals",
"op-comment"
],
"phases": [
"phase-fixedupdate",
"phase-input",
"phase-lateupdate",
"phase-render",
"phase-start",
"phase-update"
],
"random": [
"random-range",
"random-chance",
"random-seed",
"random-value",
"random-int",
"random-sign"
],
"save": [
"save-write",
"save-read"
],
"scenes": [
"kw-scene",
"kw-layer",
"kw-on",
"kw-enter",
"kw-exit",
"kw-start"
],
"screen": [
"screen-clear",
"screen-fill_rectangle",
"screen-draw_rectangle",
"screen-put_pixel",
"screen-draw_text",
"screen-draw_number",
"screen-show",
"screen-width",
"screen-height",
"screen-status",
"screen-line",
"screen-circle",
"screen-fill_circle",
"screen-triangle",
"screen-fill_triangle",
"screen-sprite",
"screen-sprite_scaled"
],
"structure": [
"kw-program",
"kw-property",
"kw-model",
"kw-handler",
"kw-phase",
"kw-const",
"kw-var",
"kw-let",
"kw-function",
"kw-return",
"kw-import",
"kw-extern",
"kw-ui",
"kw-enum"
],
"system": [
"system-arg",
"system-arg_count",
"system-exit",
"system-run",
"system-env",
"system-read_char",
"system-file_open",
"system-file_read",
"system-file_write",
"system-file_seek",
"system-file_tell",
"system-file_close",
"system-stdout",
"system-stderr"
],
"text": [
"text-length",
"text-char_at",
"text-slice",
"text-starts_with",
"text-ends_with",
"text-contains",
"text-index_of",
"text-equals",
"text-concat",
"text-to_int",
"text-from_int",
"text-upper",
"text-lower",
"text-trim",
"text-repeat",
"text-pad_left",
"text-pad_right",
"text-split",
"text-join",
"text-replace"
],
"time": [
"time-frame",
"time-delta",
"time-elapsed",
"time-now",
"time-since"
],
"types": [
"type-bool",
"type-byte",
"type-entity",
"type-fixed",
"type-fixeds",
"type-int",
"type-pointer",
"type-pointers",
"type-slices",
"type-string",
"type-void",
"type-words",
"type-vector"
],
"world": [
"world-get",
"world-set",
"world-has",
"world-count",
"world-size",
"world-spawn",
"world-save",
"world-load",
"world-prop_id",
"world-field_id",
"world-model_id",
"world-kind",
"world-register_prop",
"world-attach",
"world-detach",
"world-query_next"
],
"vector": [
"vector-make",
"vector-zero",
"vector-x",
"vector-y",
"vector-add",
"vector-sub",
"vector-scale",
"vector-dot",
"vector-length",
"vector-distance",
"vector-normalize",
"vector-lerp",
"vector-rotate",
"vector-angle",
"vector-from_angle"
],
"duration": [
"duration-seconds",
"duration-minutes",
"duration-hours",
"duration-days",
"duration-as_seconds",
"duration-as_minutes",
"duration-as_hours",
"duration-as_days"
],
"date": [
"date-new",
"date-year",
"date-month",
"date-day",
"date-weekday",
"date-is_leap",
"date-days_in_month",
"date-to_epoch",
"date-add_days",
"date-diff_days"
],
"datetime": [
"datetime-from",
"datetime-date",
"datetime-add",
"datetime-year",
"datetime-month",
"datetime-day",
"datetime-weekday",
"datetime-hour",
"datetime-minute",
"datetime-second",
"datetime-format",
"datetime-parse"
],
"clock": [
"clock-now",
"clock-set",
"clock-advance",
"clock-reset"
],
"crypto": [
"crypto-sha256",
"crypto-hmac_sha256",
"crypto-verify_hmac",
"crypto-hex",
"crypto-ct_equal",
"crypto-random_bytes",
"crypto-random_hex",
"crypto-random_u32",
"crypto-base64"
],
"uuid": [
"uuid-new",
"uuid-v4",
"uuid-new_v7",
"uuid-v7",
"uuid-parse",
"uuid-is_valid",
"uuid-to_text",
"uuid-equals",
"uuid-nil"
],
"noise": [
"noise-value2",
"noise-perlin2",
"noise-simplex2",
"noise-fbm2",
"noise-cellular2",
"noise-cellular2_id",
"noise-unit"
],
"log": [
"log-trace",
"log-debug",
"log-info",
"log-warn",
"log-error",
"log-set_level",
"log-level"
],
"os": [
"os-args",
"os-arg_count",
"os-arg",
"os-env",
"os-env_or",
"os-has_env",
"os-set_env",
"os-unset_env",
"os-exit",
"os-platform",
"os-arch",
"os-stdout_write",
"os-stderr_write",
"os-save_dir",
"os-config_dir",
"os-cache_dir",
"os-temp_dir"
]
}