Skip to content

docs: delete stale duplicate Imports API page - #318

Merged
alexgrozav merged 1 commit into
mainfrom
agent/larousse/3d7c1857
Jul 15, 2026
Merged

alexgrozav merged 1 commit into
mainfrom
agent/larousse/3d7c1857

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

What

Delete the stale duplicate Imports API page (apps/docs/content/docs/02.api/13.imports.md), leaving a single authoritative Imports page.

Why

The API section had two pages titled "Imports". The removed 13.imports.md described the old model — each *.styleframe.ts file creates its own styleframe() instance and imports from 'styleframe'. That contradicts the current single-instance architecture: the plugin's generateExtensionModule returns the config directly (tooling/plugin/src/plugin/generate/extension-module.ts:11-13), so styleframe() inside an extension file hands back the same instance. The surviving 14.imports.md documents this correctly and already covers every still-correct topic (consuming styles, exports, framework usage, HMR, all nine bundlers), so nothing needed folding — folding the old page's content would reintroduce the drift.

Deleting the stale page also clears the 13. numeric-prefix collision it had with 13.merging.md; the remaining files (12.composables, 13.merging, 14.imports) each have a unique prefix, which restores the ordering PR #132 intended. Implements SF-31.

How verified

pnpm --filter @styleframe/docs build
# ✨ Build complete! — /docs/api/imports.html and /docs/api/merging.html both prerender

Content DB after the change (.data/content/contents.sqlite, _content_docs_api):

/docs/api/merging   Merging   docs/api/13.merging
/docs/api/imports   Imports   docs/api/14.imports
rows at /docs/api/imports: 1

Exactly one Imports entry now, down from two.

Notes

  • No redirect needed. Both files mapped to the same route, /docs/api/imports (numeric prefixes are stripped from routes). Deleting the stale page leaves the authoritative page serving that exact URL, so the previously published URL does not 404 — a redirect would target itself and break the page. No internal docs link references the route, so none breaks.
  • Docs-only change; no changeset (@styleframe/docs is in the changesets ignore list).

Remove apps/docs/content/docs/02.api/13.imports.md, the stale Imports
page that described the old per-file "own instance / import from
'styleframe'" model. The authoritative single-instance page
(14.imports.md) already covers every still-correct topic.

This also resolves the 13. numeric-prefix collision with 13.merging.md
and leaves exactly one Imports entry in the API nav. The published
/docs/api/imports URL is preserved (both files mapped to it), so no
route 404s.

SF-31
@vercel

vercel Bot commented Jul 15, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
styleframe-dev Ready Ready Preview, Comment Jul 15, 2026 6:34am
styleframe-dev-storybook Ready Ready Preview, Comment Jul 15, 2026 6:34am

Request Review

@changeset-bot

changeset-bot Bot commented Jul 15, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: ab4609f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@alexgrozav
alexgrozav merged commit 19a0802 into main Jul 15, 2026
14 checks passed
@alexgrozav
alexgrozav deleted the agent/larousse/3d7c1857 branch July 15, 2026 06:52

This branch was successfully deployed

2 active deployments
Preview – styleframe-dev — ab4609f9 Deployed Jul 15, 2026 by vercel[bot]
Preview – styleframe-dev-storybook — ab4609f9 Deployed Jul 15, 2026 by vercel[bot]
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