Liking cljdoc? Tell your friends :D

Changelog

All notable changes to meme-clj will be documented in this file.

The format is based on Keep a Changelog.

[Unreleased]

Language platform: register! API for guest languages with custom preludes, rewrite rules, and parsers (meme.alpha.platform.registry)
Term rewriter: bottom-up rewrite engine with ?x/??x pattern variables, cycle detection, and fixed-point iteration (meme.alpha.rewrite)
Rewrite-based parser: alternative token→form path via tagged trees and rewrite rules (meme.alpha.rewrite.tree)
Pipeline contracts: opt-in spec validation at stage boundaries (meme.alpha.pipeline.contract)
LANGBOOK.md: language maker cookbook — patterns for building guest languages on the meme platform
Superficie example: surface-syntax renderer reimplemented as a guest language (212 lines vs ~2000 original)

Prelude expansion: prelude forms are now expanded through step-expand-syntax-quotes before eval, matching the user-code path. Previously, syntax-quote in prelude files caused runtime errors.
maybe-call nil/true/false guard: maybe-call now rejects nil, true, false as call heads (matching the existing guard in parse-call-chain). Previously, reader conditionals resolving to these values could silently produce invalid forms.
build-tree delimiter validation: build-tree now validates expected delimiters after #? and #:ns prefixes (matching the main parser). Previously, malformed tokens caused silent off-by-one parsing.
load-prelude docstring: corrected to reflect actual behavior (parse-only, not eval).
README.md: fixed dead link to doc/development.md (now points to CLAUDE.md).

defrecord-as-map bugs: MemeRaw, MemeSyntaxQuote, and other AST node defrecords satisfy (map? x), causing silent mishandling in expand-sq, normalize-bare-percent, find-percent-params, pp, and max-percent-n. All dispatch sites now guard with forms/raw?, forms/syntax-quote?, etc. before the (map? form) branch.
#?@ splicing: #?@(:clj [2 3]) inside a collection now correctly splices elements ([1 #?@(:clj [2 3]) 4] produces [1 2 3 4], not [1 [2 3] 4]). Non-sequential splice values produce a clear error.
Positive-sign BigInt/Ratio: +42N and +3/4 now parse correctly. BigInteger constructor rejects leading +; sign is now stripped before construction (matching hex/octal/radix branches).
Non-callable literal heads: nil(x), true(x), false(x) now rejected at parse time with a clear error instead of silently producing unprintable forms.
Nested syntax-quote semantics: x `` now correctly produces double-quoting (code that generates the inner expansion), matching Clojure's behavior. Previously the inner expansion was returned directly, losing one nesting level.

Expander extracted: Syntax-quote expansion (expand-sq, expand-syntax-quotes, expand-forms) moved from meme.alpha.parse.reader to new meme.alpha.parse.expander namespace.
Shared utilities: Metadata exclusion key set (strip-internal-meta) and percent-param-type extracted to meme.alpha.forms to prevent drift between reader and printer.
CI deploy gate: ClojureScript tests now required before deployment (added test-cljs to deploy job dependencies).

Initial public alpha release.

Can you improve this documentation?Edit on GitHub

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts