@abstractdata/starlight-theme 0.3.2 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. package/bin/install-skills.js +72 -4
  2. package/package.json +5 -4
  3. package/scripts/build-python-docs.mjs +385 -0
  4. package/scripts/build-ts-docs.mjs +349 -0
  5. package/scripts/python-autodoc.json +10 -0
  6. package/scripts/ts-autodoc.json +10 -0
  7. package/skills/claude/CLAUDE.md +46 -0
  8. package/skills/claude/abstract-data-docs-author/SKILL.md +305 -0
  9. package/skills/claude/abstract-data-setup/SKILL.md +441 -147
  10. package/skills/cursor/abstract-data-docs-author.mdc +311 -0
  11. package/skills/cursor/abstract-data-setup.mdc +441 -147
  12. package/skills/cursor/welcome.mdc +29 -0
  13. package/skills/github/copilot-instructions.md +773 -155
  14. package/src/components/SocialIcons.astro +17 -2
  15. package/src/components/VersionPicker.astro +238 -0
  16. package/src/index.ts +17 -1
  17. package/src/styles/hud.css +222 -210
  18. package/src/styles/theme.css +444 -432
package/skills/cursor/welcome.mdc ADDED
@@ -0,0 +1,29 @@
1
+ ---
2
+ description: "Welcome handshake for Abstract Data Documentation Theme projects. Always applied so the agent has setup-state awareness from the first message of every conversation."
3
+ alwaysApply: true
4
+ ---
5
+
6
+ # Abstract Data Documentation Theme — agent context
7
+
8
+ This project uses the **Abstract Data Documentation Theme** (built on Astro Starlight, distributed as `@abstractdata/starlight-theme`). When talking to the user, refer to the product as the **"Abstract Data Documentation Theme"** — not "Astro Starlight" — Starlight is the substrate, not the product identity.
9
+
10
+ ## First-interaction handshake
11
+
12
+ When you open a conversation in this project, check setup state:
13
+
14
+ - **`scripts/python-autodoc.json`** — does it still have placeholder values (`searchPath: "../../../python-example/src"`, `modules: ["example_module"]`)?
15
+ - **`astro.config.mjs`** — does it still say `title: 'Your Project Docs'` and `site: 'https://example.com'`?
16
+
17
+ **If either looks like a fresh scaffold,** offer the user this without waiting for them to ask:
18
+
19
+ > "Looks like this is a freshly scaffolded Abstract Data Documentation Theme project. Want me to run the `abstract-data-setup` workflow now? It'll detect Python source, audit docstring coverage, sniff docstring style, ask a few config questions, and wire up the docs config files. (Reply 'no' if you'd rather configure manually.)"
20
+
21
+ On agreement, invoke the `abstract-data-setup` rule (`.cursor/rules/abstract-data-setup.mdc`).
22
+
23
+ If setup looks already-done, don't auto-offer. Be a normal helpful assistant.
24
+
25
+ ## Project conventions
26
+
27
+ - **Bun**, not npm/yarn/pnpm
28
+ - **Conventional Commits** for version automation via release-please
29
+ - Don't hand-edit `.cursor/rules/abstract-data-setup.mdc` or `.github/copilot-instructions.md` — they're auto-generated