@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,199 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add date-time-picker --directory app
3
+
4
+ import * as React from 'react'
5
+ import { DatePicker as AriaDatePicker, DateInput, DateSegment, Button, Dialog, I18nProvider } from 'react-aria-components'
6
+ import { AnimatedPopover } from './helpers/animated-popover'
7
+ import { CalendarDateTime, parseDateTime } from '@internationalized/date'
8
+ import { tw } from '../utils/tw'
9
+ import { FormFieldComponents } from './helpers/form-field'
10
+ import { Icon } from './icon'
11
+ import { HeadlessForm } from '@maestro-js/form'
12
+ import type { ValidationFunction, ValidationResult } from '@maestro-js/form'
13
+ import { CustomCalendar } from './helpers/calendar-month-year-picker'
14
+ import { dateFns, dateTimeFns, type Iso } from 'iso-fns'
15
+
16
+ export type DateTimePickerProps = {
17
+ // Form identification
18
+ name?: string
19
+ form?: string
20
+
21
+ // Display elements
22
+ label?: React.ReactNode
23
+ cornerHint?: React.ReactNode
24
+ helpText?: React.ReactNode
25
+ placeholder?: string
26
+ warningMessage?: React.ReactNode
27
+
28
+ // Validation and state
29
+ isRequired?: boolean
30
+ isDisabled?: boolean
31
+ isReadonly?: boolean
32
+ isInvalid?: boolean
33
+ validate?: ValidationFunction<Iso.DateTime | null>
34
+ errorMessage?: React.ReactNode | ((v: ValidationResult) => React.ReactNode)
35
+
36
+ // Value management (ISO datetime string e.g. 2024-01-15T09:30:00)
37
+ value?: Iso.DateTime | null
38
+ defaultValue?: Iso.DateTime | null
39
+ onChange?: (value: Iso.DateTime | null) => void
40
+
41
+ // Date/Time specific
42
+ minValue?: Iso.DateTime
43
+ maxValue?: Iso.DateTime
44
+ use24Hour?: boolean
45
+ minuteStep?: number
46
+ locale?: string
47
+ shape?: 'rectangle' | 'oval'
48
+ }
49
+
50
+ export function DateTimePicker(props: DateTimePickerProps) {
51
+ const hiddenInputRef = React.useRef<HTMLInputElement>(null)
52
+ const helpTextId = React.useId()
53
+ const labelId = React.useId()
54
+
55
+ // Internal state for CalendarDateTime
56
+ const [value, _setValue] = React.useState(() => {
57
+ try {
58
+ const startingValue = props.value === undefined ? (props.defaultValue ?? null) : props.value
59
+ return startingValue ? parseDateTime(startingValue) : null
60
+ } catch {
61
+ return null
62
+ }
63
+ })
64
+
65
+ function setValue(dt: CalendarDateTime | null) {
66
+ _setValue(dt)
67
+ if (!dt || dateTimeFns.isValid(dt.toString())) {
68
+ props.onChange && props.onChange(dt ? (dt.toString() as Iso.DateTime) : null)
69
+ }
70
+ commitValidation()
71
+ }
72
+
73
+ // Sync controlled value
74
+ if (props.value !== undefined) {
75
+ const currentValueAsIso = value && dateTimeFns.isValid(value.toString()) ? value.toString() : null
76
+ const propValue = props.value && dateTimeFns.isValid(props.value) ? props.value : null
77
+ if ((!value || dateTimeFns.isValid(value.toString())) && propValue !== currentValueAsIso) {
78
+ try {
79
+ _setValue(propValue ? parseDateTime(propValue) : null)
80
+ } catch {
81
+ _setValue(null)
82
+ }
83
+ }
84
+ }
85
+
86
+ // Convert min/max values
87
+ const minDateTime = React.useMemo(() => {
88
+ if (!props.minValue) return undefined
89
+ try {
90
+ return parseDateTime(props.minValue)
91
+ } catch {
92
+ return undefined
93
+ }
94
+ }, [props.minValue])
95
+
96
+ const maxDateTime = React.useMemo(() => {
97
+ if (!props.maxValue) return undefined
98
+ try {
99
+ return parseDateTime(props.maxValue)
100
+ } catch {
101
+ return undefined
102
+ }
103
+ }, [props.maxValue])
104
+
105
+ // Form validation
106
+ const {
107
+ validationMessage: validationMessageRaw,
108
+ isInvalid: validationInvalid,
109
+ commitValidation
110
+ } = HeadlessForm.useValidation(
111
+ {
112
+ validate: props.validate,
113
+ value: value && dateTimeFns.isValid(value.toString()) ? (value.toString() as Iso.DateTime) : null,
114
+ name: props.name,
115
+ isRequired: props.isRequired,
116
+ form: props.form,
117
+ focus() {
118
+ // Focus handled by AriaDatePicker
119
+ }
120
+ },
121
+ hiddenInputRef as React.RefObject<HTMLInputElement>
122
+ )
123
+
124
+ const lessThanMin =
125
+ props.minValue && value && dateTimeFns.isValid(value.toString()) ? value.toString() < props.minValue : false
126
+ const greaterThanMax =
127
+ props.maxValue && value && dateTimeFns.isValid(value.toString()) ? value.toString() > props.maxValue : false
128
+
129
+ const validationMessage =
130
+ validationMessageRaw ||
131
+ (lessThanMin ? `Cannot be before ${dateTimeFns.format(props.minValue!, 'MM/dd/yyyy h:mm a')}` : '') ||
132
+ (greaterThanMax ? `Cannot be after ${dateTimeFns.format(props.maxValue!, 'MM/dd/yyyy h:mm a')}` : '')
133
+
134
+ const isInvalid = props.isInvalid || validationInvalid || lessThanMin || greaterThanMax
135
+ const hasWarning = Boolean(props.warningMessage) && !isInvalid
136
+
137
+ return (
138
+ <I18nProvider locale={props.locale ?? 'en'}>
139
+ <div className="relative">
140
+ {/* Hidden input for form submission */}
141
+ <HeadlessForm.HiddenInput ref={hiddenInputRef} name={props.name} value={value?.toString() ?? ''} form={props.form} />
142
+
143
+ <FormFieldComponents.LabelRow label={props.label} cornerHint={props.cornerHint} labelId={labelId} />
144
+
145
+ <AriaDatePicker
146
+ value={value}
147
+ aria-labelledby={labelId}
148
+ aria-describedby={helpTextId}
149
+ onChange={setValue}
150
+ minValue={minDateTime}
151
+ maxValue={maxDateTime}
152
+ isDisabled={props.isDisabled}
153
+ isReadOnly={props.isReadonly}
154
+ isInvalid={isInvalid}
155
+ isRequired={props.isRequired}
156
+ granularity="minute"
157
+ hideTimeZone
158
+ hourCycle={props.use24Hour ? 24 : 12}
159
+ >
160
+ <FormFieldComponents.FieldGroup
161
+ isDisabled={props.isDisabled}
162
+ isReadonly={props.isReadonly}
163
+ isInvalid={isInvalid}
164
+ hasWarning={hasWarning}
165
+ shape={props.shape}
166
+ className="flex"
167
+ >
168
+ <DateInput className="flex-1 grow flex px-3 py-2 text-sm">
169
+ {(segment) => (
170
+ <DateSegment
171
+ segment={segment}
172
+ className={tw('px-0.5 tabular-nums outline-none rounded-sm', 'focus:bg-primary-500 focus:text-white')}
173
+ />
174
+ )}
175
+ </DateInput>
176
+ <Button className="flex items-center px-2 py-2">
177
+ <Icon name="calendar" className="h-4 w-4 text-neutral-400" />
178
+ </Button>
179
+ </FormFieldComponents.FieldGroup>
180
+
181
+ <AnimatedPopover>
182
+ <Dialog>
183
+ <CustomCalendar value={value} onChange={setValue} minValue={minDateTime} maxValue={maxDateTime} />
184
+ </Dialog>
185
+ </AnimatedPopover>
186
+ </AriaDatePicker>
187
+
188
+ <FormFieldComponents.FormFieldHelpText
189
+ id={helpTextId}
190
+ isInvalid={isInvalid}
191
+ validationMessage={validationMessage}
192
+ hasWarning={hasWarning}
193
+ warningMessage={props.warningMessage}
194
+ helpText={props.helpText}
195
+ />
196
+ </div>
197
+ </I18nProvider>
198
+ )
199
+ }
@@ -0,0 +1,114 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add dialog --directory app
3
+
4
+ import React from 'react'
5
+ import type { To, RelativeRoutingType } from 'react-router'
6
+ import { useNavigate } from 'react-router'
7
+ import { Modal, ModalOverlay, Dialog as AriaDialog, Heading } from 'react-aria-components'
8
+ import { tw } from '../utils/tw'
9
+ import { Button } from './button'
10
+
11
+ export type DialogProps = {
12
+ children?: React.ReactNode
13
+ title?: React.ReactNode
14
+ isOpen?: boolean
15
+ close?:
16
+ | ((isOpen: boolean) => void)
17
+ | { to: To; replace?: boolean; relative?: RelativeRoutingType; reloadDocument?: boolean }
18
+ size?: 'xs' | 'sm' | 'lg'
19
+ className?: string
20
+ isDismissable?: boolean
21
+ actions?: React.ReactNode
22
+ }
23
+
24
+ interface DialogContextValue {
25
+ close(): void
26
+ }
27
+
28
+ const DialogContext = React.createContext<DialogContextValue>({ close: () => undefined })
29
+
30
+ function Dialog_({
31
+ children,
32
+ title,
33
+ isOpen = false,
34
+ close,
35
+ size = 'sm',
36
+ className,
37
+ isDismissable = false,
38
+ actions
39
+ }: DialogProps) {
40
+ const navigate = useNavigate()
41
+
42
+ const onOpenChange = close
43
+ ? typeof close === 'function'
44
+ ? close
45
+ : (open: boolean) => {
46
+ if (!open) navigate(close.to, { replace: close.replace, relative: close.relative })
47
+ }
48
+ : undefined
49
+
50
+ return (
51
+ <ModalOverlay
52
+ isOpen={isOpen}
53
+ onOpenChange={onOpenChange}
54
+ isDismissable={isDismissable}
55
+ isKeyboardDismissDisabled={!isDismissable}
56
+ className={tw(
57
+ 'fixed inset-0 z-[2000] flex items-center justify-center bg-black/25 backdrop-blur-sm',
58
+ 'transition-opacity duration-300 ease-in-out',
59
+ 'data-[entering]:opacity-0',
60
+ 'data-[exiting]:opacity-0'
61
+ )}
62
+ >
63
+ <Modal
64
+ className={tw(
65
+ 'w-[calc(100%-4rem)] m-auto',
66
+ size === 'lg' ? 'max-w-[1080px]' : size === 'xs' ? 'max-w-[400px]' : 'max-w-[640px]',
67
+ 'transition-all duration-300 ease-in-out',
68
+ 'data-[entering]:scale-95 data-[entering]:opacity-0',
69
+ 'data-[exiting]:scale-95 data-[exiting]:opacity-0'
70
+ )}
71
+ >
72
+ <AriaDialog
73
+ className={tw(
74
+ 'w-full max-h-[calc(100vh-6rem)] bg-white shadow-xl ring-1 ring-black/5 outline-none rounded-xl',
75
+ 'flex flex-col overflow-x-hidden overflow-y-auto',
76
+ className
77
+ )}
78
+ >
79
+ {({ close }) => (
80
+ <DialogContext.Provider value={{ close }}>
81
+ <div className="flex items-start justify-between gap-4 pt-6 px-6">
82
+ {title ? (
83
+ <Heading slot="title" className="flex-1 text-lg font-semibold text-neutral-900">
84
+ {title}
85
+ </Heading>
86
+ ) : (
87
+ <div />
88
+ )}
89
+ </div>
90
+
91
+ <div className="flex flex-col gap-3 px-6 pb-6">
92
+ <div className="">{children}</div>
93
+ <div className="flex gap-2 items-start">{actions}</div>
94
+ </div>
95
+ </DialogContext.Provider>
96
+ )}
97
+ </AriaDialog>
98
+ </Modal>
99
+ </ModalOverlay>
100
+ )
101
+ }
102
+
103
+ function CancelButton({ children = 'Cancel' }: { children?: React.ReactNode }) {
104
+ const context = React.useContext(DialogContext)
105
+ return (
106
+ <Button color="neutral" onClick={context.close} variant="soft" shape="oval">
107
+ {children}
108
+ </Button>
109
+ )
110
+ }
111
+
112
+ export const Dialog = Object.assign(Dialog_, {
113
+ CancelButton
114
+ })
@@ -0,0 +1,33 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add enum-chip --directory app
3
+
4
+ import * as React from 'react'
5
+ import { Chip, type ChipProps } from './chip'
6
+ import { getColor, stringToNumber } from '../utils/enum-colors'
7
+
8
+ export type EnumChipProps = {
9
+ options: string[] | Readonly<string[]>
10
+ value: string
11
+ enumLabels?: { [key: string]: string }
12
+ } & Omit<ChipProps, 'children'>
13
+
14
+ export function EnumChip({ options, enumLabels, value, style, ...props }: EnumChipProps) {
15
+ const colorIndex = Object.values(options).indexOf(value)
16
+ const colorSeed = colorIndex >= 0 ? colorIndex : stringToNumber(value)
17
+ const color = getColor(colorSeed)
18
+
19
+ const label = value ? (enumLabels ? enumLabels[value] : value) : ''
20
+
21
+ return (
22
+ <Chip
23
+ {...props}
24
+ style={{
25
+ backgroundColor: `${color}19`,
26
+ color: color,
27
+ ...style
28
+ }}
29
+ >
30
+ {label}
31
+ </Chip>
32
+ )
33
+ }
@@ -0,0 +1,248 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add file-input --directory app
3
+
4
+ import * as React from 'react'
5
+ import { HeadlessForm } from '@maestro-js/form'
6
+ import type { ValidationFunction, ValidationResult } from '@maestro-js/form'
7
+ import { tw } from '../utils/tw'
8
+ import { formatFileSize, validateFileMaxSize, validateFileType } from '../utils/file-input'
9
+ import { FormFieldComponents } from './helpers/form-field'
10
+ import { HeadlessFileInput } from './headless-file-input'
11
+ import { Icon } from './icon'
12
+
13
+ export type FileInputProps = {
14
+ // Form identification
15
+ name?: string
16
+ form?: string
17
+
18
+ // Display elements
19
+ label?: React.ReactNode
20
+ cornerHint?: React.ReactNode
21
+ helpText?: React.ReactNode
22
+ warningMessage?: React.ReactNode
23
+ renderPreview?: (props: FileInputPreviewProps) => React.ReactNode
24
+
25
+ // Validation and state
26
+ isRequired?: boolean
27
+ isDisabled?: boolean
28
+ isInvalid?: boolean
29
+ validate?: ValidationFunction<string | File | null>
30
+ errorMessage?: React.ReactNode | ((v: ValidationResult) => React.ReactNode)
31
+
32
+ // Value management (File object or string URL, held in memory until form submit)
33
+ value?: string | File | null
34
+ defaultValue?: string | File | null
35
+ onChange?: (value: string | File | null, hasError: boolean) => void
36
+
37
+ // File specific
38
+ accept?: string
39
+ maxSize?: number // in bytes
40
+ }
41
+
42
+ export interface FileInputPreviewProps {
43
+ file: File | null
44
+ fileUrl: string | null
45
+ isDisabled: boolean
46
+ onChange(value: string | null | File): unknown
47
+ inputId: string
48
+ name: string | undefined
49
+ accept: string | undefined
50
+ inputRef: React.Ref<HTMLInputElement>
51
+ formatFileSize: (bytes: number) => string
52
+ setDragging: (dragging: boolean) => void
53
+ maxSize?: number
54
+ }
55
+
56
+ export function FileInput(props: FileInputProps) {
57
+ const inputRef = React.useRef<HTMLInputElement>(null)
58
+ const helpTextId = React.useId()
59
+ const inputId = React.useId()
60
+ const [, setDragging] = React.useState(false)
61
+
62
+ // Controlled state management
63
+ const [value, setValue] = HeadlessForm.useControlledState(props.value, props.defaultValue ?? null, (value) => {
64
+ if (props.onChange) {
65
+ props.onChange(value, Boolean(validateFileMaxSize(value, props.maxSize) || validateFileType(value, props.accept)))
66
+ }
67
+ })
68
+
69
+ const exceededMaxSize = React.useMemo(() => validateFileMaxSize(value, props.maxSize), [value, props.maxSize])
70
+ const formatNotSupported = React.useMemo(() => validateFileType(value, props.accept), [value, props.accept])
71
+
72
+ // Form validation
73
+ const {
74
+ validationMessage,
75
+ isInvalid: validationInvalid,
76
+ commitValidation
77
+ } = HeadlessForm.useValidation(
78
+ {
79
+ validate: props.validate,
80
+ value,
81
+ name: props.name,
82
+ isRequired: props.isRequired,
83
+ form: props.form,
84
+ focus() {
85
+ inputRef.current?.focus()
86
+ }
87
+ },
88
+ inputRef
89
+ )
90
+
91
+ const isInvalid = props.isInvalid || validationInvalid || Boolean(exceededMaxSize || formatNotSupported)
92
+ const hasWarning = Boolean(props.warningMessage) && !isInvalid
93
+ const errorMessage = exceededMaxSize || formatNotSupported || validationMessage
94
+
95
+ const FilePreview = props.renderPreview ?? DefaultFileInputFilePreview
96
+
97
+ return (
98
+ <HeadlessFileInput
99
+ value={value}
100
+ onChange={(v) => {
101
+ setValue(v)
102
+ commitValidation()
103
+ }}
104
+ >
105
+ <div className="relative">
106
+ <FormFieldComponents.LabelRow label={props.label} cornerHint={props.cornerHint} htmlFor={inputId} />
107
+
108
+ <HeadlessFileInput.Preview>
109
+ {(files) => {
110
+ const file = files.length !== 0 ? files[0]!.file : null
111
+ const fileUrl = files.length !== 0 ? files[0]!.fileUrl : null
112
+
113
+ return (
114
+ <div
115
+ className={tw(
116
+ 'relative',
117
+ hasWarning &&
118
+ '[&_.file-preview-border]:border-notice-300 [&_.file-preview-border]:hover:border-notice-400 [&_.file-preview-border]:text-notice-900 [&_.file-preview-border]:placeholder-notice-300 [&_.file-preview-border]:focus-within:border-notice-500 [&_.file-preview-border]:focus-within:ring-notice-500',
119
+ isInvalid &&
120
+ '[&_.file-preview-border]:border-negative-300 [&_.file-preview-border]:hover:border-negative-400 [&_.file-preview-border]:text-negative-900 [&_.file-preview-border]:placeholder-negative-300 [&_.file-preview-border]:focus-within:border-negative-500 [&_.file-preview-border]:focus-within:ring-negative-500'
121
+ )}
122
+ >
123
+ {FilePreview({
124
+ file,
125
+ fileUrl,
126
+ isDisabled: !!props.isDisabled,
127
+ onChange: (v) => {
128
+ setValue(v)
129
+ commitValidation()
130
+ },
131
+ inputId,
132
+ inputRef,
133
+ name: props.name,
134
+ accept: props.accept,
135
+ formatFileSize,
136
+ setDragging,
137
+ maxSize: props.maxSize
138
+ })}
139
+ </div>
140
+ )
141
+ }}
142
+ </HeadlessFileInput.Preview>
143
+
144
+ <FormFieldComponents.FormFieldHelpText
145
+ id={helpTextId}
146
+ isInvalid={isInvalid}
147
+ validationMessage={errorMessage}
148
+ hasWarning={hasWarning}
149
+ warningMessage={props.warningMessage}
150
+ helpText={props.helpText}
151
+ />
152
+ </div>
153
+ </HeadlessFileInput>
154
+ )
155
+ }
156
+
157
+ function DragOverContent() {
158
+ return (
159
+ <div
160
+ className="absolute inset-0 p-12 rounded flex items-center justify-center"
161
+ style={{
162
+ background: `repeating-linear-gradient(45deg, #e5e7eb, #e5e7eb 20px, #d1d5db 20px, #d1d5db 50px)`
163
+ }}
164
+ >
165
+ <div>
166
+ <Icon name="cloud-arrow-up" className="h-12 w-12 mx-auto text-gray-400" />
167
+ <span className="mt-2 block text-sm font-semibold text-gray-900">Upload a File</span>
168
+ </div>
169
+ </div>
170
+ )
171
+ }
172
+
173
+ export function DefaultFileInputFilePreview({
174
+ file,
175
+ isDisabled,
176
+ onChange,
177
+ inputId,
178
+ name,
179
+ accept,
180
+ formatFileSize,
181
+ setDragging,
182
+ maxSize
183
+ }: FileInputPreviewProps) {
184
+ return (
185
+ <>
186
+ <HeadlessFileInput.DropZone
187
+ accept={accept}
188
+ name={name}
189
+ inputId={inputId}
190
+ onDragChange={setDragging}
191
+ disabled={isDisabled}
192
+ >
193
+ {({ dragOver }) => (
194
+ <div
195
+ className={tw(
196
+ 'file-preview-border relative block w-full rounded-md text-center focus:outline-none focus-within:ring-2 focus-within:ring-primary-500 focus-within:ring-offset-2',
197
+ 'border-2 border-neutral-200 hover:border-neutral-300',
198
+ file ? '' : 'border-dashed',
199
+ isDisabled && 'border-neutral-100 cursor-not-allowed'
200
+ )}
201
+ >
202
+ {file ? (
203
+ <div className="relative text-left">
204
+ <div className="flex items-center justify-between p-3 rounded">
205
+ <div className="flex items-center gap-3">
206
+ <Icon name="document" className="h-8 w-8 text-neutral-400" />
207
+ <div>
208
+ <p className="text-sm font-medium text-neutral-900">{file.name || 'File'}</p>
209
+ <p className="text-xs text-neutral-500">{formatFileSize(file.size)}</p>
210
+ </div>
211
+ </div>
212
+ </div>
213
+ {dragOver && <DragOverContent />}
214
+ </div>
215
+ ) : dragOver ? (
216
+ <DragOverContent />
217
+ ) : (
218
+ <div className="flex items-center justify-between p-3">
219
+ <div className="flex items-center gap-3">
220
+ <Icon name="cloud-arrow-up" className="h-8 w-8 text-neutral-400" />
221
+ <div className="text-left">
222
+ <p className="text-sm text-neutral-600 font-medium">Click to upload or drag and drop</p>
223
+ <div className="text-xs text-neutral-500 mt-0.5">
224
+ {accept && <span>{accept}</span>}
225
+ {accept && maxSize && <span> • </span>}
226
+ {maxSize && <span>Max: {formatFileSize(maxSize)}</span>}
227
+ </div>
228
+ </div>
229
+ </div>
230
+ </div>
231
+ )}
232
+ </div>
233
+ )}
234
+ </HeadlessFileInput.DropZone>
235
+
236
+ {file && !isDisabled && (
237
+ <button
238
+ type="button"
239
+ aria-label="Remove file"
240
+ onClick={() => onChange(null)}
241
+ className="absolute top-1/2 -translate-y-1/2 right-3 p-1 hover:bg-neutral-50 rounded transition-colors"
242
+ >
243
+ <Icon name="x-mark" className="h-5 w-5 text-neutral-500" />
244
+ </button>
245
+ )}
246
+ </>
247
+ )
248
+ }
@@ -0,0 +1,106 @@
1
+ // From @maestro-js/components
2
+ // Install with: pnpm maestro components:add form --directory app
3
+
4
+ import {
5
+ type FormProps as ReactRouterFormProps,
6
+ Form as ReactRouterForm,
7
+ data,
8
+ type ClientActionFunctionArgs
9
+ } from 'react-router'
10
+ import { HeadlessForm, type StandardSchema, type ParseFormDataOptions, type ParseFormDataResult } from '@maestro-js/form'
11
+ import { serverOnly$ } from 'vite-env-only/macros'
12
+
13
+ function _Form({ children, ...props }: ReactRouterFormProps) {
14
+ return (
15
+ <HeadlessForm as={ReactRouterForm} {...props}>
16
+ {children}
17
+ </HeadlessForm>
18
+ )
19
+ }
20
+
21
+ export const Form = Object.assign(_Form, {
22
+ HiddenInput: HeadlessForm.HiddenInput,
23
+ HiddenFileInput: HeadlessForm.HiddenFileInput,
24
+ HiddenSelect: HeadlessForm.HiddenSelect,
25
+ useControlledState: HeadlessForm.useControlledState,
26
+ useTopLevelFormValidation: HeadlessForm.useTopLevelFormValidation,
27
+ useReset: HeadlessForm.useReset,
28
+ clientSafeParse: HeadlessForm.parseFormDataClientSide,
29
+ serverSafeParse<T>(
30
+ schema: StandardSchema<T, T>,
31
+ formData: FormData | Promise<FormData>,
32
+ options?: {
33
+ handleFile: ParseFormDataOptions<T>['handleFile']
34
+ }
35
+ ): Promise<ParseFormDataResult<T>> {
36
+ return HeadlessForm.parseFormData(schema, formData, {
37
+ ...options,
38
+ jsonSchemaLibraryOptions: {
39
+ unrepresentable: 'any',
40
+ override: (ctx) => {
41
+ const meta = ctx.zodSchema.meta()
42
+ const custom = meta?.jsonSchema
43
+
44
+ if (custom && typeof custom === 'object') {
45
+ Object.assign(ctx.jsonSchema, custom)
46
+ }
47
+ }
48
+ }
49
+ })
50
+ },
51
+ validationError: serverOnly$(validationError) as typeof validationError,
52
+ customValidationError: serverOnly$(customValidationError) as typeof customValidationError,
53
+ composeValidators: HeadlessForm.composeValidators,
54
+ FormError
55
+ })
56
+
57
+ async function validationError(
58
+ {
59
+ issues,
60
+ formData,
61
+ formId
62
+ }: {
63
+ issues: { path?: ((string | number | symbol) | { key: string | number | symbol })[] | undefined; message: string }[]
64
+ formData: FormData
65
+ formId?: string | null
66
+ },
67
+ init: RequestInit = {}
68
+ ) {
69
+ console.error(issues)
70
+ return data(
71
+ {
72
+ success: false as const,
73
+ formSubmissionError: {
74
+ issues: issues.map((i) => ({
75
+ path: i.path?.map((p) => (p && typeof p === 'object' && 'key' in p ? p.key : p))?.join('.') ?? '',
76
+ message: i.message
77
+ })),
78
+ formId: formId ?? formData.get('__formId')
79
+ }
80
+ },
81
+ { status: 422, ...init }
82
+ )
83
+ }
84
+
85
+ async function customValidationError(
86
+ { message, formData }: { message: string; formData: FormData },
87
+ init?: number | ResponseInit
88
+ ) {
89
+ console.error(message)
90
+ return data(
91
+ {
92
+ success: false as const,
93
+ formSubmissionError: {
94
+ issues: [{ path: '', message: message }],
95
+ formId: formData.get('__formId')
96
+ }
97
+ },
98
+ { status: typeof init === 'number' ? init : 422, ...(typeof init === 'object' ? init : {}) }
99
+ )
100
+ }
101
+
102
+ function FormError({ formId, children }: { formId?: string; children(message: string): React.ReactNode }) {
103
+ const serverErrors = HeadlessForm.useServerErrors(formId)
104
+ const formErrors = serverErrors.filter((s) => !s.path)
105
+ return formErrors.length ? <>{children(formErrors[0]!.message)}</> : null
106
+ }