Sco 2852 drag and drop of blocks

.cursor/rules/function-naming.mdc

@@ -0,0 +1,53 @@
+---
+description: Function and method naming conventions for backend, frontend, and shared code
+globs: src/**/*.{ts,vue}
+alwaysApply: false
+---
+
+# Function Naming
+
+Follow [docs/function-naming.md](../../docs/function-naming.md) for full detail.
+Summary for agents writing or reviewing code:
+
+## Principles
+
+- camelCase for all functions/methods
+- Class/module name supplies the noun; methods use verbs
+- Prefix signals intent; do not mass-rename legacy code
+
+## Shared
+
+| Prefix | Use |
+|---|---|
+| `isX` / `hasX` / `canX` | Boolean predicates |
+| `toX` | Pure converters |
+| `getX` / `fetchX` / `loadX` / `findX` | Retrieval; omit `get`/`fetch` when bare domain name is clear (`blockKind`, `previousDevotionChapterBlocks`) |
+| `parseX` / `normalizeX` / `normalizedX` / `formatX` | Parse; `normalizedX` = pure return transform; `normalizeX` = in-place/async processing |
+| `buildX` | Assemble complex objects |
+| `XFromY` / `XForY` | Derive from source / scoped to context |
+| `*BlockedMessages` / `blockingX` | Validation blockers |
+| `compareX` / `sortX` | Sort helpers |
+
+## Frontend
+
+- **Pinia:** `setX`, `clearX`, `addX`, `removeX`, `toggleX`; boolean state as `isX`/`hasX` computed refs
+- **Composables:** export `useX()` matching `use-*.ts` filename
+- **Template handlers:** `onX` (`onFilter`, `onDragStart`, `onRemove`) — not `handleX`
+- **Page commands:** bare verbs (`saveStory`, `addPage`, `publishDraft`)
+- **Form payloads:** `getPayload()` or `buildXPayload()`
+- **Avoid:** `setIsDirty` → prefer `setDirty` or `markDirty`
+
+## Backend
+
+- **Services:** bare CRUD on `*Service` classes; `listX`, `fetchX`, shared derivation patterns
+- **Controllers:** REST (`index`, `store`, `destroy`) + domain verbs (`publish`, `toggleBookmark`); prefer `destroy` over `delete` for new resources
+- **Validators:** `*Validator.validate()` or camelCase vine exports
+- **Middleware:** `handle(ctx, next)`
+- **Models:** getters for derived shape; instance methods for mutations
+
+## Legacy (do not copy in new code)
+
+- `handle*` event handlers → use `onX`
+- `subscribed()` → `isSubscribed()`
+- `Analytics` class name (not `*Service`)
+- Stories `delete` action (prefer `destroy`)

.cursor/rules/vue-components.mdc

@@ -58,6 +58,23 @@ const emit = defineEmits<{
 }>();
 ```
 
+### Event Handlers
+
+Follow [function-naming.md](../../docs/function-naming.md) for full conventions.
+
+- Use **`onX`** for handlers bound in the template (`@click`, `@keydown`, drag/drop, child emits)
+- Use **bare domain verbs** for page-level commands not tied to a single DOM event (`saveStory`, `addPage`)
+- Do not introduce new **`handleX`** handlers; rename to `onX` when editing legacy code
+
+```typescript
+// template-bound
+const onFilter = (query: string) => { /* ... */ };
+const onDragStart = () => { /* ... */ };
+
+// page command
+const saveStory = () => router.post(/* ... */);
+```
+
 ## State Management
 
 ### Store Usage