sdk: release 0.2.28

[foxnne]

What changes

sdk_version goes from 0.2.27 to 0.2.28. Merging this tags sdk-v0.2.28 and publishes its tarball.

Why now:

• Agents: tools: an agent's edits do not lock the document agent#16 (an agent's edits don't lock the document, and a document an agent makes opens beside the person) needs sdk: a plugin can open a document beside the person #442's OpenOptions.beside.
• Pixi's CI: fizzy main dropped setExplorerNewFilePath in sdk: the file tree keeps its own folders; files.reveal shows new files #449, so every pixi PR fails the fizzy-main check until pixi repins to a release that has files.reveal.
• Untitled sprites: app: an untitled document survives a crash or a restart #447's loadUntitledDocument lets a plugin's untitled documents come back from a crash. Pixi needs a release carrying it to implement that.

SDK impact

• None
• Core-only or additive: reaches plugins at the next SDK release
• Fingerprint moved: recorded in sdk/src/version.zig, sdk_version untouched, PR labelled sdk
• SDK release: bumps sdk_version, lists the sdk PRs since the last sdk-v* tag

sdk PRs since sdk-v0.2.27:

• sdk: a plugin can open a document beside the person #442: a plugin can open a document beside the person. EditorAPI.OpenOptions.beside (one new defaulted field), and Host.openBeside / endOpenBeside, so a command run on someone's behalf opens what it makes beside them.
• app: an untitled document survives a crash or a restart #447: an untitled document survives a crash or a restart. A new optional vtable member, loadUntitledDocument, for an owner whose untitled documents should come back. Plugin.bytesPath is the path to hand documentBytes for a document's bytes outside a save.
• sdk: owners report a document's steps, and apply recorded ones #456: owners report a document's steps, and apply recorded ones (Step, a vtable step_format and applyStep, Host events). All additive: step_format defaults to 0 and applyStep to null, so an owner that records nothing changes nothing.
• sdk: the file tree keeps its own folders; files.reveal shows new files #449: the file tree keeps its own folders, and files.reveal shows new files. Host.setExplorerNewFilePath(path) becomes host.getServiceTyped(sdk.services.files.Api) then .reveal(path). The files service is now version 2. explorerBranchIsOpen and setExplorerBranchOpen are gone, with no replacement.

Reaching plugins, no fingerprint move:

• core: a canvas the person has not moved fits its pane; Fit to View puts it back #444: core: a canvas the person hasn't moved stays fitted to its pane, refitting live as the pane changes size. fitToView animates there.
• core: viewport buttons are glass bubbles; Fit to View is one #446: core: core.widgets.glass_button, round glass buttons and viewport bubbles.
• core: a kept frost reads again under a region's swap #450: core: a kept frost reads again under a region's swap.
• core: a row carried out of a tree is the OS's glass, and stays still #451: core: a row carried out of a tree is the OS's glass, and stays still.
• tape: steps of a document's history, and a deflated binary form #453: tape: steps of a document's history, and a compressed binary form. tape.binary.encode takes a third argument, Options (.{} keeps the old output).
• tape: a live tape with no ops finishes instead of crashing #457: tape: a live tape with no ops finishes instead of crashing.
• shaders: the glass written once, its Metal and GLSL generated #424: core: the glass shader written once in HLSL, its Metal and GLSL generated.
• app: a refused plugin says whether its mode or its SDK shape differs #458: sdk/src/dylib.zig: a refused plugin says whether its build mode or its SDK shape differs (it blamed the mode for both).
• zig: builtin.target.os, .cpu and .abi in place of builtin.os #435: tape, replay: builtin.target.os, .cpu and .abi in place of builtin.os.

Not in this release: #437 (the Zig 0.17 switch, labelled sdk) merged into the zig/0.17 integration branch, not main. main still builds with Zig 0.16.

Verified

• macOS:
  • On this head, zig build test-sdk-version passes, and scripts/pack-sdk.sh packs fizzy-sdk-v0.2.28.tar.gz.
  • Rebased on main after sdk: owners report a document's steps, and apply recorded ones #456, tape: steps of a document's history, and a deflated binary form #453, tape: a live tape with no ops finishes instead of crashing #457, shaders: the glass written once, its Metal and GLSL generated #424 and app: a refused plugin says whether its mode or its SDK shape differs #458. Re-checked on the new head: zig build test-sdk-version passes and scripts/pack-sdk.sh packs.
  • fizzyedit/agent main doesn't build against it: src/Recording.zig:127 calls tape.binary.encode(gpa, t), and tape: steps of a document's history, and a deflated binary form #453 added an Options argument (its notes say no plugin calls it; the agent's recording does). The fix is encode(self.gpa, t, .{}), in the agent's repin.
  • fizzyedit/pixi main doesn't build against it: src/dialogs/NewFile.zig:230 calls the removed setExplorerNewFilePath. Expected; see Follow-ups.
• Windows:
• Linux: CI.
• Web:

Follow-ups

• The repin automation opens sdk: repin to fizzy SDK 0.2.28 PRs in the store plugins whose build needs it.
• pixi's opens as a draft, since its build breaks. It needs sdk: the file tree keeps its own folders; files.reveal shows new files #449's change: NewFile.zig calls files.reveal. sdk: the file tree keeps its own folders; files.reveal shows new files #449's notes say that change is ready locally, to push with this repin. atlas needs the same, for New Note.
• agent's repin opens as a draft too: it needs tape.binary.encode(self.gpa, t, .{}) in src/Recording.zig (tape: steps of a document's history, and a deflated binary form #453).
• Then: once agent repins, tools: an agent's edits do not lock the document agent#16 can go ready, and pixi can implement loadUntitledDocument.

🤖 Generated with Claude Code