@maestro-js/agent-skills 1.0.0-alpha.2 → 1.0.0-alpha.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (691) hide show
  1. package/dist/bin.js +19 -0
  2. package/package.json +8 -7
  3. package/{dist → skills}/choosing-an-npm-package/SKILL.md +5 -4
  4. package/skills/iconify/SKILL.md +82 -0
  5. package/skills/iconify/scripts/iconify.js +111 -0
  6. package/skills/iso-fns/SKILL.md +137 -0
  7. package/skills/iso-fns/references/api_reference.md +435 -0
  8. package/skills/maestro-architecture/SKILL.md +552 -0
  9. package/skills/maestro-examples/SKILL.md +140 -0
  10. package/skills/maestro-examples/references/cadence/cadence-web/.auth/user.json +15 -0
  11. package/skills/maestro-examples/references/cadence/cadence-web/app/app.css +112 -0
  12. package/skills/maestro-examples/references/cadence/cadence-web/app/components/auth-layout.tsx +39 -0
  13. package/skills/maestro-examples/references/cadence/cadence-web/app/components/back-link.tsx +24 -0
  14. package/skills/maestro-examples/references/cadence/cadence-web/app/components/button-group.tsx +78 -0
  15. package/skills/maestro-examples/references/cadence/cadence-web/app/components/button-link.tsx +77 -0
  16. package/skills/maestro-examples/references/cadence/cadence-web/app/components/button.tsx +139 -0
  17. package/skills/maestro-examples/references/cadence/cadence-web/app/components/checkbox.tsx +210 -0
  18. package/skills/maestro-examples/references/cadence/cadence-web/app/components/chip.tsx +161 -0
  19. package/skills/maestro-examples/references/cadence/cadence-web/app/components/container.tsx +85 -0
  20. package/skills/maestro-examples/references/cadence/cadence-web/app/components/date-range.tsx +141 -0
  21. package/skills/maestro-examples/references/cadence/cadence-web/app/components/date-time-picker.tsx +199 -0
  22. package/skills/maestro-examples/references/cadence/cadence-web/app/components/empty-state.tsx +19 -0
  23. package/skills/maestro-examples/references/cadence/cadence-web/app/components/form-page.tsx +41 -0
  24. package/skills/maestro-examples/references/cadence/cadence-web/app/components/form.tsx +106 -0
  25. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/animated-popover.tsx +27 -0
  26. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/button-context.ts +13 -0
  27. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/calendar-month-year-picker.tsx +283 -0
  28. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/form-field.tsx +231 -0
  29. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/get-button-classes.ts +141 -0
  30. package/skills/maestro-examples/references/cadence/cadence-web/app/components/helpers/headless-button.tsx +39 -0
  31. package/skills/maestro-examples/references/cadence/cadence-web/app/components/icon.tsx +29 -0
  32. package/skills/maestro-examples/references/cadence/cadence-web/app/components/inline-alert.tsx +57 -0
  33. package/skills/maestro-examples/references/cadence/cadence-web/app/components/interaction-form.tsx +87 -0
  34. package/skills/maestro-examples/references/cadence/cadence-web/app/components/menu.tsx +189 -0
  35. package/skills/maestro-examples/references/cadence/cadence-web/app/components/optional-link.tsx +18 -0
  36. package/skills/maestro-examples/references/cadence/cadence-web/app/components/page-header.tsx +19 -0
  37. package/skills/maestro-examples/references/cadence/cadence-web/app/components/rich-text-editor.tsx +352 -0
  38. package/skills/maestro-examples/references/cadence/cadence-web/app/components/select.tsx +219 -0
  39. package/skills/maestro-examples/references/cadence/cadence-web/app/components/spinner.tsx +19 -0
  40. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/headless-templated-row-table.ts +553 -0
  41. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/index.tsx +44 -0
  42. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/server-table.ts +146 -0
  43. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-actions.tsx +79 -0
  44. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-container.tsx +176 -0
  45. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-container.type-test.ts +158 -0
  46. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-filters/date-range-filter.tsx +230 -0
  47. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-filters/select-filter.tsx +214 -0
  48. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-filters/sort.tsx +88 -0
  49. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-primitives.tsx +229 -0
  50. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-toolbar.tsx +303 -0
  51. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/table-types.ts +64 -0
  52. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/use-client-table.ts +160 -0
  53. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/use-client-table.type-test.ts +220 -0
  54. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/use-server-table.ts +195 -0
  55. package/skills/maestro-examples/references/cadence/cadence-web/app/components/table/use-server-table.type-test.ts +177 -0
  56. package/skills/maestro-examples/references/cadence/cadence-web/app/components/tag-editor.tsx +53 -0
  57. package/skills/maestro-examples/references/cadence/cadence-web/app/components/tag-field.tsx +253 -0
  58. package/skills/maestro-examples/references/cadence/cadence-web/app/components/text-field.tsx +147 -0
  59. package/skills/maestro-examples/references/cadence/cadence-web/app/components/toast.tsx +182 -0
  60. package/skills/maestro-examples/references/cadence/cadence-web/app/components/top-nav.tsx +175 -0
  61. package/skills/maestro-examples/references/cadence/cadence-web/app/entry.client.tsx +21 -0
  62. package/skills/maestro-examples/references/cadence/cadence-web/app/entry.server.tsx +13 -0
  63. package/skills/maestro-examples/references/cadence/cadence-web/app/features/csrf-middleware.server.ts +17 -0
  64. package/skills/maestro-examples/references/cadence/cadence-web/app/features/custom-error-status-code-middleware.server.ts +31 -0
  65. package/skills/maestro-examples/references/cadence/cadence-web/app/features/rate-limiting-middleware.server.ts +36 -0
  66. package/skills/maestro-examples/references/cadence/cadence-web/app/features/redirect-with-toast.server.ts +14 -0
  67. package/skills/maestro-examples/references/cadence/cadence-web/app/features/request-context.server.ts +40 -0
  68. package/skills/maestro-examples/references/cadence/cadence-web/app/features/security-headers-middleware.server.ts +10 -0
  69. package/skills/maestro-examples/references/cadence/cadence-web/app/icons/types.ts +36 -0
  70. package/skills/maestro-examples/references/cadence/cadence-web/app/root.tsx +208 -0
  71. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/_index.tsx +5 -0
  72. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/activity.tsx +124 -0
  73. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/archive.tsx +187 -0
  74. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.forgot-password.tsx +108 -0
  75. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.login.tsx +132 -0
  76. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.logout.tsx +17 -0
  77. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.register.tsx +172 -0
  78. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/auth.reset-password.tsx +137 -0
  79. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/contacts.$id.edit.tsx +89 -0
  80. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/contacts.$id.tsx +521 -0
  81. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/contacts.new.tsx +56 -0
  82. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/contacts.tsx +183 -0
  83. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/settings.tsx +158 -0
  84. package/skills/maestro-examples/references/cadence/cadence-web/app/routes/users.tsx +263 -0
  85. package/skills/maestro-examples/references/cadence/cadence-web/app/routes.ts +4 -0
  86. package/skills/maestro-examples/references/cadence/cadence-web/app/services.server.ts +1 -0
  87. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/colors.ts +47 -0
  88. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/compose-event-handlers.ts +13 -0
  89. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/compose-refs.ts +35 -0
  90. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/format-date.ts +10 -0
  91. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/overridable-component-helper.ts +31 -0
  92. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/sanitize-html.ts +16 -0
  93. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/tw.ts +16 -0
  94. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-hydrated.ts +12 -0
  95. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-prevent-default.ts +30 -0
  96. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-query-state.ts +629 -0
  97. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-render-props.ts +42 -0
  98. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-spin-delay.ts +27 -0
  99. package/skills/maestro-examples/references/cadence/cadence-web/app/utils/use-stable-accessor.ts +14 -0
  100. package/skills/maestro-examples/references/cadence/cadence-web/instrument.server.mjs +29 -0
  101. package/skills/maestro-examples/references/cadence/cadence-web/package.json +60 -0
  102. package/skills/maestro-examples/references/cadence/cadence-web/playwright.config.ts +39 -0
  103. package/skills/maestro-examples/references/cadence/cadence-web/react-router.config.ts +12 -0
  104. package/skills/maestro-examples/references/cadence/cadence-web/tailwind.config.ts +7 -0
  105. package/skills/maestro-examples/references/cadence/cadence-web/tests/activity/filter-activity.spec.ts +93 -0
  106. package/skills/maestro-examples/references/cadence/cadence-web/tests/activity/recent-activity.spec.ts +70 -0
  107. package/skills/maestro-examples/references/cadence/cadence-web/tests/archive/archive-view.spec.ts +62 -0
  108. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/login-invalid.spec.ts +68 -0
  109. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/login-valid.spec.ts +45 -0
  110. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/logout.spec.ts +46 -0
  111. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/password-reset.spec.ts +105 -0
  112. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth/register.spec.ts +39 -0
  113. package/skills/maestro-examples/references/cadence/cadence-web/tests/auth.setup.ts +48 -0
  114. package/skills/maestro-examples/references/cadence/cadence-web/tests/authorization/member-ownership.spec.ts +104 -0
  115. package/skills/maestro-examples/references/cadence/cadence-web/tests/authorization/viewer-read-only.spec.ts +103 -0
  116. package/skills/maestro-examples/references/cadence/cadence-web/tests/constants.ts +11 -0
  117. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/archive-restore.spec.ts +77 -0
  118. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/create-contact.spec.ts +56 -0
  119. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/delete-contact.spec.ts +53 -0
  120. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/edit-contact.spec.ts +60 -0
  121. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/filter-by-last-contacted.spec.ts +85 -0
  122. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/filter-by-tag.spec.ts +68 -0
  123. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/global-search.spec.ts +57 -0
  124. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/sort-contacts.spec.ts +60 -0
  125. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/tags.spec.ts +85 -0
  126. package/skills/maestro-examples/references/cadence/cadence-web/tests/contacts/view-detail.spec.ts +58 -0
  127. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/delete-interaction.spec.ts +59 -0
  128. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/edit-interaction.spec.ts +68 -0
  129. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/log-email.spec.ts +57 -0
  130. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/log-note.spec.ts +56 -0
  131. package/skills/maestro-examples/references/cadence/cadence-web/tests/interactions/rich-text-formatting.spec.ts +97 -0
  132. package/skills/maestro-examples/references/cadence/cadence-web/tests/organization/delete.spec.ts +70 -0
  133. package/skills/maestro-examples/references/cadence/cadence-web/tests/organization/edit-name.spec.ts +51 -0
  134. package/skills/maestro-examples/references/cadence/cadence-web/tests/users/change-role.spec.ts +62 -0
  135. package/skills/maestro-examples/references/cadence/cadence-web/tests/users/invite-user.spec.ts +56 -0
  136. package/skills/maestro-examples/references/cadence/cadence-web/tests/users/remove-user.spec.ts +58 -0
  137. package/skills/maestro-examples/references/cadence/cadence-web/tsconfig.json +22 -0
  138. package/skills/maestro-examples/references/cadence/cadence-web/vite.config.ts +37 -0
  139. package/skills/maestro-examples/references/cadence/config/agent-container.ts +4 -0
  140. package/skills/maestro-examples/references/cadence/config/cadence-web.ts +12 -0
  141. package/skills/maestro-examples/references/cadence/config/db-migrate.ts +9 -0
  142. package/skills/maestro-examples/references/cadence/config/queue-processor.ts +11 -0
  143. package/skills/maestro-examples/references/cadence/config/services.ts +16 -0
  144. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000001_organizations-and-users.ts +16 -0
  145. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000002_contacts.ts +16 -0
  146. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000003_interactions.ts +16 -0
  147. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000004_remember-me-tokens.ts +16 -0
  148. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000005_password-reset-tokens.ts +16 -0
  149. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/20260404000006_queue-and-recurring-jobs.ts +16 -0
  150. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000001_organizations-and-users-down.sql +2 -0
  151. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000001_organizations-and-users-up.sql +24 -0
  152. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000002_contacts-down.sql +1 -0
  153. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000002_contacts-up.sql +16 -0
  154. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000003_interactions-down.sql +1 -0
  155. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000003_interactions-up.sql +15 -0
  156. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000004_remember-me-tokens-down.sql +1 -0
  157. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000004_remember-me-tokens-up.sql +12 -0
  158. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000005_password-reset-tokens-down.sql +1 -0
  159. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000005_password-reset-tokens-up.sql +11 -0
  160. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000006_queue-and-recurring-jobs-down.sql +2 -0
  161. package/skills/maestro-examples/references/cadence/infrastructure/db-migrations/sqls/20260404000006_queue-and-recurring-jobs-up.sql +21 -0
  162. package/skills/maestro-examples/references/cadence/package.json +17 -0
  163. package/skills/maestro-examples/references/cadence/packages/schemas/package.json +17 -0
  164. package/skills/maestro-examples/references/cadence/packages/schemas/src/contact/index.ts +57 -0
  165. package/skills/maestro-examples/references/cadence/packages/schemas/src/index.ts +4 -0
  166. package/skills/maestro-examples/references/cadence/packages/schemas/src/interaction/index.ts +45 -0
  167. package/skills/maestro-examples/references/cadence/packages/schemas/src/organization/index.ts +32 -0
  168. package/skills/maestro-examples/references/cadence/packages/schemas/src/user/index.ts +69 -0
  169. package/skills/maestro-examples/references/cadence/packages/schemas/tsconfig.json +9 -0
  170. package/skills/maestro-examples/references/cadence/packages/services/package.json +43 -0
  171. package/skills/maestro-examples/references/cadence/packages/services/run-tests.ts +59 -0
  172. package/skills/maestro-examples/references/cadence/packages/services/src/auth/auth-db-provider.ts +202 -0
  173. package/skills/maestro-examples/references/cadence/packages/services/src/auth/auth-use-cases.ts +155 -0
  174. package/skills/maestro-examples/references/cadence/packages/services/src/auth/index.ts +17 -0
  175. package/skills/maestro-examples/references/cadence/packages/services/src/auth/profile-db-provider.ts +17 -0
  176. package/skills/maestro-examples/references/cadence/packages/services/src/contact/contact-db-provider.test.ts +120 -0
  177. package/skills/maestro-examples/references/cadence/packages/services/src/contact/contact-db-provider.ts +145 -0
  178. package/skills/maestro-examples/references/cadence/packages/services/src/contact/contact-use-cases.ts +196 -0
  179. package/skills/maestro-examples/references/cadence/packages/services/src/contact/index.ts +29 -0
  180. package/skills/maestro-examples/references/cadence/packages/services/src/index.ts +23 -0
  181. package/skills/maestro-examples/references/cadence/packages/services/src/interaction/index.ts +25 -0
  182. package/skills/maestro-examples/references/cadence/packages/services/src/interaction/interaction-db-provider.test.ts +128 -0
  183. package/skills/maestro-examples/references/cadence/packages/services/src/interaction/interaction-db-provider.ts +98 -0
  184. package/skills/maestro-examples/references/cadence/packages/services/src/interaction/interaction-use-cases.ts +171 -0
  185. package/skills/maestro-examples/references/cadence/packages/services/src/maestro.ts +218 -0
  186. package/skills/maestro-examples/references/cadence/packages/services/src/organization/index.ts +8 -0
  187. package/skills/maestro-examples/references/cadence/packages/services/src/organization/organization-db-provider.test.ts +53 -0
  188. package/skills/maestro-examples/references/cadence/packages/services/src/organization/organization-db-provider.ts +60 -0
  189. package/skills/maestro-examples/references/cadence/packages/services/src/organization/organization-use-cases.ts +88 -0
  190. package/skills/maestro-examples/references/cadence/packages/services/src/permissions.ts +28 -0
  191. package/skills/maestro-examples/references/cadence/packages/services/src/testing/contact-seed.ts +30 -0
  192. package/skills/maestro-examples/references/cadence/packages/services/src/testing/index.ts +13 -0
  193. package/skills/maestro-examples/references/cadence/packages/services/src/testing/interaction-seed.ts +29 -0
  194. package/skills/maestro-examples/references/cadence/packages/services/src/testing/organization-seed.ts +25 -0
  195. package/skills/maestro-examples/references/cadence/packages/services/src/testing/seed-pipe.ts +38 -0
  196. package/skills/maestro-examples/references/cadence/packages/services/src/testing/user-seed.ts +27 -0
  197. package/skills/maestro-examples/references/cadence/packages/services/src/user/index.ts +27 -0
  198. package/skills/maestro-examples/references/cadence/packages/services/src/user/user-db-provider.test.ts +100 -0
  199. package/skills/maestro-examples/references/cadence/packages/services/src/user/user-db-provider.ts +69 -0
  200. package/skills/maestro-examples/references/cadence/packages/services/src/user/user-use-cases.ts +162 -0
  201. package/skills/maestro-examples/references/cadence/packages/services/tsconfig.json +9 -0
  202. package/skills/maestro-examples/references/cadence/scripts/foreign-key-delete-behavior.ts +106 -0
  203. package/skills/maestro-examples/references/cadence/specs/app.md +72 -0
  204. package/skills/maestro-examples/references/cadence/specs/data-models.md +80 -0
  205. package/skills/maestro-examples/references/cadence/specs/multi-tenant-security.md +239 -0
  206. package/skills/maestro-examples/references/cadence/specs/rich-text-editor.md +108 -0
  207. package/skills/maestro-examples/references/cadence/specs/table.md +151 -0
  208. package/skills/maestro-examples/references/cadence/specs/use-cases.md +62 -0
  209. package/skills/maestro-examples/references/cadence/tsconfig.json +29 -0
  210. package/skills/maestro-examples/references/chorus/chorus-web/app/app.css +152 -0
  211. package/skills/maestro-examples/references/chorus/chorus-web/app/components/alert-dialog.tsx +153 -0
  212. package/skills/maestro-examples/references/chorus/chorus-web/app/components/avatar.tsx +57 -0
  213. package/skills/maestro-examples/references/chorus/chorus-web/app/components/button-group.tsx +78 -0
  214. package/skills/maestro-examples/references/chorus/chorus-web/app/components/button-link.tsx +77 -0
  215. package/skills/maestro-examples/references/chorus/chorus-web/app/components/button.tsx +139 -0
  216. package/skills/maestro-examples/references/chorus/chorus-web/app/components/channel-card.tsx +40 -0
  217. package/skills/maestro-examples/references/chorus/chorus-web/app/components/checkbox-group.tsx +175 -0
  218. package/skills/maestro-examples/references/chorus/chorus-web/app/components/checkbox.tsx +210 -0
  219. package/skills/maestro-examples/references/chorus/chorus-web/app/components/chip.tsx +161 -0
  220. package/skills/maestro-examples/references/chorus/chorus-web/app/components/container.tsx +85 -0
  221. package/skills/maestro-examples/references/chorus/chorus-web/app/components/date-picker.tsx +214 -0
  222. package/skills/maestro-examples/references/chorus/chorus-web/app/components/date-time-picker.tsx +199 -0
  223. package/skills/maestro-examples/references/chorus/chorus-web/app/components/dialog.tsx +114 -0
  224. package/skills/maestro-examples/references/chorus/chorus-web/app/components/enum-chip.tsx +33 -0
  225. package/skills/maestro-examples/references/chorus/chorus-web/app/components/file-input.tsx +248 -0
  226. package/skills/maestro-examples/references/chorus/chorus-web/app/components/form.tsx +106 -0
  227. package/skills/maestro-examples/references/chorus/chorus-web/app/components/headless-file-input.tsx +365 -0
  228. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/animated-popover.tsx +27 -0
  229. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/button-context.ts +13 -0
  230. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/calendar-month-year-picker.tsx +283 -0
  231. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/form-field.tsx +231 -0
  232. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/get-button-classes.ts +141 -0
  233. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/headless-button.tsx +39 -0
  234. package/skills/maestro-examples/references/chorus/chorus-web/app/components/helpers/pdf-dist.client.ts +9 -0
  235. package/skills/maestro-examples/references/chorus/chorus-web/app/components/icon.tsx +29 -0
  236. package/skills/maestro-examples/references/chorus/chorus-web/app/components/image-grid.tsx +96 -0
  237. package/skills/maestro-examples/references/chorus/chorus-web/app/components/image-input.tsx +268 -0
  238. package/skills/maestro-examples/references/chorus/chorus-web/app/components/inline-alert.tsx +57 -0
  239. package/skills/maestro-examples/references/chorus/chorus-web/app/components/like-button.tsx +48 -0
  240. package/skills/maestro-examples/references/chorus/chorus-web/app/components/menu.tsx +189 -0
  241. package/skills/maestro-examples/references/chorus/chorus-web/app/components/pdf-input.tsx +252 -0
  242. package/skills/maestro-examples/references/chorus/chorus-web/app/components/pdf.tsx +89 -0
  243. package/skills/maestro-examples/references/chorus/chorus-web/app/components/post-card.tsx +147 -0
  244. package/skills/maestro-examples/references/chorus/chorus-web/app/components/post-composer.tsx +166 -0
  245. package/skills/maestro-examples/references/chorus/chorus-web/app/components/radio-group.tsx +115 -0
  246. package/skills/maestro-examples/references/chorus/chorus-web/app/components/select.tsx +219 -0
  247. package/skills/maestro-examples/references/chorus/chorus-web/app/components/spinner.tsx +19 -0
  248. package/skills/maestro-examples/references/chorus/chorus-web/app/components/tag-field.tsx +253 -0
  249. package/skills/maestro-examples/references/chorus/chorus-web/app/components/text-area.tsx +151 -0
  250. package/skills/maestro-examples/references/chorus/chorus-web/app/components/text-field.tsx +147 -0
  251. package/skills/maestro-examples/references/chorus/chorus-web/app/components/toast.tsx +179 -0
  252. package/skills/maestro-examples/references/chorus/chorus-web/app/entry.client.tsx +21 -0
  253. package/skills/maestro-examples/references/chorus/chorus-web/app/entry.server.tsx +12 -0
  254. package/skills/maestro-examples/references/chorus/chorus-web/app/features/csrf-hidden-input.tsx +6 -0
  255. package/skills/maestro-examples/references/chorus/chorus-web/app/features/csrf-middleware.server.ts +17 -0
  256. package/skills/maestro-examples/references/chorus/chorus-web/app/features/custom-error-status-code-middleware.server.ts +18 -0
  257. package/skills/maestro-examples/references/chorus/chorus-web/app/features/rate-limiting-middleware.server.ts +36 -0
  258. package/skills/maestro-examples/references/chorus/chorus-web/app/features/redirect-with-toast.server.ts +14 -0
  259. package/skills/maestro-examples/references/chorus/chorus-web/app/features/request-context.server.ts +40 -0
  260. package/skills/maestro-examples/references/chorus/chorus-web/app/features/security-headers-middleware.server.ts +10 -0
  261. package/skills/maestro-examples/references/chorus/chorus-web/app/icons/types.ts +26 -0
  262. package/skills/maestro-examples/references/chorus/chorus-web/app/root.tsx +164 -0
  263. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/forgot-password.tsx +90 -0
  264. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/login.tsx +104 -0
  265. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/logout.tsx +44 -0
  266. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/reset-password.tsx +130 -0
  267. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_auth/signup.tsx +91 -0
  268. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_browse/_layout.tsx +36 -0
  269. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_browse/c.new.tsx +47 -0
  270. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/_browse/index.tsx +3 -0
  271. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/api/hide-post.$postId.tsx +30 -0
  272. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/api/like.$postId.tsx +22 -0
  273. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug/_layout.tsx +108 -0
  274. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug/post.new.tsx +59 -0
  275. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.edit.tsx +53 -0
  276. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.manage/_layout.tsx +123 -0
  277. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.manage/add-moderator.tsx +48 -0
  278. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.manage/transfer-ownership.tsx +71 -0
  279. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/c.$slug.post.$postId.tsx +119 -0
  280. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/files.$.tsx +22 -0
  281. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/health.tsx +3 -0
  282. package/skills/maestro-examples/references/chorus/chorus-web/app/routes/settings.tsx +128 -0
  283. package/skills/maestro-examples/references/chorus/chorus-web/app/routes.ts +4 -0
  284. package/skills/maestro-examples/references/chorus/chorus-web/app/services.server.ts +1 -0
  285. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/colors.ts +47 -0
  286. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/compose-refs.ts +35 -0
  287. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/enum-colors.ts +4 -0
  288. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/file-input.ts +52 -0
  289. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/tw.ts +16 -0
  290. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-element-size.ts +35 -0
  291. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-number-input.ts +143 -0
  292. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-pagination.ts +41 -0
  293. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-prevent-default.ts +30 -0
  294. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-profile.ts +7 -0
  295. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-render-props.ts +42 -0
  296. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-spin-delay.ts +27 -0
  297. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-stable-accessor.ts +14 -0
  298. package/skills/maestro-examples/references/chorus/chorus-web/app/utils/use-tab-indicator.ts +107 -0
  299. package/skills/maestro-examples/references/chorus/chorus-web/environment.d.ts +15 -0
  300. package/skills/maestro-examples/references/chorus/chorus-web/instrument.server.mjs +29 -0
  301. package/skills/maestro-examples/references/chorus/chorus-web/package.json +54 -0
  302. package/skills/maestro-examples/references/chorus/chorus-web/playwright.config.ts +39 -0
  303. package/skills/maestro-examples/references/chorus/chorus-web/react-router.config.ts +12 -0
  304. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth-landing.test.ts +8 -0
  305. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth-login.test.ts +40 -0
  306. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth-logout.test.ts +8 -0
  307. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth-signup.test.ts +15 -0
  308. package/skills/maestro-examples/references/chorus/chorus-web/tests/auth.setup.ts +42 -0
  309. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-browse.test.ts +43 -0
  310. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-create.test.ts +34 -0
  311. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-edit.test.ts +33 -0
  312. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-manage-moderators.test.ts +59 -0
  313. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-manage-permissions.test.ts +55 -0
  314. package/skills/maestro-examples/references/chorus/chorus-web/tests/channel-transfer.test.ts +47 -0
  315. package/skills/maestro-examples/references/chorus/chorus-web/tests/constants.ts +7 -0
  316. package/skills/maestro-examples/references/chorus/chorus-web/tests/forgot-password.test.ts +33 -0
  317. package/skills/maestro-examples/references/chorus/chorus-web/tests/hide-post-author.test.ts +62 -0
  318. package/skills/maestro-examples/references/chorus/chorus-web/tests/hide-post-nonauthor.test.ts +36 -0
  319. package/skills/maestro-examples/references/chorus/chorus-web/tests/like-toggle.test.ts +60 -0
  320. package/skills/maestro-examples/references/chorus/chorus-web/tests/like-unauth.test.ts +37 -0
  321. package/skills/maestro-examples/references/chorus/chorus-web/tests/post-create.test.ts +30 -0
  322. package/skills/maestro-examples/references/chorus/chorus-web/tests/post-listing.test.ts +33 -0
  323. package/skills/maestro-examples/references/chorus/chorus-web/tests/post-reply.test.ts +48 -0
  324. package/skills/maestro-examples/references/chorus/chorus-web/tests/post-view-unauth.test.ts +37 -0
  325. package/skills/maestro-examples/references/chorus/chorus-web/tests/settings-duplicate.test.ts +28 -0
  326. package/skills/maestro-examples/references/chorus/chorus-web/tests/settings-update.test.ts +34 -0
  327. package/skills/maestro-examples/references/chorus/chorus-web/tests/settings-view.test.ts +17 -0
  328. package/skills/maestro-examples/references/chorus/chorus-web/tests/signup-validation.test.ts +51 -0
  329. package/skills/maestro-examples/references/chorus/chorus-web/tsconfig.json +14 -0
  330. package/skills/maestro-examples/references/chorus/chorus-web/vite.config.ts +38 -0
  331. package/skills/maestro-examples/references/chorus/config/app-a.ts +7 -0
  332. package/skills/maestro-examples/references/chorus/config/chorus-web.ts +7 -0
  333. package/skills/maestro-examples/references/chorus/config/db-migrate.ts +9 -0
  334. package/skills/maestro-examples/references/chorus/config/queue-processor.ts +7 -0
  335. package/skills/maestro-examples/references/chorus/config/services.ts +15 -0
  336. package/skills/maestro-examples/references/chorus/infrastructure/cdk/index.ts +60 -0
  337. package/skills/maestro-examples/references/chorus/infrastructure/cdk.context.json +5 -0
  338. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260303005902_init_authentication.ts +16 -0
  339. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260308234835_add-maestro-queue-table.ts +16 -0
  340. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315051819_channels.ts +16 -0
  341. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052202_channel-moderators.ts +16 -0
  342. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052539_posts.ts +16 -0
  343. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315052734_post-images.ts +16 -0
  344. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/20260315053110_likes.ts +16 -0
  345. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260303005902_init_authentication-down.sql +3 -0
  346. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260303005902_init_authentication-up.sql +40 -0
  347. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260308234835_add-maestro-queue-table-down.sql +3 -0
  348. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260308234835_add-maestro-queue-table-up.sql +23 -0
  349. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315051819_channels-down.sql +1 -0
  350. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315051819_channels-up.sql +11 -0
  351. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052202_channel-moderators-down.sql +1 -0
  352. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052202_channel-moderators-up.sql +7 -0
  353. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052539_posts-down.sql +1 -0
  354. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052539_posts-up.sql +14 -0
  355. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052734_post-images-down.sql +1 -0
  356. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315052734_post-images-up.sql +7 -0
  357. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315053110_likes-down.sql +1 -0
  358. package/skills/maestro-examples/references/chorus/infrastructure/db-migrations/sqls/20260315053110_likes-up.sql +8 -0
  359. package/skills/maestro-examples/references/chorus/infrastructure/package.json +20 -0
  360. package/skills/maestro-examples/references/chorus/infrastructure/tsconfig.json +8 -0
  361. package/skills/maestro-examples/references/chorus/package.json +17 -0
  362. package/skills/maestro-examples/references/chorus/packages/email-templates/other/generate-email-modules.ts +22 -0
  363. package/skills/maestro-examples/references/chorus/packages/email-templates/other/generate-email-previews.ts +18 -0
  364. package/skills/maestro-examples/references/chorus/packages/email-templates/package.json +27 -0
  365. package/skills/maestro-examples/references/chorus/packages/email-templates/src/components/button.tsx +19 -0
  366. package/skills/maestro-examples/references/chorus/packages/email-templates/src/components/root-container.tsx +29 -0
  367. package/skills/maestro-examples/references/chorus/packages/email-templates/src/components/tailwind-wrapper.tsx +113 -0
  368. package/skills/maestro-examples/references/chorus/packages/email-templates/src/email-modules.ts +9 -0
  369. package/skills/maestro-examples/references/chorus/packages/email-templates/src/emails/password-reset.tsx +41 -0
  370. package/skills/maestro-examples/references/chorus/packages/email-templates/src/index.ts +3 -0
  371. package/skills/maestro-examples/references/chorus/packages/email-templates/src/render-email-template.ts +24 -0
  372. package/skills/maestro-examples/references/chorus/packages/email-templates/src/utils/tw.ts +5 -0
  373. package/skills/maestro-examples/references/chorus/packages/email-templates/tsconfig.json +11 -0
  374. package/skills/maestro-examples/references/chorus/packages/schemas/package.json +17 -0
  375. package/skills/maestro-examples/references/chorus/packages/schemas/src/channel/index.ts +41 -0
  376. package/skills/maestro-examples/references/chorus/packages/schemas/src/index.ts +4 -0
  377. package/skills/maestro-examples/references/chorus/packages/schemas/src/like/index.ts +16 -0
  378. package/skills/maestro-examples/references/chorus/packages/schemas/src/post/index.ts +44 -0
  379. package/skills/maestro-examples/references/chorus/packages/schemas/src/profile/index.ts +80 -0
  380. package/skills/maestro-examples/references/chorus/packages/schemas/tsconfig.json +9 -0
  381. package/skills/maestro-examples/references/chorus/packages/services/environment.d.ts +7 -0
  382. package/skills/maestro-examples/references/chorus/packages/services/package.json +47 -0
  383. package/skills/maestro-examples/references/chorus/packages/services/run-tests.ts +59 -0
  384. package/skills/maestro-examples/references/chorus/packages/services/src/auth/auth-use-cases.ts +178 -0
  385. package/skills/maestro-examples/references/chorus/packages/services/src/auth/authenticatable-db-provider.ts +59 -0
  386. package/skills/maestro-examples/references/chorus/packages/services/src/auth/index.ts +29 -0
  387. package/skills/maestro-examples/references/chorus/packages/services/src/auth/password-reset-token-db-provider.ts +58 -0
  388. package/skills/maestro-examples/references/chorus/packages/services/src/auth/remember-me-token-db-provider.ts +82 -0
  389. package/skills/maestro-examples/references/chorus/packages/services/src/channel/channel-db-provider.test.ts +85 -0
  390. package/skills/maestro-examples/references/chorus/packages/services/src/channel/channel-db-provider.ts +158 -0
  391. package/skills/maestro-examples/references/chorus/packages/services/src/channel/channel-use-cases.ts +303 -0
  392. package/skills/maestro-examples/references/chorus/packages/services/src/channel/index.ts +29 -0
  393. package/skills/maestro-examples/references/chorus/packages/services/src/index.ts +21 -0
  394. package/skills/maestro-examples/references/chorus/packages/services/src/like/index.ts +6 -0
  395. package/skills/maestro-examples/references/chorus/packages/services/src/like/like-db-provider.test.ts +47 -0
  396. package/skills/maestro-examples/references/chorus/packages/services/src/like/like-db-provider.ts +53 -0
  397. package/skills/maestro-examples/references/chorus/packages/services/src/like/like-use-cases.ts +31 -0
  398. package/skills/maestro-examples/references/chorus/packages/services/src/maestro.ts +215 -0
  399. package/skills/maestro-examples/references/chorus/packages/services/src/permissions.ts +16 -0
  400. package/skills/maestro-examples/references/chorus/packages/services/src/post/index.ts +25 -0
  401. package/skills/maestro-examples/references/chorus/packages/services/src/post/post-db-provider.test.ts +68 -0
  402. package/skills/maestro-examples/references/chorus/packages/services/src/post/post-db-provider.ts +219 -0
  403. package/skills/maestro-examples/references/chorus/packages/services/src/post/post-use-cases.ts +184 -0
  404. package/skills/maestro-examples/references/chorus/packages/services/src/post/redact-hidden-post.ts +4 -0
  405. package/skills/maestro-examples/references/chorus/packages/services/src/profile/index.ts +17 -0
  406. package/skills/maestro-examples/references/chorus/packages/services/src/profile/profile-db-provider.test.ts +57 -0
  407. package/skills/maestro-examples/references/chorus/packages/services/src/profile/profile-db-provider.ts +75 -0
  408. package/skills/maestro-examples/references/chorus/packages/services/src/profile/profile-use-cases.ts +61 -0
  409. package/skills/maestro-examples/references/chorus/packages/services/src/testing/channel-seed.ts +27 -0
  410. package/skills/maestro-examples/references/chorus/packages/services/src/testing/index.ts +13 -0
  411. package/skills/maestro-examples/references/chorus/packages/services/src/testing/like-seed.ts +21 -0
  412. package/skills/maestro-examples/references/chorus/packages/services/src/testing/post-seed.ts +27 -0
  413. package/skills/maestro-examples/references/chorus/packages/services/src/testing/profile-seed.ts +28 -0
  414. package/skills/maestro-examples/references/chorus/packages/services/src/testing/seed-pipe.ts +38 -0
  415. package/skills/maestro-examples/references/chorus/packages/services/tsconfig.json +9 -0
  416. package/skills/maestro-examples/references/chorus/scripts/foreign-key-delete-behavior.ts +111 -0
  417. package/skills/maestro-examples/references/chorus/specs/app.md +73 -0
  418. package/skills/maestro-examples/references/chorus/specs/data-models.md +48 -0
  419. package/skills/maestro-examples/references/chorus/specs/database-schema.md +59 -0
  420. package/skills/maestro-examples/references/chorus/specs/use-cases.md +33 -0
  421. package/skills/maestro-examples/references/chorus/tsconfig.json +29 -0
  422. package/skills/maestro-examples/references/setlist/IMPLEMENTATION_PLAN.md +88 -0
  423. package/skills/maestro-examples/references/setlist/config/db-migrate.ts +9 -0
  424. package/skills/maestro-examples/references/setlist/config/queue-processor.ts +11 -0
  425. package/skills/maestro-examples/references/setlist/config/services.ts +16 -0
  426. package/skills/maestro-examples/references/setlist/config/setlist-web.ts +12 -0
  427. package/skills/maestro-examples/references/setlist/infrastructure/cdk/index.ts +56 -0
  428. package/skills/maestro-examples/references/setlist/infrastructure/cdk.context.json +5 -0
  429. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/20260316000000_init.ts +16 -0
  430. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/20260317000000_add-queue-and-recurring-job-tables.ts +22 -0
  431. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/sqls/20260316000000_init-down.sql +5 -0
  432. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/sqls/20260316000000_init-up.sql +68 -0
  433. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/sqls/20260317000000_add-queue-and-recurring-job-tables-down.sql +2 -0
  434. package/skills/maestro-examples/references/setlist/infrastructure/db-migrations/sqls/20260317000000_add-queue-and-recurring-job-tables-up.sql +21 -0
  435. package/skills/maestro-examples/references/setlist/infrastructure/package.json +20 -0
  436. package/skills/maestro-examples/references/setlist/infrastructure/tsconfig.json +8 -0
  437. package/skills/maestro-examples/references/setlist/package.json +19 -0
  438. package/skills/maestro-examples/references/setlist/packages/email-templates/other/generate-email-modules.ts +22 -0
  439. package/skills/maestro-examples/references/setlist/packages/email-templates/other/generate-email-previews.ts +18 -0
  440. package/skills/maestro-examples/references/setlist/packages/email-templates/package.json +27 -0
  441. package/skills/maestro-examples/references/setlist/packages/email-templates/src/components/button.tsx +19 -0
  442. package/skills/maestro-examples/references/setlist/packages/email-templates/src/components/root-container.tsx +29 -0
  443. package/skills/maestro-examples/references/setlist/packages/email-templates/src/components/tailwind-wrapper.tsx +113 -0
  444. package/skills/maestro-examples/references/setlist/packages/email-templates/src/email-modules.ts +9 -0
  445. package/skills/maestro-examples/references/setlist/packages/email-templates/src/emails/magic-link-login.tsx +49 -0
  446. package/skills/maestro-examples/references/setlist/packages/email-templates/src/index.ts +3 -0
  447. package/skills/maestro-examples/references/setlist/packages/email-templates/src/render-email-template.ts +24 -0
  448. package/skills/maestro-examples/references/setlist/packages/email-templates/src/utils/tw.ts +5 -0
  449. package/skills/maestro-examples/references/setlist/packages/email-templates/tsconfig.json +11 -0
  450. package/skills/maestro-examples/references/setlist/packages/email-templates/tsup.config.ts +10 -0
  451. package/skills/maestro-examples/references/setlist/packages/schemas/package.json +21 -0
  452. package/skills/maestro-examples/references/setlist/packages/schemas/src/area/index.ts +28 -0
  453. package/skills/maestro-examples/references/setlist/packages/schemas/src/index.ts +6 -0
  454. package/skills/maestro-examples/references/setlist/packages/schemas/src/magic-link/index.ts +20 -0
  455. package/skills/maestro-examples/references/setlist/packages/schemas/src/position.ts +137 -0
  456. package/skills/maestro-examples/references/setlist/packages/schemas/src/project/index.ts +44 -0
  457. package/skills/maestro-examples/references/setlist/packages/schemas/src/task/index.ts +41 -0
  458. package/skills/maestro-examples/references/setlist/packages/schemas/src/user/index.ts +28 -0
  459. package/skills/maestro-examples/references/setlist/packages/schemas/tests/position.test.ts +106 -0
  460. package/skills/maestro-examples/references/setlist/packages/schemas/tsconfig.json +9 -0
  461. package/skills/maestro-examples/references/setlist/packages/services/package.json +40 -0
  462. package/skills/maestro-examples/references/setlist/packages/services/run-tests.ts +59 -0
  463. package/skills/maestro-examples/references/setlist/packages/services/src/area/area-db-provider.test.ts +29 -0
  464. package/skills/maestro-examples/references/setlist/packages/services/src/area/area-db-provider.ts +81 -0
  465. package/skills/maestro-examples/references/setlist/packages/services/src/area/area-use-cases.ts +130 -0
  466. package/skills/maestro-examples/references/setlist/packages/services/src/area/index.ts +27 -0
  467. package/skills/maestro-examples/references/setlist/packages/services/src/auth/auth-db-provider.test.ts +34 -0
  468. package/skills/maestro-examples/references/setlist/packages/services/src/auth/auth-db-provider.ts +24 -0
  469. package/skills/maestro-examples/references/setlist/packages/services/src/auth/auth-use-cases.ts +110 -0
  470. package/skills/maestro-examples/references/setlist/packages/services/src/auth/index.ts +18 -0
  471. package/skills/maestro-examples/references/setlist/packages/services/src/auth/magic-link-db-provider.test.ts +52 -0
  472. package/skills/maestro-examples/references/setlist/packages/services/src/auth/magic-link-db-provider.ts +59 -0
  473. package/skills/maestro-examples/references/setlist/packages/services/src/auth/user-db-provider.test.ts +33 -0
  474. package/skills/maestro-examples/references/setlist/packages/services/src/auth/user-db-provider.ts +55 -0
  475. package/skills/maestro-examples/references/setlist/packages/services/src/auth/verify-magic-link-credentials.ts +39 -0
  476. package/skills/maestro-examples/references/setlist/packages/services/src/index.ts +20 -0
  477. package/skills/maestro-examples/references/setlist/packages/services/src/maestro.ts +175 -0
  478. package/skills/maestro-examples/references/setlist/packages/services/src/project/index.ts +29 -0
  479. package/skills/maestro-examples/references/setlist/packages/services/src/project/project-db-provider.test.ts +46 -0
  480. package/skills/maestro-examples/references/setlist/packages/services/src/project/project-db-provider.ts +114 -0
  481. package/skills/maestro-examples/references/setlist/packages/services/src/project/project-use-cases.ts +183 -0
  482. package/skills/maestro-examples/references/setlist/packages/services/src/task/index.ts +39 -0
  483. package/skills/maestro-examples/references/setlist/packages/services/src/task/task-db-provider.test.ts +53 -0
  484. package/skills/maestro-examples/references/setlist/packages/services/src/task/task-db-provider.ts +219 -0
  485. package/skills/maestro-examples/references/setlist/packages/services/src/task/task-use-cases.ts +303 -0
  486. package/skills/maestro-examples/references/setlist/packages/services/src/testing/area-seed.ts +25 -0
  487. package/skills/maestro-examples/references/setlist/packages/services/src/testing/index.ts +13 -0
  488. package/skills/maestro-examples/references/setlist/packages/services/src/testing/project-seed.ts +29 -0
  489. package/skills/maestro-examples/references/setlist/packages/services/src/testing/seed-pipe.ts +38 -0
  490. package/skills/maestro-examples/references/setlist/packages/services/src/testing/task-seed.ts +31 -0
  491. package/skills/maestro-examples/references/setlist/packages/services/src/testing/user-seed.ts +24 -0
  492. package/skills/maestro-examples/references/setlist/packages/services/tsconfig.json +9 -0
  493. package/skills/maestro-examples/references/setlist/queue-processor/package.json +17 -0
  494. package/skills/maestro-examples/references/setlist/queue-processor/src/index.ts +29 -0
  495. package/skills/maestro-examples/references/setlist/queue-processor/src/recurring-jobs.ts +13 -0
  496. package/skills/maestro-examples/references/setlist/queue-processor/tsconfig.json +4 -0
  497. package/skills/maestro-examples/references/setlist/scripts/foreign-key-delete-behavior.ts +107 -0
  498. package/skills/maestro-examples/references/setlist/setlist-web/app/app.css +158 -0
  499. package/skills/maestro-examples/references/setlist/setlist-web/app/components/alert-dialog.tsx +153 -0
  500. package/skills/maestro-examples/references/setlist/setlist-web/app/components/app-dnd-provider.tsx +180 -0
  501. package/skills/maestro-examples/references/setlist/setlist-web/app/components/area-form.tsx +113 -0
  502. package/skills/maestro-examples/references/setlist/setlist-web/app/components/button-group.tsx +78 -0
  503. package/skills/maestro-examples/references/setlist/setlist-web/app/components/button.tsx +139 -0
  504. package/skills/maestro-examples/references/setlist/setlist-web/app/components/checkbox.tsx +210 -0
  505. package/skills/maestro-examples/references/setlist/setlist-web/app/components/context-menu.tsx +78 -0
  506. package/skills/maestro-examples/references/setlist/setlist-web/app/components/date-picker.tsx +214 -0
  507. package/skills/maestro-examples/references/setlist/setlist-web/app/components/dnd-collision-detection.ts +28 -0
  508. package/skills/maestro-examples/references/setlist/setlist-web/app/components/dnd-utils.ts +11 -0
  509. package/skills/maestro-examples/references/setlist/setlist-web/app/components/drag-ghost.tsx +24 -0
  510. package/skills/maestro-examples/references/setlist/setlist-web/app/components/form.tsx +107 -0
  511. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/animated-popover.tsx +27 -0
  512. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/button-context.ts +13 -0
  513. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/calendar-month-year-picker.tsx +283 -0
  514. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/form-field.tsx +231 -0
  515. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/get-button-classes.ts +141 -0
  516. package/skills/maestro-examples/references/setlist/setlist-web/app/components/helpers/headless-button.tsx +39 -0
  517. package/skills/maestro-examples/references/setlist/setlist-web/app/components/icon.tsx +29 -0
  518. package/skills/maestro-examples/references/setlist/setlist-web/app/components/inline-alert.tsx +57 -0
  519. package/skills/maestro-examples/references/setlist/setlist-web/app/components/project-form.tsx +153 -0
  520. package/skills/maestro-examples/references/setlist/setlist-web/app/components/select.tsx +219 -0
  521. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/helpers.ts +73 -0
  522. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/index.ts +6 -0
  523. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/inline-inputs.tsx +128 -0
  524. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/sidebar.tsx +333 -0
  525. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/sortable-rows.tsx +256 -0
  526. package/skills/maestro-examples/references/setlist/setlist-web/app/components/sidebar/use-sidebar-dnd.ts +261 -0
  527. package/skills/maestro-examples/references/setlist/setlist-web/app/components/spinner.tsx +19 -0
  528. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-inline-create.tsx +51 -0
  529. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/index.ts +3 -0
  530. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-date-helpers.ts +16 -0
  531. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-expanded-detail.tsx +273 -0
  532. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-keyboard-helpers.ts +5 -0
  533. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-list.tsx +134 -0
  534. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/task-row.tsx +100 -0
  535. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/types.ts +49 -0
  536. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/use-expanded-cache.ts +22 -0
  537. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/use-sticky-task.ts +24 -0
  538. package/skills/maestro-examples/references/setlist/setlist-web/app/components/task-list/use-task-reorder.ts +140 -0
  539. package/skills/maestro-examples/references/setlist/setlist-web/app/components/text-area.tsx +151 -0
  540. package/skills/maestro-examples/references/setlist/setlist-web/app/components/text-field.tsx +147 -0
  541. package/skills/maestro-examples/references/setlist/setlist-web/app/components/toast.tsx +179 -0
  542. package/skills/maestro-examples/references/setlist/setlist-web/app/entry.client.tsx +21 -0
  543. package/skills/maestro-examples/references/setlist/setlist-web/app/entry.server.tsx +13 -0
  544. package/skills/maestro-examples/references/setlist/setlist-web/app/features/csrf-middleware.server.ts +17 -0
  545. package/skills/maestro-examples/references/setlist/setlist-web/app/features/custom-error-status-code-middleware.server.ts +31 -0
  546. package/skills/maestro-examples/references/setlist/setlist-web/app/features/rate-limiting-middleware.server.ts +36 -0
  547. package/skills/maestro-examples/references/setlist/setlist-web/app/features/redirect-with-toast.server.ts +14 -0
  548. package/skills/maestro-examples/references/setlist/setlist-web/app/features/request-context.server.ts +52 -0
  549. package/skills/maestro-examples/references/setlist/setlist-web/app/features/security-headers-middleware.server.ts +10 -0
  550. package/skills/maestro-examples/references/setlist/setlist-web/app/hooks/use-area-actions.ts +44 -0
  551. package/skills/maestro-examples/references/setlist/setlist-web/app/hooks/use-csrf-token.ts +6 -0
  552. package/skills/maestro-examples/references/setlist/setlist-web/app/hooks/use-project-actions.ts +80 -0
  553. package/skills/maestro-examples/references/setlist/setlist-web/app/hooks/use-task-actions.ts +65 -0
  554. package/skills/maestro-examples/references/setlist/setlist-web/app/root.tsx +218 -0
  555. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/areas.$id.delete.tsx +19 -0
  556. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/areas.$id.edit.tsx +27 -0
  557. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/areas.$id.reorder.tsx +30 -0
  558. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/areas.tsx +23 -0
  559. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.complete.tsx +19 -0
  560. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.delete.tsx +19 -0
  561. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.edit.tsx +32 -0
  562. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.move.tsx +23 -0
  563. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.reorder.tsx +30 -0
  564. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.$id.uncomplete.tsx +19 -0
  565. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/projects.tsx +23 -0
  566. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.complete.tsx +19 -0
  567. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.delete.tsx +19 -0
  568. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.edit.tsx +27 -0
  569. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.move.tsx +30 -0
  570. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.reorder.tsx +32 -0
  571. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.$id.uncomplete.tsx +19 -0
  572. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/api/tasks.tsx +23 -0
  573. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/areas.$id.tsx +155 -0
  574. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/auth.login.tsx +98 -0
  575. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/auth.logout.tsx +17 -0
  576. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/auth.verify.tsx +154 -0
  577. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/completed.tsx +121 -0
  578. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/inbox.tsx +68 -0
  579. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/projects.$id.tsx +217 -0
  580. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/today.tsx +86 -0
  581. package/skills/maestro-examples/references/setlist/setlist-web/app/routes/upcoming.tsx +83 -0
  582. package/skills/maestro-examples/references/setlist/setlist-web/app/routes.ts +4 -0
  583. package/skills/maestro-examples/references/setlist/setlist-web/app/services.server.ts +1 -0
  584. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/colors.ts +47 -0
  585. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/compose-refs.ts +35 -0
  586. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/tw.ts +16 -0
  587. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-dismiss.ts +27 -0
  588. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-fetcher-complete.ts +17 -0
  589. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-prevent-default.ts +30 -0
  590. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-render-props.ts +42 -0
  591. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-spin-delay.ts +27 -0
  592. package/skills/maestro-examples/references/setlist/setlist-web/app/utils/use-stable-accessor.ts +14 -0
  593. package/skills/maestro-examples/references/setlist/setlist-web/environment.d.ts +8 -0
  594. package/skills/maestro-examples/references/setlist/setlist-web/instrument.server.mjs +29 -0
  595. package/skills/maestro-examples/references/setlist/setlist-web/knip.json +3 -0
  596. package/skills/maestro-examples/references/setlist/setlist-web/package.json +52 -0
  597. package/skills/maestro-examples/references/setlist/setlist-web/playwright.config.ts +39 -0
  598. package/skills/maestro-examples/references/setlist/setlist-web/react-router.config.ts +12 -0
  599. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-create.test.ts +37 -0
  600. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-delete.test.ts +45 -0
  601. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-deleted-not-in-sidebar.test.ts +44 -0
  602. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-detail-view.test.ts +46 -0
  603. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-edit-title.test.ts +48 -0
  604. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-expand-collapse.test.ts +50 -0
  605. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-list-in-sidebar.test.ts +37 -0
  606. package/skills/maestro-examples/references/setlist/setlist-web/tests/areas-reorder-dnd.test.ts +82 -0
  607. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-logout.test.ts +18 -0
  608. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-reject-invalid-token.test.ts +35 -0
  609. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-reject-used-token.test.ts +104 -0
  610. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-request-magic-link.test.ts +29 -0
  611. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-verify-via-pasted-token.test.ts +52 -0
  612. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth-verify-via-url.test.ts +48 -0
  613. package/skills/maestro-examples/references/setlist/setlist-web/tests/auth.setup.ts +55 -0
  614. package/skills/maestro-examples/references/setlist/setlist-web/tests/constants.ts +13 -0
  615. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-inbox-to-area.test.ts +74 -0
  616. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-inbox-to-project.test.ts +73 -0
  617. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-move-to-inbox.test.ts +51 -0
  618. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-project-to-area.test.ts +76 -0
  619. package/skills/maestro-examples/references/setlist/setlist-web/tests/dnd-project-to-project.test.ts +75 -0
  620. package/skills/maestro-examples/references/setlist/setlist-web/tests/home.test.ts +27 -0
  621. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-complete.test.ts +53 -0
  622. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-completed-not-in-sidebar.test.ts +46 -0
  623. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-create-in-area.test.ts +55 -0
  624. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-create-top-level.test.ts +37 -0
  625. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-delete.test.ts +55 -0
  626. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-edit-notes-date.test.ts +69 -0
  627. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-edit-title.test.ts +48 -0
  628. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-move-into-area.test.ts +72 -0
  629. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-move-out-of-area.test.ts +76 -0
  630. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-reorder-top-level.test.ts +82 -0
  631. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-reorder-within-area.test.ts +91 -0
  632. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-uncomplete.test.ts +39 -0
  633. package/skills/maestro-examples/references/setlist/setlist-web/tests/projects-view-tasks.test.ts +48 -0
  634. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-complete-removes-from-active-views.test.ts +52 -0
  635. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-complete.test.ts +46 -0
  636. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-create-in-inbox.test.ts +19 -0
  637. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-create-in-project.test.ts +44 -0
  638. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-delete.test.ts +52 -0
  639. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-edit.test.ts +73 -0
  640. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-reorder-in-project.test.ts +81 -0
  641. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-reorder-inbox.test.ts +80 -0
  642. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-reorder-today.test.ts +103 -0
  643. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-uncomplete.test.ts +51 -0
  644. package/skills/maestro-examples/references/setlist/setlist-web/tests/tasks-view-details.test.ts +51 -0
  645. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-active-sidebar-highlight.test.ts +38 -0
  646. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-inbox-unassigned-only.test.ts +43 -0
  647. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-navigate-to-completed.test.ts +59 -0
  648. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-navigate-to-inbox.test.ts +21 -0
  649. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-navigate-to-today.test.ts +42 -0
  650. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-navigate-to-upcoming.test.ts +59 -0
  651. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-sidebar-built-in-views.test.ts +23 -0
  652. package/skills/maestro-examples/references/setlist/setlist-web/tests/views-today-shows-overdue.test.ts +48 -0
  653. package/skills/maestro-examples/references/setlist/setlist-web/tsconfig.json +22 -0
  654. package/skills/maestro-examples/references/setlist/setlist-web/vite.config.ts +37 -0
  655. package/skills/maestro-examples/references/setlist/specs/app.md +69 -0
  656. package/skills/maestro-examples/references/setlist/specs/data-models.md +92 -0
  657. package/skills/maestro-examples/references/setlist/specs/database-schema.md +76 -0
  658. package/skills/maestro-examples/references/setlist/specs/drag-and-drop.md +89 -0
  659. package/skills/maestro-examples/references/setlist/specs/magic-link-login.md +300 -0
  660. package/skills/maestro-examples/references/setlist/specs/position-ordering.md +329 -0
  661. package/skills/maestro-examples/references/setlist/specs/sidebar.md +65 -0
  662. package/skills/maestro-examples/references/setlist/specs/use-cases.md +55 -0
  663. package/skills/maestro-examples/references/setlist/tsconfig.json +28 -0
  664. package/{dist → skills}/maestro-packages/SKILL.md +3 -3
  665. package/skills/maestro-packages/permissions.md +215 -0
  666. package/skills/maestro-packages/queue.md +442 -0
  667. package/skills/maestro-packages/recurring-jobs.md +238 -0
  668. package/skills/react-use-effect/SKILL.md +65 -0
  669. package/skills/react-use-effect/references/patterns.md +283 -0
  670. package/dist/maestro-packages/queue.md +0 -284
  671. package/dist/maestro-packages/recurring-jobs.md +0 -353
  672. package/dist/maestro-packages/tracing.md +0 -240
  673. /package/{dist → skills}/maestro-cli/SKILL.md +0 -0
  674. /package/{dist → skills}/maestro-packages/broadcast.md +0 -0
  675. /package/{dist → skills}/maestro-packages/cache-control.md +0 -0
  676. /package/{dist → skills}/maestro-packages/cache.md +0 -0
  677. /package/{dist → skills}/maestro-packages/config.md +0 -0
  678. /package/{dist → skills}/maestro-packages/context.md +0 -0
  679. /package/{dist → skills}/maestro-packages/crypt.md +0 -0
  680. /package/{dist → skills}/maestro-packages/db.md +0 -0
  681. /package/{dist → skills}/maestro-packages/events.md +0 -0
  682. /package/{dist → skills}/maestro-packages/exceptions.md +0 -0
  683. /package/{dist → skills}/maestro-packages/form.md +0 -0
  684. /package/{dist → skills}/maestro-packages/hash.md +0 -0
  685. /package/{dist → skills}/maestro-packages/helpers.md +0 -0
  686. /package/{dist → skills}/maestro-packages/log.md +0 -0
  687. /package/{dist → skills}/maestro-packages/mail.md +0 -0
  688. /package/{dist → skills}/maestro-packages/metrics.md +0 -0
  689. /package/{dist → skills}/maestro-packages/rate-limiting.md +0 -0
  690. /package/{dist → skills}/maestro-packages/react-router-file-routes.md +0 -0
  691. /package/{dist → skills}/maestro-packages/sql.md +0 -0
@@ -0,0 +1,15 @@
1
+ {
2
+ "cookies": [
3
+ {
4
+ "name": "cadence_session",
5
+ "value": "i1To.BLvpK4v2AZ5oaUF1.bEkATVN1vH83APq3cB1HI2kgtoEq%2B9oYhQL7qxEIzLC6TTZj.ARQCtO%2BCqIavpkpd2uhxeg%3D%3D",
6
+ "domain": "localhost",
7
+ "path": "/",
8
+ "expires": 1778360173.123072,
9
+ "httpOnly": true,
10
+ "secure": false,
11
+ "sameSite": "Lax"
12
+ }
13
+ ],
14
+ "origins": []
15
+ }
@@ -0,0 +1,112 @@
1
+ @import 'tailwindcss';
2
+ @plugin "@tailwindcss/typography";
3
+
4
+ @theme {
5
+ --color-primary-50: var(--color-blue-50);
6
+ --color-primary-100: var(--color-blue-100);
7
+ --color-primary-200: var(--color-blue-200);
8
+ --color-primary-300: var(--color-blue-300);
9
+ --color-primary-400: var(--color-blue-400);
10
+ --color-primary-500: var(--color-blue-500);
11
+ --color-primary-600: var(--color-blue-600);
12
+ --color-primary-700: var(--color-blue-700);
13
+ --color-primary-800: var(--color-blue-800);
14
+ --color-primary-900: var(--color-blue-900);
15
+ --color-primary-950: var(--color-blue-950);
16
+
17
+ --color-positive-50: var(--color-emerald-50);
18
+ --color-positive-100: var(--color-emerald-100);
19
+ --color-positive-200: var(--color-emerald-200);
20
+ --color-positive-300: var(--color-emerald-300);
21
+ --color-positive-400: var(--color-emerald-400);
22
+ --color-positive-500: var(--color-emerald-500);
23
+ --color-positive-600: var(--color-emerald-600);
24
+ --color-positive-700: var(--color-emerald-700);
25
+ --color-positive-800: var(--color-emerald-800);
26
+ --color-positive-900: var(--color-emerald-900);
27
+ --color-positive-950: var(--color-emerald-950);
28
+
29
+ --color-negative-50: var(--color-red-50);
30
+ --color-negative-100: var(--color-red-100);
31
+ --color-negative-200: var(--color-red-200);
32
+ --color-negative-300: var(--color-red-300);
33
+ --color-negative-400: var(--color-red-400);
34
+ --color-negative-500: var(--color-red-500);
35
+ --color-negative-600: var(--color-red-600);
36
+ --color-negative-700: var(--color-red-700);
37
+ --color-negative-800: var(--color-red-800);
38
+ --color-negative-900: var(--color-red-900);
39
+ --color-negative-950: var(--color-red-950);
40
+
41
+ --color-neutral-50: var(--color-gray-50);
42
+ --color-neutral-100: var(--color-gray-100);
43
+ --color-neutral-200: var(--color-gray-200);
44
+ --color-neutral-300: var(--color-gray-300);
45
+ --color-neutral-400: var(--color-gray-400);
46
+ --color-neutral-500: var(--color-gray-500);
47
+ --color-neutral-600: var(--color-gray-600);
48
+ --color-neutral-700: var(--color-gray-700);
49
+ --color-neutral-800: var(--color-gray-800);
50
+ --color-neutral-900: var(--color-gray-900);
51
+ --color-neutral-950: var(--color-gray-950);
52
+
53
+ --font-sans: ui-sans-serif, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
54
+ }
55
+
56
+ /* Base styles */
57
+ html {
58
+ @apply h-full antialiased;
59
+ }
60
+
61
+ body {
62
+ @apply h-full bg-white text-neutral-900 font-sans text-sm leading-relaxed;
63
+ }
64
+
65
+ /* Interactive element base states */
66
+ button,
67
+ [role='button'] {
68
+ @apply cursor-pointer;
69
+ }
70
+
71
+ a,
72
+ button,
73
+ [role='button'],
74
+ input,
75
+ select,
76
+ textarea {
77
+ @apply outline-none focus-visible:ring-2 focus-visible:ring-primary-500/40 focus-visible:ring-offset-1 rounded-sm;
78
+ }
79
+
80
+ /* Top nav item styles */
81
+ .top-nav-item {
82
+ @apply flex items-center gap-1.5 rounded-lg px-2.5 py-1.5 text-sm font-medium text-neutral-500 transition-colors duration-100;
83
+ }
84
+
85
+ .top-nav-item:hover {
86
+ @apply bg-neutral-100 text-neutral-900;
87
+ }
88
+
89
+ .top-nav-item.active {
90
+ @apply bg-primary-50 text-primary-700;
91
+ }
92
+
93
+ /* Typography utilities */
94
+ .typography-h1 {
95
+ @apply text-2xl font-semibold tracking-tight text-balance text-neutral-900;
96
+ }
97
+
98
+ .typography-h2 {
99
+ @apply text-base font-semibold text-neutral-900;
100
+ }
101
+
102
+ .typography-h3 {
103
+ @apply text-sm font-semibold text-neutral-900;
104
+ }
105
+
106
+ .typography-link {
107
+ @apply text-sm font-medium text-blue-600 hover:text-blue-500;
108
+ }
109
+
110
+ .typography-button {
111
+ @apply text-sm font-medium;
112
+ }
@@ -0,0 +1,39 @@
1
+ import type { ReactNode } from 'react'
2
+ import { InlineAlert } from './inline-alert'
3
+
4
+ interface AuthLayoutProps {
5
+ title: string
6
+ subtitle: string
7
+ formError?: string | null | false
8
+ footer?: ReactNode
9
+ children: ReactNode
10
+ }
11
+
12
+ export function AuthLayout({ title, subtitle, formError, footer, children }: AuthLayoutProps) {
13
+ return (
14
+ <div className="flex min-h-dvh items-center justify-center bg-linear-to-br from-blue-50 via-white to-indigo-50 px-4 py-12">
15
+ <div className="w-full max-w-xs">
16
+ <div className="flex flex-col items-center gap-3">
17
+ <div className="flex size-12 items-center justify-center rounded-xl bg-linear-to-br from-blue-600 to-indigo-600 shadow-md">
18
+ <span className="text-xl font-semibold text-white">C</span>
19
+ </div>
20
+ <div className="text-center">
21
+ <h1 className="text-xl font-semibold tracking-tight text-balance text-neutral-900">{title}</h1>
22
+ <p className="mt-1 text-sm text-pretty text-neutral-500">{subtitle}</p>
23
+ </div>
24
+ </div>
25
+
26
+ <div className="mt-8 rounded-xl bg-white p-6 shadow-md ring-1 ring-black/5">
27
+ {formError && (
28
+ <div className="mb-6">
29
+ <InlineAlert variant="negative" description={formError} />
30
+ </div>
31
+ )}
32
+ {children}
33
+ </div>
34
+
35
+ {footer && <p className="mt-6 text-center text-sm text-neutral-500">{footer}</p>}
36
+ </div>
37
+ </div>
38
+ )
39
+ }
@@ -0,0 +1,24 @@
1
+ import { Link } from 'react-router'
2
+
3
+ interface BackLinkProps {
4
+ to: string
5
+ children: string
6
+ }
7
+
8
+ export function BackLink({ to, children }: BackLinkProps) {
9
+ return (
10
+ <Link
11
+ to={to}
12
+ className="inline-flex items-center gap-1.5 text-sm text-neutral-500 transition-colors hover:text-neutral-700"
13
+ >
14
+ <svg viewBox="0 0 16 16" fill="currentColor" className="size-4">
15
+ <path
16
+ fillRule="evenodd"
17
+ d="M9.78 4.22a.75.75 0 0 1 0 1.06L7.06 8l2.72 2.72a.75.75 0 1 1-1.06 1.06L5.47 8.53a.75.75 0 0 1 0-1.06l3.25-3.25a.75.75 0 0 1 1.06 0Z"
18
+ clipRule="evenodd"
19
+ />
20
+ </svg>
21
+ {children}
22
+ </Link>
23
+ )
24
+ }
@@ -0,0 +1,78 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add button-group --directory app
3
+
4
+ import * as React from 'react'
5
+ import { mergeProps } from '@react-aria/utils'
6
+ import { tw } from '../utils/tw'
7
+
8
+ export type ButtonGroupOrientation = 'horizontal' | 'vertical'
9
+ export type ButtonGroupAlignment = 'start' | 'center' | 'end'
10
+ export type ButtonGroupSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl'
11
+
12
+ export type ButtonGroupProps = {
13
+ orientation?: ButtonGroupOrientation
14
+ alignment?: ButtonGroupAlignment
15
+ size?: ButtonGroupSize
16
+ className?: string
17
+ children?: React.ReactNode
18
+ 'aria-label'?: string
19
+ 'aria-labelledby'?: string
20
+ 'aria-describedby'?: string
21
+ fullWidth?: boolean
22
+ }
23
+
24
+ export const ButtonGroupContext = React.createContext<{
25
+ orientation?: ButtonGroupOrientation
26
+ alignment?: ButtonGroupAlignment
27
+ size?: ButtonGroupSize
28
+ fullWidth?: boolean
29
+ className?: string
30
+ }>({})
31
+
32
+ const sizeGapClasses: Record<ButtonGroupSize, string> = {
33
+ xl: 'gap-4',
34
+ lg: 'gap-3',
35
+ md: 'gap-2',
36
+ sm: 'gap-1',
37
+ xs: 'gap-0.5'
38
+ }
39
+
40
+ const alignmentClasses: Record<ButtonGroupAlignment, string> = {
41
+ start: 'justify-start',
42
+ center: 'justify-center',
43
+ end: 'justify-end'
44
+ }
45
+
46
+ export function ButtonGroup(inputProps: ButtonGroupProps) {
47
+ const context = React.useContext(ButtonGroupContext)
48
+ const {
49
+ orientation = 'horizontal',
50
+ alignment = 'end',
51
+ size = 'md',
52
+ className,
53
+ children,
54
+ fullWidth,
55
+ ...ariaProps
56
+ } = mergeProps(React.useContext(ButtonGroupContext), inputProps)
57
+
58
+ return (
59
+ <div
60
+ role="group"
61
+ aria-label={ariaProps['aria-label']}
62
+ aria-labelledby={ariaProps['aria-labelledby']}
63
+ aria-describedby={ariaProps['aria-describedby']}
64
+ className={tw(
65
+ 'inline-flex w-fit',
66
+ sizeGapClasses[size],
67
+ orientation === 'horizontal' ? 'flex-row items-center flex-wrap' : 'flex-col',
68
+ alignmentClasses[alignment],
69
+ fullWidth && 'w-full',
70
+ className
71
+ )}
72
+ >
73
+ {children}
74
+ </div>
75
+ )
76
+ }
77
+
78
+ ButtonGroup.displayName = 'ButtonGroup'
@@ -0,0 +1,77 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add button-link --directory app
3
+
4
+ import * as React from 'react'
5
+ import { Link } from 'react-router'
6
+ import { usePress } from '@react-aria/interactions'
7
+ import { mergeProps } from '@react-aria/utils'
8
+ import { Spinner } from './spinner'
9
+ import {
10
+ getButtonClasses,
11
+ type ButtonColor,
12
+ type ButtonShape,
13
+ type ButtonSize,
14
+ type ButtonVariant
15
+ } from './helpers/get-button-classes'
16
+ import { useSpinDelay } from '../utils/use-spin-delay'
17
+ import { tw } from '../utils/tw'
18
+ import { ButtonContext } from './helpers/button-context'
19
+
20
+ export type ButtonLinkProps = React.ComponentPropsWithoutRef<typeof Link> & {
21
+ size?: ButtonSize
22
+ variant?: ButtonVariant
23
+ color?: ButtonColor
24
+ shape?: ButtonShape
25
+ disabled?: boolean
26
+ fullWidth?: boolean
27
+ isPending?: boolean
28
+ }
29
+
30
+ export const ButtonLink = React.forwardRef<HTMLAnchorElement, ButtonLinkProps>(
31
+ ({ disabled, fullWidth, isPending: isPendingProp, children, onClick, className, ...propsRaw }, ref) => {
32
+ const {
33
+ size = 'md',
34
+ variant = 'contained',
35
+ color = 'primary',
36
+ shape = 'oval',
37
+ ...props
38
+ } = mergeProps(propsRaw, React.useContext(ButtonContext))
39
+ const { isPressed, pressProps } = usePress({ isDisabled: disabled })
40
+
41
+ const isPending = isPendingProp ?? false
42
+ const showSpinner = useSpinDelay(isPending, { delay: 500, minDuration: 200 })
43
+
44
+ const handleClick = disabled || isPending ? (e: React.MouseEvent<HTMLAnchorElement>) => e.preventDefault() : onClick
45
+
46
+ return (
47
+ <Link
48
+ {...mergeProps(props, pressProps, { onClick: handleClick })}
49
+ ref={ref}
50
+ data-pending={isPending || undefined}
51
+ data-disabled={disabled || undefined}
52
+ data-pressed={(isPressed && !disabled) || undefined}
53
+ aria-disabled={disabled || undefined}
54
+ className={getButtonClasses({
55
+ size,
56
+ variant,
57
+ color,
58
+ shape,
59
+ className: tw(fullWidth && 'w-full', className)
60
+ })}
61
+ >
62
+ {(size === 'xs' || size === 'sm' || shape === 'circle') && (
63
+ <span className="absolute left-1/2 top-1/2 size-12 -translate-x-1/2 -translate-y-1/2" aria-hidden="true" />
64
+ )}
65
+ <span className={tw('inline-flex items-center gap-2', showSpinner && 'opacity-0')}>{children}</span>
66
+ <span
67
+ aria-hidden={!showSpinner ? true : undefined}
68
+ className={tw('absolute inset-0 flex items-center justify-center', !showSpinner && 'opacity-0')}
69
+ >
70
+ <Spinner className="size-4" />
71
+ </span>
72
+ </Link>
73
+ )
74
+ }
75
+ )
76
+
77
+ ButtonLink.displayName = 'ButtonLink'
@@ -0,0 +1,139 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add button --directory app
3
+
4
+ import * as React from 'react'
5
+ import { Spinner } from './spinner'
6
+ import { flushSync } from 'react-dom'
7
+ import { composeRenderProps } from 'react-aria-components'
8
+ import {
9
+ getButtonClasses,
10
+ type ButtonColor,
11
+ type ButtonShape,
12
+ type ButtonSize,
13
+ type ButtonVariant
14
+ } from './helpers/get-button-classes'
15
+ import { HeadlessButton } from './helpers/headless-button'
16
+ import { useSpinDelay } from '../utils/use-spin-delay'
17
+ import { usePreventDefault } from '../utils/use-prevent-default'
18
+ import { composeTailwindRenderProps, tw } from '../utils/tw'
19
+ import { useStableAccessor } from '../utils/use-stable-accessor'
20
+ import { mergeProps } from '@react-aria/utils'
21
+ import { ButtonContext } from './helpers/button-context'
22
+
23
+ // --- Public types ---
24
+
25
+ export type ButtonProps = {
26
+ variant?: ButtonVariant
27
+ color?: ButtonColor
28
+ size?: ButtonSize
29
+ shape?: ButtonShape
30
+ isToggled?: boolean
31
+ fullWidth?: boolean
32
+ onActionSucceeded?: () => void
33
+ onActionCompleted?: () => void
34
+ disabled?: boolean
35
+ onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void
36
+ className?: string
37
+ children?: React.ReactNode
38
+ value?: string | undefined
39
+ isPending?: boolean
40
+ } & Partial<Pick<React.ComponentProps<'button'>, 'type' | 'role' | 'name' | 'form' | 'id' | 'title' | 'aria-label'>>
41
+
42
+ export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
43
+ ({ isToggled, onActionSucceeded, onActionCompleted, isPending: isPendingProp, ...propsRaw }, ref) => {
44
+ const {
45
+ variant = 'contained',
46
+ color = 'primary',
47
+ size = 'md',
48
+ shape = 'oval',
49
+ fullWidth,
50
+ ...props
51
+ } = mergeProps(propsRaw, React.useContext(ButtonContext))
52
+
53
+ const { isClicking, onClick: isClickingHandler } = useIsClicking(props.onClick)
54
+
55
+ const isPending = isPendingProp || isClicking
56
+ const isPendingSmoothed = useSpinDelay(isPending, { delay: 0, minDuration: 50 })
57
+ const showSpinner = useSpinDelay(isPending, { delay: 500, minDuration: 200 })
58
+
59
+ const getOnActionCompleted = useStableAccessor(onActionCompleted)
60
+ const getOnActionSucceeded = useStableAccessor(onActionSucceeded)
61
+ const wasPending = React.useRef(false)
62
+ React.useEffect(() => {
63
+ if (isPendingSmoothed !== wasPending.current) {
64
+ wasPending.current = isPendingSmoothed
65
+ if (!isPendingSmoothed) {
66
+ getOnActionCompleted()?.()
67
+ getOnActionSucceeded()?.()
68
+ }
69
+ }
70
+ }, [isPendingSmoothed, getOnActionCompleted, getOnActionSucceeded])
71
+
72
+ const onClick = usePreventDefault(isClickingHandler, showSpinner || isClicking)
73
+
74
+ return (
75
+ <HeadlessButton
76
+ {...props}
77
+ ref={ref}
78
+ data-pending={isPending}
79
+ onClick={onClick}
80
+ {...(isToggled != null ? { 'aria-pressed': isToggled } : {})}
81
+ className={composeTailwindRenderProps(
82
+ props.className,
83
+ tw(getButtonClasses({ variant, color, size, shape, isToggled }), fullWidth && 'w-full')
84
+ )}
85
+ >
86
+ {composeRenderProps(props.children, (children) => (
87
+ <>
88
+ {(size === 'xs' || size === 'sm' || shape === 'circle') && (
89
+ <span className="absolute left-1/2 top-1/2 size-12 -translate-x-1/2 -translate-y-1/2" aria-hidden="true" />
90
+ )}
91
+ <span className={tw('inline-flex items-center gap-2', showSpinner && 'opacity-0')}>{children}</span>
92
+ <span
93
+ aria-hidden={!showSpinner ? true : undefined}
94
+ className={tw('absolute inset-0 flex items-center justify-center', !showSpinner && 'opacity-0')}
95
+ >
96
+ <Spinner className="size-4" />
97
+ </span>
98
+ </>
99
+ ))}
100
+ </HeadlessButton>
101
+ )
102
+ }
103
+ )
104
+
105
+ Button.displayName = 'Button'
106
+
107
+ function useIsClicking<C extends ((event: React.MouseEvent<any, MouseEvent>) => unknown) | undefined>(
108
+ onClickRaw: C
109
+ ): { onClick: C; isClicking: boolean } {
110
+ type Event = C extends (event: infer E) => unknown ? E : never
111
+
112
+ const [isClicking, setIsClicking] = React.useState<boolean>(false)
113
+
114
+ const onClickRawStabilized = useStableAccessor(onClickRaw)
115
+
116
+ const onClickDebounced = React.useCallback(
117
+ (event: Event) => {
118
+ try {
119
+ const onClickInner = onClickRawStabilized()
120
+ flushSync(() => setIsClicking(true))
121
+ const result = onClickInner ? onClickInner(event) : null
122
+ Promise.resolve(result).finally(() => {
123
+ setIsClicking(false)
124
+ })
125
+ return result
126
+ } catch (e) {
127
+ setIsClicking(false)
128
+ throw e
129
+ }
130
+ },
131
+ [onClickRawStabilized, setIsClicking]
132
+ )
133
+
134
+ if (!onClickRaw) {
135
+ return { onClick: undefined as C, isClicking }
136
+ } else {
137
+ return { onClick: onClickDebounced as C, isClicking }
138
+ }
139
+ }
@@ -0,0 +1,210 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add checkbox --directory app
3
+
4
+ import * as React from 'react'
5
+ import { Checkbox as AriaCheckbox } from 'react-aria-components'
6
+ import { HeadlessForm } from '@maestro-js/form'
7
+ import type { ValidationFunction, ValidationResult } from '@maestro-js/form'
8
+ import { tw } from '../utils/tw'
9
+ import { FormFieldComponents } from './helpers/form-field'
10
+ import { Icon } from './icon'
11
+
12
+ // ── Props ─────────────────────────────────────────────────────────────────────
13
+
14
+ export type PlainCheckboxProps = {
15
+ name?: string
16
+ form?: string
17
+
18
+ isDisabled?: boolean
19
+ isRequired?: boolean
20
+ isInvalid?: boolean
21
+ validate?: ValidationFunction<boolean>
22
+
23
+ checked?: boolean
24
+ defaultChecked?: boolean
25
+ onChange?: (checked: boolean) => void
26
+
27
+ 'aria-label'?: string
28
+ }
29
+
30
+ export type LabeledCheckboxProps = {
31
+ name?: string
32
+ form?: string
33
+
34
+ label?: React.ReactNode
35
+ cornerHint?: React.ReactNode
36
+ helpText?: React.ReactNode
37
+ warningMessage?: React.ReactNode
38
+
39
+ isRequired?: boolean
40
+ isDisabled?: boolean
41
+ isIndeterminate?: boolean
42
+ isInvalid?: boolean
43
+ validate?: ValidationFunction<boolean>
44
+ errorMessage?: React.ReactNode | ((v: ValidationResult) => React.ReactNode)
45
+
46
+ checked?: boolean
47
+ defaultChecked?: boolean
48
+ onChange?: (checked: boolean) => void
49
+
50
+ value?: string
51
+ }
52
+
53
+ // ── Plain Checkbox ─────────────────────────────────────────────────────────────
54
+
55
+ export function PlainCheckbox(props: PlainCheckboxProps) {
56
+ const hiddenInputRef = React.useRef<HTMLInputElement>(null)
57
+
58
+ const [checked, setChecked] = HeadlessForm.useControlledState(props.checked, props.defaultChecked ?? false, props.onChange)
59
+
60
+ const { isInvalid: validationInvalid, commitValidation } = HeadlessForm.useValidation(
61
+ {
62
+ validate: props.validate,
63
+ value: checked,
64
+ name: props.name,
65
+ isRequired: false,
66
+ form: props.form,
67
+ focus() {
68
+ hiddenInputRef.current?.closest('label')?.focus()
69
+ }
70
+ },
71
+ hiddenInputRef
72
+ )
73
+
74
+ return (
75
+ <AriaCheckbox
76
+ isSelected={checked}
77
+ onChange={(v) => {
78
+ setChecked(v)
79
+ commitValidation()
80
+ }}
81
+ isDisabled={props.isDisabled}
82
+ isInvalid={props.isInvalid || validationInvalid}
83
+ aria-label={props['aria-label']}
84
+ className="group inline-flex items-center focus:outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-600"
85
+ >
86
+ {({ isSelected, isIndeterminate, isDisabled }) => (
87
+ <>
88
+ {props.isDisabled || !props.name ? null : (
89
+ <HeadlessForm.HiddenInput
90
+ ref={hiddenInputRef}
91
+ name={props.name}
92
+ form={props.form}
93
+ value={checked ? 'true' : 'false'}
94
+ />
95
+ )}
96
+ <CheckboxBox isSelected={isSelected} isIndeterminate={isIndeterminate} isDisabled={isDisabled} />
97
+ </>
98
+ )}
99
+ </AriaCheckbox>
100
+ )
101
+ }
102
+
103
+ PlainCheckbox.displayName = 'PlainCheckbox'
104
+
105
+ // ── Labeled Checkbox ───────────────────────────────────────────────────────────
106
+
107
+ export function LabeledCheckbox(props: LabeledCheckboxProps) {
108
+ const hiddenInputRef = React.useRef<HTMLInputElement>(null)
109
+ const helpTextId = React.useId()
110
+
111
+ const [checked, setChecked] = HeadlessForm.useControlledState(props.checked, props.defaultChecked ?? false, props.onChange)
112
+
113
+ const {
114
+ validationMessage,
115
+ isInvalid: validationInvalid,
116
+ commitValidation
117
+ } = HeadlessForm.useValidation(
118
+ {
119
+ validate: props.validate,
120
+ value: checked,
121
+ name: props.name,
122
+ isRequired: props.isRequired,
123
+ form: props.form,
124
+ focus() {
125
+ hiddenInputRef.current?.closest('label')?.focus()
126
+ }
127
+ },
128
+ hiddenInputRef
129
+ )
130
+
131
+ const isInvalid = props.isInvalid || validationInvalid
132
+ const hasWarning = Boolean(props.warningMessage) && !isInvalid
133
+
134
+ return (
135
+ <AriaCheckbox
136
+ isSelected={checked}
137
+ isIndeterminate={props.isIndeterminate}
138
+ onChange={(v) => {
139
+ setChecked(v)
140
+ commitValidation()
141
+ }}
142
+ isDisabled={props.isDisabled}
143
+ isInvalid={isInvalid}
144
+ aria-describedby={helpTextId}
145
+ className="group relative flex items-start gap-3 select-none focus:outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-600"
146
+ >
147
+ {({ isSelected, isIndeterminate, isDisabled }) => (
148
+ <>
149
+ {props.isDisabled || !props.name ? null : (
150
+ <HeadlessForm.HiddenInput
151
+ ref={hiddenInputRef}
152
+ name={props.name}
153
+ form={props.form}
154
+ value={checked ? 'true' : 'false'}
155
+ />
156
+ )}
157
+ <div className="shrink-0">
158
+ <CheckboxBox isSelected={isSelected} isIndeterminate={isIndeterminate} isDisabled={isDisabled} />
159
+ </div>
160
+ <div className="flex flex-col justify-center">
161
+ <div className="flex items-center gap-2 justify-between">
162
+ <FormFieldComponents.Label as="span">{props.label}</FormFieldComponents.Label>
163
+ {props.cornerHint && <div className="text-sm text-neutral-500">{props.cornerHint}</div>}
164
+ </div>
165
+ <FormFieldComponents.FormFieldHelpText
166
+ id={helpTextId}
167
+ isInvalid={isInvalid}
168
+ validationMessage={validationMessage}
169
+ hasWarning={hasWarning}
170
+ warningMessage={props.warningMessage}
171
+ helpText={props.helpText}
172
+ UNSAFE_className="mt-0.5"
173
+ />
174
+ </div>
175
+ </>
176
+ )}
177
+ </AriaCheckbox>
178
+ )
179
+ }
180
+
181
+ LabeledCheckbox.displayName = 'LabeledCheckbox'
182
+
183
+ // ── Helper components ──────────────────────────────────────────────────────────
184
+
185
+ function CheckboxBox({
186
+ isSelected,
187
+ isIndeterminate,
188
+ isDisabled
189
+ }: {
190
+ isSelected: boolean
191
+ isIndeterminate: boolean
192
+ isDisabled: boolean
193
+ }) {
194
+ return (
195
+ <div
196
+ className={tw(
197
+ 'relative size-5 rounded border transition-colors duration-200',
198
+ isSelected || isIndeterminate ? 'bg-primary-600 border-primary-600' : 'bg-white border-neutral-300',
199
+ !isDisabled && !(isSelected || isIndeterminate) && 'group-hovered:border-neutral-400',
200
+ isDisabled && 'cursor-not-allowed border-neutral-300 bg-neutral-100'
201
+ )}
202
+ >
203
+ {isIndeterminate ? (
204
+ <Icon name="minus" className="h-5/6 absolute inset-0 m-auto aspect-square stroke-white text-white" />
205
+ ) : (
206
+ <Icon name="check" className="h-5/6 absolute inset-0 m-auto aspect-square stroke-white text-white" />
207
+ )}
208
+ </div>
209
+ )
210
+ }