From 3602ab149ead925a121783caa9534c2be67810ca Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sat, 24 Oct 2026 14:35:27 +0000 Subject: [PATCH] Squashed 'vendor/ui/' changes from 2a8e9ad..62834e1 62834e1 feat(ui): use the lig header list as the Menu and Select default (#12) 826561e fix(ui): ignore SSR slot comments when measuring signature marks 81ec46b fix(ui): declare GridTable private row height in CSS f483e20 fix(ui): satisfy upstream lint rules for GridTable exports d236d70 feat(ui): add UiDevtools to show library and project components abd153c feat(ui): transition pinned title halo and clear pinned table columns at rest f59c5d3 feat(ui): add a bg-colored halo around pinned titles 6313114 feat(ui): add a bg-colored halo around floating panels 4501f0b fix(ui): drop opaque backgrounds from in-flow components 6428c22 fix(ui): tint GridTable pin fade with the hovered row 3e3aa93 feat(ui): add crosshair hover highlight to GridTable 4e59077 feat(ui): add GridTable and use it for lightweight ports d579cb4 style(ui): mark checked select item with a dot c04293b refactor(ui): rename DropdownMenu to Menu 192fdc2 fix(ui): allow private custom properties in token check e972b00 feat(ui): support untitled CodeBlock and keep title rule when folded dc0465f fix(ui): indent collapsible panel content 563e395 chore(ui): merge upstream 0froq/ui main c01fc75 feat(ui): add CodeBlock, sticky open headers and a footer-band pen route 1b874ef docs: merge English README from Air with Workers deploy notes 1bbdf04 docs: update README caf1c6c wip: palette, signature and i18n updates from Air 4ad6ad9 chore: pin og-layer v0.2.1 (#9) e2d36ca feat: draw page descriptions on og-layer v0.2.0 cards (#8) 8e4dc84 fix(ui): stabilize Select popup layout and focus handling 0f689d1 feat(ui): add a custom mode to Select for header language switching 5b64792 fix: remove menu highlight edge markers 9f6eda2 fix(docs): list nuxt as peer so root cf deploy uses Wrangler (#7) 8888e40 fix(docs): move shared helpers under app/utils for Nitro bundle (#6) f196627 fix(docs): move site config into app dir for Nitro bundle (#5) 50a3c60 feat: show syntax inspector popovers on narrow screens 8976b7a feat: share boundary-aware wheel scroll handoff e254580 feat: ease pen stroke progress behind scrolling f87bb31 feat: reveal connecting pen strokes while scrolling b02ae41 fix: inset the page rule turn from the left edge 84dc56d feat(docs): OG cover layer (paper cards on Workers image origin) (#4) 1f3eb9f fix: end the page rule above the first label 160d4eb docs: relicense under MIT and rewrite the guides 479a33f feat: social share card meta (og/twitter) (#3) 49c290f ci: plain cf deploy + Worker Previews (#2) 13e43a9 Merge pull request #4 from 0froq/codex/ui-paper-signature 5e6eacf chore(docs): migrate UI docs site from Pages to Workers (#1) git-subtree-dir: vendor/ui git-subtree-split: 62834e120909b156fe4e3b38e08bbe1e8aa885d3 --- .agents/skills/cloudflare-sites/SKILL.md | 113 + .agents/skills/oq/SKILL.md | 156 + .../skills/oq/references/app-development.md | 290 + .../oq/references/library-development.md | 161 + .agents/skills/oq/references/monorepo.md | 208 + .../skills/oq/references/oq-eslint-config.md | 183 + .../skills/oq/references/oq-unocss-config.md | 228 + .agents/skills/oq/references/pnpm-catalog.md | 303 + .../skills/oq/references/release-workflow.md | 221 + .agents/skills/oq/references/setting-up.md | 214 + .../ui/.github => .github}/workflows/ci.yml | 0 .github/workflows/refresh-circle.yml | 33 - .gitignore | 26 +- AGENTS.md | 96 +- README.md | 219 +- app/app.config.ts | 29 - app/app.vue | 43 - app/assets/css/kit.css | 1287 -- app/components/Copy.ts | 15 - app/components/CopyCommand.vue | 27 - app/components/Fill.ts | 25 - app/components/InstallLink.vue | 33 - app/components/Installed.vue | 34 - app/components/PageHead.vue | 70 - app/components/RichText.ts | 17 - app/components/SectionNav.vue | 20 - app/components/Sheet.vue | 15 - app/components/SiteFooter.vue | 51 - app/components/SiteHeader.vue | 128 - app/components/Stop.ts | 27 - .../circle/CircleAccessibleList.vue | 248 - app/components/circle/CircleBoard.vue | 838 - app/components/circle/CircleCopySlots.vue | 59 - app/components/circle/CircleNoteText.vue | 27 - app/components/circle/CirclePage.vue | 117 - app/components/circle/CirclePersonCard.vue | 407 - app/components/content/Block.vue | 47 - app/components/content/Faq.vue | 39 - app/components/content/Figures.vue | 55 - app/components/content/Final.vue | 52 - app/components/content/Hero.vue | 87 - app/components/content/Price.vue | 67 - app/components/content/Quotes.vue | 34 - app/components/content/Statement.vue | 30 - app/components/content/Step.vue | 36 - app/composables/useCircleData.ts | 16 - app/composables/useCopy.ts | 10 - app/composables/useInstalled.ts | 6 - app/composables/useKitLink.ts | 19 - app/composables/usePageSections.ts | 50 - app/composables/useSignature.ts | 115 - app/composables/useTheme.ts | 34 - app/error.vue | 38 - app/layouts/default.vue | 39 - app/pages/[...slug].vue | 47 - app/pages/changelog.vue | 63 - app/pages/docs/[...slug].vue | 109 - app/pages/index.vue | 7 - app/pages/notes/[slug].vue | 87 - app/pages/notes/index.vue | 68 - app/types.ts | 91 - app/utils/text.ts | 30 - app/utils/theme.ts | 14 - cloudflare.config.ts | 18 + content.config.ts | 42 - content/en/changelog/release.md | 5 - content/en/docs/0.index.md | 4 - content/en/index.md | 100 - content/en/install.md | 17 - content/en/notes/note.md | 5 - content/ja/changelog/release.md | 5 - content/ja/docs/0.index.md | 4 - content/ja/index.md | 100 - content/ja/install.md | 17 - content/ja/notes/note.md | 5 - content/zh/changelog/release.md | 5 - content/zh/docs/0.index.md | 4 - content/zh/index.md | 100 - content/zh/install.md | 17 - content/zh/notes/note.md | 5 - data/README.md | 40 - data/hidden.json | 1 - data/people.json | 1478 -- data/sync.json | 111 - {vendor/ui/docs => docs}/app/app.config.ts | 13 +- {vendor/ui/docs => docs}/app/app.vue | 0 .../ui/docs => docs}/app/assets/css/fonts.css | 0 .../ui/docs => docs}/app/assets/css/site.css | 0 .../app/components/ComponentApi.vue | 0 .../app/components/ComponentDemo.vue | 0 docs/app/components/ComponentStatus.vue | 86 + .../docs => docs}/app/components/DocBody.vue | 0 .../docs => docs}/app/components/PageHead.vue | 0 .../app/components/SectionLayout.vue | 0 .../docs => docs}/app/components/Sidebar.vue | 0 .../app/components/SiteFooter.vue | 0 .../app/components/SiteHeader.vue | 0 .../docs => docs}/app/components/SiteNav.vue | 0 .../app/components/content/ProseA.vue | 0 .../app/components/content/TokenBoard.vue | 0 .../app/composables/useComponentDocs.ts | 0 .../app/composables/useComponentRoute.ts | 0 docs/app/composables/usePaperOgImage.ts | 106 + docs/app/composables/useShareMeta.ts | 72 + .../app/composables/useSiteLink.ts | 0 .../docs => docs}/app/composables/useTheme.ts | 0 {vendor/ui/docs => docs}/app/error.vue | 7 +- .../ui/docs => docs}/app/layouts/default.vue | 0 .../ui/docs => docs}/app/pages/[...slug].vue | 7 +- .../ui/docs => docs}/app/pages/changelog.vue | 9 +- .../ui/docs => docs}/app/pages/components.vue | 0 .../app/pages/components/[concept]/[name].vue | 7 +- .../app/pages/components/[concept]/index.vue | 7 +- .../app/pages/components/index.vue | 19 +- .../app/pages/docs/[...slug].vue | 7 +- {vendor/ui/docs => docs}/app/pages/index.vue | 15 +- .../app/utils}/component-files.ts | 0 .../ui/docs => docs}/app/utils/components.ts | 2 +- {shared => docs/app/utils}/empty-title.ts | 0 .../ui/docs => docs}/app/utils/navigation.ts | 0 docs/app/utils/public-files.ts | 29 + docs/app/utils/site.ts | 39 + {vendor/ui/docs => docs}/component-roadmap.md | 4 +- {vendor/ui/docs => docs}/consumer-mapping.md | 0 {vendor/ui/docs => docs}/content.config.ts | 21 +- .../content/en/changelog/release.md | 0 .../docs => docs}/content/en/docs/0.index.md | 1 + .../content/en/docs/1.install.md | 0 .../docs => docs}/content/en/docs/2.tokens.md | 2 + docs/content/en/docs/3.language.md | 45 + .../content/zh/changelog/release.md | 0 .../docs => docs}/content/zh/docs/0.index.md | 1 + .../content/zh/docs/1.install.md | 0 .../docs => docs}/content/zh/docs/2.tokens.md | 2 + docs/content/zh/docs/3.language.md | 45 + {vendor/ui/docs => docs}/eslint.config.ts | 0 .../examples/ConsumerAdapters.vue | 0 {vendor/ui/docs => docs}/handoff.md | 4 + {vendor/ui/docs => docs}/i18n/locales/en.json | 15 +- {vendor/ui/docs => docs}/i18n/locales/zh.json | 15 +- {vendor/ui/docs => docs}/nuxt.config.ts | 43 +- {vendor/ui/docs => docs}/package.json | 11 +- .../plans/2026-09-30-ui-coverage.md | 0 .../plans/2026-10-01-draft-homepage.md | 0 .../plans/2026-10-01-site-banner.md | 0 docs/public/_headers | 6 + {vendor/ui/docs => docs}/public/favicon.svg | 0 docs/public/og.png | Bin 0 -> 28084 bytes {vendor/ui/docs => docs}/release-audit.md | 0 {vendor/ui/docs => docs}/tsconfig.json | 0 eslint.config.ts | 46 +- i18n/locales/en.json | 74 - i18n/locales/ja.json | 74 - i18n/locales/zh.json | 74 - nuxt.config.ts | 89 - package.json | 71 +- pnpm-lock.yaml | 7896 +++++++--- pnpm-workspace.yaml | 17 +- public/avatars/1067085110372171779.jpg | Bin 18136 -> 0 bytes public/avatars/1074838588012052481.jpg | Bin 42497 -> 0 bytes public/avatars/1126207424602337280.png | Bin 56060 -> 0 bytes public/avatars/1169225590077108224.jpg | Bin 42497 -> 0 bytes public/avatars/1248286805134196737.jpg | Bin 32796 -> 0 bytes public/avatars/1249322582869852161.jpg | Bin 24875 -> 0 bytes public/avatars/1263990230916444162.jpg | Bin 24875 -> 0 bytes public/avatars/1297343586984321024.jpg | Bin 24875 -> 0 bytes public/avatars/1313424628900036609.jpg | Bin 24875 -> 0 bytes public/avatars/1317141761689485312.jpg | Bin 42497 -> 0 bytes public/avatars/1325815317990305793.jpg | Bin 24875 -> 0 bytes public/avatars/1449354945900072964.jpg | Bin 42497 -> 0 bytes public/avatars/1455938770105090051.jpg | Bin 32796 -> 0 bytes public/avatars/1476943097980276743.jpg | Bin 42497 -> 0 bytes public/avatars/1487217749067591680.png | Bin 3504 -> 0 bytes public/avatars/1521086568194211842.jpg | Bin 42497 -> 0 bytes public/avatars/1554575293264072705.jpg | Bin 12302 -> 0 bytes public/avatars/1571894847610695681.jpg | Bin 24875 -> 0 bytes public/avatars/1586383785687650304.jpg | Bin 12302 -> 0 bytes public/avatars/1749277587535474688.jpg | Bin 24875 -> 0 bytes public/avatars/1789666230993145856.jpg | Bin 12302 -> 0 bytes public/avatars/1811126002749427713.jpg | Bin 32796 -> 0 bytes public/avatars/1815427488945770497.jpg | Bin 42497 -> 0 bytes public/avatars/1820066784625758208.jpg | Bin 24875 -> 0 bytes public/avatars/1825733032151756801.jpg | Bin 32796 -> 0 bytes public/avatars/1831648250841198593.jpg | Bin 18136 -> 0 bytes public/avatars/1833723975375192064.jpg | Bin 24875 -> 0 bytes public/avatars/1841126187789324288.jpg | Bin 32796 -> 0 bytes public/avatars/1854066640847298560.jpg | Bin 24875 -> 0 bytes public/avatars/1865722200185307136.jpg | Bin 24875 -> 0 bytes public/avatars/1870889540510212096.jpg | Bin 42497 -> 0 bytes public/avatars/1886927751065821188.jpg | Bin 32796 -> 0 bytes public/avatars/1898761780207501312.jpg | Bin 32796 -> 0 bytes public/avatars/1929526459661721600.jpg | Bin 24875 -> 0 bytes public/avatars/1947522310816337921.jpg | Bin 32796 -> 0 bytes public/avatars/1951001334850912256.jpg | Bin 42497 -> 0 bytes public/avatars/1979131969054347264.png | Bin 3504 -> 0 bytes public/avatars/1987402138667130881.jpg | Bin 56060 -> 0 bytes public/avatars/1994485839402057728.jpg | Bin 56060 -> 0 bytes public/avatars/2001163937388355584.jpg | Bin 24875 -> 0 bytes public/avatars/2003750140973305856.jpg | Bin 18136 -> 0 bytes public/avatars/2007010624291983360.jpg | Bin 56060 -> 0 bytes public/avatars/2012631283898187776.jpg | Bin 24875 -> 0 bytes public/avatars/2018144705448730624.jpg | Bin 12302 -> 0 bytes public/avatars/2032599702454329344.jpg | Bin 32796 -> 0 bytes public/avatars/2034862697150644224.jpg | Bin 42497 -> 0 bytes public/avatars/2046621802432983040.jpg | Bin 42497 -> 0 bytes public/avatars/2069854346590978048.jpg | Bin 86406 -> 0 bytes public/avatars/2072115710260903936.jpg | Bin 24875 -> 0 bytes public/avatars/2073035346707968000.jpg | Bin 18136 -> 0 bytes public/avatars/2080146118566944768.jpg | Bin 86406 -> 0 bytes public/avatars/2080270067426832384.jpg | Bin 42497 -> 0 bytes public/avatars/2084117736096190464.jpg | Bin 56060 -> 0 bytes public/avatars/2085321127182884864.jpg | Bin 56060 -> 0 bytes public/avatars/2085668508915118080.jpg | Bin 32796 -> 0 bytes public/avatars/2087152708696346624.jpg | Bin 42497 -> 0 bytes public/avatars/2087997512850235392.jpg | Bin 24875 -> 0 bytes public/avatars/2089299881433448448.jpg | Bin 32796 -> 0 bytes public/avatars/2089887330790481920.jpg | Bin 177444 -> 0 bytes public/avatars/2090037143972593664.jpg | Bin 32796 -> 0 bytes public/avatars/2090816762610962432.jpg | Bin 56060 -> 0 bytes public/avatars/2090993417744719872.jpg | Bin 86406 -> 0 bytes public/avatars/2092993804852948992.jpg | Bin 32796 -> 0 bytes public/avatars/2094811881961844736.jpg | Bin 32796 -> 0 bytes public/avatars/2095023594594320384.jpg | Bin 42497 -> 0 bytes public/avatars/2095556737231364096.jpg | Bin 177444 -> 0 bytes public/avatars/2097614252605648896.jpg | Bin 177444 -> 0 bytes public/avatars/2098243498973519885.jpg | Bin 24875 -> 0 bytes public/avatars/2100959825303932928.jpg | Bin 511250 -> 0 bytes public/avatars/2391269245.jpg | Bin 18136 -> 0 bytes public/avatars/2871437570.jpg | Bin 86406 -> 0 bytes public/avatars/294688744.jpg | Bin 42497 -> 0 bytes public/avatars/3005075238.jpg | Bin 12302 -> 0 bytes public/avatars/380562749.jpg | Bin 24875 -> 0 bytes public/avatars/425629159.jpg | Bin 18136 -> 0 bytes public/avatars/4313176880.jpg | Bin 42497 -> 0 bytes public/avatars/454281254.jpg | Bin 32796 -> 0 bytes public/avatars/54918133.jpg | Bin 12302 -> 0 bytes public/avatars/802087418295783426.jpg | Bin 24875 -> 0 bytes public/avatars/818705139120734209.jpg | Bin 56060 -> 0 bytes public/avatars/84791916.jpg | Bin 32796 -> 0 bytes public/avatars/849656764312178688.jpg | Bin 56060 -> 0 bytes public/avatars/912516778298720256.jpg | Bin 24875 -> 0 bytes public/avatars/918716499254132736.jpg | Bin 24875 -> 0 bytes public/avatars/96058727.jpg | Bin 177444 -> 0 bytes public/favicon.svg | 12 - .../ui/scripts => scripts}/check-tokens.ts | 7 +- scripts/generate-mock-circle.mjs | 119 - scripts/refresh-circle.ts | 155 - shared/circle/layout.test.ts | 84 - shared/circle/layout.ts | 73 - shared/circle/note.test.ts | 42 - shared/circle/note.ts | 67 - shared/circle/pack.test.ts | 51 - shared/circle/pack.ts | 135 - shared/circle/sync.test.ts | 100 - shared/circle/sync.ts | 135 - shared/circle/types.ts | 47 - shared/circle/viewport.test.ts | 75 - shared/circle/viewport.ts | 105 - shared/circle/waiting.test.ts | 30 - shared/circle/waiting.ts | 8 - shared/final-mark.ts | 55 - skills-lock.json | 17 + .../components/button/Button.demo.vue | 0 .../src => src}/components/button/Button.md | 0 .../src => src}/components/button/Button.vue | 0 .../components/button/Button.zh.md | 0 .../components/button/CopyButton.demo.vue | 0 .../components/button/CopyButton.md | 0 .../components/button/CopyButton.vue | 0 .../components/button/CopyButton.zh.md | 0 .../components/button/IconButton.demo.vue | 0 .../components/button/IconButton.md | 0 .../components/button/IconButton.vue | 0 .../components/button/IconButton.zh.md | 0 .../components/button/copy-button.css | 0 .../components/button/icon-button.css | 0 .../components/checkbox/Checkbox.demo.vue | 0 .../components/checkbox/Checkbox.md | 0 .../components/checkbox/Checkbox.vue | 0 .../components/checkbox/Checkbox.zh.md | 0 .../components/date/Calendar.demo.vue | 0 .../src => src}/components/date/Calendar.md | 0 .../src => src}/components/date/Calendar.vue | 0 .../components/date/Calendar.zh.md | 0 .../components/date/DatePicker.demo.vue | 0 .../src => src}/components/date/DatePicker.md | 0 .../components/date/DatePicker.vue | 0 .../components/date/DatePicker.zh.md | 0 .../ui/src => src}/components/date/date.css | 2 +- src/components/devtools/UiDevtools.demo.vue | 13 + src/components/devtools/UiDevtools.md | 44 + src/components/devtools/UiDevtools.vue | 220 + src/components/devtools/UiDevtools.zh.md | 33 + src/components/devtools/devtools.css | 158 + .../components/disclosure/Accordion.demo.vue | 0 .../components/disclosure/Accordion.md | 0 .../components/disclosure/Accordion.vue | 0 .../components/disclosure/Accordion.zh.md | 0 .../disclosure/Collapsible.demo.vue | 0 .../components/disclosure/Collapsible.md | 4 +- .../components/disclosure/Collapsible.vue | 11 +- .../components/disclosure/Collapsible.zh.md | 4 +- src/components/disclosure/collapsible.css | 160 + .../components/display/AspectRatio.demo.vue | 0 .../components/display/AspectRatio.md | 0 .../components/display/AspectRatio.vue | 0 .../components/display/AspectRatio.zh.md | 0 .../components/display/Avatar.demo.vue | 0 .../src => src}/components/display/Avatar.md | 0 .../src => src}/components/display/Avatar.vue | 0 .../components/display/Avatar.zh.md | 0 .../components/display/Badge.demo.vue | 0 .../src => src}/components/display/Badge.md | 0 .../src => src}/components/display/Badge.vue | 0 .../components/display/Badge.zh.md | 0 .../components/display/Card.demo.vue | 0 .../ui/src => src}/components/display/Card.md | 0 .../src => src}/components/display/Card.vue | 0 .../src => src}/components/display/Card.zh.md | 0 src/components/display/CodeBlock.demo.vue | 63 + src/components/display/CodeBlock.md | 68 + src/components/display/CodeBlock.vue | 97 + src/components/display/CodeBlock.zh.md | 68 + src/components/display/GridTable.demo.vue | 56 + src/components/display/GridTable.md | 110 + src/components/display/GridTable.vue | 89 + src/components/display/GridTable.zh.md | 110 + .../components/display/Separator.demo.vue | 0 .../components/display/Separator.md | 0 .../components/display/Separator.vue | 0 .../components/display/Separator.zh.md | 0 .../components/display/Table.demo.vue | 0 .../src => src}/components/display/Table.md | 0 .../src => src}/components/display/Table.vue | 0 .../components/display/Table.zh.md | 0 src/components/display/code-block.css | 216 + src/components/display/display.css | 331 + .../components/feedback/Alert.demo.vue | 0 .../src => src}/components/feedback/Alert.md | 0 .../src => src}/components/feedback/Alert.vue | 0 .../components/feedback/Alert.zh.md | 0 .../components/feedback/Banner.demo.vue | 0 .../src => src}/components/feedback/Banner.md | 2 +- .../components/feedback/Banner.vue | 0 .../components/feedback/Banner.zh.md | 2 +- .../components/feedback/EmptyState.demo.vue | 0 .../components/feedback/EmptyState.md | 0 .../components/feedback/EmptyState.vue | 0 .../components/feedback/EmptyState.zh.md | 0 .../components/feedback/Progress.demo.vue | 0 .../components/feedback/Progress.md | 0 .../components/feedback/Progress.vue | 0 .../components/feedback/Progress.zh.md | 0 .../components/feedback/Skeleton.demo.vue | 0 .../components/feedback/Skeleton.md | 0 .../components/feedback/Skeleton.vue | 0 .../components/feedback/Skeleton.zh.md | 0 .../components/feedback/Spinner.demo.vue | 0 .../components/feedback/Spinner.md | 0 .../components/feedback/Spinner.vue | 0 .../components/feedback/Spinner.zh.md | 0 .../components/feedback/Toast.demo.vue | 0 .../src => src}/components/feedback/Toast.md | 0 .../src => src}/components/feedback/Toast.vue | 0 .../components/feedback/Toast.zh.md | 0 .../components/feedback/ToastRegion.demo.vue | 0 .../components/feedback/ToastRegion.md | 0 .../components/feedback/ToastRegion.vue | 0 .../components/feedback/ToastRegion.zh.md | 0 .../components/feedback/banner.css | 4 + .../components/feedback/feedback.css | 2 +- .../components/feedback/skeleton.css | 2 +- .../src => src}/components/feedback/toast.css | 1 + .../components/field/DateInput.demo.vue | 0 .../src => src}/components/field/DateInput.md | 0 .../components/field/DateInput.vue | 0 .../components/field/DateInput.zh.md | 0 .../components/field/FileUpload.demo.vue | 0 .../components/field/FileUpload.md | 0 .../components/field/FileUpload.vue | 0 .../components/field/FileUpload.zh.md | 0 .../components/field/FormField.demo.vue | 0 .../src => src}/components/field/FormField.md | 0 .../components/field/FormField.vue | 0 .../components/field/FormField.zh.md | 0 .../components/field/NumberInput.demo.vue | 0 .../components/field/NumberInput.md | 0 .../components/field/NumberInput.vue | 0 .../components/field/NumberInput.zh.md | 0 .../components/field/Slider.demo.vue | 0 .../ui/src => src}/components/field/Slider.md | 0 .../src => src}/components/field/Slider.vue | 0 .../src => src}/components/field/Slider.zh.md | 0 .../components/field/TextArea.demo.vue | 0 .../src => src}/components/field/TextArea.md | 0 .../src => src}/components/field/TextArea.vue | 0 .../components/field/TextArea.zh.md | 0 .../components/field/TextInput.demo.vue | 0 .../src => src}/components/field/TextInput.md | 0 .../components/field/TextInput.vue | 0 .../components/field/TextInput.zh.md | 0 .../ui/src => src}/components/field/form.css | 1 - .../components/navigation/Breadcrumb.demo.vue | 0 .../components/navigation/Breadcrumb.md | 0 .../components/navigation/Breadcrumb.vue | 0 .../components/navigation/Breadcrumb.zh.md | 0 .../components/navigation/Navigation.demo.vue | 0 .../components/navigation/Navigation.md | 0 .../components/navigation/Navigation.vue | 0 .../components/navigation/Navigation.zh.md | 0 .../components/navigation/Pagination.demo.vue | 0 .../components/navigation/Pagination.md | 0 .../components/navigation/Pagination.vue | 0 .../components/navigation/Pagination.zh.md | 0 .../components/navigation/Sidebar.demo.vue | 0 .../components/navigation/Sidebar.md | 0 .../components/navigation/Sidebar.vue | 0 .../components/navigation/Sidebar.zh.md | 0 .../components/navigation/Tabs.demo.vue | 0 .../src => src}/components/navigation/Tabs.md | 0 .../components/navigation/Tabs.vue | 0 .../components/navigation/Tabs.zh.md | 0 .../components/navigation/navigation.css | 0 .../components/navigation/sidebar.css | 4 +- .../components/navigation/tabs.css | 0 .../components/overlay/AlertDialog.demo.vue | 0 .../components/overlay/AlertDialog.md | 0 .../components/overlay/AlertDialog.vue | 0 .../components/overlay/AlertDialog.zh.md | 0 .../components/overlay/ContextMenu.demo.vue | 0 .../components/overlay/ContextMenu.md | 0 .../components/overlay/ContextMenu.vue | 0 .../components/overlay/ContextMenu.zh.md | 0 .../components/overlay/Dialog.demo.vue | 0 .../src => src}/components/overlay/Dialog.md | 0 .../src => src}/components/overlay/Dialog.vue | 0 .../components/overlay/Dialog.zh.md | 0 .../components/overlay/Drawer.demo.vue | 0 .../src => src}/components/overlay/Drawer.md | 0 .../src => src}/components/overlay/Drawer.vue | 0 .../components/overlay/Drawer.zh.md | 0 .../components/overlay/HoverCard.demo.vue | 0 .../components/overlay/HoverCard.md | 0 .../components/overlay/HoverCard.vue | 0 .../components/overlay/HoverCard.zh.md | 0 .../components/overlay/Menu.demo.vue | 6 +- .../components/overlay/Menu.md | 16 +- .../components/overlay/Menu.vue | 0 .../components/overlay/Menu.zh.md | 16 +- src/components/overlay/Popover.demo.vue | 41 + .../src => src}/components/overlay/Popover.md | 10 +- .../components/overlay/Popover.vue | 10 +- .../components/overlay/Popover.zh.md | 9 +- .../components/overlay/Tooltip.demo.vue | 0 .../src => src}/components/overlay/Tooltip.md | 0 .../components/overlay/Tooltip.vue | 0 .../components/overlay/Tooltip.zh.md | 0 .../overlay/_internal/ContextMenuState.vue | 0 .../overlay/_internal/MenuItems.vue | 0 .../components/overlay/overlay.css | 70 +- .../components/paper/Paper.demo.vue | 0 .../ui/src => src}/components/paper/Paper.md | 2 +- .../ui/src => src}/components/paper/Paper.vue | 0 .../src => src}/components/paper/Paper.zh.md | 2 +- .../components/radio/Choice.demo.vue | 0 .../ui/src => src}/components/radio/Choice.md | 0 .../src => src}/components/radio/Choice.vue | 0 .../src => src}/components/radio/Choice.zh.md | 0 .../components/radio/ChoiceCircle.demo.vue | 0 .../components/radio/ChoiceCircle.md | 0 .../components/radio/ChoiceCircle.vue | 0 .../components/radio/ChoiceCircle.zh.md | 0 .../components/radio/RadioGroup.demo.vue | 0 .../components/radio/RadioGroup.md | 0 .../components/radio/RadioGroup.vue | 0 .../components/radio/RadioGroup.zh.md | 0 .../components/radio/radio-group.css | 0 .../components/select/Combobox.demo.vue | 0 .../src => src}/components/select/Combobox.md | 0 .../components/select/Combobox.vue | 0 .../components/select/Combobox.zh.md | 0 .../components/select/Select.demo.vue | 10 + src/components/select/Select.md | 94 + src/components/select/Select.vue | 153 + src/components/select/Select.zh.md | 94 + .../components/select/combobox.css | 2 +- src/components/select/select.css | 147 + .../components/toggle/Toggle.demo.vue | 0 .../src => src}/components/toggle/Toggle.md | 0 .../src => src}/components/toggle/Toggle.vue | 0 .../components/toggle/Toggle.zh.md | 0 .../components/toggle/ToggleGroup.demo.vue | 0 .../components/toggle/ToggleGroup.md | 0 .../components/toggle/ToggleGroup.vue | 0 .../components/toggle/ToggleGroup.zh.md | 0 .../components/toggle/toggle-group.css | 0 {vendor/ui/src => src}/core/contract.ts | 0 {vendor/ui/src => src}/core/date.ts | 0 {vendor/ui/src => src}/core/index.ts | 2 + {vendor/ui/src => src}/core/keys.ts | 0 {vendor/ui/src => src}/core/motion.ts | 0 {vendor/ui/src => src}/core/pagination.ts | 0 {vendor/ui/src => src}/core/paper.ts | 0 {vendor/ui/src => src}/core/pen.ts | 0 src/core/scroll.ts | 36 + .../ui/src => src}/core/signature/NOTICE.md | 0 {vendor/ui/src => src}/core/signature/OFL.txt | 0 .../core/signature/canvas-viewport.ts | 0 .../src => src}/core/signature/hand-font.ts | 0 .../ui/src => src}/core/signature/paper.ts | 3 +- .../core/signature/pen-geometry.ts | 0 {vendor/ui/src => src}/core/signature/pen.ts | 121 +- .../ui/src => src}/core/signature/settle.ts | 0 .../ui/src => src}/core/signature/types.ts | 4 + {vendor/ui/src => src}/index.ts | 7 +- {vendor/ui/src => src}/style.css | 2 + {vendor/ui/src => src}/tokens.css | 0 {vendor/ui/src => src}/vue/index.ts | 6 +- {vendor/ui/src => src}/vue/types.ts | 5 + {vendor/ui/src => src}/vue/useAutoDismiss.ts | 0 {vendor/ui/src => src}/vue/useChoice.ts | 0 {vendor/ui/src => src}/vue/useClipboard.ts | 0 src/vue/useComponentSources.md | 20 + src/vue/useComponentSources.ts | 96 + .../src => src}/vue/useContextMenuControl.ts | 0 {vendor/ui/src => src}/vue/useControlAttrs.ts | 0 {vendor/ui/src => src}/vue/useDisclosure.ts | 0 {vendor/ui/src => src}/vue/useFocusReturn.ts | 0 {vendor/ui/src => src}/vue/useNavigation.ts | 0 .../ui/src => src}/vue/usePaperSignature.ts | 0 {vendor/ui/src => src}/vue/usePortalTarget.ts | 0 src/vue/useScrollHandoff.md | 29 + src/vue/useScrollHandoff.ts | 85 + {vendor/ui/src => src}/vue/useSidebar.ts | 0 {vendor/ui/src => src}/vue/useTabs.ts | 0 tsconfig.json | 22 +- vendor/ui/.gitignore | 8 - vendor/ui/AGENTS.md | 186 - vendor/ui/README.md | 120 - .../docs/app/components/ComponentStatus.vue | 50 - vendor/ui/eslint.config.ts | 27 - vendor/ui/package.json | 54 - vendor/ui/pnpm-lock.yaml | 13095 ---------------- vendor/ui/pnpm-workspace.yaml | 30 - .../src/components/disclosure/collapsible.css | 64 - vendor/ui/src/components/display/display.css | 187 - .../src/components/overlay/Popover.demo.vue | 21 - vendor/ui/src/components/select/Select.md | 53 - vendor/ui/src/components/select/Select.vue | 49 - vendor/ui/src/components/select/Select.zh.md | 53 - vendor/ui/src/components/select/select.css | 34 - vendor/ui/tsconfig.json | 17 - wrangler.config.ts | 8 + wrangler.jsonc | 7 - 554 files changed, 11865 insertions(+), 24832 deletions(-) create mode 100644 .agents/skills/cloudflare-sites/SKILL.md create mode 100644 .agents/skills/oq/SKILL.md create mode 100644 .agents/skills/oq/references/app-development.md create mode 100644 .agents/skills/oq/references/library-development.md create mode 100644 .agents/skills/oq/references/monorepo.md create mode 100644 .agents/skills/oq/references/oq-eslint-config.md create mode 100644 .agents/skills/oq/references/oq-unocss-config.md create mode 100644 .agents/skills/oq/references/pnpm-catalog.md create mode 100644 .agents/skills/oq/references/release-workflow.md create mode 100644 .agents/skills/oq/references/setting-up.md rename {vendor/ui/.github => .github}/workflows/ci.yml (100%) delete mode 100644 .github/workflows/refresh-circle.yml delete mode 100644 app/app.config.ts delete mode 100644 app/app.vue delete mode 100644 app/assets/css/kit.css delete mode 100644 app/components/Copy.ts delete mode 100644 app/components/CopyCommand.vue delete mode 100644 app/components/Fill.ts delete mode 100644 app/components/InstallLink.vue delete mode 100644 app/components/Installed.vue delete mode 100644 app/components/PageHead.vue delete mode 100644 app/components/RichText.ts delete mode 100644 app/components/SectionNav.vue delete mode 100644 app/components/Sheet.vue delete mode 100644 app/components/SiteFooter.vue delete mode 100644 app/components/SiteHeader.vue delete mode 100644 app/components/Stop.ts delete mode 100644 app/components/circle/CircleAccessibleList.vue delete mode 100644 app/components/circle/CircleBoard.vue delete mode 100644 app/components/circle/CircleCopySlots.vue delete mode 100644 app/components/circle/CircleNoteText.vue delete mode 100644 app/components/circle/CirclePage.vue delete mode 100644 app/components/circle/CirclePersonCard.vue delete mode 100644 app/components/content/Block.vue delete mode 100644 app/components/content/Faq.vue delete mode 100644 app/components/content/Figures.vue delete mode 100644 app/components/content/Final.vue delete mode 100644 app/components/content/Hero.vue delete mode 100644 app/components/content/Price.vue delete mode 100644 app/components/content/Quotes.vue delete mode 100644 app/components/content/Statement.vue delete mode 100644 app/components/content/Step.vue delete mode 100644 app/composables/useCircleData.ts delete mode 100644 app/composables/useCopy.ts delete mode 100644 app/composables/useInstalled.ts delete mode 100644 app/composables/useKitLink.ts delete mode 100644 app/composables/usePageSections.ts delete mode 100644 app/composables/useSignature.ts delete mode 100644 app/composables/useTheme.ts delete mode 100644 app/error.vue delete mode 100644 app/layouts/default.vue delete mode 100644 app/pages/[...slug].vue delete mode 100644 app/pages/changelog.vue delete mode 100644 app/pages/docs/[...slug].vue delete mode 100644 app/pages/index.vue delete mode 100644 app/pages/notes/[slug].vue delete mode 100644 app/pages/notes/index.vue delete mode 100644 app/types.ts delete mode 100644 app/utils/text.ts delete mode 100644 app/utils/theme.ts create mode 100644 cloudflare.config.ts delete mode 100644 content.config.ts delete mode 100644 content/en/changelog/release.md delete mode 100644 content/en/docs/0.index.md delete mode 100644 content/en/index.md delete mode 100644 content/en/install.md delete mode 100644 content/en/notes/note.md delete mode 100644 content/ja/changelog/release.md delete mode 100644 content/ja/docs/0.index.md delete mode 100644 content/ja/index.md delete mode 100644 content/ja/install.md delete mode 100644 content/ja/notes/note.md delete mode 100644 content/zh/changelog/release.md delete mode 100644 content/zh/docs/0.index.md delete mode 100644 content/zh/index.md delete mode 100644 content/zh/install.md delete mode 100644 content/zh/notes/note.md delete mode 100644 data/README.md delete mode 100644 data/hidden.json delete mode 100644 data/people.json delete mode 100644 data/sync.json rename {vendor/ui/docs => docs}/app/app.config.ts (63%) rename {vendor/ui/docs => docs}/app/app.vue (100%) rename {vendor/ui/docs => docs}/app/assets/css/fonts.css (100%) rename {vendor/ui/docs => docs}/app/assets/css/site.css (100%) rename {vendor/ui/docs => docs}/app/components/ComponentApi.vue (100%) rename {vendor/ui/docs => docs}/app/components/ComponentDemo.vue (100%) create mode 100644 docs/app/components/ComponentStatus.vue rename {vendor/ui/docs => docs}/app/components/DocBody.vue (100%) rename {vendor/ui/docs => docs}/app/components/PageHead.vue (100%) rename {vendor/ui/docs => docs}/app/components/SectionLayout.vue (100%) rename {vendor/ui/docs => docs}/app/components/Sidebar.vue (100%) rename {vendor/ui/docs => docs}/app/components/SiteFooter.vue (100%) rename {vendor/ui/docs => docs}/app/components/SiteHeader.vue (100%) rename {vendor/ui/docs => docs}/app/components/SiteNav.vue (100%) rename {vendor/ui/docs => docs}/app/components/content/ProseA.vue (100%) rename {vendor/ui/docs => docs}/app/components/content/TokenBoard.vue (100%) rename {vendor/ui/docs => docs}/app/composables/useComponentDocs.ts (100%) rename {vendor/ui/docs => docs}/app/composables/useComponentRoute.ts (100%) create mode 100644 docs/app/composables/usePaperOgImage.ts create mode 100644 docs/app/composables/useShareMeta.ts rename {vendor/ui/docs => docs}/app/composables/useSiteLink.ts (100%) rename {vendor/ui/docs => docs}/app/composables/useTheme.ts (100%) rename {vendor/ui/docs => docs}/app/error.vue (80%) rename {vendor/ui/docs => docs}/app/layouts/default.vue (100%) rename {vendor/ui/docs => docs}/app/pages/[...slug].vue (91%) rename {vendor/ui/docs => docs}/app/pages/changelog.vue (91%) rename {vendor/ui/docs => docs}/app/pages/components.vue (100%) rename {vendor/ui/docs => docs}/app/pages/components/[concept]/[name].vue (94%) rename {vendor/ui/docs => docs}/app/pages/components/[concept]/index.vue (88%) rename {vendor/ui/docs => docs}/app/pages/components/index.vue (82%) rename {vendor/ui/docs => docs}/app/pages/docs/[...slug].vue (97%) rename {vendor/ui/docs => docs}/app/pages/index.vue (96%) rename {vendor/ui/docs/shared => docs/app/utils}/component-files.ts (100%) rename {vendor/ui/docs => docs}/app/utils/components.ts (98%) rename {shared => docs/app/utils}/empty-title.ts (100%) rename {vendor/ui/docs => docs}/app/utils/navigation.ts (100%) create mode 100644 docs/app/utils/public-files.ts create mode 100644 docs/app/utils/site.ts rename {vendor/ui/docs => docs}/component-roadmap.md (99%) rename {vendor/ui/docs => docs}/consumer-mapping.md (100%) rename {vendor/ui/docs => docs}/content.config.ts (72%) rename {vendor/ui/docs => docs}/content/en/changelog/release.md (100%) rename {vendor/ui/docs => docs}/content/en/docs/0.index.md (87%) rename {vendor/ui/docs => docs}/content/en/docs/1.install.md (100%) rename {vendor/ui/docs => docs}/content/en/docs/2.tokens.md (92%) create mode 100644 docs/content/en/docs/3.language.md rename {vendor/ui/docs => docs}/content/zh/changelog/release.md (100%) rename {vendor/ui/docs => docs}/content/zh/docs/0.index.md (85%) rename {vendor/ui/docs => docs}/content/zh/docs/1.install.md (100%) rename {vendor/ui/docs => docs}/content/zh/docs/2.tokens.md (93%) create mode 100644 docs/content/zh/docs/3.language.md rename {vendor/ui/docs => docs}/eslint.config.ts (100%) rename {vendor/ui/docs => docs}/examples/ConsumerAdapters.vue (100%) rename {vendor/ui/docs => docs}/handoff.md (95%) rename {vendor/ui/docs => docs}/i18n/locales/en.json (78%) rename {vendor/ui/docs => docs}/i18n/locales/zh.json (79%) rename {vendor/ui/docs => docs}/nuxt.config.ts (67%) rename {vendor/ui/docs => docs}/package.json (75%) rename {vendor/ui/docs => docs}/plans/2026-09-30-ui-coverage.md (100%) rename {vendor/ui/docs => docs}/plans/2026-10-01-draft-homepage.md (100%) rename {vendor/ui/docs => docs}/plans/2026-10-01-site-banner.md (100%) create mode 100644 docs/public/_headers rename {vendor/ui/docs => docs}/public/favicon.svg (100%) create mode 100644 docs/public/og.png rename {vendor/ui/docs => docs}/release-audit.md (100%) rename {vendor/ui/docs => docs}/tsconfig.json (100%) delete mode 100644 i18n/locales/en.json delete mode 100644 i18n/locales/ja.json delete mode 100644 i18n/locales/zh.json delete mode 100644 nuxt.config.ts delete mode 100644 public/avatars/1067085110372171779.jpg delete mode 100644 public/avatars/1074838588012052481.jpg delete mode 100644 public/avatars/1126207424602337280.png delete mode 100644 public/avatars/1169225590077108224.jpg delete mode 100644 public/avatars/1248286805134196737.jpg delete mode 100644 public/avatars/1249322582869852161.jpg delete mode 100644 public/avatars/1263990230916444162.jpg delete mode 100644 public/avatars/1297343586984321024.jpg delete mode 100644 public/avatars/1313424628900036609.jpg delete mode 100644 public/avatars/1317141761689485312.jpg delete mode 100644 public/avatars/1325815317990305793.jpg delete mode 100644 public/avatars/1449354945900072964.jpg delete mode 100644 public/avatars/1455938770105090051.jpg delete mode 100644 public/avatars/1476943097980276743.jpg delete mode 100644 public/avatars/1487217749067591680.png delete mode 100644 public/avatars/1521086568194211842.jpg delete mode 100644 public/avatars/1554575293264072705.jpg delete mode 100644 public/avatars/1571894847610695681.jpg delete mode 100644 public/avatars/1586383785687650304.jpg delete mode 100644 public/avatars/1749277587535474688.jpg delete mode 100644 public/avatars/1789666230993145856.jpg delete mode 100644 public/avatars/1811126002749427713.jpg delete mode 100644 public/avatars/1815427488945770497.jpg delete mode 100644 public/avatars/1820066784625758208.jpg delete mode 100644 public/avatars/1825733032151756801.jpg delete mode 100644 public/avatars/1831648250841198593.jpg delete mode 100644 public/avatars/1833723975375192064.jpg delete mode 100644 public/avatars/1841126187789324288.jpg delete mode 100644 public/avatars/1854066640847298560.jpg delete mode 100644 public/avatars/1865722200185307136.jpg delete mode 100644 public/avatars/1870889540510212096.jpg delete mode 100644 public/avatars/1886927751065821188.jpg delete mode 100644 public/avatars/1898761780207501312.jpg delete mode 100644 public/avatars/1929526459661721600.jpg delete mode 100644 public/avatars/1947522310816337921.jpg delete mode 100644 public/avatars/1951001334850912256.jpg delete mode 100644 public/avatars/1979131969054347264.png delete mode 100644 public/avatars/1987402138667130881.jpg delete mode 100644 public/avatars/1994485839402057728.jpg delete mode 100644 public/avatars/2001163937388355584.jpg delete mode 100644 public/avatars/2003750140973305856.jpg delete mode 100644 public/avatars/2007010624291983360.jpg delete mode 100644 public/avatars/2012631283898187776.jpg delete mode 100644 public/avatars/2018144705448730624.jpg delete mode 100644 public/avatars/2032599702454329344.jpg delete mode 100644 public/avatars/2034862697150644224.jpg delete mode 100644 public/avatars/2046621802432983040.jpg delete mode 100644 public/avatars/2069854346590978048.jpg delete mode 100644 public/avatars/2072115710260903936.jpg delete mode 100644 public/avatars/2073035346707968000.jpg delete mode 100644 public/avatars/2080146118566944768.jpg delete mode 100644 public/avatars/2080270067426832384.jpg delete mode 100644 public/avatars/2084117736096190464.jpg delete mode 100644 public/avatars/2085321127182884864.jpg delete mode 100644 public/avatars/2085668508915118080.jpg delete mode 100644 public/avatars/2087152708696346624.jpg delete mode 100644 public/avatars/2087997512850235392.jpg delete mode 100644 public/avatars/2089299881433448448.jpg delete mode 100644 public/avatars/2089887330790481920.jpg delete mode 100644 public/avatars/2090037143972593664.jpg delete mode 100644 public/avatars/2090816762610962432.jpg delete mode 100644 public/avatars/2090993417744719872.jpg delete mode 100644 public/avatars/2092993804852948992.jpg delete mode 100644 public/avatars/2094811881961844736.jpg delete mode 100644 public/avatars/2095023594594320384.jpg delete mode 100644 public/avatars/2095556737231364096.jpg delete mode 100644 public/avatars/2097614252605648896.jpg delete mode 100644 public/avatars/2098243498973519885.jpg delete mode 100644 public/avatars/2100959825303932928.jpg delete mode 100644 public/avatars/2391269245.jpg delete mode 100644 public/avatars/2871437570.jpg delete mode 100644 public/avatars/294688744.jpg delete mode 100644 public/avatars/3005075238.jpg delete mode 100644 public/avatars/380562749.jpg delete mode 100644 public/avatars/425629159.jpg delete mode 100644 public/avatars/4313176880.jpg delete mode 100644 public/avatars/454281254.jpg delete mode 100644 public/avatars/54918133.jpg delete mode 100644 public/avatars/802087418295783426.jpg delete mode 100644 public/avatars/818705139120734209.jpg delete mode 100644 public/avatars/84791916.jpg delete mode 100644 public/avatars/849656764312178688.jpg delete mode 100644 public/avatars/912516778298720256.jpg delete mode 100644 public/avatars/918716499254132736.jpg delete mode 100644 public/avatars/96058727.jpg delete mode 100644 public/favicon.svg rename {vendor/ui/scripts => scripts}/check-tokens.ts (83%) delete mode 100644 scripts/generate-mock-circle.mjs delete mode 100644 scripts/refresh-circle.ts delete mode 100644 shared/circle/layout.test.ts delete mode 100644 shared/circle/layout.ts delete mode 100644 shared/circle/note.test.ts delete mode 100644 shared/circle/note.ts delete mode 100644 shared/circle/pack.test.ts delete mode 100644 shared/circle/pack.ts delete mode 100644 shared/circle/sync.test.ts delete mode 100644 shared/circle/sync.ts delete mode 100644 shared/circle/types.ts delete mode 100644 shared/circle/viewport.test.ts delete mode 100644 shared/circle/viewport.ts delete mode 100644 shared/circle/waiting.test.ts delete mode 100644 shared/circle/waiting.ts delete mode 100644 shared/final-mark.ts create mode 100644 skills-lock.json rename {vendor/ui/src => src}/components/button/Button.demo.vue (100%) rename {vendor/ui/src => src}/components/button/Button.md (100%) rename {vendor/ui/src => src}/components/button/Button.vue (100%) rename {vendor/ui/src => src}/components/button/Button.zh.md (100%) rename {vendor/ui/src => src}/components/button/CopyButton.demo.vue (100%) rename {vendor/ui/src => src}/components/button/CopyButton.md (100%) rename {vendor/ui/src => src}/components/button/CopyButton.vue (100%) rename {vendor/ui/src => src}/components/button/CopyButton.zh.md (100%) rename {vendor/ui/src => src}/components/button/IconButton.demo.vue (100%) rename {vendor/ui/src => src}/components/button/IconButton.md (100%) rename {vendor/ui/src => src}/components/button/IconButton.vue (100%) rename {vendor/ui/src => src}/components/button/IconButton.zh.md (100%) rename {vendor/ui/src => src}/components/button/copy-button.css (100%) rename {vendor/ui/src => src}/components/button/icon-button.css (100%) rename {vendor/ui/src => src}/components/checkbox/Checkbox.demo.vue (100%) rename {vendor/ui/src => src}/components/checkbox/Checkbox.md (100%) rename {vendor/ui/src => src}/components/checkbox/Checkbox.vue (100%) rename {vendor/ui/src => src}/components/checkbox/Checkbox.zh.md (100%) rename {vendor/ui/src => src}/components/date/Calendar.demo.vue (100%) rename {vendor/ui/src => src}/components/date/Calendar.md (100%) rename {vendor/ui/src => src}/components/date/Calendar.vue (100%) rename {vendor/ui/src => src}/components/date/Calendar.zh.md (100%) rename {vendor/ui/src => src}/components/date/DatePicker.demo.vue (100%) rename {vendor/ui/src => src}/components/date/DatePicker.md (100%) rename {vendor/ui/src => src}/components/date/DatePicker.vue (100%) rename {vendor/ui/src => src}/components/date/DatePicker.zh.md (100%) rename {vendor/ui/src => src}/components/date/date.css (98%) create mode 100644 src/components/devtools/UiDevtools.demo.vue create mode 100644 src/components/devtools/UiDevtools.md create mode 100644 src/components/devtools/UiDevtools.vue create mode 100644 src/components/devtools/UiDevtools.zh.md create mode 100644 src/components/devtools/devtools.css rename {vendor/ui/src => src}/components/disclosure/Accordion.demo.vue (100%) rename {vendor/ui/src => src}/components/disclosure/Accordion.md (100%) rename {vendor/ui/src => src}/components/disclosure/Accordion.vue (100%) rename {vendor/ui/src => src}/components/disclosure/Accordion.zh.md (100%) rename {vendor/ui/src => src}/components/disclosure/Collapsible.demo.vue (100%) rename {vendor/ui/src => src}/components/disclosure/Collapsible.md (72%) rename {vendor/ui/src => src}/components/disclosure/Collapsible.vue (88%) rename {vendor/ui/src => src}/components/disclosure/Collapsible.zh.md (72%) create mode 100644 src/components/disclosure/collapsible.css rename {vendor/ui/src => src}/components/display/AspectRatio.demo.vue (100%) rename {vendor/ui/src => src}/components/display/AspectRatio.md (100%) rename {vendor/ui/src => src}/components/display/AspectRatio.vue (100%) rename {vendor/ui/src => src}/components/display/AspectRatio.zh.md (100%) rename {vendor/ui/src => src}/components/display/Avatar.demo.vue (100%) rename {vendor/ui/src => src}/components/display/Avatar.md (100%) rename {vendor/ui/src => src}/components/display/Avatar.vue (100%) rename {vendor/ui/src => src}/components/display/Avatar.zh.md (100%) rename {vendor/ui/src => src}/components/display/Badge.demo.vue (100%) rename {vendor/ui/src => src}/components/display/Badge.md (100%) rename {vendor/ui/src => src}/components/display/Badge.vue (100%) rename {vendor/ui/src => src}/components/display/Badge.zh.md (100%) rename {vendor/ui/src => src}/components/display/Card.demo.vue (100%) rename {vendor/ui/src => src}/components/display/Card.md (100%) rename {vendor/ui/src => src}/components/display/Card.vue (100%) rename {vendor/ui/src => src}/components/display/Card.zh.md (100%) create mode 100644 src/components/display/CodeBlock.demo.vue create mode 100644 src/components/display/CodeBlock.md create mode 100644 src/components/display/CodeBlock.vue create mode 100644 src/components/display/CodeBlock.zh.md create mode 100644 src/components/display/GridTable.demo.vue create mode 100644 src/components/display/GridTable.md create mode 100644 src/components/display/GridTable.vue create mode 100644 src/components/display/GridTable.zh.md rename {vendor/ui/src => src}/components/display/Separator.demo.vue (100%) rename {vendor/ui/src => src}/components/display/Separator.md (100%) rename {vendor/ui/src => src}/components/display/Separator.vue (100%) rename {vendor/ui/src => src}/components/display/Separator.zh.md (100%) rename {vendor/ui/src => src}/components/display/Table.demo.vue (100%) rename {vendor/ui/src => src}/components/display/Table.md (100%) rename {vendor/ui/src => src}/components/display/Table.vue (100%) rename {vendor/ui/src => src}/components/display/Table.zh.md (100%) create mode 100644 src/components/display/code-block.css create mode 100644 src/components/display/display.css rename {vendor/ui/src => src}/components/feedback/Alert.demo.vue (100%) rename {vendor/ui/src => src}/components/feedback/Alert.md (100%) rename {vendor/ui/src => src}/components/feedback/Alert.vue (100%) rename {vendor/ui/src => src}/components/feedback/Alert.zh.md (100%) rename {vendor/ui/src => src}/components/feedback/Banner.demo.vue (100%) rename {vendor/ui/src => src}/components/feedback/Banner.md (90%) rename {vendor/ui/src => src}/components/feedback/Banner.vue (100%) rename {vendor/ui/src => src}/components/feedback/Banner.zh.md (90%) rename {vendor/ui/src => src}/components/feedback/EmptyState.demo.vue (100%) rename {vendor/ui/src => src}/components/feedback/EmptyState.md (100%) rename {vendor/ui/src => src}/components/feedback/EmptyState.vue (100%) rename {vendor/ui/src => src}/components/feedback/EmptyState.zh.md (100%) rename {vendor/ui/src => src}/components/feedback/Progress.demo.vue (100%) rename {vendor/ui/src => src}/components/feedback/Progress.md (100%) rename {vendor/ui/src => src}/components/feedback/Progress.vue (100%) rename {vendor/ui/src => src}/components/feedback/Progress.zh.md (100%) rename {vendor/ui/src => src}/components/feedback/Skeleton.demo.vue (100%) rename {vendor/ui/src => src}/components/feedback/Skeleton.md (100%) rename {vendor/ui/src => src}/components/feedback/Skeleton.vue (100%) rename {vendor/ui/src => src}/components/feedback/Skeleton.zh.md (100%) rename {vendor/ui/src => src}/components/feedback/Spinner.demo.vue (100%) rename {vendor/ui/src => src}/components/feedback/Spinner.md (100%) rename {vendor/ui/src => src}/components/feedback/Spinner.vue (100%) rename {vendor/ui/src => src}/components/feedback/Spinner.zh.md (100%) rename {vendor/ui/src => src}/components/feedback/Toast.demo.vue (100%) rename {vendor/ui/src => src}/components/feedback/Toast.md (100%) rename {vendor/ui/src => src}/components/feedback/Toast.vue (100%) rename {vendor/ui/src => src}/components/feedback/Toast.zh.md (100%) rename {vendor/ui/src => src}/components/feedback/ToastRegion.demo.vue (100%) rename {vendor/ui/src => src}/components/feedback/ToastRegion.md (100%) rename {vendor/ui/src => src}/components/feedback/ToastRegion.vue (100%) rename {vendor/ui/src => src}/components/feedback/ToastRegion.zh.md (100%) rename {vendor/ui/src => src}/components/feedback/banner.css (95%) rename {vendor/ui/src => src}/components/feedback/feedback.css (97%) rename {vendor/ui/src => src}/components/feedback/skeleton.css (92%) rename {vendor/ui/src => src}/components/feedback/toast.css (97%) rename {vendor/ui/src => src}/components/field/DateInput.demo.vue (100%) rename {vendor/ui/src => src}/components/field/DateInput.md (100%) rename {vendor/ui/src => src}/components/field/DateInput.vue (100%) rename {vendor/ui/src => src}/components/field/DateInput.zh.md (100%) rename {vendor/ui/src => src}/components/field/FileUpload.demo.vue (100%) rename {vendor/ui/src => src}/components/field/FileUpload.md (100%) rename {vendor/ui/src => src}/components/field/FileUpload.vue (100%) rename {vendor/ui/src => src}/components/field/FileUpload.zh.md (100%) rename {vendor/ui/src => src}/components/field/FormField.demo.vue (100%) rename {vendor/ui/src => src}/components/field/FormField.md (100%) rename {vendor/ui/src => src}/components/field/FormField.vue (100%) rename {vendor/ui/src => src}/components/field/FormField.zh.md (100%) rename {vendor/ui/src => src}/components/field/NumberInput.demo.vue (100%) rename {vendor/ui/src => src}/components/field/NumberInput.md (100%) rename {vendor/ui/src => src}/components/field/NumberInput.vue (100%) rename {vendor/ui/src => src}/components/field/NumberInput.zh.md (100%) rename {vendor/ui/src => src}/components/field/Slider.demo.vue (100%) rename {vendor/ui/src => src}/components/field/Slider.md (100%) rename {vendor/ui/src => src}/components/field/Slider.vue (100%) rename {vendor/ui/src => src}/components/field/Slider.zh.md (100%) rename {vendor/ui/src => src}/components/field/TextArea.demo.vue (100%) rename {vendor/ui/src => src}/components/field/TextArea.md (100%) rename {vendor/ui/src => src}/components/field/TextArea.vue (100%) rename {vendor/ui/src => src}/components/field/TextArea.zh.md (100%) rename {vendor/ui/src => src}/components/field/TextInput.demo.vue (100%) rename {vendor/ui/src => src}/components/field/TextInput.md (100%) rename {vendor/ui/src => src}/components/field/TextInput.vue (100%) rename {vendor/ui/src => src}/components/field/TextInput.zh.md (100%) rename {vendor/ui/src => src}/components/field/form.css (97%) rename {vendor/ui/src => src}/components/navigation/Breadcrumb.demo.vue (100%) rename {vendor/ui/src => src}/components/navigation/Breadcrumb.md (100%) rename {vendor/ui/src => src}/components/navigation/Breadcrumb.vue (100%) rename {vendor/ui/src => src}/components/navigation/Breadcrumb.zh.md (100%) rename {vendor/ui/src => src}/components/navigation/Navigation.demo.vue (100%) rename {vendor/ui/src => src}/components/navigation/Navigation.md (100%) rename {vendor/ui/src => src}/components/navigation/Navigation.vue (100%) rename {vendor/ui/src => src}/components/navigation/Navigation.zh.md (100%) rename {vendor/ui/src => src}/components/navigation/Pagination.demo.vue (100%) rename {vendor/ui/src => src}/components/navigation/Pagination.md (100%) rename {vendor/ui/src => src}/components/navigation/Pagination.vue (100%) rename {vendor/ui/src => src}/components/navigation/Pagination.zh.md (100%) rename {vendor/ui/src => src}/components/navigation/Sidebar.demo.vue (100%) rename {vendor/ui/src => src}/components/navigation/Sidebar.md (100%) rename {vendor/ui/src => src}/components/navigation/Sidebar.vue (100%) rename {vendor/ui/src => src}/components/navigation/Sidebar.zh.md (100%) rename {vendor/ui/src => src}/components/navigation/Tabs.demo.vue (100%) rename {vendor/ui/src => src}/components/navigation/Tabs.md (100%) rename {vendor/ui/src => src}/components/navigation/Tabs.vue (100%) rename {vendor/ui/src => src}/components/navigation/Tabs.zh.md (100%) rename {vendor/ui/src => src}/components/navigation/navigation.css (100%) rename {vendor/ui/src => src}/components/navigation/sidebar.css (96%) rename {vendor/ui/src => src}/components/navigation/tabs.css (100%) rename {vendor/ui/src => src}/components/overlay/AlertDialog.demo.vue (100%) rename {vendor/ui/src => src}/components/overlay/AlertDialog.md (100%) rename {vendor/ui/src => src}/components/overlay/AlertDialog.vue (100%) rename {vendor/ui/src => src}/components/overlay/AlertDialog.zh.md (100%) rename {vendor/ui/src => src}/components/overlay/ContextMenu.demo.vue (100%) rename {vendor/ui/src => src}/components/overlay/ContextMenu.md (100%) rename {vendor/ui/src => src}/components/overlay/ContextMenu.vue (100%) rename {vendor/ui/src => src}/components/overlay/ContextMenu.zh.md (100%) rename {vendor/ui/src => src}/components/overlay/Dialog.demo.vue (100%) rename {vendor/ui/src => src}/components/overlay/Dialog.md (100%) rename {vendor/ui/src => src}/components/overlay/Dialog.vue (100%) rename {vendor/ui/src => src}/components/overlay/Dialog.zh.md (100%) rename {vendor/ui/src => src}/components/overlay/Drawer.demo.vue (100%) rename {vendor/ui/src => src}/components/overlay/Drawer.md (100%) rename {vendor/ui/src => src}/components/overlay/Drawer.vue (100%) rename {vendor/ui/src => src}/components/overlay/Drawer.zh.md (100%) rename {vendor/ui/src => src}/components/overlay/HoverCard.demo.vue (100%) rename {vendor/ui/src => src}/components/overlay/HoverCard.md (100%) rename {vendor/ui/src => src}/components/overlay/HoverCard.vue (100%) rename {vendor/ui/src => src}/components/overlay/HoverCard.zh.md (100%) rename vendor/ui/src/components/overlay/DropdownMenu.demo.vue => src/components/overlay/Menu.demo.vue (90%) rename vendor/ui/src/components/overlay/DropdownMenu.md => src/components/overlay/Menu.md (85%) rename vendor/ui/src/components/overlay/DropdownMenu.vue => src/components/overlay/Menu.vue (100%) rename vendor/ui/src/components/overlay/DropdownMenu.zh.md => src/components/overlay/Menu.zh.md (86%) create mode 100644 src/components/overlay/Popover.demo.vue rename {vendor/ui/src => src}/components/overlay/Popover.md (85%) rename {vendor/ui/src => src}/components/overlay/Popover.vue (86%) rename {vendor/ui/src => src}/components/overlay/Popover.zh.md (85%) rename {vendor/ui/src => src}/components/overlay/Tooltip.demo.vue (100%) rename {vendor/ui/src => src}/components/overlay/Tooltip.md (100%) rename {vendor/ui/src => src}/components/overlay/Tooltip.vue (100%) rename {vendor/ui/src => src}/components/overlay/Tooltip.zh.md (100%) rename {vendor/ui/src => src}/components/overlay/_internal/ContextMenuState.vue (100%) rename {vendor/ui/src => src}/components/overlay/_internal/MenuItems.vue (100%) rename {vendor/ui/src => src}/components/overlay/overlay.css (80%) rename {vendor/ui/src => src}/components/paper/Paper.demo.vue (100%) rename {vendor/ui/src => src}/components/paper/Paper.md (95%) rename {vendor/ui/src => src}/components/paper/Paper.vue (100%) rename {vendor/ui/src => src}/components/paper/Paper.zh.md (93%) rename {vendor/ui/src => src}/components/radio/Choice.demo.vue (100%) rename {vendor/ui/src => src}/components/radio/Choice.md (100%) rename {vendor/ui/src => src}/components/radio/Choice.vue (100%) rename {vendor/ui/src => src}/components/radio/Choice.zh.md (100%) rename {vendor/ui/src => src}/components/radio/ChoiceCircle.demo.vue (100%) rename {vendor/ui/src => src}/components/radio/ChoiceCircle.md (100%) rename {vendor/ui/src => src}/components/radio/ChoiceCircle.vue (100%) rename {vendor/ui/src => src}/components/radio/ChoiceCircle.zh.md (100%) rename {vendor/ui/src => src}/components/radio/RadioGroup.demo.vue (100%) rename {vendor/ui/src => src}/components/radio/RadioGroup.md (100%) rename {vendor/ui/src => src}/components/radio/RadioGroup.vue (100%) rename {vendor/ui/src => src}/components/radio/RadioGroup.zh.md (100%) rename {vendor/ui/src => src}/components/radio/radio-group.css (100%) rename {vendor/ui/src => src}/components/select/Combobox.demo.vue (100%) rename {vendor/ui/src => src}/components/select/Combobox.md (100%) rename {vendor/ui/src => src}/components/select/Combobox.vue (100%) rename {vendor/ui/src => src}/components/select/Combobox.zh.md (100%) rename {vendor/ui/src => src}/components/select/Select.demo.vue (64%) create mode 100644 src/components/select/Select.md create mode 100644 src/components/select/Select.vue create mode 100644 src/components/select/Select.zh.md rename {vendor/ui/src => src}/components/select/combobox.css (98%) create mode 100644 src/components/select/select.css rename {vendor/ui/src => src}/components/toggle/Toggle.demo.vue (100%) rename {vendor/ui/src => src}/components/toggle/Toggle.md (100%) rename {vendor/ui/src => src}/components/toggle/Toggle.vue (100%) rename {vendor/ui/src => src}/components/toggle/Toggle.zh.md (100%) rename {vendor/ui/src => src}/components/toggle/ToggleGroup.demo.vue (100%) rename {vendor/ui/src => src}/components/toggle/ToggleGroup.md (100%) rename {vendor/ui/src => src}/components/toggle/ToggleGroup.vue (100%) rename {vendor/ui/src => src}/components/toggle/ToggleGroup.zh.md (100%) rename {vendor/ui/src => src}/components/toggle/toggle-group.css (100%) rename {vendor/ui/src => src}/core/contract.ts (100%) rename {vendor/ui/src => src}/core/date.ts (100%) rename {vendor/ui/src => src}/core/index.ts (90%) rename {vendor/ui/src => src}/core/keys.ts (100%) rename {vendor/ui/src => src}/core/motion.ts (100%) rename {vendor/ui/src => src}/core/pagination.ts (100%) rename {vendor/ui/src => src}/core/paper.ts (100%) rename {vendor/ui/src => src}/core/pen.ts (100%) create mode 100644 src/core/scroll.ts rename {vendor/ui/src => src}/core/signature/NOTICE.md (100%) rename {vendor/ui/src => src}/core/signature/OFL.txt (100%) rename {vendor/ui/src => src}/core/signature/canvas-viewport.ts (100%) rename {vendor/ui/src => src}/core/signature/hand-font.ts (100%) rename {vendor/ui/src => src}/core/signature/paper.ts (98%) rename {vendor/ui/src => src}/core/signature/pen-geometry.ts (100%) rename {vendor/ui/src => src}/core/signature/pen.ts (81%) rename {vendor/ui/src => src}/core/signature/settle.ts (100%) rename {vendor/ui/src => src}/core/signature/types.ts (91%) rename {vendor/ui/src => src}/index.ts (86%) rename {vendor/ui/src => src}/style.css (98%) rename {vendor/ui/src => src}/tokens.css (100%) rename {vendor/ui/src => src}/vue/index.ts (60%) rename {vendor/ui/src => src}/vue/types.ts (96%) rename {vendor/ui/src => src}/vue/useAutoDismiss.ts (100%) rename {vendor/ui/src => src}/vue/useChoice.ts (100%) rename {vendor/ui/src => src}/vue/useClipboard.ts (100%) create mode 100644 src/vue/useComponentSources.md create mode 100644 src/vue/useComponentSources.ts rename {vendor/ui/src => src}/vue/useContextMenuControl.ts (100%) rename {vendor/ui/src => src}/vue/useControlAttrs.ts (100%) rename {vendor/ui/src => src}/vue/useDisclosure.ts (100%) rename {vendor/ui/src => src}/vue/useFocusReturn.ts (100%) rename {vendor/ui/src => src}/vue/useNavigation.ts (100%) rename {vendor/ui/src => src}/vue/usePaperSignature.ts (100%) rename {vendor/ui/src => src}/vue/usePortalTarget.ts (100%) create mode 100644 src/vue/useScrollHandoff.md create mode 100644 src/vue/useScrollHandoff.ts rename {vendor/ui/src => src}/vue/useSidebar.ts (100%) rename {vendor/ui/src => src}/vue/useTabs.ts (100%) delete mode 100644 vendor/ui/.gitignore delete mode 100644 vendor/ui/AGENTS.md delete mode 100644 vendor/ui/README.md delete mode 100644 vendor/ui/docs/app/components/ComponentStatus.vue delete mode 100644 vendor/ui/eslint.config.ts delete mode 100644 vendor/ui/package.json delete mode 100644 vendor/ui/pnpm-lock.yaml delete mode 100644 vendor/ui/pnpm-workspace.yaml delete mode 100644 vendor/ui/src/components/disclosure/collapsible.css delete mode 100644 vendor/ui/src/components/display/display.css delete mode 100644 vendor/ui/src/components/overlay/Popover.demo.vue delete mode 100644 vendor/ui/src/components/select/Select.md delete mode 100644 vendor/ui/src/components/select/Select.vue delete mode 100644 vendor/ui/src/components/select/Select.zh.md delete mode 100644 vendor/ui/src/components/select/select.css delete mode 100644 vendor/ui/tsconfig.json create mode 100644 wrangler.config.ts delete mode 100644 wrangler.jsonc diff --git a/.agents/skills/cloudflare-sites/SKILL.md b/.agents/skills/cloudflare-sites/SKILL.md new file mode 100644 index 0000000..f4d22e1 --- /dev/null +++ b/.agents/skills/cloudflare-sites/SKILL.md @@ -0,0 +1,113 @@ +--- +name: cloudflare-sites +description: Deploy froQ static sites and Nuxt sites to Cloudflare as Workers with the cf CLI. Use when adding Cloudflare deploy, Workers Builds, migrating a Pages project, migrating wrangler.jsonc, or when asked to copy void, paper-landing, or lig. Do not create new Pages projects. +metadata: + author: froQ + version: "2026.10.11" + source: Hand-written from the 1000-observations Workers migration. https://github.com/0froq/skills-pack +--- + +新的 froQ 静态站和 Nuxt 站发布到 Cloudflare Workers,用 `cf`。不要新建 Pages 项目,也不要照抄 void、paper-landing、lig。 + +## 不要照抄的仓库 + +- `void`:先是 Worker 加 GitHub Action(仓库里放 API token),后来改成 Pages 的 GitHub 连接。那是旧决定。 +- `paper-landing`:Pages 的 GitHub 连接,构建 `pnpm generate`,发布 `.output/public`。没有 wrangler。 +- `lig`:没有部署。 + +不要照抄它们的部署方式。新站点和从 Pages 迁过来的站点都读这份 skill。迁的时候新建 Worker,不要沿用 Pages 项目、仓库里的 API token,或 `preset: 'cloudflare_pages'`。 + +## Pages + +`cf` 不能创建 Pages 项目。控制台里新建 Pages 的入口已经被收起来。官方文档仍说现有 Pages 不会被关掉,新项目从 Workers 开始。静态资源请求在 Workers 上和 Pages 一样不按请求计费。Wrangler 还有 `wrangler pages project create`,那不是新站点的路径。 + +## 已有 wrangler 配置时 + +仓库里有 `wrangler.jsonc` 或 `wrangler.toml`,还没有 `cloudflare.config.ts`: + +1. 工作区要干净。`cf migrate` 在脏工作区会停,除非加上 `--force`。 +2. 安装 wrangler,至少 4.136。`cf` 的 Wrangler bundler 需要它。 +3. 跑 `cf migrate`。它写出 `cloudflare.config.ts`。没有 `@cloudflare/vite-plugin` 时,资源目录写在 `wrangler.config.ts` 的 `assetsDirectory`。 +4. 它不覆盖已有的 `cloudflare.config.ts`,也不删除旧的 `wrangler.jsonc`。 +5. `cf deploy --dry-run` 通过之后,再删 `wrangler.jsonc`。 + +还没有 `cloudflare.config.ts` 时,不要跑 `cf init`、`cf dev`、`cf build`、`cf deploy`。它们不读 `wrangler.jsonc`,可能改写配置。 + +## Nuxt 静态站 + +Nitro 用静态预设,公开目录指到 `dist`。不要设 `preset: 'cloudflare_pages'`。那个预设会写 `_routes.json` 和 `_redirects`(`/* /404.html 404`),并警告要切到 D1。 + +```ts +nitro: { + output: { + publicDir: 'dist', + }, +} +``` + +`cloudflare.config.ts` 放 Worker 本身。`compatibilityDate` 用动手那天的日期。名字可以以数字开头。 + +```ts +import { defineConfig } from 'cf/config' + +export default defineConfig({ + worker: { + name: '', + compatibilityDate: '', + observability: { + enabled: true, + traces: { enabled: true }, + }, + assets: { + htmlHandling: 'drop-trailing-slash', + notFoundHandling: '404-page', + }, + }, +}) +``` + +`wrangler.config.ts` 只放构建侧的资源目录。它不是 Pages 配置,不要写 `pages_build_output_dir`。 + +```ts +import { defineWranglerConfig } from 'wrangler/experimental-config' + +export default defineWranglerConfig({ + types: { generate: false }, + assetsDirectory: './dist', +}) +``` + +`package.json` 保留 `dev`、`build`、`generate`。另加: + +```json +"deploy": "pnpm generate && cf deploy" +``` + +`cf build` 和 `cf deploy` 不跑 `package.json` 脚本,所以生成要写在 deploy 前面。不要把 `pnpm dev` 换成 `cf dev`。 + +Nuxt 路由没有尾斜杠,静态文件却是 `folder/index.html`。`auto-trailing-slash` 会把 `/s/0001/homepage` 307 到 `/s/0001/homepage/`,空段再进文档路径就会 404。用 `drop-trailing-slash`。页面如果自己拼接 slug,丢掉空段。 + +Workers Builds 设 `NODE_VERSION=22`。构建命令 `pnpm generate`。生产分支的部署命令是 `pnpm exec cf deploy`,用项目里钉住的 `cf`。仓库里不放 API token。 + +非生产分支的预览部署命令是 `pnpm exec cf previews deploy`。预览不继承生产的变量和绑定;静态站两边都只要 `NODE_VERSION`。分支预览地址按分支名固定,后面的构建更新同一条。日志里另外一条带哈希的地址每次都会变。 + +PR 评论里的 Preview URL 只在部署命令执行 `wrangler preview` 时出现。`cf previews deploy` 会把预览部署上去,地址在构建日志里,评论不写链接。继续用 `cf`,不要为了那条评论改成 wrangler。 + +已经连上 Workers Builds、还在用旧的非生产 trigger 的 Worker,才能做一次 `cf workers-builds workers migrate-to-previews`。这一步不能撤销。新建的 Worker 默认就是预览,不要再跑迁移。 + +`public/_headers` 会被复制进 `dist`,用来给 `/_nuxt` 加缓存头。`.cloudflare` 和 `.wrangler` 放进 `.gitignore`。 + +## 工具版本 + +- `cf` 是 beta,命令和配置格式还会变。验证过的版本是 `1.0.0-beta.12`,钉死这个版本,不要跟 latest。 +- 加载 `cloudflare.config.ts` 需要 Node.js >= 22.18(`module.registerHooks`)。报错文案可能让人以为是 Bun,先看 `node -v`。 +- 项目声明了 `cf` 之后,全局的 `cf` 会转给项目里的那份。 +- `cf deploy --dry-run` 不需要登录,用来确认资源打进了包。 +- `cf auth login` 要浏览器。无人值守用环境变量 `CLOUDFLARE_API_TOKEN`,不要写进仓库。 + +## 文档 + +- https://developers.cloudflare.com/cf/wrangler/migrate/ +- https://developers.cloudflare.com/cf/projects/ +- https://developers.cloudflare.com/workers/static-assets/routing/static-site-generation/ +- https://developers.cloudflare.com/pages/get-started/ diff --git a/.agents/skills/oq/SKILL.md b/.agents/skills/oq/SKILL.md new file mode 100644 index 0000000..e5c47e4 --- /dev/null +++ b/.agents/skills/oq/SKILL.md @@ -0,0 +1,156 @@ +--- +name: oq +description: oQ's opinionated tooling and conventions for JavaScript/TypeScript projects. Based on Anthony Fu's style with personal customizations for UnoCSS, ESLint, pnpm catalog, and automated releases. Use when setting up new projects with these preferences. +metadata: + author: oQ + version: "2026.03.10" + source: Hand-written. https://github.com/0froq/skills-pack +--- + +## Coding Practices + +### Code Organization + +- **Single responsibility**: Each source file should have a clear, focused scope/purpose +- **Split large files**: Break files when they become large or handle too many concerns +- **Type separation**: Always separate types and interfaces into `types.ts` or `types/*.ts` +- **Constants extraction**: Move constants to a dedicated `constants.ts` file + +### Runtime Environment + +- **Prefer isomorphic code**: Write runtime-agnostic code that works in Node, browser, and workers whenever possible +- **Clear runtime indicators**: When code is environment-specific, add a comment at the top of the file: + +```ts +// @env node +// @env browser +``` + +### TypeScript + +- **Explicit return types**: Declare return types explicitly when possible +- **Avoid complex inline types**: Extract complex types into dedicated `type` or `interface` declarations + +### Comments + +- **Avoid unnecessary comments**: Code should be self-explanatory +- **Explain "why" not "how"**: Comments should describe the reasoning or intent, not what the code does + +### Testing (Vitest) + +- Test files: `foo.ts` → `foo.test.ts` (same directory) +- Use `describe`/`it` API (not `test`) +- Use `toMatchSnapshot` for complex outputs +- Use `toMatchFileSnapshot` with explicit path for language-specific snapshots + +--- + +## Tooling Choices + +### @antfu/ni Commands + +| Command | Description | +|---------|-------------| +| `ni` | Install dependencies | +| `ni ` / `ni -D ` | Add dependency / dev dependency | +| `nr + + +``` + +### State Management + +| Scenario | Choice | +|----------|--------| +| Component state | `shallowRef()` over `ref()` | +| Objects | Use `ref()`, avoid `reactive()` | +| Global state | Pinia | +| URL state | `useRoute()` / `useRouter()` | + +### Props and Emits + +Always type with interfaces: + +```vue + +``` + +### Component Structure + +```vue + + + + + +``` + +## UnoCSS Conventions + +### Attribute Usage + +Always use `un-` prefixed attributes: + +```vue + +
+ + +
+``` + +### Shortcuts + +Use defined shortcuts for common patterns: + +```vue + +
+ +
+``` + +### Icon Usage + +```vue + +
+
+
+ + +
+
+``` + +### Responsive Design + +```vue +
+ +
+``` + +Custom breakpoints: +- `sm`: 600px +- `md`: 900px + +## Nuxt Conventions + +### File Structure + +``` +app/ +├── components/ # Vue components +│ ├── ui/ # UI primitives +│ ├── forms/ # Form components +│ └── layouts/ # Layout components +├── composables/ # Auto-imported composables +├── layouts/ # Page layouts +├── pages/ # File-based routes +├── server/ # API routes +│ └── api/ # Server API +├── types/ # TypeScript types +├── utils/ # Utility functions +├── app.vue # App root +└── nuxt.config.ts # Nuxt configuration +``` + +### Server Routes + +```ts +// server/api/users.get.ts +export default defineEventHandler(async (event) => { + // Handle GET /api/users + return await fetchUsers() +}) + +// server/api/users.post.ts +export default defineEventHandler(async (event) => { + const body = await readBody(event) + return await createUser(body) +}) +``` + +### Composables + +Place in `composables/` for auto-import: + +```ts +// composables/useUser.ts +export function useUser() { + const user = useState('user', () => null) + + async function login(credentials) { + user.value = await $fetch('/api/login', { + method: 'POST', + body: credentials + }) + } + + return { + user: readonly(user), + login + } +} +``` + +### Layouts + +```vue + + +``` + +## Font Usage + +### Apply Font Classes + +```vue + +``` + +## Utilities + +### Preferred Libraries + +| Purpose | Library | +|---------|---------| +| Vue utilities | @vueuse/core | +| HTTP client | $fetch (built-in) | +| Date formatting | date-fns or Intl.DateTimeFormat | +| Validation | zod | +| Testing | vitest + @vue/test-utils | + +### VueUse Composables + +```ts +// Common VueUse composables +import { + useDark, + useToggle, + useStorage, + useFetch, + useIntersectionObserver +} from '@vueuse/core' +``` diff --git a/.agents/skills/oq/references/library-development.md b/.agents/skills/oq/references/library-development.md new file mode 100644 index 0000000..662c78a --- /dev/null +++ b/.agents/skills/oq/references/library-development.md @@ -0,0 +1,161 @@ +--- +name: library-development +description: Library bundling with tsdown and pure ESM publishing. Use when creating npm packages. +--- + +# Library Development + +## Bundling with tsdown + +Use [tsdown](https://github.com/rolldown/tsdown) for TypeScript library bundling (powered by Rolldown). + +### Installation + +```bash +pnpm add -D tsdown +``` + +### Configuration + +```ts +// tsdown.config.ts +import { defineConfig } from 'tsdown' + +export default defineConfig({ + entry: ['./src/index.ts'], + outDir: 'dist', + format: ['esm'], // Pure ESM + dts: true, // Generate declarations + clean: true, // Clean outDir before build + splitting: true, // Code splitting + minify: false, // Keep readable for debugging +}) +``` + +### Package.json + +```json +{ + "name": "@myorg/my-lib", + "version": "1.0.0", + "type": "module", + "main": "./dist/index.js", + "module": "./dist/index.js", + "types": "./dist/index.d.ts", + "exports": { + ".": { + "types": "./dist/index.d.ts", + "import": "./dist/index.js" + } + }, + "files": [ + "dist" + ], + "scripts": { + "build": "tsdown", + "dev": "tsdown --watch", + "prepack": "pnpm build" + } +} +``` + +## Pure ESM + +Publish only ESM (no CommonJS): + +```json +{ + "type": "module" +} +``` + +Benefits: +- Smaller bundle size +- Tree-shaking support +- Native async imports +- Future-proof + +## Export Patterns + +### Named Exports + +```ts +// src/index.ts +export { foo, bar } from './foo' +export type { FooOptions } from './types' +export { default as MyComponent } from './MyComponent.vue' +``` + +### Subpath Exports + +```json +{ + "exports": { + ".": { + "types": "./dist/index.d.ts", + "import": "./dist/index.js" + }, + "./utils": { + "types": "./dist/utils.d.ts", + "import": "./dist/utils.js" + }, + "./package.json": "./package.json" + } +} +``` + +Usage: +```ts +import { foo } from 'my-lib' +import { util } from 'my-lib/utils' +``` + +## TypeScript Configuration + +```json +{ + "compilerOptions": { + "target": "ESNext", + "module": "ESNext", + "moduleResolution": "bundler", + "strict": true, + "esModuleInterop": true, + "skipLibCheck": true, + "resolveJsonModule": true, + "isolatedModules": true, + "declaration": true, + "declarationMap": true, + "noEmit": true + }, + "include": ["src"], + "exclude": ["node_modules", "dist"] +} +``` + +## Testing Libraries + +```ts +// vitest.config.ts +import { defineConfig } from 'vitest/config' + +export default defineConfig({ + test: { + environment: 'node', + globals: true, + }, +}) +``` + +## GitHub Actions for Release + +See [release-workflow](release-workflow.md) for automated releases. + +## Versioning Strategy + +Follow semantic versioning: + +- **MAJOR**: Breaking changes +- **MINOR**: New features (backward compatible) +- **PATCH**: Bug fixes + +Use conventional commits for automatic changelog generation. diff --git a/.agents/skills/oq/references/monorepo.md b/.agents/skills/oq/references/monorepo.md new file mode 100644 index 0000000..85b33e8 --- /dev/null +++ b/.agents/skills/oq/references/monorepo.md @@ -0,0 +1,208 @@ +--- +name: monorepo +description: Monorepo setup with pnpm workspaces, centralized aliases, and Turborepo. Use when creating or managing multi-package repositories. +--- + +# Monorepo Setup + +## pnpm Workspaces + +Use pnpm workspaces for monorepo management: + +```yaml +# pnpm-workspace.yaml +packages: + - 'packages/*' + - 'apps/*' +``` + +## Scripts Convention + +Have scripts in each package, and use `-r` (recursive) flag at root. +Enable ESLint cache for faster linting in monorepos. + +```json +// root package.json +{ + "scripts": { + "build": "pnpm run -r build", + "test": "vitest", + "lint": "eslint . --cache --concurrency=auto", + "lint:fix": "eslint . --cache --concurrency=auto --fix", + "dev": "pnpm run -r --parallel dev", + "clean": "rm -rf node_modules packages/*/node_modules apps/*/node_modules" + } +} +``` + +In each package's `package.json`, add the scripts: + +```json +// packages/*/package.json +{ + "scripts": { + "build": "tsdown", + "dev": "tsdown --watch", + "prepack": "pnpm build" + } +} + +// apps/*/package.json +{ + "scripts": { + "build": "nuxt build", + "dev": "nuxt dev", + "generate": "nuxt generate" + } +} +``` + +## ESLint Cache + +```json +{ + "scripts": { + "lint": "eslint . --cache --concurrency=auto" + } +} +``` + +## Turborepo (Optional) + +For monorepos with many packages or long build times, use Turborepo for task orchestration and caching. + +### Configuration + +```json +// turbo.json +{ + "$schema": "https://turbo.build/schema.json", + "globalDependencies": ["**/.env.*local"], + "pipeline": { + "build": { + "dependsOn": ["^build"], + "outputs": [".nuxt/**", ".output/**", "dist/**"] + }, + "lint": { + "outputs": [] + }, + "dev": { + "cache": false, + "persistent": true + } + } +} +``` + +## Centralized Alias + +For better DX across Vite, Nuxt, Vitest configs, create a centralized `alias.ts` at project root: + +```ts +// alias.ts +import fs from 'node:fs' +import { fileURLToPath } from 'node:url' +import { join, relative } from 'pathe' + +const root = fileURLToPath(new URL('.', import.meta.url)) +const r = (path: string) => fileURLToPath(new URL(`./packages/${path}`, import.meta.url)) + +export const alias = { + '@myorg/core': r('core/src/index.ts'), + '@myorg/utils': r('utils/src/index.ts'), + '@myorg/ui': r('ui/src/index.ts'), + // Add more aliases as needed +} + +// Auto-update tsconfig.alias.json paths +const raw = fs.readFileSync(join(root, 'tsconfig.alias.json'), 'utf-8').trim() +const tsconfig = JSON.parse(raw) +tsconfig.compilerOptions.paths = Object.fromEntries( + Object.entries(alias).map(([key, value]) => [key, [`./${relative(root, value)}`]]), +) +const newRaw = JSON.stringify(tsconfig, null, 2) +if (newRaw !== raw) + fs.writeFileSync(join(root, 'tsconfig.alias.json'), `${newRaw}\n`, 'utf-8') +``` + +Then update the `tsconfig.json` to use the alias file: + +```json +{ + "extends": [ + "./tsconfig.alias.json" + ] +} +``` + +### Using Alias in Configs + +Reference the centralized alias in all config files: + +```ts +// vite.config.ts +import { alias } from './alias' + +export default defineConfig({ + resolve: { alias }, +}) +``` + +```ts +// nuxt.config.ts +import { alias } from './alias' + +export default defineNuxtConfig({ + alias, +}) +``` + +```ts +// vitest.config.ts +import { alias } from './alias' + +export default defineConfig({ + resolve: { alias }, +}) +``` + +## Package Naming + +Use scoped packages for internal packages: + +```json +// packages/core/package.json +{ + "name": "@myorg/core", + "version": "1.0.0", + "main": "./dist/index.js", + "types": "./dist/index.d.ts" +} +``` + +## Internal Dependencies + +Reference workspace packages with `workspace:` protocol: + +```json +{ + "dependencies": { + "@myorg/core": "workspace:*", + "@myorg/utils": "workspace:*" + } +} +``` + +## Build Order + +pnpm automatically handles build order based on `workspace:` dependencies. No need for manual sequencing. + +## Publishing + +```bash +# Version all packages +pnpm version [major|minor|patch] + +# Publish all +pnpm publish -r +``` diff --git a/.agents/skills/oq/references/oq-eslint-config.md b/.agents/skills/oq/references/oq-eslint-config.md new file mode 100644 index 0000000..c1149d8 --- /dev/null +++ b/.agents/skills/oq/references/oq-eslint-config.md @@ -0,0 +1,183 @@ +--- +name: oq-eslint-config +description: Custom @antfu/eslint-config setup with specific Vue formatting rules and dprint for markdown. Use when configuring ESLint for oQ-style projects. +--- + +# oQ's ESLint Configuration + +Based on `@antfu/eslint-config` with personal customizations for Vue projects and specific formatting preferences. + +## Base Configuration + +```ts +// eslint.config.ts +import antfu from '@antfu/eslint-config' +import nuxt from './.nuxt/eslint.config.mjs' + +export default antfu( + { + unocss: true, + pnpm: true, + typescript: true, + vue: true, + rules: { + // Vue template formatting - one attribute per line + 'vue/max-attributes-per-line': ['error', { + singleline: { max: 1 }, + multiline: { max: 1 }, + }], + // Disable unused imports auto-removal (manual cleanup preferred) + 'unused-imports/no-unused-imports': 'off', + }, + formatters: { + css: true, // Format CSS, LESS, SCSS + html: true, // Format HTML + markdown: 'dprint' // Use dprint for markdown (not prettier) + }, + }, +) + .append(nuxt()) // Append Nuxt's ESLint config if using Nuxt +``` + +## Key Customizations + +### Vue Template Formatting + +Strict attribute-per-line enforcement for Vue templates: + +```vue + +
+ + +
+``` + +### Unused Imports + +Unlike the default antfu config, unused imports are NOT automatically removed. This allows for: +- Intentional side-effect imports +- Gradual refactoring without breaking builds +- Manual review of what to remove + +### Markdown Formatting + +Uses **dprint** instead of Prettier for markdown files: +- Faster formatting +- Better control over formatting rules +- Consistent with modern tooling + +## Required Dependencies + +```bash +# Core +pnpm add -D @antfu/eslint-config + +# For Nuxt projects +pnpm add -D @nuxt/eslint + +# Formatters (CSS/HTML/Markdown) +pnpm add -D eslint-plugin-format + +# If using dprint for markdown +pnpm add -D dprint +``` + +## Formatters Setup + +### dprint Configuration (Optional) + +Create `dprint.json` for markdown formatting: + +```json +{ + "typescript": {}, + "json": {}, + "markdown": { + "lineWidth": 100, + "deno": true + }, + "excludes": [ + "**/node_modules", + "**/.nuxt", + "**/dist" + ], + "plugins": [ + "https://plugins.dprint.dev/typescript-0.88.0.wasm", + "https://plugins.dprint.dev/json-0.19.0.wasm", + "https://plugins.dprint.dev/markdown-0.16.0.wasm" + ] +} +``` + +## VS Code Settings + +Add to `.vscode/settings.json`: + +```jsonc +{ + "prettier.enable": false, + "editor.formatOnSave": false, + "editor.codeActionsOnSave": { + "source.fixAll.eslint": "explicit", + "source.organizeImports": "never" + }, + "eslint.rules.customizations": [ + { "rule": "style/*", "severity": "off", "fixable": true }, + { "rule": "format/*", "severity": "off", "fixable": true }, + { "rule": "*vue/max-attributes-per-line", "severity": "error", "fixable": true } + ], + "eslint.validate": [ + "javascript", + "javascriptreact", + "typescript", + "typescriptreact", + "vue", + "html", + "markdown", + "json", + "jsonc", + "yaml", + "css", + "less", + "scss" + ] +} +``` + +## Running ESLint + +```bash +# Lint and fix +pnpm run lint --fix + +# Check only +pnpm run lint +``` + +## Additional Rule Overrides + +If needed, add overrides after the main config: + +```ts +export default antfu({ + // ... base config +}) + .append(nuxt()) + .override('my-custom-rules', { + files: ['**/*.vue'], + rules: { + // Additional Vue-specific rules + }, + }) +``` + + diff --git a/.agents/skills/oq/references/oq-unocss-config.md b/.agents/skills/oq/references/oq-unocss-config.md new file mode 100644 index 0000000..ad3461b --- /dev/null +++ b/.agents/skills/oq/references/oq-unocss-config.md @@ -0,0 +1,228 @@ +--- +name: oq-unocss-config +description: Custom UnoCSS configuration with specific fonts, prefixed attributify, and icon collections. Use when setting up UnoCSS for oQ-style projects. +--- + +# oQ's UnoCSS Configuration + +Personalized UnoCSS setup with custom fonts, prefixed attributify mode, and curated icon collections. + +## Configuration + +```ts +// uno.config.ts +import { + defineConfig, + presetAttributify, + presetIcons, + presetTagify, + presetTypography, + presetWind4, + transformerDirectives, + transformerVariantGroup, +} from 'unocss' + +// Optional: For Markdown support +// import extractorMdc from '@unocss/extractor-mdc' + +export default defineConfig({ + theme: { + breakpoints: { + sm: '600px', + md: '900px', + }, + }, + rules: [ + // Local fonts - place font files in assets/fonts/ + ['font-sans', { 'font-family': 'LXGW Neo ZhiSong Plus' }], + ['font-serif', { 'font-family': 'YshiPen-ShutiTC' }], + ['font-mono', { 'font-family': 'LXGW Bright Code TC' }], + // Google Fonts - loaded via Google Fonts CDN + ['font-stylish', { 'font-family': 'Caveat' }], + ['font-script', { 'font-family': 'Ephesis' }], + ], + content: { + pipeline: { + include: [ + /\.(vue|svelte|[jt]sx|mdx?|astro|elm|php|phtml|html|css)($|\?)/, + ], + }, + }, + shortcuts: { + 'page-content': 'mx-auto max-w-[800px] block px-10 min-w-0', + }, + presets: [ + presetWind4(), + presetIcons({ + collections: { + carbon: () => import('@iconify-json/carbon/icons.json', { with: { type: 'json' } }).then(i => i.default), + solar: () => import('@iconify-json/solar/icons.json', { with: { type: 'json' } }).then(i => i.default), + openmoji: () => import('@iconify-json/openmoji/icons.json', { with: { type: 'json' } }).then(i => i.default), + }, + }), + presetAttributify({ + strict: true, + prefixedOnly: true, // Only match `un-` prefixed attributes + prefix: 'un-', + }), + presetTagify({ + prefix: 'un-', + }), + presetTypography(), + ], + transformers: [ + transformerDirectives(), + transformerVariantGroup(), + ], + extractors: [ + // Uncomment for Markdown support + // extractorMdc(), + ], + layers: { + default: 0, + components: 1, + utilities: 2, + }, +}) +``` + +## Key Features + +### Custom Fonts + +Five font families configured: + +| Class | Font | Type | Source | +|-------|------|------|--------| +| `font-sans` | LXGW Neo ZhiSong Plus | Sans-serif | Local files in `assets/fonts/` | +| `font-serif` | YshiPen-ShutiTC | Serif | Local files in `assets/fonts/` | +| `font-mono` | LXGW Bright Code TC | Monospace | Local files in `assets/fonts/` | +| `font-stylish` | Caveat | Handwriting | Google Fonts CDN | +| `font-script` | Ephesis | Script | Google Fonts CDN | + +### Prefixed Attributify Mode + +Uses `un-` prefix to avoid conflicts with other libraries: + +```html + +
+ + +
+``` + +Benefits: +- Avoids conflicts with Vue props or HTML attributes +- Clear separation of UnoCSS utilities +- Strict mode ensures only valid utilities work + +### Icon Collections + +Three curated icon sets: + +- **carbon**: IBM Carbon Design System icons +- **solar**: Solar icons by 480 Design +- **openmoji**: OpenMoji open source emojis + +Usage: +```html +
+
+
+``` + +### Shortcuts + +Pre-defined shortcuts for common patterns: + +```html + +
+ +
+``` + +## Dependencies + +```bash +# Core UnoCSS +pnpm add -D unocss + +# Presets +pnpm add -D @unocss/preset-attributify +pnpm add -D @unocss/preset-icons +pnpm add -D @unocss/preset-tagify +pnpm add -D @unocss/preset-typography +pnpm add -D @unocss/preset-wind4 + +# Transformers +pnpm add -D @unocss/transformer-directives +pnpm add -D @unocss/transformer-variant-group + +# Icon collections +pnpm add -D @iconify-json/carbon +pnpm add -D @iconify-json/solar +pnpm add -D @iconify-json/openmoji + +# Optional: Markdown support +# pnpm add -D @unocss/extractor-mdc +``` + +## Vite/Nuxt Integration + +### Vite + +```ts +// vite.config.ts +import UnoCSS from 'unocss/vite' +import { defineConfig } from 'vite' + +export default defineConfig({ + plugins: [ + UnoCSS(), + ], +}) +``` + +### Nuxt + +```ts +// nuxt.config.ts +export default defineNuxtConfig({ + modules: [ + '@unocss/nuxt', + ], + unocss: { + // Config loaded from uno.config.ts automatically + }, +}) +``` + +## Custom Breakpoints + +Custom responsive breakpoints: + +| Breakpoint | Width | +|------------|-------| +| `sm` | 600px | +| `md` | 900px | + +Usage: +```html +
+``` + +## Layers + +CSS layer ordering: + +1. `default` (0) - Base styles +2. `components` (1) - Component-specific styles +3. `utilities` (2) - Utility classes (highest specificity) + + diff --git a/.agents/skills/oq/references/pnpm-catalog.md b/.agents/skills/oq/references/pnpm-catalog.md new file mode 100644 index 0000000..84ad572 --- /dev/null +++ b/.agents/skills/oq/references/pnpm-catalog.md @@ -0,0 +1,303 @@ +--- +name: pnpm-catalog +description: pnpm catalog configuration and management tools. Use when setting up workspace dependency management with strict catalog conventions. +--- + +# pnpm Catalog Configuration + +Strict pnpm catalog setup for consistent dependency management across workspaces. + +## What is pnpm Catalog? + +A centralized dependency version management system for pnpm workspaces. Instead of specifying versions in each package's `package.json`, you define them once in `pnpm-workspace.yaml`. + +**Benefits:** +- Single source of truth for dependency versions +- Easy bulk updates +- Prevents version drift across packages +- Automatic deduplication + +## Configuration + +### pnpm-workspace.yaml + +```yaml +packages: + - 'packages/*' + - 'apps/*' + +# Named catalogs - NEVER use default catalog +catalog: + # Production dependencies + prod: + vue: ^3.5.0 + pinia: ^2.2.0 + vue-router: ^4.4.0 + + # Bundler inlined dependencies + inlined: + defu: ^6.1.4 + scule: ^1.3.0 + + # Dev tools + dev: + typescript: ^5.6.0 + eslint: ^9.0.0 + vitest: ^2.1.0 + + # Frontend libraries + frontend: + '@vueuse/core': ^11.0.0 + '@vueuse/head': ^2.0.0 +``` + +### Using Catalog Dependencies + +In package.json, use `catalog:` protocol: + +```json +{ + "dependencies": { + "vue": "catalog:prod", + "pinia": "catalog:prod", + "defu": "catalog:inlined", + "@vueuse/core": "catalog:frontend" + }, + "devDependencies": { + "typescript": "catalog:dev", + "vitest": "catalog:dev" + } +} +``` + +### Catalog Protocol Syntax + +```json +{ + "package-name": "catalog:" // Use default catalog (AVOID) + "package-name": "catalog:prod", // Use 'prod' named catalog + "package-name": "catalog:dev" // Use 'dev' named catalog +} +``` + +## Catalog Organization Strategy + +### Recommended Categories + +| Catalog | Purpose | Examples | +|---------|---------|----------| +| `prod` | Production runtime deps | vue, pinia, vue-router | +| `inlined` | Bundled/inlined deps | defu, scule, pathe | +| `dev` | Development tools | typescript, eslint, vitest | +| `frontend` | UI/frontend libraries | @vueuse/core, unocss | +| `backend` | Server-side deps | h3, nitro, @trpc/server | +| `testing` | Testing utilities | @vue/test-utils, cypress | + +### Catalog Selection Rules + +1. **NEVER use the default catalog** - Always use named catalogs +2. **Group by function** - Similar purposes in same catalog +3. **Consider bundle size** - Separate inlined vs external deps +4. **Update frequency** - Group deps that update together + +## pnpm-workspace-utils + +Anthony Fu's tool for managing pnpm workspaces and catalogs. + +### Installation + +```bash +pnpm add -D pnpm-workspace-utils +``` + +### Usage + +```bash +# Check for catalog inconsistencies +pnpm exec pnpm-workspace-utils check + +# Update catalog versions interactively +pnpm exec pnpm-workspace-utils update + +# Sync catalog to all packages +pnpm exec pnpm-workspace-utils sync +``` + +### Features + +- Detects packages using non-catalog versions +- Shows outdated catalog entries +- Interactive version updates +- Validates workspace consistency + +## nip - Interactive Package Manager + +Interactive tool for managing dependencies in pnpm workspaces. + +### Installation + +```bash +pnpm add -D @antfu/nip +``` + +### Usage + +```bash +# Interactive dependency management +pnpm exec nip + +# Add dependency to specific workspace +pnpm exec nip add vue --workspace=apps/web + +# Update dependencies interactively +pnpm exec nip update + +# Remove dependency +pnpm exec nip remove lodash +``` + +### Features + +- Interactive UI for dependency management +- Workspace-aware operations +- Bulk add/remove/update +- Catalog integration + +## VS Code Integration + +### pnpm-catalog-lens Extension + +Shows catalog version hints inline: + +```json +// .vscode/extensions.json +{ + "recommendations": [ + "antfu.pnpm-catalog-lens" + ] +} +``` + +Features: +- Inline version hints +- Click to navigate to catalog definition +- Highlights non-catalog dependencies + +## Workflow + +### Adding a New Dependency + +1. **Check if it exists** in catalog: + ```bash + cat pnpm-workspace.yaml | grep package-name + ``` + +2. **If exists**: Use catalog protocol in package.json + ```json + { "package-name": "catalog:prod" } + ``` + +3. **If new**: Add to appropriate catalog first + ```yaml + catalog: + prod: + package-name: ^1.0.0 + ``` + +4. **Then install**: + ```bash + pnpm install + ``` + +### Updating Dependencies + +1. **Check status**: + ```bash + pnpm exec pnpm-workspace-utils check + ``` + +2. **Update catalog versions**: + ```bash + pnpm exec pnpm-workspace-utils update + ``` + +3. **Or manually** edit `pnpm-workspace.yaml` + +4. **Install updates**: + ```bash + pnpm update + ``` + +### Migration to Catalog + +Convert existing dependencies to use catalog: + +```bash +# Check for non-catalog deps +pnpm exec pnpm-workspace-utils check + +# Shows recommendations for migration +# Manually update package.json files to use catalog: protocol +``` + +## Common Patterns + +### Lockfile Maintenance + +```json +{ + "scripts": { + "clean": "rm -rf node_modules pnpm-lock.yaml", + "fresh": "pnpm clean && pnpm install", + "check-catalog": "pnpm-workspace-utils check" + } +} +``` + +### CI/CD with Catalog + +```yaml +# .github/workflows/ci.yml +- name: Install dependencies + run: pnpm install --frozen-lockfile + +# Lockfile ensures catalog versions are respected +``` + +## Best Practices + +1. **Always use named catalogs** - Never rely on default catalog +2. **Keep catalogs organized** - Group by purpose/function +3. **Regular consistency checks** - Run `pnpm-workspace-utils check` +4. **Document catalog categories** - Add comments in pnpm-workspace.yaml +5. **Update systematically** - Use tools for bulk updates +6. **Pin critical versions** - For sensitive deps, use exact versions + +## Troubleshooting + +### Dependency not found + +```bash +# Ensure catalog is defined +pnpm exec pnpm-workspace-utils check + +# Reinstall to pick up catalog changes +rm -rf node_modules pnpm-lock.yaml && pnpm install +``` + +### Version conflicts + +```bash +# Check which packages use different versions +pnpm why package-name + +# Update catalog to resolve +pnpm exec pnpm-workspace-utils update +``` + + diff --git a/.agents/skills/oq/references/release-workflow.md b/.agents/skills/oq/references/release-workflow.md new file mode 100644 index 0000000..fcc4013 --- /dev/null +++ b/.agents/skills/oq/references/release-workflow.md @@ -0,0 +1,221 @@ +--- +name: release-workflow +description: Automated GitHub releases using changelogithub. Use when setting up release automation for oQ-style projects. +--- + +# Release Workflow + +Automated GitHub releases using [changelogithub](https://github.com/antfu/changelogithub) by Anthony Fu. + +## What is changelogithub? + +Generates beautiful changelogs from conventional commits and creates GitHub releases automatically. + +- Parses conventional commits +- Groups changes by type (features, fixes, etc.) +- Generates markdown changelog +- Creates GitHub releases with notes +- Cross-references issues and PRs + +## GitHub Actions Workflow + +**`.github/workflows/release.yml`**: + +```yaml +name: Release + +on: + push: + tags: + - 'v*' + +jobs: + release: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Install pnpm + uses: pnpm/action-setup@v4 + + - name: Setup Node + uses: actions/setup-node@v4 + with: + node-version: lts/* + cache: pnpm + + - name: Install dependencies + run: pnpm install --frozen-lockfile + + - name: Build + run: pnpm run build + + - name: Release + run: npx changelogithub + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} +``` + +## Conventional Commits + +changelogithub parses conventional commits. Follow this format: + +``` +(): + +[optional body] + +[optional footer(s)] +``` + +### Types + +| Type | Description | Changelog Section | +|------|-------------|-------------------| +| `feat` | New feature | ✨ Features | +| `fix` | Bug fix | 🐞 Bug Fixes | +| `docs` | Documentation changes | 📖 Documentation | +| `style` | Code style changes | 🎨 Styles | +| `refactor` | Code refactoring | 🏗 Refactoring | +| `perf` | Performance improvements | ⚡ Performance | +| `test` | Adding/updating tests | 🧪 Tests | +| `chore` | Build/process changes | 🛠 Chore | + +### Examples + +```bash +# Feature +feat: add user authentication + +# Bug fix +fix(api): resolve null pointer exception + +# Breaking change +feat!: redesign API response format + +# With scope and body +feat(auth): implement OAuth2 login + +Adds support for Google and GitHub OAuth2 providers. +Closes #123 +``` + +## Versioning + +Use semantic versioning for tags: + +```bash +# Patch release (bug fixes) +git tag v1.0.1 + +# Minor release (features, backwards compatible) +git tag v1.1.0 + +# Major release (breaking changes) +git tag v2.0.0 +``` + +## Release Process + +1. **Ensure all changes are committed** with conventional commit messages +2. **Update version** in package.json (if applicable) +3. **Create and push tag**: + ```bash + git tag v1.0.0 + git push origin v1.0.0 + ``` +4. **GitHub Actions automatically**: + - Runs build + - Generates changelog + - Creates GitHub release + +## Changelog Preview + +Generated changelog includes: + +- ✨ Features +- 🐞 Bug Fixes +- 🏗 Refactoring +- 📖 Documentation +- 🧪 Tests +- ⚡ Performance +- 🎨 Styles +- 🛠 Chore + +## Custom Configuration + +Create `changelogithub.config.ts` for customization: + +```ts +import { defineConfig } from 'changelogithub' + +export default defineConfig({ + // Filter commits + types: { + feat: { title: '🚀 Features' }, + fix: { title: '🐛 Bug Fixes' }, + docs: { title: '📚 Documentation' }, + }, + + // Exclude certain commits + excludeScopes: ['deps', 'ci'], + + // Custom contributors section + contributors: true, +}) +``` + +## Alternative: sxzz/workflows + +For a simpler setup, use the reusable workflow: + +```yaml +name: Release + +on: + push: + tags: + - 'v*' + +jobs: + release: + uses: sxzz/workflows/.github/workflows/release.yml@v1 + with: + publish: true + permissions: + contents: write + id-token: write +``` + +This uses changelogithub internally with sensible defaults. + +## Required Permissions + +Ensure GitHub Actions has write permissions: + +1. Go to **Settings → Actions → General** +2. Under **Workflow permissions**, select: + - ✅ Read and write permissions + - ✅ Allow GitHub Actions to create and approve pull requests + +## Troubleshooting + +### No changelog generated + +- Ensure commits follow conventional commit format +- Check that tags follow semantic versioning (`v*.*.*`) +- Verify GITHUB_TOKEN has write permissions + +### Missing entries + +- Only commits since last tag are included +- Squash merges preserve commit messages from the PR +- Use `!` suffix for breaking changes + + diff --git a/.agents/skills/oq/references/setting-up.md b/.agents/skills/oq/references/setting-up.md new file mode 100644 index 0000000..6574f7f --- /dev/null +++ b/.agents/skills/oq/references/setting-up.md @@ -0,0 +1,214 @@ +--- +name: setting-up +description: Project setup files including .gitignore, GitHub Actions workflows, VS Code extensions, and font loading. Use when initializing new projects with oQ's style. +--- + +# Project Setup + +## .gitignore + +Create when `.gitignore` is not present: + +``` +*.log +*.tgz +.cache +.DS_Store +.eslintcache +.idea +.env +.env.local +.env.*.local +.nuxt +.temp +.output +.turbo +cache +coverage +dist +lib-cov +logs +node_modules +temp +``` + +## GitHub Actions + +### Autofix Workflow + +**`.github/workflows/autofix.yml`** - Auto-fix linting on PRs: + +```yaml +name: autofix.ci + +on: [pull_request] + +jobs: + autofix: + uses: sxzz/workflows/.github/workflows/autofix.yml@v1 + permissions: + contents: read +``` + +### Unit Test Workflow + +**`.github/workflows/unit-test.yml`** - Run tests on push/PR: + +```yaml +name: Unit Test + +on: + push: + branches: [main] + pull_request: + branches: [main] + +permissions: {} + +jobs: + unit-test: + uses: sxzz/workflows/.github/workflows/unit-test.yml@v1 +``` + +### Release Workflow + +See [release-workflow](release-workflow.md) for changelogithub setup. + +## VS Code Extensions + +Configure in `.vscode/extensions.json`: + +```json +{ + "recommendations": [ + "dbaeumer.vscode-eslint", + "antfu.pnpm-catalog-lens", + "antfu.iconify", + "antfu.unocss", + "antfu.slidev", + "vue.volar" + ] +} +``` + +| Extension | Description | +|-----------|-------------| +| `dbaeumer.vscode-eslint` | ESLint integration for linting and formatting | +| `antfu.pnpm-catalog-lens` | Shows pnpm catalog version hints inline | +| `antfu.iconify` | Iconify icon preview and autocomplete | +| `antfu.unocss` | UnoCSS IntelliSense and syntax highlighting | +| `antfu.slidev` | Slidev preview and syntax highlighting | +| `vue.volar` | Vue Language Features | + +## Font Loading + +### Local Fonts + +For LXGW Neo ZhiSong Plus, YshiPen-ShutiTC, and LXGW Bright Code TC: + +1. Place font files in `assets/fonts/` +2. Create CSS `@font-face` declarations: + +```css +/* assets/fonts/fonts.css */ +@font-face { + font-family: 'LXGW Neo ZhiSong Plus'; + src: url('./LXGWNeoZhiSongPlus-Regular.woff2') format('woff2'); + font-weight: normal; + font-style: normal; + font-display: swap; +} + +@font-face { + font-family: 'YshiPen-ShutiTC'; + src: url('./YshiPen-ShutiTC-Regular.woff2') format('woff2'); + font-weight: normal; + font-style: normal; + font-display: swap; +} + +@font-face { + font-family: 'LXGW Bright Code TC'; + src: url('./LXGWBrightCodeTC-Regular.woff2') format('woff2'); + font-weight: normal; + font-style: normal; + font-display: swap; +} +``` + +3. Import in your app entry: + +```ts +// main.ts or app.vue +import '~/assets/fonts/fonts.css' +``` + +### Google Fonts + +For Caveat and Ephesis, add to your HTML head: + +```html + + + +``` + +Or via Nuxt configuration: + +```ts +// nuxt.config.ts +export default defineNuxtConfig({ + app: { + head: { + link: [ + { rel: 'preconnect', href: 'https://fonts.googleapis.com' }, + { rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' }, + { rel: 'stylesheet', href: 'https://fonts.googleapis.com/css2?family=Caveat:wght@400;500;600;700&family=Ephesis&display=swap' }, + ], + }, + }, +}) +``` + +## package.json Scripts + +Standard scripts for oQ-style projects: + +```json +{ + "scripts": { + "dev": "nuxt dev", + "build": "nuxt build", + "generate": "nuxt generate", + "preview": "nuxt preview", + "lint": "eslint . --cache --concurrency=auto", + "lint:fix": "eslint . --cache --concurrency=auto --fix", + "postinstall": "nuxt prepare", + "prepare": "npx simple-git-hooks" + } +} +``` + +## TypeScript Configuration + +```json +{ + "compilerOptions": { + "target": "ESNext", + "module": "ESNext", + "moduleResolution": "bundler", + "strict": true, + "esModuleInterop": true, + "skipLibCheck": true, + "resolveJsonModule": true, + "isolatedModules": true, + "noEmit": true, + "baseUrl": ".", + "paths": { + "~/*": ["./*"], + "@/*": ["./*"] + } + }, + "exclude": ["node_modules", ".nuxt", "dist"] +} +``` diff --git a/vendor/ui/.github/workflows/ci.yml b/.github/workflows/ci.yml similarity index 100% rename from vendor/ui/.github/workflows/ci.yml rename to .github/workflows/ci.yml diff --git a/.github/workflows/refresh-circle.yml b/.github/workflows/refresh-circle.yml deleted file mode 100644 index 78aef64..0000000 --- a/.github/workflows/refresh-circle.yml +++ /dev/null @@ -1,33 +0,0 @@ -name: Refresh mutuals - -on: - schedule: - - cron: '20 4 * * 1' - workflow_dispatch: - -permissions: - contents: write - -jobs: - refresh: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v4 - - uses: actions/setup-node@v4 - with: - node-version: '22' - - name: Pull mutuals and new interactions - run: node --experimental-strip-types scripts/refresh-circle.ts - env: - SOCIALDATA_API_KEY: ${{ secrets.SOCIALDATA_API_KEY }} - - name: Commit the roster - run: | - git config user.name "github-actions[bot]" - git config user.email "41898282+github-actions[bot]@users.noreply.github.com" - git add data - if git diff --staged --quiet; then - echo "no changes" - exit 0 - fi - git commit -m "chore: refresh mutual circle" - git push diff --git a/.gitignore b/.gitignore index ff051b9..b6d6d66 100644 --- a/.gitignore +++ b/.gitignore @@ -1,22 +1,10 @@ -*.log -*.tgz -.cache -.DS_Store -.eslintcache -.idea -.env -.env.local -.env.*.local +node_modules +dist .nuxt -.temp .output -.turbo -.wrangler -cache -coverage -dist -lib-cov -logs -node_modules -temp .data +.cloudflare +.wrangler +.eslintcache +*.log +.DS_Store diff --git a/AGENTS.md b/AGENTS.md index 0c01607..89df742 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,18 +1,70 @@ -# Agents +# 把 @froq/ui 嵌进当前项目 -改 `data/people.json` 里某个人的条目时,提交说明统一用: +你在另一个项目里工作。用户要这个项目使用 froq 的 UI 库。按本文件做。库的仓库是 https://github.com/0froq/ui ,本文件在仓库根目录。 +做完之后要同时满足这两件事: + +- 当前项目的 `vendor/ui/` 里是这份库的完整源码,并且已经提交在当前项目里。依赖用 file 协议指向 `vendor/ui`。本地 dev 和远端构建都编译这次提交里的这些文件。 +- 当前项目自己的 agent markdown 里写有「推送到上游」「拉取上游」和「把项目里的组件抽进库」。以后用户在这个项目里说「推到上游」「跟上 UI 上游」或「把这个组件抽进 UI 库」,只读该项目的 agent markdown 就能做。抽组件时,拿不准分层、粒度和风格要先问用户;做完要说明放在哪、props 是什么。不必再打开本文件,但写库代码时要读 `vendor/ui/AGENTS.md` 的「代码规范」。 + +## 禁止 + +- 不要 `pnpm add github:0froq/ui`,不要锁 tag,不要发 npm。 +- 不要 `pnpm link`,不要 `UI_LOCAL`,不要把 `@froq/ui` alias 到本项目以外的目录。 +- 不要用 git submodule。不要在 `vendor/ui` 里执行 `git init`、`git commit` 或 `git push`。 +- 不要把库挪进 `packages/ui`。不要把 `vendor/ui` 写进当前项目的 `pnpm-workspace.yaml`。 +- 当前项目已有的页面和组件保持不动,除非用户要你换成这个库里的组件,或要你把某个组件抽进库。 + +`vendor/ui` 是当前项目里的普通目录,提交记在当前项目上。 + +## 安装 + +在当前项目的根目录操作。 + +1. 确认这是一个 git 仓库。`git status` 必须是干净的。不干净就停下来,不要 stash。 +2. `vendor/ui` 已经存在就不要再 `subtree add`。转到「已经嵌过」。 +3. 把库放进项目并提交。这条命令自己会产生提交: + +```bash +git subtree add --prefix=vendor/ui https://github.com/0froq/ui.git main --squash ``` -docs(people): update <字段> of <名字> -docs(people): add <字段> of <名字> + +仓库是公开的,用这个 https 地址,不需要 token。 + +4. 加上依赖。项目用 pnpm 时: + +```bash +pnpm add ./vendor/ui ``` -`update` 改已有内容,`add` 写入新内容。字段用数据里的名字,例如 `impression`、`aboutMe`、`timeline`。名字用这个人的 `name`。 +保持包管理器写进 `package.json` 的那一行。它必须是 file 协议,指向 `vendor/ui`,例如 `"@froq/ui": "file:vendor/ui"`。项目用别的包管理器时,用那个管理器的 `file:` 依赖,不要把项目改成 pnpm。 -这次提交如果改了 `data/people.json` 里某些人的 `impression`,在提交说明的正文里另起一行,把这些人的 `@handle` 用空格隔开写全,方便整段复制去发 X。只算画出来的文字变了的人。`""` 和 `[]` 都是空白,字符串和拆成同样几行的数组也算同一份内容,这类格式改动不要写进这行。 +5. 当前项目是 Nuxt 时,在 `nuxt.config` 里加上 `build: { transpile: ['@froq/ui'] }`。页面要用组件时,把 `@froq/ui/style.css` 放进 `css`。没有页面要用,就不要加进全局 `css`。Vite 项目直接编译 `vendor/ui` 里的 `.vue`,不要加 alias,也不要加 `server.fs.allow`。 +6. 当前项目的 eslint 如果会检查全部文件,把 `vendor/ui/**` 加进 ignore。不要用当前项目的格式规则去改库里已有的源码。 +7. 按下一节,把同步和抽组件的步骤写进当前项目的 agent markdown。 +8. 提交这次安装剩下的文件:`package.json`、锁文件、`nuxt.config`、eslint 配置、agent markdown。`subtree add` 已经提交过 `vendor/ui` 本身,不要把无关改动放进这次提交。 - +### 引用 + +```ts +import '@froq/ui/style.css' +import { Choice, Toggle } from '@froq/ui' +``` + +包名 `@froq/ui`。导出有 `.`、`./core`、`./vue`,以及 `./style.css` 和 `./tokens.css`。作用域类是 `ui`。字体不在包里。组件用 Instrument Serif、Geist、Geist Mono,由当前项目自己引入。组件放在带 `class="ui"` 的元素里。 + +## 写进当前项目的 agent markdown +查找顺序:`AGENTS.md`、`AGENT.md`、`CLAUDE.md`。找到的第一份就是要改的文件。一份都没有就新建根目录的 `AGENTS.md`。只改这一份。 + +文件里已有 `` 时,用下面这一整段替换从该标记到 `` 的内容(含两端标记)。没有就追加到文件末尾。 + +把下面围栏里的正文原样写入,不要改命令、路径和仓库地址。 + +用户要求抽组件、推上游或拉上游,而当前项目的 agent markdown 里还没有这一段时,先写入并提交这一段,再按其中对应的小节做。 + +~~~~markdown + ## @froq/ui 本项目的 UI 库源码在 `vendor/ui`。这是本仓库里的普通目录,不是 submodule,目录里没有自己的 git。所有 git 命令都在本项目根目录执行,不要进入 `vendor/ui`。依赖用 file 协议指向 `vendor/ui`,包名是 `@froq/ui`。 @@ -102,5 +154,33 @@ git subtree pull --prefix=vendor/ui https://github.com/0froq/ui.git main --squas - 库组件的样式里没有本项目的类名和色值。 - 本项目通过 `@froq/ui` 使用它,不再引用旧文件。 - 改动在本项目的 git 历史里,还没有进入 https://github.com/0froq/ui ,除非用户另外要求推到上游。 - +~~~~ + +## 代码规范 + +抽进库的代码要符合这一节。移植前先读这里,再对照同一层已有文件。 + +eslint 使用 `@antfu/eslint-config`。Vue 单行和多行都是每个属性单独一行。改完在库仓库里跑 `pnpm lint`,或在项目里对 `vendor/ui` 跑同一套配置。不要为了迁就项目原来的格式去关规则。 + +### 细则 + +维护者把具体写法写在这里。这一节还没有细则时,以同一目录里已有组件为准。 + +## 已经嵌过 + +不要再执行 `subtree add`。确认依赖仍用 file 协议指向 `vendor/ui`。如果还是 git 地址、tag 或 `link:`,改成 file 协议并更新锁文件。然后按上一节把同步和抽组件的步骤写进或更新到当前项目的 agent markdown,并提交这次改动。 + +## 在当前项目里改库 + +改 `vendor/ui/src/...`,在当前项目根目录提交并推送。不要主动执行 `subtree push`,除非用户明确要求推到上游。用户这么要求时,按该项目 agent markdown 里「推送到上游」做。用户要求把项目里的组件抽进库时,按该项目 agent markdown 里「把项目里的组件抽进库」做。 + +## 核对 + +- `vendor/ui/package.json` 的 `name` 是 `@froq/ui`。 +- 当前项目的依赖用 file 协议指向 `vendor/ui`。 +- `vendor/ui` 已经出现在当前项目的 git 历史里。 +- 没有 `.gitmodules` 记录这份库。 +- 配置里没有 `UI_LOCAL`。 +- 当前项目的 agent markdown 含有 ``,其中有 `git subtree push --prefix=vendor/ui https://github.com/0froq/ui.git main`、`git subtree pull --prefix=vendor/ui https://github.com/0froq/ui.git main --squash`,以及「把项目里的组件抽进库」。 +- `git -C vendor/ui status` 会失败,因为那里不是一个 git 仓库。 diff --git a/README.md b/README.md index 35cb716..df44780 100644 --- a/README.md +++ b/README.md @@ -1,43 +1,194 @@ -# circle +# @froq/ui -一张纸上的朋友画板。底是 paper-landing 的纸面,鼠标不着墨。圆可以缩放和拖动,缩放停在 1 倍和 3 倍之间。头像齐了才一起出现,也不能被选中。悬停时其余头像降低饱和度并变淡;当前头像小于 96px 才把图片放大到这个尺寸,热区仍是原来的圆。点头像,屏幕中间摊开一张纸条:「我想说的」和「TA 想说的」。还没写过的,按 id 固定显示一句等候的话。在纸条外滚动鼠标会收起,在纸条里滚动则翻笔记本身。暗色纸面只有斑点,没有横纹。圆排成 GitHub Sponsors 那种打包。头像大小按近 90 天的互动量:回复、引用和 @ 越多越大,最大的靠近中间。没有互动的头像一样小。画板上没有 froQ 自己的头像。点头像看纸条。画板只放互关。每周一,GitHub Action 用 SocialData 重拉名单,只写入互关,并把这一周新的回复、引用和 @ 加进互动数。secret 是 `SOCIALDATA_API_KEY`。头像用 X 的图片地址,每周任务不提交新的图片文件。最早那批文件还在 `public/avatars/`。 +Shared logic, a token contract, and the components. +`core` and `vue` have no project styles. +Components live in `src/components`. -## 本地运行 +``` +src/ + core/ TypeScript. No framework. Tokens, keyboard, strokes, reduced motion + vue/ Vue behavior without styles + components/ One directory per concept, such as radio/ or toggle/ + index.ts Components exported from @froq/ui + style.css + tokens.css +docs/ Docs site. It depends on this package. Component and docs changes ship together +``` + +## Components + +> [!NOTE] +> Design status is `ai-draft`, `reviewed`, or `stable`. +> Most notes are still `ai-draft`. A working component is not a finished design. +> Menu and Select lists are `reviewed`. +> The docs site shows the mark on each note. + +Everything below is exported from `@froq/ui`. + +| Component | Role | +| --- | --- | +| Button / CopyButton | Native button. Async clipboard, stable width | +| TextInput / TextArea / Select / Checkbox | Native fields. Attributes and events reach the control | +| FormField / NumberInput / DateInput / Slider / FileUpload / RadioGroup | Label, error, native value. Validation stays with the caller | +| Choice / ChoiceCircle / Toggle | Controlled choice and switch. Custom radio does not submit a form value | +| ToggleGroup | Single or multiple. Arrow keys move focus. A selected value can be cleared | +| Combobox | Search and multiple selection. Remote requests stay with the caller | +| Calendar / DatePicker | One month. ISO dates, locale, range, disabled dates | +| Navigation / Sidebar | Flat links and collapsible groups. Routing stays with the caller | +| Breadcrumb / Pagination | Path and page links. No router and no data fetching | +| Collapsible / Accordion / Tabs | Controlled panels. Content stays mounted | +| Skeleton / Progress / Spinner / Alert | Loading, progress, wait, inline notice | +| Banner | Site notice. Actions slot. The caller owns dismissal | +| Toast / ToastRegion | Temporary notice and a shared region. The queue stays with the caller | +| IconButton / EmptyState | Named icon button. Empty content and an actions slot | +| Badge / Avatar / Separator / Card / AspectRatio / Table | Mark, image, rule, surface, ratio, native table | +| Dialog / AlertDialog / Drawer / Popover / Menu / Tooltip | Dialog, confirm, side panel, anchored layer, menu, tip | +| ContextMenu / HoverCard | Context menu and link preview. The preview is not required content | +| Paper | Paper texture | + +Each component has a demo, an English note, and a Chinese note. +The docs site discovers them from the source. +There is no second list. +Coverage is in [docs/component-roadmap.md](docs/component-roadmap.md). + +## Tokens + +`tokens.css` defines these on `.ui`. +Components read only these: + +`--ui-bg` `--ui-fg` `--ui-muted` `--ui-faint` `--ui-line` `--ui-accent` `--ui-font-display` `--ui-font-text` `--ui-font-meta` `--ui-ease` `--ui-dur` `--ui-radius` + +Color uses `light-dark()` and follows the system. +Set `data-theme="light"` or `data-theme="dark"` on the scope, or an ancestor, to force one. +`.ui` is a class, not the document. +`@froq/ui/tokens.css` is enough when a project wants the tokens without the components. +`pnpm check:tokens` fails if a variable is missing, or if a component reads one outside this list. + +## Use + +```ts +import '@froq/ui/style.css' +import { Choice, Toggle } from '@froq/ui' +``` + +```vue +
+ +
+``` + +Fonts are not in the package. +Components expect Instrument Serif, Geist, and Geist Mono. +Load them in the app, or the page falls back to system fonts. +Those faces are SIL OFL 1.1. + +Nuxt: + +```ts +export default defineNuxtConfig({ + build: { transpile: ['@froq/ui'] }, + css: ['@froq/ui/style.css'], +}) +``` + +The package publishes source. +Vite compiles it. +The root dependencies use normal version ranges, not this workspace's `catalog:`. +A consumer that installs `file:vendor/ui` cannot see the catalog. +Dev tools may use a named catalog. + +## Behavior that stays with the caller + +Skeleton follows an explicit `loading` prop. +It does not wait for fonts, routes, or requests. +Use the default slot when the layout is known. +Use `width` and `height` when it is not. + +Toast renders inside `ToastRegion`. +The queue, ids, and anything that must remain on screen stay with the caller. +`useAutoDismiss(active, { duration, paused?, onDismiss })` is exported from `@froq/ui/vue`. +Call it in setup. +A pause keeps the remaining time. +A new duration or a new activation resets it. +A duration that is not finite and greater than zero does not auto-close. + +Calendar and DatePicker use a Gregorian `YYYY-MM-DD` string, or `''`. +They do not convert that string into a zoned timestamp. +The caller passes `locale`, `initialDate`, and `today`. +`parseCalendarDate`, `calendarDateBounds`, and `formatCalendarDate` come from `@froq/ui/core`. +DatePicker is a calendar button. +Use DateInput when the form needs a native date field. + +Overlays use `reka-ui`. +The default portal target is the nearest `.ui`, so the theme stays. +`portal-to` must exist and carry the same tokens. +Do not portal into a `body` that has none. +A transform or clip on the scope can break a fixed layer. + +Dialog and Drawer include a trigger. +For an external opener, set `:show-trigger="false"` and pass that opener's element as `return-focus`. +`disabled` does not disable the external button. +`useFocusReturn(open, target, captureFallback)` is exported from `@froq/ui/vue`. +It does not trap focus. +[docs/examples/ConsumerAdapters.vue](docs/examples/ConsumerAdapters.vue) shows the wiring. +It is not a migrated site and it is not a visual acceptance test. + +`ContextMenu` exposes `close()` on the component ref. +`useContextMenuControl(disabled)` must run under `ContextMenuRoot`. +The menu is not a `v-model`. + +## In another project + +That project keeps its own copy in `vendor/ui` and commits it. +Dev and the remote build compile that copy. +The agent steps are in [AGENTS.md](AGENTS.md). +On install, also write the push, pull, and extract steps into that project's agent markdown. + +## Add a component + +Write the behavior in `src/vue/` first. +Then `src/components//.vue`. +Export it from `src/index.ts`. +Add `.demo.vue`, `.md`, and `.zh.md` beside it. +`/components/` shows the demos. +`/components//` renders the note. +Group labels in the sidebar are not pages. +Concepts and components are. + +## Commands ```bash -pnpm install -pnpm dev # http://localhost:3000 -pnpm generate # 静态导出到 dist,给 Cloudflare Pages -pnpm test # 摆放与头像大小 -pnpm lint -pnpm typecheck +pnpm dev # docs at http://localhost:3000 +pnpm generate # static files in dist/ +pnpm deploy # generate, then cf deploy +pnpm preview:deploy # generate, then cf previews deploy +pnpm check # lint, types, token contract ``` -## 部署 +## Docs site -推 `main` 后由 Cloudflare Pages 的 GitHub 连接构建。仓库里不放 Cloudflare token。构建命令是 `pnpm generate`,发布目录是 `dist`。 +https://ui.froq.me -## 内容在哪里 +`docs/` is Nuxt Content. +The static output is `dist/` at the repo root. +It deploys to the Cloudflare Worker `ui`. +The Worker config is `cloudflare.config.ts`; the assets directory is in `wrangler.config.ts`. -| 路径 | 作用 | -| --- | --- | -| `data/people.json` | 成员数据(构建时读取,页面只画互关) | -| `data/hidden.json` | 不要再出现的 user id | -| `data/sync.json` | 每周任务写下的时间与已计帖子 id(第一次跑之后才有) | -| `data/README.md` | JSON 字段说明 | -| `public/avatars/` | 这一次快照的头像。之后的名单改用远程地址 | -| `shared/circle/` | 类型、互关合并与画板摆放 | -| `.github/workflows/refresh-circle.yml` | 每周一重拉互关 | -| `wrangler.jsonc` | Cloudflare Pages 的项目名和发布目录 | -| `app/components/circle/` | 画板、纸条、名单 | -| `app/pages/index.vue` | 首页。英文 `/`,中文 `/zh`,日文 `/ja` | - -## 占位项 - -- 「TA 想说的」还是空的,标签不可点。「我想说的」空着时,显示按 userId 固定的等候句 -- 互动数从 2026-08-21 起累加。每周任务第一次跑不重扫更早的帖 -- `product.install.href` 指向 `/`,避免模板「安装」遮罩 - -## 许可 - -手写字体 EMS Allure(SIL OFL 1.1),见 `vendor/ui/src/core/signature/hand-font.ts`。 +Workers Builds (GitHub connection, no API token in the repo): `NODE_VERSION=22`, build `pnpm generate`, production `pnpm exec cf deploy`, preview `pnpm exec cf previews deploy`. + +The docs live in the `docs/` subpackage, so root `cf deploy` does not run generate on its own. +That is why `deploy` is `pnpm generate && cf deploy`. +`docs` keeps `nuxt` in peerDependencies so root `cf deploy` bundles `dist/` instead of running `pnpm nuxt build`. + +Queries run in the browser from the bundled WASM SQLite and SQL dump. +Do not use the `cloudflare_pages` Nitro preset. +A passing local generate is not a verified deploy. +See [the release audit](docs/release-audit.md). +CI installs from the lockfile. + +## License + +This package has no root license file. +The handwriting strokes in `src/core/signature/` are SIL OFL 1.1. +Copyright 2010 The Allura Project Authors. +See `OFL.txt` and `NOTICE.md` beside that data. diff --git a/app/app.config.ts b/app/app.config.ts deleted file mode 100644 index 877c100..0000000 --- a/app/app.config.ts +++ /dev/null @@ -1,29 +0,0 @@ -import type { ProductConfig } from './types' - -export default defineAppConfig({ - product: { - name: 'circle', - mark: '·', - theme: { - light: { - bg: '#f4f2ec', - fg: '#1a1917', - muted: '#85837c', - faint: '#cfccc3', - line: 'rgba(26, 25, 23, 0.12)', - accent: '#e8431f', - }, - dark: { - bg: '#111113', - fg: '#f2f0ea', - muted: '#918f88', - faint: '#32312d', - line: 'rgba(242, 240, 234, 0.1)', - accent: '#ff6242', - }, - }, - install: { href: '/' }, - nav: [], - signature: { paper: true, line: false, hand: false, bloom: false, pointer: { dwell: false, click: false, dwellAfter: 0 } }, - } satisfies ProductConfig, -}) diff --git a/app/app.vue b/app/app.vue deleted file mode 100644 index 66c152d..0000000 --- a/app/app.vue +++ /dev/null @@ -1,43 +0,0 @@ - - - diff --git a/app/assets/css/kit.css b/app/assets/css/kit.css deleted file mode 100644 index 9a06952..0000000 --- a/app/assets/css/kit.css +++ /dev/null @@ -1,1287 +0,0 @@ -/* Skin. Type, scale and grid live here. Colors come from `product.theme`. */ -:root { - --bg: #f4f2ec; - --fg: #1a1917; - --muted: #85837c; - --faint: #cfccc3; - --line: rgba(26, 25, 23, 0.12); - --accent: #e8431f; - --font-display: - 'Instrument Serif', 'Iowan Old Style', Georgia, 'Songti SC', 'Noto Serif SC', 'Source Han Serif SC', serif; - --font-text: - 'Geist Variable', 'Geist', ui-sans-serif, system-ui, -apple-system, 'PingFang SC', 'Hiragino Sans GB', - 'Noto Sans SC', sans-serif; - --font-meta: 'Geist Mono Variable', 'Geist Mono', ui-monospace, SFMono-Regular, Menlo, monospace; - --display-scale: 1; - --poster-scale: 1; - --title-scale: 1; - --section-scale: 1; - --pad: clamp(20px, 4vw, 56px); - --gap: 24px; - --section: clamp(120px, 22svh, 240px); - --section-tight: clamp(72px, 14svh, 160px); - --cols: 12; - --span-margin: 3; - --span-body: 9; - --ease: cubic-bezier(0.16, 1, 0.3, 1); - color-scheme: light; -} - -:root[data-theme='dark'] { - --bg: #111113; - --fg: #f2f0ea; - --muted: #918f88; - --faint: #32312d; - --line: rgba(242, 240, 234, 0.1); - --accent: #ff6242; - color-scheme: dark; -} - -@media (prefers-color-scheme: dark) { - :root:not([data-theme]) { - --bg: #111113; - --fg: #f2f0ea; - --muted: #918f88; - --faint: #32312d; - --line: rgba(242, 240, 234, 0.1); - --accent: #ff6242; - color-scheme: dark; - } -} - -*, -*::before, -*::after { - box-sizing: border-box; -} - -html { - overflow-x: clip; - background: var(--bg); - transition: - background-color 0.6s var(--ease), - color 0.6s var(--ease); - color: var(--fg); - font-family: var(--font-text); - font-size: 16px; - line-height: 1.55; - -webkit-font-smoothing: antialiased; - text-rendering: optimizeLegibility; - scroll-behavior: smooth; -} - -body { - position: relative; - margin: 0; -} - -a { - color: inherit; - text-decoration: none; -} - -::selection { - background: var(--accent); - color: var(--bg); -} - -:focus-visible { - outline: 1px solid var(--accent); - outline-offset: 4px; -} - -code { - font-family: var(--font-meta); - font-size: 0.86em; -} - -.l-site { - position: relative; - z-index: 1; -} - -/* The library sheet paints an opaque --ui-bg. This site has no .ui scope and no - body wash, so the ground stays --bg. A transparent sheet would be sampled as - black and the light fibre would collapse. */ -.ui-paper { - position: relative; - background: var(--bg); -} - -.l-site.ui-paper { - background: var(--bg); -} - -.ui-paper-grain { - position: absolute; - z-index: 0; - pointer-events: none; -} - -.ui-paper-body { - position: relative; - z-index: 1; - display: flex; - flex: 1 0 auto; - flex-direction: column; - min-width: 0; - min-height: 100%; -} - -.l-sheet { - position: relative; - z-index: 0; -} - -/* Header */ -.l-top { - position: absolute; - inset: 0 0 auto; - z-index: 10; - display: grid; - grid-template-columns: 1fr auto 1fr; - align-items: center; - height: 72px; - padding: 0 var(--pad); - font-size: 14px; -} - -.l-brand { - grid-column: 1; - font-family: var(--font-display); - font-size: calc(24px * var(--title-scale)); - letter-spacing: -0.01em; -} - -.l-dot { - display: inline-block; - color: var(--accent); - /* U+00B7 sits on the midline. Drop the ink onto the baseline, at the word's lower right. */ - transform: translateY(0.33em); -} - -.l-nav { - display: flex; - gap: 28px; - font-size: 14px; - color: var(--muted); -} - -.l-top > .l-sections { - grid-column: 2; - justify-self: center; -} - -.l-sections { - display: flex; - gap: 20px; - font-family: var(--font-meta); - font-size: 11px; - letter-spacing: 0.08em; - text-transform: uppercase; - color: var(--muted); -} - -.l-sections a { - transition: color 0.3s; -} - -.l-sections a[aria-current='true'], -.l-nav a:hover, -.l-sections a:hover { - color: var(--fg); -} - -.l-section-bar { - position: fixed; - top: 36px; - left: 50%; - z-index: 20; - translate: -50% 0; - padding: 8px 16px; - background: var(--bg); - border: 1px solid var(--line); -} - -.section-bar-enter-active, -.section-bar-leave-active { - transition: - translate 0.6s var(--ease), - opacity 0.6s var(--ease); -} - -.section-bar-enter-from, -.section-bar-leave-to { - opacity: 0; - translate: -50% calc(-100% - 36px); -} - -/* Hero */ -.l-hero { - position: relative; - display: grid; - align-content: end; - min-height: 100svh; - padding: 0 var(--pad) clamp(32px, 6svh, 64px); -} - -.l-word { - margin: 0 0 0 -0.05em; - font-family: var(--font-display); - font-weight: 400; - /* Long names shrink so the word always fits the width */ - font-size: calc(clamp(88px, min(27vw, calc(108vw / var(--len, 4))), 440px) * var(--display-scale)); - line-height: 0.78; - letter-spacing: -0.045em; -} - -.l-mark { - display: inline-block; - color: var(--accent); - transform: translateY(0.33em); -} - -/* Layers draw the stops, the tagline and the rules themselves */ -.has-bloom .l-mark { - color: transparent; -} - -/* Without washes the pen dots the last stop itself */ -.has-stroke:not(.has-bloom) [data-anchor='final-mark'] { - color: transparent; -} - -.has-hand .l-tagline { - position: absolute; - top: 24svh; - right: var(--pad); - font-size: calc(clamp(56px, 6.4vw, 104px) * var(--poster-scale)); - color: transparent; - user-select: none; -} - -.has-stroke [data-anchor='rule'] { - border-top-color: transparent; -} - -.l-skip { - position: absolute; - top: 12px; - left: var(--pad); - z-index: 20; - padding: 6px 10px; - background: var(--bg); - font-size: 13px; - translate: 0 -200%; -} - -.l-skip:focus { - translate: 0; -} - -.l-release { - grid-column: span var(--span-margin); - display: flex; - gap: 12px; - align-items: baseline; - font-size: 14px; - color: var(--muted); - transition: color 0.3s; -} - -.l-release span { - font-family: var(--font-meta); - font-size: 11px; - letter-spacing: 0.08em; -} - -.l-release:hover { - color: var(--fg); -} - -html:not(.has-hand) .l-release { - grid-row: 2; -} - -:lang(zh) .l-page-title, -:lang(zh) .l-title, -:lang(zh) .l-statement, -:lang(zh) .l-final-title, -:lang(zh) .l-entry-title { - letter-spacing: 0; -} - -:lang(zh) .l-page-title.is-long, -:lang(zh) .l-statement { - line-height: 1.15; -} - -.l-hero-foot { - display: grid; - grid-template-columns: repeat(var(--cols), minmax(0, 1fr)); - gap: var(--gap); - align-items: end; - margin-top: clamp(28px, 5svh, 56px); - padding-top: 20px; - border-top: 1px solid var(--line); -} - -.l-tagline { - grid-column: span var(--span-margin); - margin: 0; - font-family: var(--font-display); - font-size: calc(24px * var(--title-scale)); - line-height: 1.1; -} - -.l-hero-foot .l-lede { - grid-column: calc(var(--span-margin) + 2) / span 5; - margin: 0; -} - -.l-lede { - max-width: 30rem; - color: var(--muted); -} - -.l-hero-foot .l-cta { - grid-column: 11 / span 2; - justify-self: end; -} - -.l-cta { - position: relative; - display: inline-flex; - align-items: center; - gap: 10px; - font-size: 15px; - white-space: nowrap; -} - -.l-cta::after { - content: '→'; - transition: translate 0.4s var(--ease); -} - -.l-cta:hover::after { - translate: 4px 0; -} - -.l-cta::before { - content: ''; - position: absolute; - left: 0; - right: 0; - bottom: -4px; - height: 1px; - background: currentColor; - transform-origin: right; - transform: scaleX(0.999); - transition: transform 0.6s var(--ease); -} - -.l-cta:hover::before { - transform-origin: left; - animation: l-underline 0.8s var(--ease); -} - -@keyframes l-underline { - 0% { - transform: scaleX(1); - transform-origin: right; - } - - 45% { - transform: scaleX(0); - transform-origin: right; - } - - 46% { - transform: scaleX(0); - transform-origin: left; - } - - 100% { - transform: scaleX(1); - transform-origin: left; - } -} - -/* Sections */ -.l-section { - display: grid; - grid-template-columns: repeat(var(--cols), minmax(0, 1fr)); - gap: var(--gap); - padding: calc(var(--section) * var(--section-scale)) var(--pad) 0; - scroll-margin-top: 64px; -} - -.l-label { - grid-column: span var(--span-margin); - margin: 0; - font-family: var(--font-meta); - font-size: 11px; - letter-spacing: 0.08em; - text-transform: uppercase; - color: var(--muted); -} - -.l-body { - min-width: 0; - grid-column: span var(--span-body); -} - -.l-title { - max-width: 18ch; - text-wrap: balance; - margin: 0; - font-family: var(--font-display); - font-weight: 400; - font-size: calc(clamp(40px, 5.2vw, 76px) * var(--title-scale)); - line-height: 1; - letter-spacing: -0.02em; -} - -.l-copy { - margin: 0; - color: var(--muted); -} - -.l-specs { - display: grid; - grid-template-columns: repeat(var(--cols, 4), minmax(0, 1fr)); - gap: var(--gap); - margin: 72px 0 0; -} - -.l-spec { - padding-top: 18px; - border-top: 1px solid var(--line); -} - -.l-spec dt { - font-size: 14px; -} - -.l-spec dd { - margin: 0; -} - -.l-figure { - margin: 36px 0 12px !important; - font-family: var(--font-display); - font-size: calc(clamp(72px, 8vw, 128px) * var(--poster-scale)); - line-height: 0.8; - letter-spacing: -0.03em; -} - -.l-figure small { - margin-left: 6px; - font-family: var(--font-text); - font-size: 14px; - letter-spacing: 0; - color: var(--muted); -} - -.l-spec .l-copy { - max-width: 16rem; - font-size: 14px; -} - -.l-statement { - margin: 0; - font-family: var(--font-display); - font-size: calc(clamp(44px, 6.4vw, 104px) * var(--poster-scale)); - line-height: 1; - letter-spacing: -0.025em; -} - -.l-quotes { - display: grid; - grid-template-columns: repeat(var(--cols, 3), minmax(0, 1fr)); - gap: var(--gap); -} - -.l-quote { - margin: 0; - padding-top: 18px; - border-top: 1px solid var(--line); -} - -.l-quote blockquote { - margin: 0; - font-family: var(--font-display); - font-size: calc(24px * var(--title-scale)); - line-height: 1.2; -} - -.l-quote figcaption { - margin-top: 20px; - font-size: 14px; - color: var(--muted); -} - -.l-price { - display: grid; - grid-template-columns: repeat(9, minmax(0, 1fr)); - gap: var(--gap); - align-items: end; -} - -.l-amount { - grid-column: 1 / span 5; - margin: 0; - font-family: var(--font-display); - font-size: calc(clamp(120px, 16vw, 260px) * var(--display-scale)); - line-height: 0.78; - letter-spacing: -0.04em; -} - -.l-amount small { - font-size: 0.16em; - letter-spacing: 0; - color: var(--muted); -} - -.l-price > div { - grid-column: 6 / span 4; -} - -.l-facts { - margin: 28px 0 0; -} - -.l-facts div { - display: flex; - justify-content: space-between; - padding: 10px 0; - border-top: 1px solid var(--line); - font-size: 14px; -} - -.l-facts dt { - color: var(--muted); -} - -.l-facts dd { - margin: 0; -} - -.l-qa details { - border-top: 1px solid var(--line); -} - -.l-qa details:last-child { - border-bottom: 1px solid var(--line); -} - -.l-qa summary { - display: flex; - justify-content: space-between; - gap: var(--gap); - padding: 22px 0; - cursor: pointer; - list-style: none; - font-family: var(--font-display); - font-size: calc(clamp(22px, 2.2vw, 30px) * var(--title-scale)); - line-height: 1.2; -} - -.l-qa summary::-webkit-details-marker { - display: none; -} - -.l-qa summary::after { - content: '+'; - font-family: var(--font-text); - font-size: 18px; - color: var(--muted); - transition: rotate 0.4s var(--ease); -} - -.l-qa details[open] summary::after { - rotate: 45deg; -} - -.l-qa summary code { - font-size: 0.72em; -} - -.l-qa p { - max-width: 34rem; - margin: 0; - padding: 0 0 26px; - color: var(--muted); -} - -.l-final { - display: grid; - justify-items: center; - gap: 20px; - padding: clamp(180px, 34svh, 360px) var(--pad); - text-align: center; -} - -.l-final-title { - margin: 0; - font-family: var(--font-display); - font-weight: 400; - font-size: calc(clamp(64px, 10vw, 168px) * var(--display-scale)); - line-height: 0.9; - letter-spacing: -0.035em; -} - -.l-final .l-lede { - margin: 0 0 16px; -} - -.l-foot { - display: grid; - grid-template-columns: 1fr auto 1fr; - gap: 16px; - padding: 24px var(--pad) 32px; - border-top: 1px solid var(--line); - font-size: 13px; - color: var(--muted); -} - -.l-controls { - display: flex; - gap: 20px; - justify-self: end; -} - -.l-controls button { - padding: 0; - border: 0; - background: none; - color: inherit; - font: inherit; - cursor: pointer; - transition: color 0.3s; -} - -.l-controls button:hover { - color: var(--fg); -} - -.l-foot a { - transition: color 0.3s; -} - -.l-foot a:hover { - color: var(--fg); -} - -/* Inner pages */ -.l-page-head { - display: grid; - align-content: end; - min-height: 78svh; - padding: 0 var(--pad) clamp(32px, 6svh, 64px); -} - -.l-page-head.is-compact { - min-height: 54svh; -} - -.l-page-title { - margin: 0 0 0 -0.04em; - font-family: var(--font-display); - font-weight: 400; - font-size: calc(clamp(96px, 17vw, 280px) * var(--display-scale)); - line-height: 0.82; - letter-spacing: -0.04em; -} - -.l-page-title.is-long { - max-width: 14ch; - margin-left: 0; - font-size: calc(clamp(56px, 8vw, 128px) * var(--display-scale)); - line-height: 0.95; - letter-spacing: -0.03em; - text-wrap: balance; -} - -.l-page-foot { - display: grid; - grid-template-columns: repeat(var(--cols), minmax(0, 1fr)); - gap: var(--gap); - align-items: baseline; - margin-top: clamp(28px, 5svh, 56px); - padding-top: 20px; - border-top: 1px solid var(--line); -} - -.l-kicker { - margin: 0; - font-family: var(--font-meta); - font-size: 11px; - letter-spacing: 0.08em; - text-transform: uppercase; - color: var(--muted); -} - -.l-kicker a { - transition: color 0.3s; -} - -.l-kicker a:hover { - color: var(--fg); -} - -.l-page-foot .l-kicker { - grid-column: span var(--span-margin); -} - -.l-page-foot .l-lede { - grid-column: calc(var(--span-margin) + 1) / span 6; - margin: 0; -} - -.l-page-foot .l-meta { - grid-column: 10 / span 3; - justify-self: end; - margin: 0; - font-size: 14px; - color: var(--muted); -} - -.l-section.is-entry { - padding-top: calc(var(--section-tight) * var(--section-scale)); -} - -.l-section.is-entry .l-body { - padding-top: 18px; - border-top: 1px solid var(--line); -} - -.l-section.is-entry .l-label { - padding-top: 18px; -} - -.l-entry { - display: grid; - gap: 14px; -} - -.l-entry-title { - margin: 0; - font-family: var(--font-display); - font-weight: 400; - font-size: calc(clamp(32px, 3.6vw, 56px) * var(--title-scale)); - line-height: 1.02; - letter-spacing: -0.02em; - text-wrap: balance; -} - -.l-section.is-entry .l-kicker + .l-entry-title { - margin-top: 14px; -} - -.l-entry .l-copy { - max-width: 34rem; -} - -.l-more { - display: inline-flex; - gap: 10px; - align-items: baseline; - margin-top: 6px; - font-size: 14px; -} - -.l-more::after { - content: '→'; - transition: translate 0.4s var(--ease); -} - -.l-more small { - order: 2; - font-size: 13px; - color: var(--muted); -} - -.l-entry:hover .l-more::after { - translate: 4px 0; -} - -a.l-entry .l-entry-title { - transition: color 0.3s; -} - -a.l-entry:hover .l-entry-title { - color: var(--muted); -} - -.l-notes ul { - max-width: 34rem; - margin: 22px 0 0; - padding: 0; - list-style: none; - color: var(--muted); -} - -.l-notes li { - margin: 0; - padding: 10px 0; - border-top: 1px solid var(--line); -} - -.l-notes li:first-child { - border-top: 0; - padding-top: 0; -} - -.l-section.is-prose { - padding-top: calc(var(--section-tight) * var(--section-scale)); -} - -.l-prose { - max-width: 36rem; - font-family: var(--font-display); - font-size: calc(clamp(21px, 1.7vw, 25px) * var(--title-scale)); - line-height: 1.45; -} - -.l-prose p { - margin: 0 0 1.1em; -} - -.l-prose .l-excerpt { - margin-bottom: 1.6em; - font-family: var(--font-text); - font-size: 16px; - line-height: 1.55; - color: var(--muted); -} - -.l-section.is-pager { - align-items: baseline; - padding-top: clamp(96px, 18svh, 200px); - padding-bottom: clamp(96px, 16svh, 180px); -} - -.l-section.is-pager .l-label a { - transition: color 0.3s; -} - -.l-section.is-pager .l-label a:hover { - color: var(--fg); -} - -.l-section.is-pager .l-entry { - gap: 10px; - padding-top: 18px; - border-top: 1px solid var(--line); -} - -.l-final.is-end { - padding: clamp(160px, 30svh, 320px) var(--pad); -} - -.l-final.is-end .l-final-title { - font-size: calc(clamp(48px, 6.4vw, 104px) * var(--display-scale)); -} - -/* Installed: the page returns nothing */ -main, -.l-top, -.l-foot { - transition: opacity 1.2s var(--ease); -} - -.stroke-layer { - transition: opacity 1.2s var(--ease); -} - -.is-installed { - overflow: hidden; -} - -.is-installed main, -.is-installed .l-top, -.is-installed .l-foot, -.is-installed .stroke-layer { - opacity: 0; - pointer-events: none; -} - -.l-installed { - position: fixed; - top: 24svh; - left: var(--pad); - z-index: 30; - display: grid; - justify-items: start; - gap: 14px; - opacity: 0; - pointer-events: none; - transition: opacity 0.8s var(--ease); -} - -.is-installed .l-installed { - opacity: 1; - pointer-events: auto; - transition-delay: 0.9s; -} - -.l-installed-title { - margin: 0; - font-family: var(--font-display); - font-size: calc(clamp(56px, 7vw, 112px) * var(--display-scale)); - line-height: 1; - letter-spacing: -0.03em; -} - -.l-back { - padding: 0; - border: 0; - background: none; - color: var(--muted); - font: inherit; - font-size: 14px; - cursor: pointer; - transition: color 0.3s; -} - -.l-back::before { - content: '← '; -} - -.l-back:hover { - color: var(--fg); -} - -/* Install page */ -.l-command { - display: flex; - justify-content: space-between; - align-items: center; - gap: 16px; - max-width: 34rem; - margin: 22px 0 14px; - padding: 14px 16px; - border: 1px solid var(--line); - font-size: 14px; -} - -.l-command code { - overflow-x: auto; - white-space: nowrap; -} - -.l-command button { - padding: 0; - border: 0; - background: none; - color: var(--muted); - font: inherit; - font-size: 13px; - cursor: pointer; - transition: color 0.3s; -} - -.l-command button:hover { - color: var(--fg); -} - -button.l-cta { - padding: 0; - border: 0; - background: none; - color: inherit; - font: inherit; - font-size: 15px; - cursor: pointer; -} - -@media (max-width: 860px) { - .l-top > .l-sections { - display: none; - } - - .l-top { - grid-template-columns: 1fr auto; - } - - .l-hero-foot, - .l-page-foot, - .l-section, - .l-price { - grid-template-columns: minmax(0, 1fr); - } - - .l-tagline, - .l-release, - .l-hero-foot .l-lede, - .l-hero-foot .l-cta, - .l-page-foot > *, - .l-label, - .l-body, - .l-amount, - .l-price > div { - grid-column: 1 / -1; - } - - .l-tagline, - .l-hero-foot .l-cta, - .l-page-foot .l-meta, - .l-label, - .l-amount { - justify-self: start; - } - - .l-section.is-entry .l-label { - padding-top: 0; - } - - .l-foot { - grid-template-columns: 1fr auto; - } - - .l-foot nav { - grid-row: 2; - } - - .l-specs { - grid-template-columns: repeat(2, minmax(0, 1fr)); - } - - .l-quotes { - grid-template-columns: minmax(0, 1fr); - } -} - -@media (prefers-reduced-motion: reduce) { - html { - scroll-behavior: auto; - } - - *, - *::before, - *::after { - animation-duration: 0.001ms !important; - transition-duration: 0.001ms !important; - } -} - -/* Empty copy: a block labeled with the field that still needs replacing */ -.l-fill { - display: inline-flex; - align-items: center; - box-sizing: border-box; - width: max-content; - min-width: calc(var(--fill, 8) * 0.5em); - max-width: 100%; - height: 1.35rem; - padding: 0 0.45rem; - vertical-align: middle; - border-radius: 2px; - background: var(--faint); - color: var(--fg); - font-family: var(--font-meta); - font-size: 0.68rem; - font-weight: 400; - font-style: normal; - letter-spacing: 0; - line-height: 1; - white-space: nowrap; -} - -/* Each page is a new sheet */ -.page-enter-active, -.page-leave-active { - transition: opacity 0.35s var(--ease); -} - -.page-enter-from, -.page-leave-to { - opacity: 0; -} - -/* Plain markdown inside a block */ -.l-body > p:not([class]) { - max-width: 34rem; - margin: 24px 0 0; - color: var(--muted); -} - -.l-body > p:not([class]):first-child { - margin-top: 0; -} - -.l-copy p { - margin: 0; -} - -/* Markdown written straight on a page, outside any block */ -.l-page > :not(section) { - max-width: 42rem; - margin-inline: var(--pad); -} - -/* Docs */ -.l-section.is-docs { - align-items: start; - padding-top: clamp(48px, 8svh, 96px); -} - -.l-toc { - position: sticky; - top: 96px; - grid-column: span var(--span-margin); - display: grid; - align-content: start; - gap: 10px; - font-size: 14px; - color: var(--muted); -} - -.l-toc a { - width: fit-content; - transition: color 0.3s; -} - -.l-toc a:hover, -.l-toc a[aria-current='page'] { - color: var(--fg); -} - -.l-doc { - max-width: 42rem; - font-size: 16px; - line-height: 1.7; -} - -.l-doc h2, -.l-prose h2 { - margin: 2.4em 0 0.6em; - font-family: var(--font-display); - font-weight: 400; - font-size: calc(clamp(30px, 2.8vw, 40px) * var(--title-scale)); - line-height: 1.1; - letter-spacing: -0.015em; -} - -.l-doc h3, -.l-prose h3 { - margin: 2em 0 0.5em; - font-size: 17px; - font-weight: 500; -} - -.l-doc h2 a, -.l-doc h3 a { - text-decoration: none; -} - -.l-md > :first-child { - margin-top: 0; -} - -.l-doc p, -.l-doc ul, -.l-doc ol { - margin: 0 0 1em; -} - -.l-doc ul, -.l-doc ol { - padding-left: 1.2em; -} - -.l-doc li { - margin: 0.3em 0; -} - -.l-doc p a, -.l-doc li a, -.l-prose p a { - text-decoration: underline; - text-decoration-color: var(--faint); - text-underline-offset: 3px; - transition: text-decoration-color 0.3s; -} - -.l-doc p a:hover, -.l-doc li a:hover, -.l-prose p a:hover { - text-decoration-color: var(--fg); -} - -.l-doc pre { - overflow-x: auto; - margin: 1.4em 0; - padding: 16px 18px; - border: 1px solid var(--line); - font-size: 13.5px; - line-height: 1.6; -} - -.l-doc :not(pre) > code, -.l-prose :not(pre) > code { - padding: 0.1em 0.35em; - border: 1px solid var(--line); - border-radius: 3px; -} - -.l-doc blockquote { - margin: 1.4em 0; - padding-left: 16px; - border-left: 1px solid var(--line); - color: var(--muted); -} - -.l-doc table { - width: 100%; - margin: 1.4em 0; - border-collapse: collapse; - font-size: 14px; -} - -.l-doc th, -.l-doc td { - padding: 10px 12px 10px 0; - border-top: 1px solid var(--line); - text-align: left; -} - -.l-doc th { - font-weight: 400; - color: var(--muted); -} - -.l-doc hr { - margin: 2.4em 0; - border: 0; - border-top: 1px solid var(--line); -} - -/* Code highlighting follows the paper, not its own background */ -.shiki, -.shiki span { - background-color: transparent !important; -} - -:root[data-theme='dark'] .shiki, -:root[data-theme='dark'] .shiki span { - color: var(--shiki-dark) !important; -} - -@media (prefers-color-scheme: dark) { - :root:not([data-theme]) .shiki, - :root:not([data-theme]) .shiki span { - color: var(--shiki-dark) !important; - } -} - -@media (max-width: 860px) { - .l-toc { - position: static; - grid-column: 1 / -1; - display: flex; - flex-wrap: wrap; - gap: 8px 18px; - } -} diff --git a/app/components/Copy.ts b/app/components/Copy.ts deleted file mode 100644 index 389ba22..0000000 --- a/app/components/Copy.ts +++ /dev/null @@ -1,15 +0,0 @@ -import { defineComponent, h } from 'vue' -import Fill from './Fill' - -/** An i18n string. An empty message renders a block labeled with the key. */ -export default defineComponent({ - name: 'Copy', - props: { - k: { type: String, required: true }, - size: { type: Number, default: 8 }, - }, - setup(props) { - const copy = useCopy() - return () => h(Fill, { value: copy(props.k), name: props.k, size: props.size }) - }, -}) diff --git a/app/components/CopyCommand.vue b/app/components/CopyCommand.vue deleted file mode 100644 index 537dab5..0000000 --- a/app/components/CopyCommand.vue +++ /dev/null @@ -1,27 +0,0 @@ - - - diff --git a/app/components/Fill.ts b/app/components/Fill.ts deleted file mode 100644 index 5303967..0000000 --- a/app/components/Fill.ts +++ /dev/null @@ -1,25 +0,0 @@ -import type { PropType, VNode } from 'vue' -import { defineComponent, h } from 'vue' - -/** A labeled block standing in for copy that has not been replaced yet. */ -export function placeholder(size: number, name?: string): VNode { - return h('span', { - 'class': 'l-fill', - 'style': { '--fill': size }, - 'data-slot': name || undefined, - }, name ?? '') -} - -export default defineComponent({ - name: 'Fill', - props: { - value: { type: String as PropType, default: null }, - /** Field name drawn inside the block while the value is empty. */ - name: { type: String, default: '' }, - /** Minimum width in characters of the surrounding type. */ - size: { type: Number, default: 8 }, - }, - setup(props) { - return (): VNode | string => isFilled(props.value) ? props.value : placeholder(props.size, props.name || undefined) - }, -}) diff --git a/app/components/InstallLink.vue b/app/components/InstallLink.vue deleted file mode 100644 index 9f4abb9..0000000 --- a/app/components/InstallLink.vue +++ /dev/null @@ -1,33 +0,0 @@ - - - diff --git a/app/components/Installed.vue b/app/components/Installed.vue deleted file mode 100644 index 2b18bac..0000000 --- a/app/components/Installed.vue +++ /dev/null @@ -1,34 +0,0 @@ - - - diff --git a/app/components/PageHead.vue b/app/components/PageHead.vue deleted file mode 100644 index 1f51e44..0000000 --- a/app/components/PageHead.vue +++ /dev/null @@ -1,70 +0,0 @@ - - - diff --git a/app/components/RichText.ts b/app/components/RichText.ts deleted file mode 100644 index 8917360..0000000 --- a/app/components/RichText.ts +++ /dev/null @@ -1,17 +0,0 @@ -import type { VNode } from 'vue' -import { defineComponent, h } from 'vue' - -export function rich(text: string): (VNode | string)[] { - return text.split('`').map((part, index) => index % 2 ? h('code', part) : part).filter(part => part !== '') -} - -// Inline copy from props: `backticks` become code, nothing else is interpreted -export default defineComponent({ - name: 'RichText', - props: { - text: { type: String, default: '' }, - }, - setup(props) { - return (): (VNode | string)[] => rich(props.text) - }, -}) diff --git a/app/components/SectionNav.vue b/app/components/SectionNav.vue deleted file mode 100644 index 381fdd7..0000000 --- a/app/components/SectionNav.vue +++ /dev/null @@ -1,20 +0,0 @@ - - - diff --git a/app/components/Sheet.vue b/app/components/Sheet.vue deleted file mode 100644 index 0821fe9..0000000 --- a/app/components/Sheet.vue +++ /dev/null @@ -1,15 +0,0 @@ - - - diff --git a/app/components/SiteFooter.vue b/app/components/SiteFooter.vue deleted file mode 100644 index 0daa996..0000000 --- a/app/components/SiteFooter.vue +++ /dev/null @@ -1,51 +0,0 @@ - - - - - diff --git a/app/components/SiteHeader.vue b/app/components/SiteHeader.vue deleted file mode 100644 index f4967bb..0000000 --- a/app/components/SiteHeader.vue +++ /dev/null @@ -1,128 +0,0 @@ - - - - - diff --git a/app/components/Stop.ts b/app/components/Stop.ts deleted file mode 100644 index b0d85b1..0000000 --- a/app/components/Stop.ts +++ /dev/null @@ -1,27 +0,0 @@ -import type { PropType, VNode } from 'vue' -import { defineComponent, h } from 'vue' -import { placeholder } from './Fill' -import { rich } from './RichText' - -// A title whose trailing stop is its own element, so the paper can bloom it or the pen can land on it -export default defineComponent({ - name: 'Stop', - props: { - text: { type: String as PropType, default: null }, - /** Field name drawn inside the block while the text is empty. */ - name: { type: String, default: '' }, - anchor: { type: String as PropType<'mark' | 'final-mark'>, default: 'mark' }, - /** Stop added when the text has none. */ - fallback: { type: String, default: '' }, - size: { type: Number, default: 8 }, - }, - setup(props) { - return (): VNode | (VNode | string)[] => { - if (!isFilled(props.text)) - return placeholder(props.size, props.name || undefined) - const { body, stop } = splitStop(props.text, props.fallback) - const mark = h('span', { 'class': 'l-mark', 'data-anchor': props.anchor }, stop) - return stop ? [...rich(body), mark] : rich(body) - } - }, -}) diff --git a/app/components/circle/CircleAccessibleList.vue b/app/components/circle/CircleAccessibleList.vue deleted file mode 100644 index ab9e061..0000000 --- a/app/components/circle/CircleAccessibleList.vue +++ /dev/null @@ -1,248 +0,0 @@ - - - - - diff --git a/app/components/circle/CircleBoard.vue b/app/components/circle/CircleBoard.vue deleted file mode 100644 index 5aee860..0000000 --- a/app/components/circle/CircleBoard.vue +++ /dev/null @@ -1,838 +0,0 @@ - - - - - diff --git a/app/components/circle/CircleCopySlots.vue b/app/components/circle/CircleCopySlots.vue deleted file mode 100644 index 42a6578..0000000 --- a/app/components/circle/CircleCopySlots.vue +++ /dev/null @@ -1,59 +0,0 @@ - - - - - diff --git a/app/components/circle/CircleNoteText.vue b/app/components/circle/CircleNoteText.vue deleted file mode 100644 index 7c242a8..0000000 --- a/app/components/circle/CircleNoteText.vue +++ /dev/null @@ -1,27 +0,0 @@ - - - diff --git a/app/components/circle/CirclePage.vue b/app/components/circle/CirclePage.vue deleted file mode 100644 index 259cd0e..0000000 --- a/app/components/circle/CirclePage.vue +++ /dev/null @@ -1,117 +0,0 @@ - - - - - diff --git a/app/components/circle/CirclePersonCard.vue b/app/components/circle/CirclePersonCard.vue deleted file mode 100644 index 345bc6b..0000000 --- a/app/components/circle/CirclePersonCard.vue +++ /dev/null @@ -1,407 +0,0 @@ - - - - - diff --git a/app/components/content/Block.vue b/app/components/content/Block.vue deleted file mode 100644 index dce283e..0000000 --- a/app/components/content/Block.vue +++ /dev/null @@ -1,47 +0,0 @@ - - - diff --git a/app/components/content/Faq.vue b/app/components/content/Faq.vue deleted file mode 100644 index da86a4f..0000000 --- a/app/components/content/Faq.vue +++ /dev/null @@ -1,39 +0,0 @@ - - - diff --git a/app/components/content/Figures.vue b/app/components/content/Figures.vue deleted file mode 100644 index a66a4e1..0000000 --- a/app/components/content/Figures.vue +++ /dev/null @@ -1,55 +0,0 @@ - - - diff --git a/app/components/content/Final.vue b/app/components/content/Final.vue deleted file mode 100644 index 72b3199..0000000 --- a/app/components/content/Final.vue +++ /dev/null @@ -1,52 +0,0 @@ - - - diff --git a/app/components/content/Hero.vue b/app/components/content/Hero.vue deleted file mode 100644 index af74ec1..0000000 --- a/app/components/content/Hero.vue +++ /dev/null @@ -1,87 +0,0 @@ - - - diff --git a/app/components/content/Price.vue b/app/components/content/Price.vue deleted file mode 100644 index 736cfb4..0000000 --- a/app/components/content/Price.vue +++ /dev/null @@ -1,67 +0,0 @@ - - - diff --git a/app/components/content/Quotes.vue b/app/components/content/Quotes.vue deleted file mode 100644 index 857be50..0000000 --- a/app/components/content/Quotes.vue +++ /dev/null @@ -1,34 +0,0 @@ - - - diff --git a/app/components/content/Statement.vue b/app/components/content/Statement.vue deleted file mode 100644 index 0eb1da8..0000000 --- a/app/components/content/Statement.vue +++ /dev/null @@ -1,30 +0,0 @@ - - - diff --git a/app/components/content/Step.vue b/app/components/content/Step.vue deleted file mode 100644 index cc76e83..0000000 --- a/app/components/content/Step.vue +++ /dev/null @@ -1,36 +0,0 @@ - - - diff --git a/app/composables/useCircleData.ts b/app/composables/useCircleData.ts deleted file mode 100644 index 80a6c50..0000000 --- a/app/composables/useCircleData.ts +++ /dev/null @@ -1,16 +0,0 @@ -import type { PeopleFile, Person } from '#shared/circle/types' -import { visiblePeople } from '#shared/circle/layout' -import peopleJson from '../../data/people.json' - -export function useCircleData() { - const data = peopleJson as PeopleFile - const people = computed(() => visiblePeople(data.people)) - - return { - center: data.center, - people, - listed: computed(() => [...people.value].sort((a, b) => a.handle.localeCompare(b.handle))), - } -} - -export type { Person } diff --git a/app/composables/useCopy.ts b/app/composables/useCopy.ts deleted file mode 100644 index 6fc84d6..0000000 --- a/app/composables/useCopy.ts +++ /dev/null @@ -1,10 +0,0 @@ -/** Like `t`, but a missing or empty message is `''`, so `` can show a placeholder. */ -export function useCopy(): (key: string, params?: Record) => string { - const { t, te } = useI18n() - return (key, params = {}) => { - if (!te(key)) - return '' - const message = t(key, params) - return message === key ? '' : message - } -} diff --git a/app/composables/useInstalled.ts b/app/composables/useInstalled.ts deleted file mode 100644 index b60355a..0000000 --- a/app/composables/useInstalled.ts +++ /dev/null @@ -1,6 +0,0 @@ -import type { Ref } from 'vue' - -/** The vanish: without an install page, "Install" removes the site and leaves the paper. */ -export function useInstalled(): Ref { - return useState('installed', () => false) -} diff --git a/app/composables/useKitLink.ts b/app/composables/useKitLink.ts deleted file mode 100644 index bc06db4..0000000 --- a/app/composables/useKitLink.ts +++ /dev/null @@ -1,19 +0,0 @@ -const EXTERNAL = /^[a-z][a-z\d+.-]*:/i - -/** Resolves a locale-free path such as `/#pricing` for the current locale; URLs pass through. */ -export function useKitLink(): (to: string) => string { - const localePath = useLocalePath() - return (to) => { - if (EXTERNAL.test(to)) - return to - const [path = '/', hash] = to.split('#') - const resolved = localePath(path || '/') - return hash ? `${resolved}#${hash}` : resolved - } -} - -/** Content paths are prefixed with the locale folder: `/en/notes/x`. */ -export function useContentPath(): (path?: string) => string { - const { locale } = useI18n() - return (path = '') => `/${locale.value}${path === '/' ? '' : path}`.replace(/\/$/, '') -} diff --git a/app/composables/usePageSections.ts b/app/composables/usePageSections.ts deleted file mode 100644 index 799098b..0000000 --- a/app/composables/usePageSections.ts +++ /dev/null @@ -1,50 +0,0 @@ -import type { Ref } from 'vue' - -export interface PageSection { - id: string - label: string -} - -/** Sections are `block`s with an `id`. A filled label wins; an empty one shows the id. */ -export function usePageSections(): { sections: Ref, current: Ref, pinned: Ref } { - const sections = ref([]) - const current = ref('') - const pinned = ref(false) - - function read(): void { - sections.value = [...document.querySelectorAll('main section.l-section[id]')].map((section) => { - const label = section.querySelector('[data-anchor="label"]') - const text = label?.querySelector('.l-fill') ? '' : label?.textContent?.trim() - return { id: section.id, label: text || section.id } - }) - if (!sections.value.some(section => section.id === current.value)) - current.value = '' - } - - function onScroll(): void { - pinned.value = window.scrollY > 220 - const line = 80 - let active = '' - for (const section of sections.value) { - const node = document.getElementById(section.id) - if (node && node.getBoundingClientRect().top <= line) - active = section.id - } - current.value = active - } - - function sync(): void { - read() - onScroll() - } - - onMounted(() => { - sync() - addEventListener('scroll', onScroll, { passive: true }) - useNuxtApp().hook('page:finish', sync) - }) - - onBeforeUnmount(() => removeEventListener('scroll', onScroll)) - - return { sections, current, pinned } -} diff --git a/app/composables/useSignature.ts b/app/composables/useSignature.ts deleted file mode 100644 index 0d366ea..0000000 --- a/app/composables/useSignature.ts +++ /dev/null @@ -1,115 +0,0 @@ -import type { LayerColors, PenAnchors } from '@froq/ui/core' -import type { Ref } from 'vue' -import { usePaperSignature } from '@froq/ui/vue' - -export interface SignatureOptions { - /** The page leaves a margin for the pen; it still needs a `[data-anchor="rule"]`. */ - line?: boolean -} - -function readColors(): LayerColors { - const html = document.documentElement - const css = getComputedStyle(html) - const get = (name: string): string => css.getPropertyValue(name).trim() - return { paper: get('--bg'), ink: get('--fg'), accent: get('--accent'), dark: html.dataset.theme === 'dark' } -} - -function mixHex(first: string, weight: number, second: string): string { - const channel = (hex: string): number[] => { - const h = hex.replace('#', '') - return [0, 2, 4].map(index => Number.parseInt(h.slice(index, index + 2), 16)) - } - const a = channel(first) - const b = channel(second) - const mixed = a.map((value, index) => Math.round(value * weight + (b[index] ?? 0) * (1 - weight))) - return `#${mixed.map(value => value.toString(16).padStart(2, '0')).join('')}` -} - -/** Tagline text the pen writes. A placeholder block is not copy. */ -function handCopy(el: HTMLElement | null): string { - if (!el) - return '' - const clone = el.cloneNode(true) as HTMLElement - clone.querySelectorAll('.l-fill').forEach(node => node.remove()) - return (clone.textContent ?? '').trim() -} - -function sectionsOf(root: HTMLElement): NonNullable { - return [...root.querySelectorAll('.l-section')].flatMap((section) => { - const label = section.querySelector('[data-anchor="label"]') - if (!label) - return [] - return [{ element: section, label, price: section.querySelector('[data-anchor="price"]') }] - }) -} - -/** - * One sheet of paper under the page, and the pen through it when the page has a margin. - * Layers are rebuilt per page: a new page is a new sheet. - * - * `has-hand` has to land in the same turn the pen measures, because it takes the tagline - * out of flow. The signature reports that synchronously; a pre-flush watch would be late. - */ -export function useSignature(root: Ref, options: SignatureOptions): void { - const { product } = useAppConfig() - const { theme } = useTheme() - - const signature = usePaperSignature(root, { - settings: () => { - const sig = product.signature - const el = root.value - const ruled = !!sig.line && !!options.line && !!el?.querySelector('[data-anchor="rule"]') - return { - paper: sig.paper, - bloom: sig.bloom, - line: ruled, - hand: sig.hand, - dwellAfter: sig.pointer.dwell === 'wash' ? sig.pointer.dwellAfter : 0, - click: sig.pointer.click === 'wash', - } - }, - anchors: () => { - const el = root.value - const find = (anchor: string): HTMLElement | null => el?.querySelector(`[data-anchor="${anchor}"]`) ?? null - const hand = find('tagline') - const finalMark = find('final-mark') - return { - mark: find('mark'), - hand, - handText: handCopy(hand), - rule: find('rule'), - sections: el ? sectionsOf(el) : [], - finalMark, - finalSection: finalMark?.closest('section') ?? null, - margin: find('label'), - } - }, - colors: readColors, - mixColors: mixHex, - // Travel between marks fades toward the paper. Same curve as lig: 0.24 ink in the - // middle, full ink within 32px of a mark. Section names stay underlines. - fadeRoute: true, - labels: 'line', - }) - - watch( - () => [signature.state.paper, signature.state.bloom, signature.state.stroke, signature.state.hand] as const, - ([paper, bloom, stroke, hand]) => { - const html = document.documentElement - html.classList.toggle('has-paper', paper) - html.classList.toggle('has-bloom', bloom) - html.classList.toggle('has-stroke', stroke) - html.classList.toggle('has-hand', hand) - }, - { flush: 'sync' }, - ) - - watch(theme, async () => { - await nextTick() - signature.setColors() - }) - - onBeforeUnmount(() => { - document.documentElement.classList.remove('has-paper', 'has-bloom', 'has-stroke', 'has-hand') - }) -} diff --git a/app/composables/useTheme.ts b/app/composables/useTheme.ts deleted file mode 100644 index 8aa9e3b..0000000 --- a/app/composables/useTheme.ts +++ /dev/null @@ -1,34 +0,0 @@ -import type { Ref } from 'vue' -import type { Theme } from '~/types' - -const KEY = 'kit-theme' - -/** Theme on `html[data-theme]`; the head script picks it before paint, this keeps it in sync. */ -export function useTheme(): { theme: Ref, ready: Ref, toggle: () => void } { - const theme = useState('theme', () => 'light') - const ready = useState('theme-ready', () => false) - - if (import.meta.client && !ready.value) { - onNuxtReady(() => { - theme.value = document.documentElement.dataset.theme === 'dark' ? 'dark' : 'light' - ready.value = true - matchMedia('(prefers-color-scheme: dark)').addEventListener('change', (event) => { - if (!localStorage.getItem(KEY)) - apply(event.matches ? 'dark' : 'light') - }) - }) - } - - function apply(next: Theme): void { - document.documentElement.dataset.theme = next - theme.value = next - } - - function toggle(): void { - const next = theme.value === 'dark' ? 'light' : 'dark' - localStorage.setItem(KEY, next) - apply(next) - } - - return { theme, ready, toggle } -} diff --git a/app/error.vue b/app/error.vue deleted file mode 100644 index 97b8e8a..0000000 --- a/app/error.vue +++ /dev/null @@ -1,38 +0,0 @@ - - - diff --git a/app/layouts/default.vue b/app/layouts/default.vue deleted file mode 100644 index 37d0bdd..0000000 --- a/app/layouts/default.vue +++ /dev/null @@ -1,39 +0,0 @@ - - - diff --git a/app/pages/[...slug].vue b/app/pages/[...slug].vue deleted file mode 100644 index 376f3bb..0000000 --- a/app/pages/[...slug].vue +++ /dev/null @@ -1,47 +0,0 @@ - - - diff --git a/app/pages/changelog.vue b/app/pages/changelog.vue deleted file mode 100644 index a839bae..0000000 --- a/app/pages/changelog.vue +++ /dev/null @@ -1,63 +0,0 @@ - - - diff --git a/app/pages/docs/[...slug].vue b/app/pages/docs/[...slug].vue deleted file mode 100644 index 34b32d3..0000000 --- a/app/pages/docs/[...slug].vue +++ /dev/null @@ -1,109 +0,0 @@ - - - diff --git a/app/pages/index.vue b/app/pages/index.vue deleted file mode 100644 index 5ac2daf..0000000 --- a/app/pages/index.vue +++ /dev/null @@ -1,7 +0,0 @@ - - - diff --git a/app/pages/notes/[slug].vue b/app/pages/notes/[slug].vue deleted file mode 100644 index 7635afe..0000000 --- a/app/pages/notes/[slug].vue +++ /dev/null @@ -1,87 +0,0 @@ - - - diff --git a/app/pages/notes/index.vue b/app/pages/notes/index.vue deleted file mode 100644 index ae555bc..0000000 --- a/app/pages/notes/index.vue +++ /dev/null @@ -1,68 +0,0 @@ - - - diff --git a/app/types.ts b/app/types.ts deleted file mode 100644 index a9c8b03..0000000 --- a/app/types.ts +++ /dev/null @@ -1,91 +0,0 @@ -export interface Signature { - /** WebGL sheet and washes behind the page. The tooth lives on `Paper`. */ - paper: boolean - /** One pen line threading the page head, the label column and the last full stop. */ - line: boolean - /** The pen handwrites the hero tagline (Latin only; the font has no CJK glyphs). */ - hand: boolean - /** Watercolour on punctuation. Needs `paper`. */ - bloom: boolean - /** Ink the pointer leaves on the paper. `false` is still. `wash` is watercolour. */ - pointer: { - dwell: false | 'wash' - click: false | 'wash' - /** Seconds the pointer must rest before dwell ink starts. */ - dwellAfter: number - } -} - -export interface NavLink { - /** i18n key, e.g. `nav.docs`. */ - label: string - /** Locale-free path (`/docs`, `/#pricing`) or an absolute URL. */ - to: string -} - -export interface Palette { - bg: string - fg: string - muted: string - faint: string - line: string - accent: string -} - -/** Optional overrides for type, scale and grid. Omitted keys keep the stylesheet defaults. */ -export interface Skin { - font?: { display?: string, text?: string, meta?: string } - /** 1 is the shipped page. Display, poster and title scale their own clamps. */ - scale?: { display?: number, poster?: number, title?: number, section?: number } - gap?: string - section?: string - /** Margin column and body column. They should add up to 12. */ - margin?: number - body?: number -} - -export interface ProductConfig { - /** Wordmark. Empty renders a placeholder block. */ - name: string - /** The accent stop after the name. */ - mark: string - theme: { light: Palette, dark: Palette } - skin?: Skin - signature: Signature - /** Where "Install" goes. `null` plays the vanish instead of navigating. */ - install: { href: string | null } - nav: NavLink[] -} - -declare module 'nuxt/schema' { - interface AppConfigInput { - product?: Partial - } - interface AppConfig { - product: ProductConfig - } -} - -export type Theme = 'light' | 'dark' - -export interface Figure { - value: string - unit?: string - label?: string - copy?: string -} - -export interface Quote { - quote: string - by?: string -} - -export interface Fact { - label: string - value: string -} - -export interface Question { - q: string - a: string -} diff --git a/app/utils/text.ts b/app/utils/text.ts deleted file mode 100644 index ecd50e5..0000000 --- a/app/utils/text.ts +++ /dev/null @@ -1,30 +0,0 @@ -const STOP = /^(.*?)([.!?。!?])$/s - -/** Splits trailing punctuation off so a signature layer can take its place. */ -export function splitStop(text: string, fallback = ''): { body: string, stop: string } { - const match = STOP.exec(text.trim()) - return match ? { body: match[1] ?? '', stop: match[2] ?? '' } : { body: text.trim(), stop: fallback } -} - -export function isFilled(value: unknown): value is string { - return typeof value === 'string' && value.trim().length > 0 -} - -function collectText(node: unknown, out: string[]): void { - if (typeof node === 'string') - out.push(node) - else if (Array.isArray(node)) - node.forEach((child, index) => (index > 0 || typeof child !== 'string' ? collectText(child, out) : undefined)) - else if (node && typeof node === 'object' && 'value' in node) - collectText((node as { value: unknown }).value, out) -} - -/** Rough reading time from a minimark body: ~200 words or ~400 CJK characters a minute. */ -export function readingMinutes(body: unknown): number { - const out: string[] = [] - collectText(body, out) - const text = out.join(' ') - const cjk = (text.match(/[\u3400-\u9FFF]/g) ?? []).length - const words = text.replace(/[\u3400-\u9FFF]/g, ' ').split(/\s+/).filter(Boolean).length - return Math.max(1, Math.round(words / 200 + cjk / 400)) -} diff --git a/app/utils/theme.ts b/app/utils/theme.ts deleted file mode 100644 index 46697bb..0000000 --- a/app/utils/theme.ts +++ /dev/null @@ -1,14 +0,0 @@ -import type { Palette } from '~/types' - -const KEYS = ['bg', 'fg', 'muted', 'faint', 'line', 'accent'] as const - -function decl(palette: Palette, scheme: 'light' | 'dark'): string { - const colors = KEYS.map(key => `--${key}: ${palette[key]}`).join('; ') - return `${colors}; color-scheme: ${scheme}` -} - -/** Light and dark palettes. `html:root` beats the stylesheet so these win. */ -export function themeStyle(theme: { light: Palette, dark: Palette }): string { - const dark = decl(theme.dark, 'dark') - return `html:root{${decl(theme.light, 'light')}}html:root[data-theme=dark]{${dark}}@media (prefers-color-scheme: dark){html:root:not([data-theme]){${dark}}}` -} diff --git a/cloudflare.config.ts b/cloudflare.config.ts new file mode 100644 index 0000000..2285441 --- /dev/null +++ b/cloudflare.config.ts @@ -0,0 +1,18 @@ +import { defineConfig } from 'cf/config' + +export default defineConfig({ + worker: { + name: 'ui', + compatibilityDate: '2026-10-12', + observability: { + enabled: true, + traces: { + enabled: true, + }, + }, + assets: { + htmlHandling: 'drop-trailing-slash', + notFoundHandling: '404-page', + }, + }, +}) diff --git a/content.config.ts b/content.config.ts deleted file mode 100644 index 06af7b8..0000000 --- a/content.config.ts +++ /dev/null @@ -1,42 +0,0 @@ -import { defineCollection, defineContentConfig, z } from '@nuxt/content' - -// Every file lives under a locale folder (`en/`, `zh/`, `ja/`), so paths start with `/en`, `/zh`, `/ja`. -export default defineContentConfig({ - collections: { - // Free-form pages built from MDC blocks: the landing (`index.md`), install, anything else - pages: defineCollection({ - type: 'page', - source: { - include: '*/**/*.md', - exclude: ['*/notes/**', '*/changelog/**', '*/docs/**'], - }, - schema: z.object({ - kicker: z.string().optional(), - // Page head with a big title and ruled lede; the landing turns it off and uses `::hero` - head: z.boolean().default(true), - // Whether the pen runs through this page - line: z.boolean().default(true), - }), - }), - notes: defineCollection({ - type: 'page', - source: '*/notes/*.md', - schema: z.object({ - date: z.string(), - }), - }), - changelog: defineCollection({ - type: 'page', - source: '*/changelog/*.md', - schema: z.object({ - version: z.string(), - date: z.string(), - }), - }), - // Numeric prefixes (`1.install.md`) order the sidebar and are dropped from the path - docs: defineCollection({ - type: 'page', - source: '*/docs/**/*.md', - }), - }, -}) diff --git a/content/en/changelog/release.md b/content/en/changelog/release.md deleted file mode 100644 index 11352bf..0000000 --- a/content/en/changelog/release.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: '' -version: '' -date: '' ---- diff --git a/content/en/docs/0.index.md b/content/en/docs/0.index.md deleted file mode 100644 index 378751d..0000000 --- a/content/en/docs/0.index.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -title: '' -description: '' ---- diff --git a/content/en/index.md b/content/en/index.md deleted file mode 100644 index 2a5a06e..0000000 --- a/content/en/index.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: '' -description: '' -head: false ---- - -::hero ---- -tagline: i shipped nothing. -lede: '' ---- -:: - -::block ---- -id: specs -label: '' -title: '' ---- - :::figures - --- - items: - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - --- - ::: -:: - -::block ---- -id: statement -label: '' -title: '' ---- - :::statement - --- - lines: - - '' - - '' - --- - ::: -:: - -::block ---- -id: quotes -label: '' ---- - :::quotes - --- - items: - - { quote: '', by: '' } - - { quote: '', by: '' } - - { quote: '', by: '' } - --- - ::: -:: - -::block ---- -id: pricing -label: '' ---- - :::price - --- - price: '' - period: '' - lede: '' - facts: - - { label: '', value: '' } - - { label: '', value: '' } - - { label: '', value: '' } - - { label: '', value: '' } - --- - ::: -:: - -::block ---- -id: faq -label: '' ---- - :::faq - --- - items: - - { q: '', a: '' } - - { q: '', a: '' } - - { q: '', a: '' } - --- - ::: -:: - -::final ---- -title: '' -lede: '' ---- -:: diff --git a/content/en/install.md b/content/en/install.md deleted file mode 100644 index 2f28a5d..0000000 --- a/content/en/install.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: '' -kicker: '' -description: '' ---- - -::step{label="" title="" code=""} -:: - -::step{label="" title="" code=""} -:: - -::step{label="" title="" code=""} -:: - -::final{title="" end} -:: diff --git a/content/en/notes/note.md b/content/en/notes/note.md deleted file mode 100644 index ac7bb8e..0000000 --- a/content/en/notes/note.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: '' -description: '' -date: '' ---- diff --git a/content/ja/changelog/release.md b/content/ja/changelog/release.md deleted file mode 100644 index 11352bf..0000000 --- a/content/ja/changelog/release.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: '' -version: '' -date: '' ---- diff --git a/content/ja/docs/0.index.md b/content/ja/docs/0.index.md deleted file mode 100644 index 378751d..0000000 --- a/content/ja/docs/0.index.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -title: '' -description: '' ---- diff --git a/content/ja/index.md b/content/ja/index.md deleted file mode 100644 index 2a5a06e..0000000 --- a/content/ja/index.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: '' -description: '' -head: false ---- - -::hero ---- -tagline: i shipped nothing. -lede: '' ---- -:: - -::block ---- -id: specs -label: '' -title: '' ---- - :::figures - --- - items: - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - --- - ::: -:: - -::block ---- -id: statement -label: '' -title: '' ---- - :::statement - --- - lines: - - '' - - '' - --- - ::: -:: - -::block ---- -id: quotes -label: '' ---- - :::quotes - --- - items: - - { quote: '', by: '' } - - { quote: '', by: '' } - - { quote: '', by: '' } - --- - ::: -:: - -::block ---- -id: pricing -label: '' ---- - :::price - --- - price: '' - period: '' - lede: '' - facts: - - { label: '', value: '' } - - { label: '', value: '' } - - { label: '', value: '' } - - { label: '', value: '' } - --- - ::: -:: - -::block ---- -id: faq -label: '' ---- - :::faq - --- - items: - - { q: '', a: '' } - - { q: '', a: '' } - - { q: '', a: '' } - --- - ::: -:: - -::final ---- -title: '' -lede: '' ---- -:: diff --git a/content/ja/install.md b/content/ja/install.md deleted file mode 100644 index 2f28a5d..0000000 --- a/content/ja/install.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: '' -kicker: '' -description: '' ---- - -::step{label="" title="" code=""} -:: - -::step{label="" title="" code=""} -:: - -::step{label="" title="" code=""} -:: - -::final{title="" end} -:: diff --git a/content/ja/notes/note.md b/content/ja/notes/note.md deleted file mode 100644 index ac7bb8e..0000000 --- a/content/ja/notes/note.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: '' -description: '' -date: '' ---- diff --git a/content/zh/changelog/release.md b/content/zh/changelog/release.md deleted file mode 100644 index 11352bf..0000000 --- a/content/zh/changelog/release.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: '' -version: '' -date: '' ---- diff --git a/content/zh/docs/0.index.md b/content/zh/docs/0.index.md deleted file mode 100644 index 378751d..0000000 --- a/content/zh/docs/0.index.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -title: '' -description: '' ---- diff --git a/content/zh/index.md b/content/zh/index.md deleted file mode 100644 index 2a5a06e..0000000 --- a/content/zh/index.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: '' -description: '' -head: false ---- - -::hero ---- -tagline: i shipped nothing. -lede: '' ---- -:: - -::block ---- -id: specs -label: '' -title: '' ---- - :::figures - --- - items: - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - - { value: '', unit: '', label: '', copy: '' } - --- - ::: -:: - -::block ---- -id: statement -label: '' -title: '' ---- - :::statement - --- - lines: - - '' - - '' - --- - ::: -:: - -::block ---- -id: quotes -label: '' ---- - :::quotes - --- - items: - - { quote: '', by: '' } - - { quote: '', by: '' } - - { quote: '', by: '' } - --- - ::: -:: - -::block ---- -id: pricing -label: '' ---- - :::price - --- - price: '' - period: '' - lede: '' - facts: - - { label: '', value: '' } - - { label: '', value: '' } - - { label: '', value: '' } - - { label: '', value: '' } - --- - ::: -:: - -::block ---- -id: faq -label: '' ---- - :::faq - --- - items: - - { q: '', a: '' } - - { q: '', a: '' } - - { q: '', a: '' } - --- - ::: -:: - -::final ---- -title: '' -lede: '' ---- -:: diff --git a/content/zh/install.md b/content/zh/install.md deleted file mode 100644 index 2f28a5d..0000000 --- a/content/zh/install.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: '' -kicker: '' -description: '' ---- - -::step{label="" title="" code=""} -:: - -::step{label="" title="" code=""} -:: - -::step{label="" title="" code=""} -:: - -::final{title="" end} -:: diff --git a/content/zh/notes/note.md b/content/zh/notes/note.md deleted file mode 100644 index ac7bb8e..0000000 --- a/content/zh/notes/note.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: '' -description: '' -date: '' ---- diff --git a/data/README.md b/data/README.md deleted file mode 100644 index e8e332f..0000000 --- a/data/README.md +++ /dev/null @@ -1,40 +0,0 @@ -# `data/people.json` - -站点构建时只读此文件(与 `public/avatars/` 中的头像路径)。画板只显示 `status` 为 `mutual` 且未隐藏的人。当前文件里还留着 2026-09-28 的快照,其中有关注了 froQ 但 froQ 没有回关的人;这些人不会画出来。每周一 04:20 UTC,`.github/workflows/refresh-circle.yml` 用 SocialData 重拉关注者与正在关注的人,只保留两边都有的互关,写回这个文件。仓库需要 secret `SOCIALDATA_API_KEY`。余额不足时这次跳过,不把任务标成失败。 - -第一次跑只记下时间,不回头重扫互动,文件里已有的 `interactions` 留着。之后每次只搜上次记下的时间之后、froQ 发出的和提到 froQ 的帖,把回复、引用、@ 加到对应互关的 `interactions` 上。已经计过的帖子 id 写在 `data/sync.json`,同一条不会再加一次。头像不下载进仓库,只把 X 的图片地址写进 `avatar`,页面打开时由浏览器去取。这次快照里已经缓存的 `public/avatars/` 仍给当前文件用,下次任务跑完就会换成远程地址。 - -`data/hidden.json` 是一串 user id。出现在里面的人不会被每周任务加回来,也不会上墙。 - -`scripts/generate-mock-circle.mjs` 会用虚构名单覆盖 `people.json`。不要在这份真名单上跑它。备注没有写入。 - -## 顶层结构 - -| 字段 | 类型 | 说明 | -| --------- | ------ | ------------------------------------------------------ | -| `version` | `1` | 格式版本 | -| `center` | object | froQ 的名字和 handle,仅作数据归属。画板不渲染这张头像 | -| `people` | array | 成员列表 | - -## `people[]` 字段 - -| 字段 | 类型 | 说明 | -| -------------- | ---------------------------------------------------- | ------------------------------------------------------------ | -| `name` | string | 显示名 | -| `handle` | string | X handle,不带 `@` | -| `userId` | string | X user id,改名后对齐同一人 | -| `avatar` | string | 头像地址。远程 URL,或快照里的 `/avatars/{userId}.jpg` | -| `status` | `mutual` \| `followsMe` \| `iFollow` \| `unfollowed` | 关注状态 | -| `firstSeen` | string (ISO date) | 首次出现在快照的日期 | -| `unfollowedAt` | string \| null | 取关日 | -| `hidden` | boolean | `true` 则不上墙、不参与渲染 | -| `ring` | `auto` \| `1` \| `2` \| `3` \| `4` | 数据管线可保留。站点不读取、不展示、不参与摆放 | -| `platforms` | `{ name, url }[]` | 其他平台链接 | -| `impression` | `string` \| `string[]` | 我对这个人写下的句子。空着时笔记用按 userId 固定的等候句 | -| `aboutMe` | `string` \| `string[]`,可省略 | 这个人写给我的句子。空着或没有该字段时,对应标签不可点 | -| `timeline` | `{ date, text }[]` | 时间线 | -| `interactions` | number | 回复、引用、@ 的合计,从 2026-08-21 的快照累加。决定头像大小 | - -`impression` 和 `aboutMe` 里的换行会画出来,反引号中间的换行也一样。字符串里写 `\n` 可以。要在 JSON 里直接回车,写成字符串数组,一项一行,空字符串是空行。代码里的模板字符串直接回车。`[文字](https://…)` 画成链接,只接受 `http` 和 `https`。写在反引号里的链接保持原文。 - -TypeScript 类型见 `shared/circle/types.ts`。每周合并逻辑见 `shared/circle/sync.ts`。 diff --git a/data/hidden.json b/data/hidden.json deleted file mode 100644 index fe51488..0000000 --- a/data/hidden.json +++ /dev/null @@ -1 +0,0 @@ -[] diff --git a/data/people.json b/data/people.json deleted file mode 100644 index 68c99b8..0000000 --- a/data/people.json +++ /dev/null @@ -1,1478 +0,0 @@ -{ - "version": 1, - "center": { - "name": "froQ 蛙", - "handle": "0froQ", - "avatar": "" - }, - "people": [ - { - "name": "Raco | 玉米须", - "handle": "0xraco", - "userId": "54918133", - "avatar": "https://pbs.twimg.com/profile_images/2096185618346946560/nbWjIPWy_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "aBER", - "handle": "aBER0724", - "userId": "1500658863363833861", - "avatar": "https://pbs.twimg.com/profile_images/2087195079278804993/EXRBIxG1_400x400.png", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "塔菲是我疊二代機", - "handle": "Acetaffyismymom", - "userId": "2090037143972593664", - "avatar": "https://pbs.twimg.com/profile_images/2090040489114513408/Vp9HDaFj_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "塔菲喵,祝你开心啊,祝愿你" - ], - "timeline": [], - "interactions": 2 - }, - { - "name": "コンベア寿司🍣🍣", - "handle": "AlanGreenywtn", - "userId": "2045473176357056512", - "avatar": "https://pbs.twimg.com/profile_images/2102070738769637376/Ew41nZuU_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "Alex Chen", - "handle": "AlexChe31659937", - "userId": "1313424628900036609", - "avatar": "https://pbs.twimg.com/profile_images/2100936264136491008/SEz4gt2g_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Alexis", - "handle": "alexisbchz", - "userId": "1811126002749427713", - "avatar": "https://pbs.twimg.com/profile_images/2092266981680386048/GaHPlGWY_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Explore the world", - "handle": "Alina_bloom79", - "userId": "2046621802432983040", - "avatar": "https://pbs.twimg.com/profile_images/2086688714386743296/GKsIsglv_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Andy🌱(薄肌版)", - "handle": "AndyMuse5yxy", - "userId": "2092993804852948992", - "avatar": "https://pbs.twimg.com/profile_images/2103999576709701632/OesQtmpw_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "是现生好朋友,做过一件很有勇气我很佩服的事情,敬礼" - ], - "timeline": [], - "interactions": 4 - }, - { - "name": "一个托尼・Anthony Fu", - "handle": "antfuzh", - "userId": "1838445323317805057", - "avatar": "https://pbs.twimg.com/profile_images/1983288024957161472/lD6DjnS8_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 2 - }, - { - "name": "Aron厚玉", - "handle": "aronhouyu", - "userId": "1554575293264072705", - "avatar": "https://pbs.twimg.com/profile_images/2064553439850532864/a3JplYRF_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 1 - }, - { - "name": "Han Cheng e/acc", - "handle": "ashfold", - "userId": "84791916", - "avatar": "https://pbs.twimg.com/profile_images/1809928490625769472/oNxI4Rbs_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "dim 那边的前辈,敬礼" - ], - "timeline": [], - "interactions": 1 - }, - { - "name": "Aulia Danaya🌟", - "handle": "auliadanaya", - "userId": "1594178606682427392", - "avatar": "https://pbs.twimg.com/profile_images/2102403911655239680/apEvqlr2_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "Ayesha Vibes 💫", - "handle": "ayeshakivibes", - "userId": "1740761794740899840", - "avatar": "https://pbs.twimg.com/profile_images/1741194137368752128/_J6ViPdD_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "سما اليمن", - "handle": "bentyemenone", - "userId": "2072115710260903936", - "avatar": "https://pbs.twimg.com/profile_images/2100988853628567552/GW8dzcue_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Bdark", - "handle": "Bryankdark", - "userId": "96058727", - "avatar": "https://pbs.twimg.com/profile_images/904148775593066496/RQVdcCOZ_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "BTC_Fahmi", - "handle": "btc_fahmi", - "userId": "1947522310816337921", - "avatar": "https://pbs.twimg.com/profile_images/2080435819765190656/aV-H3qZw_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "ByteLee · AI Investing", - "handle": "bytelee_trade", - "userId": "1749597659902713856", - "avatar": "https://pbs.twimg.com/profile_images/2067425510221889536/koDGQGTL_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 1 - }, - { - "name": "沧弦", - "handle": "Cang390", - "userId": "2032861173780267008", - "avatar": "https://pbs.twimg.com/profile_images/2100840235269840896/fnfLqkcU_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 1 - }, - { - "name": "Cat tgp", - "handle": "Cattgp01", - "userId": "2084117736096190464", - "avatar": "https://pbs.twimg.com/profile_images/2084119102810148864/wq6RG_gm_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Hardy Chen", - "handle": "Chchenhao0129", - "userId": "1929526459661721600", - "avatar": "https://pbs.twimg.com/profile_images/2104833492974813184/xW3uc0rj_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 11 - }, - { - "name": "多吃香菜", - "handle": "chen20010418", - "userId": "1898761780207501312", - "avatar": "https://pbs.twimg.com/profile_images/2086520636416143360/QCc8Wrai_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "chenke", - "handle": "chenke20266", - "userId": "1586383785687650304", - "avatar": "https://pbs.twimg.com/profile_images/2105156461622177792/vWvFiTQG_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "初白洛🇦🇶", - "handle": "chubailuo", - "userId": "2080270067426832384", - "avatar": "https://pbs.twimg.com/profile_images/2105347660807049216/dKxy1NTW_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "创始 fo 之一。 \n", - "这个疑似是小号,或者另一个是小号。总之另一个已经消失的号是我的第一个 fo \n", - "I'm blushing" - ], - "timeline": [], - "interactions": 5 - }, - { - "name": "✡春夏风波🇭🇰🌈", - "handle": "ChunXiaFb", - "userId": "1074838588012052481", - "avatar": "https://pbs.twimg.com/profile_images/1541781569442299904/qC3mMBsn_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "3arbiDeluxe", - "handle": "claire1babyuyzx", - "userId": "1815427488945770497", - "avatar": "https://pbs.twimg.com/profile_images/1974917957483376640/fNNz34Fa_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "CocKtaiL", - "handle": "cocktail_o1", - "userId": "1571894847610695681", - "avatar": "https://pbs.twimg.com/profile_images/2103142068478771200/oj-UtDO2_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Cyrus", - "handle": "cyrusss_7", - "userId": "1455938770105090051", - "avatar": "https://pbs.twimg.com/profile_images/2070534468562231296/Rui5MUeY_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Dasun Tharanga", - "handle": "dasundev", - "userId": "1248286805134196737", - "avatar": "https://pbs.twimg.com/profile_images/1895139640698388480/8kFo0yhM_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Darling", - "handle": "dawndarlinwbdn", - "userId": "454281254", - "avatar": "https://pbs.twimg.com/profile_images/2081277577012891648/XLyZYbeD_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "小八, PhD", - "handle": "Demetrius250946", - "userId": "2034862697150644224", - "avatar": "https://pbs.twimg.com/profile_images/2034862746857357312/7FxCNBrc_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "鹿人甲", - "handle": "doubllife", - "userId": "1449354945900072964", - "avatar": "https://pbs.twimg.com/profile_images/2100918182592831488/GL9mM9la_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Emiliao_Weber", - "handle": "Emiliao_Weber", - "userId": "2871437570", - "avatar": "https://pbs.twimg.com/profile_images/2094055470294003712/lGxl2gzw_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Ethan Wang 亦衡", - "handle": "EthanWang07X", - "userId": "2094811881961844736", - "avatar": "https://pbs.twimg.com/profile_images/2094812329577988096/g43P8xzm_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 7 - }, - { - "name": "Aventurero Espacial H_12", - "handle": "ExplorastrosH12", - "userId": "1263990230916444162", - "avatar": "https://pbs.twimg.com/profile_images/2086877068197761024/1ku88Sx1_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "星野ふじ", - "handle": "fake_fuji", - "userId": "4313176880", - "avatar": "https://pbs.twimg.com/profile_images/2092628974954504192/4swLS2sK_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "小藤,那还不是你全部的故事,祝你开心!" - ], - "timeline": [], - "interactions": 2 - }, - { - "name": "World Explorer", - "handle": "flower6260", - "userId": "1951001334850912256", - "avatar": "https://pbs.twimg.com/profile_images/2042375597016399872/qejxxwtz_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Flynn", - "handle": "fly3nn", - "userId": "1854066640847298560", - "avatar": "https://pbs.twimg.com/profile_images/2078835312848162817/yo0b8c26_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 2 - }, - { - "name": "阿离啊哩哩", - "handle": "gengzishunli", - "userId": "918716499254132736", - "avatar": "https://pbs.twimg.com/profile_images/2049935213028048896/cOC68CPP_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Gia", - "handle": "giadotai", - "userId": "1820066784625758208", - "avatar": "https://pbs.twimg.com/profile_images/2103517950640852993/0ApmLjvo_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 1 - }, - { - "name": "gKev1n", - "handle": "GKev1n", - "userId": "1067085110372171779", - "avatar": "https://pbs.twimg.com/profile_images/2100717851745394688/wg1dGu-F_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "hr3eoo", - "handle": "HR3EOO", - "userId": "2085457755243167744", - "avatar": "https://pbs.twimg.com/profile_images/2104104851718422528/ooGu9HWn_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 1 - }, - { - "name": "Husan Awan", - "handle": "husanmubarak47", - "userId": "1833723975375192064", - "avatar": "https://pbs.twimg.com/profile_images/2010649753126895616/lrIq8gM2_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Ian (伊恩)", - "handle": "ianneo_ai", - "userId": "1249322582869852161", - "avatar": "https://pbs.twimg.com/profile_images/1891533502811865088/TGLd-ENY_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 9 - }, - { - "name": "Jacie 🌸🏳️", - "handle": "Jaciezyt", - "userId": "1271652280438308864", - "avatar": "https://pbs.twimg.com/profile_images/2101600062413635584/KemIHPfL_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 1 - }, - { - "name": "Jack", - "handle": "JacksAISites", - "userId": "1169225590077108224", - "avatar": "https://pbs.twimg.com/profile_images/1998750686897397760/-656IiK9_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "一个好像在北欧的 indie dev 哥,北欧好玩吗我也想去,有钱就去嗯\n", - "爆过一条 Astra 的帖子我记得哈哈" - ], - "timeline": [], - "interactions": 1 - }, - { - "name": "Jayati :)", - "handle": "jayaticore", - "userId": "1870889540510212096", - "avatar": "https://pbs.twimg.com/profile_images/2103175368924680192/H_ZwDyrZ_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "kia", - "handle": "jkiesoft", - "userId": "1987402138667130881", - "avatar": "https://pbs.twimg.com/profile_images/2043260826774392832/Mu52LJKL_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "喜欢点赞,有时候发一些有趣的 meme,爱看" - ], - "timeline": [], - "interactions": 2 - }, - { - "name": "HaonanPro", - "handle": "keke202106", - "userId": "3005075238", - "avatar": "https://pbs.twimg.com/profile_images/1954072516668145664/ud5Wtdme_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Keng", - "handle": "kengdaica", - "userId": "1297343586984321024", - "avatar": "https://pbs.twimg.com/profile_images/2058974247259947008/Cw6IyZur_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "King of Fitness", - "handle": "kingoffitnessuk", - "userId": "2391269245", - "avatar": "https://pbs.twimg.com/profile_images/2101996907769786368/8dITTZlr_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Kiruha 2.0", - "handle": "Kir4uh", - "userId": "2087152708696346624", - "avatar": "https://pbs.twimg.com/profile_images/2103827237304721408/Zhs9NnwQ_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "A nice Russian guy. Posts a lot anime photos with long thoughts, but unfortunately I have no idea who are them. \n", - "We love you, Kiruha. Remember that" - ], - "timeline": [], - "interactions": 1 - }, - { - "name": "无能的艾薇娜", - "handle": "klarkxy", - "userId": "1495741137193435140", - "avatar": "https://pbs.twimg.com/profile_images/2091464264754380800/mFogn0wp_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 3 - }, - { - "name": "Kory(互fo", - "handle": "Kory0bir", - "userId": "2095023594594320384", - "avatar": "https://pbs.twimg.com/profile_images/2095073161943642112/MV3E2szK_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "江小鱼", - "handle": "ldxhjxy", - "userId": "1141991788300984326", - "avatar": "https://pbs.twimg.com/profile_images/2103701213531303936/yr-3u0vO_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-30", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Lê Hưng", - "handle": "lehunggm", - "userId": "849656764312178688", - "avatar": "https://pbs.twimg.com/profile_images/2041142172532301825/d0EBte-z_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "林檎k", - "handle": "linqin_loveme", - "userId": "2085668508915118080", - "avatar": "https://pbs.twimg.com/profile_images/2104596359173279745/sPGWaFRP_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "创始 fo 之一,话很多我很喜欢,互动最多的人没有之一。\n", - "在另外某一个平台好像也在 mutual。\n", - "还是 feeds 的最早的早鸟,可能暗恋我,但不确定。" - ], - "timeline": [], - "interactions": 69 - }, - { - "name": "dodge", - "handle": "littlelion_love", - "userId": "2018144705448730624", - "avatar": "https://pbs.twimg.com/profile_images/2096868551739265024/QUb0g4XW_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 1 - }, - { - "name": "LKDenchin", - "handle": "LKDenchin", - "userId": "1825733032151756801", - "avatar": "https://pbs.twimg.com/profile_images/2050444945090383872/13FFGUjq_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "好像不太活跃。\n", - "记得一个类似「对于同学全程用 AI 不看代码写了一个博客的批判」(joking)的帖子,觉得说得很对,记了很久" - ], - "timeline": [], - "interactions": 1 - }, - { - "name": "卡尔森", - "handle": "loooool_fun", - "userId": "2007010624291983360", - "avatar": "https://pbs.twimg.com/profile_images/2102381328901734400/8OQV_8SM_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "猫", - "handle": "Lorp_Voltemord", - "userId": "2001163937388355584", - "avatar": "https://pbs.twimg.com/profile_images/2096491165608718336/OnyPzvqu_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "May", - "handle": "mayflowers2x8", - "userId": "818705139120734209", - "avatar": "https://pbs.twimg.com/profile_images/2059692432821043200/cWH-O5yb_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "ポストトゥルース", - "handle": "miaodeisu", - "userId": "1755853048277331968", - "avatar": "https://pbs.twimg.com/profile_images/2105197674832244736/PkwO5dmd_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 12 - }, - { - "name": "Julia REPL stan now at mas to/b sky", - "handle": "miguelraz_", - "userId": "1317141761689485312", - "avatar": "https://pbs.twimg.com/profile_images/1510087078259961856/YNb1gT_R_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "Might be the one that start something" - ], - "timeline": [], - "interactions": 6 - }, - { - "name": "𝒎𝒊𝒓𝒂", - "handle": "mira_beant", - "userId": "2069854346590978048", - "avatar": "https://pbs.twimg.com/profile_images/2077243542880276480/asKfRA-K_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "A lot of beautiful scenes, like that" - ], - "timeline": [], - "interactions": 1 - }, - { - "name": "雨夹雪❄️", - "handle": "mizorewww", - "userId": "1987885638038036480", - "avatar": "https://pbs.twimg.com/profile_images/1987888073292881921/_qmTL0fK_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-30", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "智乃萌萌", - "handle": "moeKafuuChino", - "userId": "2090993417744719872", - "avatar": "https://pbs.twimg.com/profile_images/2090995335971950592/9TidCFGQ_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "凌甫Oberon", - "handle": "Mr_Lingfu", - "userId": "1886927751065821188", - "avatar": "https://pbs.twimg.com/profile_images/1942403760451461120/NffNZ4PG_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "著名token投资人", - "handle": "mydream2025", - "userId": "410856662", - "avatar": "https://pbs.twimg.com/profile_images/1635514576/u_1859023631_728900639_fm_0_gp_0_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "nature vibes", - "handle": "naturevibe8tkf", - "userId": "2083615743099469824", - "avatar": "https://pbs.twimg.com/profile_images/2103479505633619968/ripQKhHp_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-30", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Nguyễn Nhật Linh", - "handle": "NgNhatLinh23", - "userId": "2095556737231364096", - "avatar": "https://pbs.twimg.com/profile_images/2095557346009530368/eIyDA-Lg_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "XL", - "handle": "onionl5236", - "userId": "2032494322457964544", - "avatar": "https://pbs.twimg.com/profile_images/2090307654086475776/nPUX-lud_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "Ban Nguyen", - "handle": "pandev00", - "userId": "1789666230993145856", - "avatar": "https://pbs.twimg.com/profile_images/2091121842451034112/yYG7IzRD_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Pavot", - "handle": "Pavotttt", - "userId": "425629159", - "avatar": "https://pbs.twimg.com/profile_images/2063865784108273664/M5XtR8J-_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 1 - }, - { - "name": "Revolutionary Gangsta💚", - "handle": "RevoGangSta777", - "userId": "294688744", - "avatar": "https://pbs.twimg.com/profile_images/2088483892000940032/W3vgrXBA_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "阿彬油画日记", - "handle": "roberthuang236", - "userId": "912516778298720256", - "avatar": "https://pbs.twimg.com/profile_images/2098724307388248064/cXx3HqPk_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "SeanX888", - "handle": "SeanX_888", - "userId": "2098243498973519885", - "avatar": "https://pbs.twimg.com/profile_images/2101705547896811520/GrmzeaWl_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "青空 しょな", - "handle": "seikuushona", - "userId": "1684547487460388864", - "avatar": "https://pbs.twimg.com/profile_images/2040417468221620224/AJg3v3Jf_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "𝐒𝐡𝐢 Anime ☄️", - "handle": "Senshi2k2", - "userId": "1476943097980276743", - "avatar": "https://pbs.twimg.com/profile_images/2106374933547044864/YjbMswpp_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "SerKo", - "handle": "serkodev", - "userId": "1514266603080548357", - "avatar": "https://pbs.twimg.com/profile_images/1906792885145739264/PyG0mDjb_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "Shohana", - "handle": "Shohana79", - "userId": "2090816762610962432", - "avatar": "https://pbs.twimg.com/profile_images/2099066102370492416/H0jx0-FX_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "Rita", - "handle": "sleepyRizzy", - "userId": "2097614252605648896", - "avatar": "https://pbs.twimg.com/profile_images/2097616171067736064/wmbtosvz_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "我老大" - ], - "timeline": [], - "interactions": 1 - }, - { - "name": "大嘴和尚", - "handle": "SonicAIWizard", - "userId": "1521086568194211842", - "avatar": "https://pbs.twimg.com/profile_images/2014498796286124032/uyhvKFRa_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "TheEasySale(互关,有关必回)", - "handle": "TheEasySale1", - "userId": "1126207424602337280", - "avatar": "https://pbs.twimg.com/profile_images/1126241289526071296/a9Qu3z3a_400x400.png", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "红与羽", - "handle": "tingzi_love", - "userId": "2089299881433448448", - "avatar": "https://pbs.twimg.com/profile_images/2099017490902994944/TwoP_-lB_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "林檎的小号,见 @linqin_loveme" - ], - "timeline": [], - "interactions": 5 - }, - { - "name": "文森", - "handle": "wensen771", - "userId": "802087418295783426", - "avatar": "https://pbs.twimg.com/profile_images/2099508195794501632/Ovl1hiu8_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "wjcjdk", - "handle": "wjcjdkqj7", - "userId": "2089887330790481920", - "avatar": "https://pbs.twimg.com/profile_images/2089887741236723712/-xEiNxHz_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 2 - }, - { - "name": "夕凡的撸毛之路", - "handle": "xifancry", - "userId": "1843183245808271360", - "avatar": "https://pbs.twimg.com/profile_images/1947343260080607232/-huf5FB__400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 0 - }, - { - "name": "Yifan Xu", - "handle": "yifanxu_ephai", - "userId": "2073035346707968000", - "avatar": "https://pbs.twimg.com/profile_images/2086091150700711936/YHkMTIg__400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "第一个来看我 live streaming 的人,早上好老师" - ], - "timeline": [], - "interactions": 9 - }, - { - "name": "由依🍥", - "handle": "youy1qwq", - "userId": "2012631283898187776", - "avatar": "https://pbs.twimg.com/profile_images/2013914887219449856/H9ph0zAm_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "喜欢搬屎(joking),爱看,希望你开心" - ], - "timeline": [], - "interactions": 2 - }, - { - "name": "我比坏人好一点", - "handle": "yugencjb", - "userId": "2060338627302072321", - "avatar": "https://pbs.twimg.com/profile_images/2081368323485552640/JpFIQkhj_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-10-05", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": "", - "timeline": [], - "interactions": 2 - }, - { - "name": "幽幽小雪", - "handle": "YuuYuki233", - "userId": "1841126187789324288", - "avatar": "https://pbs.twimg.com/profile_images/2086743249411260416/dRVKFVxM_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "创始 fo 之一,苦逼高中生,虽然天天吐槽学校但是好像并不很黑暗消极,我直接很佩服" - ], - "timeline": [], - "interactions": 1 - }, - { - "name": "兴雨", - "handle": "YxzRainy", - "userId": "1994485839402057728", - "avatar": "https://pbs.twimg.com/profile_images/2101321385062854656/z5ps0oPg_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "huihui", - "handle": "yyhhyyyyyy", - "userId": "1831648250841198593", - "avatar": "https://pbs.twimg.com/profile_images/2104127421717106688/Z_JW4bMY_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - }, - { - "name": "ℤ𝕒𝕔𝕜", - "handle": "Zack_1229", - "userId": "2032599702454329344", - "avatar": "https://pbs.twimg.com/profile_images/2104092099293638656/1u36Z-j-_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [ - "创始 fo 之一,经常默默给我点赞,希望你可以多开心一点因为看起来很多时候有一点 down" - ], - "timeline": [], - "interactions": 4 - }, - { - "name": "Zara_Quinn", - "handle": "Zara_Quinnx", - "userId": "1325815317990305793", - "avatar": "https://pbs.twimg.com/profile_images/2104997454601187328/IyKr-sBi_400x400.jpg", - "status": "mutual", - "firstSeen": "2026-09-28", - "unfollowedAt": null, - "hidden": false, - "ring": "auto", - "platforms": [], - "impression": [], - "timeline": [], - "interactions": 0 - } - ] -} diff --git a/data/sync.json b/data/sync.json deleted file mode 100644 index 07f3582..0000000 --- a/data/sync.json +++ /dev/null @@ -1,111 +0,0 @@ -{ - "since": 1791199850, - "seen": [ - "2107050147217801671", - "2107044847073050649", - "2107044701270618364", - "2107043731664933123", - "2107043023985242286", - "2107042839750431060", - "2107031479750701184", - "2107029513720995852", - "2107004623513116717", - "2107002939827224694", - "2107002320651526601", - "2107002093806747798", - "2106999660829356400", - "2106998997709983754", - "2106990448426492105", - "2106990265252860263", - "2106979272976171351", - "2106977294858572253", - "2106752456436990434", - "2106750168221827255", - "2106705610113003569", - "2106695610061725704", - "2106692009616666732", - "2106691707802988977", - "2106602550183317520", - "2106602362144231741", - "2106598706405638482", - "2106437241489035394", - "2106420322652332262", - "2106417862919496009", - "2106407417768735115", - "2106405949124804692", - "2106404968655999224", - "2106402038477369497", - "2106400259983487136", - "2106400103737270528", - "2106399694532554901", - "2106354028548628589", - "2106334613056692614", - "2106315684284424451", - "2106069361748582576", - "2106067429831086469", - "2106066989374730684", - "2106061830313689509", - "2106057779924636019", - "2106048415448899904", - "2106047822282010738", - "2106045222128132600", - "2106040593088725491", - "2106031882567864534", - "2105998270619365449", - "2105982911061344534", - "2105981895196783081", - "2105963341516841278", - "2105900712979054795", - "2105893921696239886", - "2105892398413013148", - "2105891812657541447", - "2105891547380347107", - "2105886513917767858", - "2105855928012829108", - "2105850597220171838", - "2105832917545218444", - "2105711156358963520", - "2105704862474449221", - "2105641297629589920", - "2105631287767941317", - "2105631241244688687", - "2105628300274257999", - "2105627251123630327", - "2105624603695759567", - "2105624520363266112", - "2105623019469296123", - "2105622385580007894", - "2105608541033882021", - "2105607007504142783", - "2105598782775980422", - "2105584451468292400", - "2105583418847441245", - "2105582216067874921", - "2105543314720379014", - "2105541871724560726", - "2105535423724618135", - "2105529391715656025", - "2105527423903420857", - "2105527420237520996", - "2105495499717701858", - "2105491584007671887", - "2105491288598728729", - "2105490762016415748", - "2105490211014881400", - "2105474589820440938", - "2105302684169617862", - "2107043409685004607", - "2107040330042466361", - "2107033245024137549", - "2107002507599954012", - "2107001887769940355", - "2107001865133264942", - "2106992393673376103", - "2106980765859000336", - "2106470032469557483", - "2106032286928093633", - "2105556547183182222", - "2105542861953568887", - "2105491189176951088" - ] -} diff --git a/vendor/ui/docs/app/app.config.ts b/docs/app/app.config.ts similarity index 63% rename from vendor/ui/docs/app/app.config.ts rename to docs/app/app.config.ts index 7b08102..0ff44d4 100644 --- a/vendor/ui/docs/app/app.config.ts +++ b/docs/app/app.config.ts @@ -1,4 +1,15 @@ export default defineAppConfig({ + ogCovers: { + mark: 'froQ', + colors: { + title: '#1a1917', + paper: '#f4f2ec', + border: 'rgba(26, 25, 23, 0.12)', + mark: 'rgba(26, 25, 23, 0.11)', + meta: '#85837c', + evergreen: 'rgba(22, 163, 74, 0.8)', + }, + }, site: { nav: [ { label: 'nav.docs', to: '/docs', external: false }, @@ -13,7 +24,7 @@ export default defineAppConfig({ }, { label: 'docs.groups.contract', - items: ['/docs/tokens'], + items: ['/docs/tokens', '/docs/language'], }, ], }, diff --git a/vendor/ui/docs/app/app.vue b/docs/app/app.vue similarity index 100% rename from vendor/ui/docs/app/app.vue rename to docs/app/app.vue diff --git a/vendor/ui/docs/app/assets/css/fonts.css b/docs/app/assets/css/fonts.css similarity index 100% rename from vendor/ui/docs/app/assets/css/fonts.css rename to docs/app/assets/css/fonts.css diff --git a/vendor/ui/docs/app/assets/css/site.css b/docs/app/assets/css/site.css similarity index 100% rename from vendor/ui/docs/app/assets/css/site.css rename to docs/app/assets/css/site.css diff --git a/vendor/ui/docs/app/components/ComponentApi.vue b/docs/app/components/ComponentApi.vue similarity index 100% rename from vendor/ui/docs/app/components/ComponentApi.vue rename to docs/app/components/ComponentApi.vue diff --git a/vendor/ui/docs/app/components/ComponentDemo.vue b/docs/app/components/ComponentDemo.vue similarity index 100% rename from vendor/ui/docs/app/components/ComponentDemo.vue rename to docs/app/components/ComponentDemo.vue diff --git a/docs/app/components/ComponentStatus.vue b/docs/app/components/ComponentStatus.vue new file mode 100644 index 0000000..4577d54 --- /dev/null +++ b/docs/app/components/ComponentStatus.vue @@ -0,0 +1,86 @@ + + + + + diff --git a/vendor/ui/docs/app/components/DocBody.vue b/docs/app/components/DocBody.vue similarity index 100% rename from vendor/ui/docs/app/components/DocBody.vue rename to docs/app/components/DocBody.vue diff --git a/vendor/ui/docs/app/components/PageHead.vue b/docs/app/components/PageHead.vue similarity index 100% rename from vendor/ui/docs/app/components/PageHead.vue rename to docs/app/components/PageHead.vue diff --git a/vendor/ui/docs/app/components/SectionLayout.vue b/docs/app/components/SectionLayout.vue similarity index 100% rename from vendor/ui/docs/app/components/SectionLayout.vue rename to docs/app/components/SectionLayout.vue diff --git a/vendor/ui/docs/app/components/Sidebar.vue b/docs/app/components/Sidebar.vue similarity index 100% rename from vendor/ui/docs/app/components/Sidebar.vue rename to docs/app/components/Sidebar.vue diff --git a/vendor/ui/docs/app/components/SiteFooter.vue b/docs/app/components/SiteFooter.vue similarity index 100% rename from vendor/ui/docs/app/components/SiteFooter.vue rename to docs/app/components/SiteFooter.vue diff --git a/vendor/ui/docs/app/components/SiteHeader.vue b/docs/app/components/SiteHeader.vue similarity index 100% rename from vendor/ui/docs/app/components/SiteHeader.vue rename to docs/app/components/SiteHeader.vue diff --git a/vendor/ui/docs/app/components/SiteNav.vue b/docs/app/components/SiteNav.vue similarity index 100% rename from vendor/ui/docs/app/components/SiteNav.vue rename to docs/app/components/SiteNav.vue diff --git a/vendor/ui/docs/app/components/content/ProseA.vue b/docs/app/components/content/ProseA.vue similarity index 100% rename from vendor/ui/docs/app/components/content/ProseA.vue rename to docs/app/components/content/ProseA.vue diff --git a/vendor/ui/docs/app/components/content/TokenBoard.vue b/docs/app/components/content/TokenBoard.vue similarity index 100% rename from vendor/ui/docs/app/components/content/TokenBoard.vue rename to docs/app/components/content/TokenBoard.vue diff --git a/vendor/ui/docs/app/composables/useComponentDocs.ts b/docs/app/composables/useComponentDocs.ts similarity index 100% rename from vendor/ui/docs/app/composables/useComponentDocs.ts rename to docs/app/composables/useComponentDocs.ts diff --git a/vendor/ui/docs/app/composables/useComponentRoute.ts b/docs/app/composables/useComponentRoute.ts similarity index 100% rename from vendor/ui/docs/app/composables/useComponentRoute.ts rename to docs/app/composables/useComponentRoute.ts diff --git a/docs/app/composables/usePaperOgImage.ts b/docs/app/composables/usePaperOgImage.ts new file mode 100644 index 0000000..9d3fbea --- /dev/null +++ b/docs/app/composables/usePaperOgImage.ts @@ -0,0 +1,106 @@ +import type { MaybeRefOrGetter } from 'vue' +import type { ShareMetaInput } from './useShareMeta' +import { shareTitle, SITE_DESCRIPTION, SITE_NAME } from '~/utils/site' + +function cardTitle(value: string | undefined): string { + const titled = shareTitle(value) + return titled || SITE_NAME +} + +/** Generated paper card for routes that are not Nuxt Content entries. */ +export function usePaperOgImage( + share: ShareMetaInput, + paper?: { title?: MaybeRefOrGetter }, +): void { + const title = computed(() => cardTitle( + paper?.title != null ? toValue(paper.title) : toValue(share.title), + )) + + defineOgImage('Paper', { + title: () => title.value, + description: () => { + const raw = share.description == null ? undefined : toValue(share.description) + return (typeof raw === 'string' ? raw.trim() : '') || SITE_DESCRIPTION + }, + words: 0, + }, { + alt: () => title.value, + }) + + useShareMeta({ + ...share, + image: false, + }) +} + +interface ContentPage { + path: string + title?: string | null + description?: string | null + cover?: string | null + ogImage?: boolean | { url?: string, component?: string, props?: Record } | null + evergreen?: boolean | null + kind?: string | null + created?: string | null + date?: string | null + updated?: string | null + last_modified?: string | null + words?: number | null +} + +/** Cover precedence + generated paper card for a Nuxt Content entry. */ +export function useContentOgImage( + page: MaybeRefOrGetter, + collection: string, + share: Omit, +): void { + const files = useRuntimeConfig().public.publicFiles + const override = computed(() => contentOgOverride(toValue(page), collection, files)) + const current = computed(() => toValue(page)) + + if (override.value === undefined) { + defineOgImage(ogComponentName(current.value), { + title: () => paperFields(current.value).title, + description: () => paperFields(current.value, SITE_DESCRIPTION).description, + evergreen: () => paperFields(current.value).evergreen, + created: () => paperFields(current.value).created, + updated: () => paperFields(current.value).updated, + words: () => paperFields(current.value).words, + ...ogExtraProps(current.value), + }, { + alt: () => paperFields(current.value).title, + }) + } + + useShareMeta({ + ...share, + image: () => override.value === undefined ? false : override.value, + }) +} + +/** Index/list routes under a collection (e.g. changelog) without a content file. */ +export function useCollectionIndexOgImage( + source: { collection: string, path: string }, + share: ShareMetaInput, +): void { + const files = useRuntimeConfig().public.publicFiles + const override = computed(() => explicitContentCover(source, path => hasShareFile(files, path))) + + if (!override.value) { + defineOgImage('Paper', { + title: () => cardTitle(toValue(share.title)), + description: () => { + const raw = share.description == null ? undefined : toValue(share.description) + return (typeof raw === 'string' ? raw.trim() : '') || SITE_DESCRIPTION + }, + words: 0, + }, { + alt: () => cardTitle(toValue(share.title)), + }) + } + + useShareMeta({ + ...share, + image: () => override.value ?? false, + }) +} diff --git a/docs/app/composables/useShareMeta.ts b/docs/app/composables/useShareMeta.ts new file mode 100644 index 0000000..883b2bf --- /dev/null +++ b/docs/app/composables/useShareMeta.ts @@ -0,0 +1,72 @@ +import type { MaybeRefOrGetter } from 'vue' +import { absoluteImageUrl, canonicalUrl, OG_IMAGE_HEIGHT, OG_IMAGE_PATH, OG_IMAGE_WIDTH, shareTitle, SITE_NAME } from '~/utils/site' + +export interface ShareMetaInput { + title?: MaybeRefOrGetter + description?: MaybeRefOrGetter + type?: MaybeRefOrGetter<'website' | 'article' | undefined> + /** + * Share image path or https URL. + * `false` when defineOgImage owns `og:image`. + * Omitted routes use `/og.png`. + */ + image?: MaybeRefOrGetter +} + +function filled(value: string | undefined, fallback: string): string { + const text = value?.trim() + return text || fallback +} + +/** Document title plus Open Graph / Twitter tags for the current route. */ +export function useShareMeta(input: ShareMetaInput = {}): void { + const route = useRoute() + + const title = computed(() => shareTitle(input.title == null ? undefined : toValue(input.title))) + const description = computed(() => { + const value = input.description == null ? undefined : toValue(input.description) + return filled(value, SITE_DESCRIPTION) + }) + const type = computed(() => toValue(input.type) ?? 'website') + const url = computed(() => canonicalUrl(route.path)) + const skipImage = toValue(input.image) === false + const image = computed(() => { + const value = toValue(input.image) + if (value === false || !value) + return absoluteImageUrl(OG_IMAGE_PATH) + return absoluteImageUrl(value) + }) + + useHead({ + title: () => input.title == null ? undefined : toValue(input.title) || undefined, + }) + + useSeoMeta({ + description: () => description.value, + ogTitle: () => title.value, + ogDescription: () => description.value, + ogUrl: () => url.value, + ogType: () => type.value, + ogSiteName: SITE_NAME, + twitterCard: 'summary_large_image', + twitterTitle: () => title.value, + twitterDescription: () => description.value, + }) + + if (!skipImage) { + useSeoMeta({ + ogImage: () => image.value, + ogImageSecureUrl: () => image.value, + ogImageType: 'image/png', + ogImageWidth: OG_IMAGE_WIDTH, + ogImageHeight: OG_IMAGE_HEIGHT, + ogImageAlt: () => title.value, + twitterImage: () => image.value, + twitterImageAlt: () => title.value, + }) + } + + useHead({ + link: [{ rel: 'canonical', href: () => url.value }], + }) +} diff --git a/vendor/ui/docs/app/composables/useSiteLink.ts b/docs/app/composables/useSiteLink.ts similarity index 100% rename from vendor/ui/docs/app/composables/useSiteLink.ts rename to docs/app/composables/useSiteLink.ts diff --git a/vendor/ui/docs/app/composables/useTheme.ts b/docs/app/composables/useTheme.ts similarity index 100% rename from vendor/ui/docs/app/composables/useTheme.ts rename to docs/app/composables/useTheme.ts diff --git a/vendor/ui/docs/app/error.vue b/docs/app/error.vue similarity index 80% rename from vendor/ui/docs/app/error.vue rename to docs/app/error.vue index 127a015..cb4e7f4 100644 --- a/vendor/ui/docs/app/error.vue +++ b/docs/app/error.vue @@ -1,12 +1,15 @@