…dashes
Review pass over the new Framework section.
Overview: open by naming the alternative (the visual editor) and the job
this does, instead of leading with a feature list. Adds a "which should I
use" comparison. The section previously never mentioned the editor at all.
Claim fixes, each verified against superwall/superwall and the iOS SDK:
- Restore does not fire transaction_complete. iOS sends restoreComplete /
transactionRestore, neither of which the framework protocol models, so
the typed event map cannot subscribe to them. lifecycle.mdx and
actions.mdx claimed otherwise while purchases.mdx had it right; made
purchases.mdx canonical. Note the dev mock does answer a restore with
transaction_complete, so this works in the studio and no-ops on device.
- transaction_fail is unmodeled, so a declined card leaves purchase()
pending rather than resolving failed. Documented, with the advice to set
purchaseTimeoutMs on any paywall gating UI on the awaited result.
- --sw-background was undocumented on the styling page. Nothing derives it
from config.background; every example and the CLI scaffold set it by
hand, so following the page as written left system Canvas painted over
the configured color. navigation.mdx framed it as layout-conditional,
which is true of --sw-routes-height only; split the two.
- presentation, featureGating and onDeviceCacheEnabled were called "not
config keys". They are keys, accepted by the type and never read, so
setting them type-checks, builds, pushes without warning and does
nothing. Reworded to say so.
- superseded narrowed to a newer purchase for the same product reference.
- Portability warning names the first five offenders, then counts the
rest, and offers a package registry as a second remedy.
- Declared the missing haptics binding in the restore snippet.
Prose: 385 em dashes down to 30, all of which are code samples, paywall
copy inside examples, table "none" cells, or a JSX fallback glyph.
Build: raise the prerender heap from 5120 to 8192. The section pushed the
crawl past the old ceiling; branch HEAD passed only marginally, and 6144
is the floor. 719 pages prerendered, 64 tests pass.
Findings that look like framework rather than docs bugs, including the
restore mock divergence and a missing *.m4a module declaration, are on
PR #272.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
No description provided.