Skip to content

Release 1.0.0-preview.3 - #3

Merged
soyeyalon merged 6 commits into
mainfrom
candidate
Nov 13, 2026
Merged

soyeyalon merged 6 commits into
mainfrom
candidate

Conversation

@soyeyalon

Copy link
Copy Markdown
Contributor

Promotes the candidate de3d574 to main as DOMQL 1.0.0-preview.3, the third preview, whose npm package changes only the README it carries.

  • Why DOMQL: the README says what a component gets from DOMQL, where DOMQL comes from, in Forma's scripts, and what it can't follow.
  • Why queries are Nexo scripts: how the language grew inside DOMQL and became Nexo, and what Nexo lets DOMQL know before, during and after a query's evaluation.
  • Installing: the README says why npm's latest holds a deprecated placeholder, so a reader installs @preview.
  • The link test reads every Nexo file DOMQL's documents link to in one git cat-file --batch, so it no longer times out under the full suite.

The specification is unchanged at 1.0.0-preview.1, on Nexo's language 1.0.0-preview.1. The changelog entry lists the change.

npm's page for a package shows the version latest names, so until 1.0
it shows DOMQL's placeholder deprecated. D110 now records why latest
stays there: moving it to a preview would make a pre-release the
default install, which FormaUI Versioning forbids, and the deprecation
is what tells npm install to ask for @Preview.
The link test spawned git once for each Nexo file a document links
to, which took about a second alone and passed vitest's five-second
limit while the other test files ran beside it. It now reads them all
through one git cat-file --batch, and still refuses a link to a file
or an anchor the release doesn't hold.
The README answers why DOMQL exists and why its queries are Nexo
scripts, where it compared DOMQL with jQuery alone. It names the work
DOMQL takes off each component, what it can't follow, when plain
JavaScript is simpler, and what Nexo lets DOMQL learn before, during
and after a query's evaluation, keeping the C# half as planned.
"Why DOMQL" now opens with what a component gets, then where DOMQL
comes from. Forma's scripts each tracked their own part of the page,
grew hard to reason about and to cache, and cost a round trip into
JavaScript for each answer the C# side needed. "Why queries are Nexo
scripts" opens with how the language grew inside DOMQL and became
Nexo.
The README's Install section now says that npm's latest tag holds a
deprecated placeholder until 1.0, so a reader who sees the warning on
npm knows to install the preview dist-tag.

The npm package carries the README, so this change and the two README
sections since 1.0.0-preview.2 open 1.0.0-preview.3's changelog entry,
and the sources declare that version. The specification stays at
1.0.0-preview.1.
The third preview, implementing DOMQL's specification 1.0.0-preview.1
on Nexo's language 1.0.0-preview.1, as the second does. Its npm
package changes only the README it carries. It dates the changelog's
entry, and is tagged v1.0.0-preview.3, whose release publishes both
packages.
@soyeyalon
soyeyalon merged commit de3d574 into main Nov 13, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
release — de3d5742 Deployed Nov 13, 2026 by soyeyalon via Release #3
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant