Another pass#268
Draft
janderland wants to merge 34 commits into
Draft
Conversation
Update syntax.ebnf to match the current grammar defined in docs/index.md, and fix inline grammar blocks in docs to be consistent with the full grammar. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adds scripts/serve_docs.sh which runs watchexec to rebuild docs
on save (docs/index.md, docs/index.tmpl) and browser-sync to
reload the page on docs/index.html change. Supports --stop and
--log <watchexec|browsersync>, with PID-recycling guards and
SIGTERM -> SIGKILL escalation.
Skips hljs.highlightElement on inline code pre-tagged with
hljs-* classes so pandoc's {.hljs-variable} spans don't trigger
"Could not find the language 'hljs-variable'" warnings.
Disables Fira Code's contextual-alternate ligatures (-> => \!=
etc.) in code via font-feature-settings "calt" 0.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds scripts/serve_docs.sh, which runs npx chokidar-cli to rebuild on docs source changes alongside npx browser-sync to serve and live-reload the rendered output. Both tools install via npx so the loop works the same on macOS and Fedora with no system package required. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* Add virtual directory syntax Allow a directory path to begin with '@' instead of '/' as a "virtual directory". Only the first component may use '@'; subsequent components must use '/'. Updates the EBNF in syntax.ebnf and the embedded grammar in docs/index.md, and loosens the highlight.js DIRECTORY rule to accept '@' as a starting separator. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Rename directory grammar helper from 'element' to 'segment' Distinguishes the directory-component helper from the unrelated 'elements' rule used by tuples in the same grammar dump. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Use 'segment' helper in syntax.ebnf and bottom grammar dump Brings the formal EBNF and the full-grammar block at the bottom of docs/index.md in line with the inline directory grammar, which already factored the segment choice into a helper rule. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Update syntax.ebnf to match the current grammar defined in docs/index.md, and fix inline grammar blocks in docs to be consistent with the full grammar. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Only added partial sections. Will flesh out later on.
Clarifies FQL's query chaining behavior with improved terminology. The new Cardinality section demonstrates how FQL joins key-spaces when pipeline queries have different cardinalities, with SQL comparisons for reference.
- type rule now carries trailing options, applying both inside a
variable's type list and inside a reference's type_cast
- data carries trailing options instead of treating options as a
data-element variant
- reference accepts optional type_cast ('!' type)
- comment rule defined and folded into nl
- variable no longer has its own trailing options; options ride on
the type instead
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Picks up two upstream changes: removal of the bint type and the DIRECTORY restriction to bare '<>', plus the new TYPE-level options binding (highlightjs-fql commits 602ab3f and a97462a). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Drop the sep alias in favor of separator. Rename want_all to wantall to give 'mode' values a consistent no-underscore convention. Refresh docs/js/fql.js from highlightjs-fql. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Replaces 'tuple' with 'tup' in the type rule of both syntax.ebnf and the docs grammar listings. Aligns the spec with the highlighters (hljs, tree-sitter, lezer) which already use 'tup' and matches the short-form convention used elsewhere in the type set (str, num). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.