+274

src/forms/form-builder.ts

reviewed

··· 1 1 + /** 2 2 + * Form Builder — question types and form construction. 3 3 + * 4 4 + * Pure logic module: form schema, question CRUD, validation, submission. 5 5 + * DOM rendering handled by the forms UI layer. 6 6 + */ 7 7 + 8 8 + export type QuestionType = 9 9 + | 'short_text' 10 10 + | 'long_text' 11 11 + | 'number' 12 12 + | 'email' 13 13 + | 'url' 14 14 + | 'single_choice' 15 15 + | 'multiple_choice' 16 16 + | 'dropdown' 17 17 + | 'date' 18 18 + | 'rating' 19 19 + | 'scale' 20 20 + | 'file_upload'; 21 21 + 22 22 + export interface QuestionOption { 23 23 + id: string; 24 24 + label: string; 25 25 + } 26 26 + 27 27 + export interface Question { 28 28 + id: string; 29 29 + type: QuestionType; 30 30 + label: string; 31 31 + description: string; 32 32 + required: boolean; 33 33 + options: QuestionOption[]; 34 34 + /** For scale/rating: min and max */ 35 35 + scaleMin?: number; 36 36 + scaleMax?: number; 37 37 + /** Validation pattern (regex string) */ 38 38 + validationPattern?: string; 39 39 + } 40 40 + 41 41 + export interface FormSchema { 42 42 + id: string; 43 43 + title: string; 44 44 + description: string; 45 45 + questions: Question[]; 46 46 + /** Target sheet ID for responses */ 47 47 + targetSheetId: string | null; 48 48 + createdAt: number; 49 49 + updatedAt: number; 50 50 + } 51 51 + 52 52 + export interface FormResponse { 53 53 + formId: string; 54 54 + answers: Map<string, unknown>; 55 55 + submittedAt: number; 56 56 + } 57 57 + 58 58 + let _formCounter = 0; 59 59 + let _questionCounter = 0; 60 60 + let _optionCounter = 0; 61 61 + 62 62 + /** 63 63 + * Create a new empty form. 64 64 + */ 65 65 + export function createForm(title: string, description = ''): FormSchema { 66 66 + const now = Date.now(); 67 67 + return { 68 68 + id: `form-${now}-${++_formCounter}`, 69 69 + title, 70 70 + description, 71 71 + questions: [], 72 72 + targetSheetId: null, 73 73 + createdAt: now, 74 74 + updatedAt: now, 75 75 + }; 76 76 + } 77 77 + 78 78 + /** 79 79 + * Add a question to the form. 80 80 + */ 81 81 + export function addQuestion( 82 82 + form: FormSchema, 83 83 + type: QuestionType, 84 84 + label: string, 85 85 + options: Partial<Pick<Question, 'description' | 'required' | 'options' | 'scaleMin' | 'scaleMax' | 'validationPattern'>> = {}, 86 86 + ): FormSchema { 87 87 + const question: Question = { 88 88 + id: `q-${Date.now()}-${++_questionCounter}`, 89 89 + type, 90 90 + label, 91 91 + description: options.description ?? '', 92 92 + required: options.required ?? false, 93 93 + options: options.options ?? [], 94 94 + scaleMin: options.scaleMin, 95 95 + scaleMax: options.scaleMax, 96 96 + validationPattern: options.validationPattern, 97 97 + }; 98 98 + return { 99 99 + ...form, 100 100 + questions: [...form.questions, question], 101 101 + updatedAt: Date.now(), 102 102 + }; 103 103 + } 104 104 + 105 105 + /** 106 106 + * Remove a question from the form. 107 107 + */ 108 108 + export function removeQuestion(form: FormSchema, questionId: string): FormSchema { 109 109 + return { 110 110 + ...form, 111 111 + questions: form.questions.filter(q => q.id !== questionId), 112 112 + updatedAt: Date.now(), 113 113 + }; 114 114 + } 115 115 + 116 116 + /** 117 117 + * Update a question's properties. 118 118 + */ 119 119 + export function updateQuestion( 120 120 + form: FormSchema, 121 121 + questionId: string, 122 122 + updates: Partial<Omit<Question, 'id'>>, 123 123 + ): FormSchema { 124 124 + return { 125 125 + ...form, 126 126 + questions: form.questions.map(q => 127 127 + q.id === questionId ? { ...q, ...updates } : q, 128 128 + ), 129 129 + updatedAt: Date.now(), 130 130 + }; 131 131 + } 132 132 + 133 133 + /** 134 134 + * Reorder a question (move to new index). 135 135 + */ 136 136 + export function moveQuestion( 137 137 + form: FormSchema, 138 138 + questionId: string, 139 139 + toIndex: number, 140 140 + ): FormSchema { 141 141 + const fromIndex = form.questions.findIndex(q => q.id === questionId); 142 142 + if (fromIndex === -1) return form; 143 143 + const clamped = Math.max(0, Math.min(toIndex, form.questions.length - 1)); 144 144 + const questions = [...form.questions]; 145 145 + const [moved] = questions.splice(fromIndex, 1); 146 146 + questions.splice(clamped, 0, moved); 147 147 + return { ...form, questions, updatedAt: Date.now() }; 148 148 + } 149 149 + 150 150 + /** 151 151 + * Create an option for choice questions. 152 152 + */ 153 153 + export function createOption(label: string): QuestionOption { 154 154 + return { id: `opt-${Date.now()}-${++_optionCounter}`, label }; 155 155 + } 156 156 + 157 157 + /** 158 158 + * Add an option to a choice question. 159 159 + */ 160 160 + export function addOption( 161 161 + form: FormSchema, 162 162 + questionId: string, 163 163 + label: string, 164 164 + ): FormSchema { 165 165 + return updateQuestion(form, questionId, { 166 166 + options: [ 167 167 + ...(form.questions.find(q => q.id === questionId)?.options ?? []), 168 168 + createOption(label), 169 169 + ], 170 170 + }); 171 171 + } 172 172 + 173 173 + /** 174 174 + * Set the target sheet for responses. 175 175 + */ 176 176 + export function setTargetSheet(form: FormSchema, sheetId: string | null): FormSchema { 177 177 + return { ...form, targetSheetId: sheetId, updatedAt: Date.now() }; 178 178 + } 179 179 + 180 180 + /** 181 181 + * Validate a single answer against its question. 182 182 + */ 183 183 + export function validateAnswer(question: Question, answer: unknown): string | null { 184 184 + // Required check 185 185 + if (question.required && (answer === null || answer === undefined || answer === '')) { 186 186 + return 'This field is required'; 187 187 + } 188 188 + 189 189 + // Allow empty for non-required 190 190 + if (answer === null || answer === undefined || answer === '') return null; 191 191 + 192 192 + const str = String(answer); 193 193 + 194 194 + switch (question.type) { 195 195 + case 'email': 196 196 + if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(str)) return 'Invalid email address'; 197 197 + break; 198 198 + case 'url': 199 199 + if (!/^https?:\/\/[^\s]+$/.test(str)) return 'Invalid URL'; 200 200 + break; 201 201 + case 'number': 202 202 + if (isNaN(Number(str))) return 'Must be a number'; 203 203 + break; 204 204 + case 'date': 205 205 + if (isNaN(new Date(str).getTime())) return 'Invalid date'; 206 206 + break; 207 207 + case 'single_choice': 208 208 + case 'dropdown': 209 209 + if (!question.options.some(o => o.id === str || o.label === str)) return 'Invalid choice'; 210 210 + break; 211 211 + case 'rating': 212 212 + case 'scale': { 213 213 + const num = Number(str); 214 214 + const min = question.scaleMin ?? 1; 215 215 + const max = question.scaleMax ?? 5; 216 216 + if (isNaN(num) || num < min || num > max) return `Must be between ${min} and ${max}`; 217 217 + break; 218 218 + } 219 219 + } 220 220 + 221 221 + // Custom validation pattern 222 222 + if (question.validationPattern) { 223 223 + try { 224 224 + if (!new RegExp(question.validationPattern).test(str)) return 'Invalid format'; 225 225 + } catch { 226 226 + // Invalid pattern, skip 227 227 + } 228 228 + } 229 229 + 230 230 + return null; 231 231 + } 232 232 + 233 233 + /** 234 234 + * Validate an entire form submission. 235 235 + */ 236 236 + export function validateSubmission( 237 237 + form: FormSchema, 238 238 + answers: Map<string, unknown>, 239 239 + ): Map<string, string> { 240 240 + const errors = new Map<string, string>(); 241 241 + for (const q of form.questions) { 242 242 + const error = validateAnswer(q, answers.get(q.id)); 243 243 + if (error) errors.set(q.id, error); 244 244 + } 245 245 + return errors; 246 246 + } 247 247 + 248 248 + /** 249 249 + * Count questions in the form. 250 250 + */ 251 251 + export function questionCount(form: FormSchema): number { 252 252 + return form.questions.length; 253 253 + } 254 254 + 255 255 + /** 256 256 + * Count required questions. 257 257 + */ 258 258 + export function requiredCount(form: FormSchema): number { 259 259 + return form.questions.filter(q => q.required).length; 260 260 + } 261 261 + 262 262 + /** 263 263 + * Duplicate a form with a new ID. 264 264 + */ 265 265 + export function duplicateForm(form: FormSchema): FormSchema { 266 266 + const now = Date.now(); 267 267 + return { 268 268 + ...form, 269 269 + id: `form-${now}-${++_formCounter}`, 270 270 + title: `${form.title} (Copy)`, 271 271 + createdAt: now, 272 272 + updatedAt: now, 273 273 + }; 274 274 + }

+182

src/lib/cross-doc-links.ts

reviewed

··· 1 1 + /** 2 2 + * Cross-Document Links — manage references between docs, sheets, and forms. 3 3 + * 4 4 + * Pure logic module: link creation, resolution, graph traversal. 5 5 + * Live syncing handled by the collaboration layer. 6 6 + */ 7 7 + 8 8 + export type DocType = 'doc' | 'sheet' | 'form' | 'slide'; 9 9 + 10 10 + export interface CrossDocLink { 11 11 + id: string; 12 12 + sourceId: string; 13 13 + sourceType: DocType; 14 14 + targetId: string; 15 15 + targetType: DocType; 16 16 + /** Label displayed for the link */ 17 17 + label: string; 18 18 + /** Position in source document */ 19 19 + position: number; 20 20 + createdAt: number; 21 21 + } 22 22 + 23 23 + export interface LinkGraph { 24 24 + links: CrossDocLink[]; 25 25 + } 26 26 + 27 27 + let _linkCounter = 0; 28 28 + 29 29 + /** 30 30 + * Create empty link graph. 31 31 + */ 32 32 + export function createLinkGraph(): LinkGraph { 33 33 + return { links: [] }; 34 34 + } 35 35 + 36 36 + /** 37 37 + * Add a cross-document link. 38 38 + */ 39 39 + export function addLink( 40 40 + graph: LinkGraph, 41 41 + sourceId: string, 42 42 + sourceType: DocType, 43 43 + targetId: string, 44 44 + targetType: DocType, 45 45 + label: string, 46 46 + position = 0, 47 47 + ): LinkGraph { 48 48 + const link: CrossDocLink = { 49 49 + id: `link-${Date.now()}-${++_linkCounter}`, 50 50 + sourceId, 51 51 + sourceType, 52 52 + targetId, 53 53 + targetType, 54 54 + label, 55 55 + position, 56 56 + createdAt: Date.now(), 57 57 + }; 58 58 + return { links: [...graph.links, link] }; 59 59 + } 60 60 + 61 61 + /** 62 62 + * Remove a link by ID. 63 63 + */ 64 64 + export function removeLink(graph: LinkGraph, linkId: string): LinkGraph { 65 65 + return { links: graph.links.filter(l => l.id !== linkId) }; 66 66 + } 67 67 + 68 68 + /** 69 69 + * Get all outgoing links from a document. 70 70 + */ 71 71 + export function outgoingLinks(graph: LinkGraph, sourceId: string): CrossDocLink[] { 72 72 + return graph.links.filter(l => l.sourceId === sourceId); 73 73 + } 74 74 + 75 75 + /** 76 76 + * Get all incoming links to a document (backlinks). 77 77 + */ 78 78 + export function incomingLinks(graph: LinkGraph, targetId: string): CrossDocLink[] { 79 79 + return graph.links.filter(l => l.targetId === targetId); 80 80 + } 81 81 + 82 82 + /** 83 83 + * Get all documents linked to or from a document (both directions). 84 84 + */ 85 85 + export function connectedDocIds(graph: LinkGraph, docId: string): string[] { 86 86 + const ids = new Set<string>(); 87 87 + for (const link of graph.links) { 88 88 + if (link.sourceId === docId) ids.add(link.targetId); 89 89 + if (link.targetId === docId) ids.add(link.sourceId); 90 90 + } 91 91 + return [...ids]; 92 92 + } 93 93 + 94 94 + /** 95 95 + * Check if two documents are linked (either direction). 96 96 + */ 97 97 + export function areLinked(graph: LinkGraph, docA: string, docB: string): boolean { 98 98 + return graph.links.some( 99 99 + l => 100 100 + (l.sourceId === docA && l.targetId === docB) || 101 101 + (l.sourceId === docB && l.targetId === docA), 102 102 + ); 103 103 + } 104 104 + 105 105 + /** 106 106 + * Find all links between two specific documents. 107 107 + */ 108 108 + export function linksBetween( 109 109 + graph: LinkGraph, 110 110 + docA: string, 111 111 + docB: string, 112 112 + ): CrossDocLink[] { 113 113 + return graph.links.filter( 114 114 + l => 115 115 + (l.sourceId === docA && l.targetId === docB) || 116 116 + (l.sourceId === docB && l.targetId === docA), 117 117 + ); 118 118 + } 119 119 + 120 120 + /** 121 121 + * Count links by document type. 122 122 + */ 123 123 + export function linkCountByType(graph: LinkGraph): Record<string, number> { 124 124 + const counts: Record<string, number> = {}; 125 125 + for (const link of graph.links) { 126 126 + const key = `${link.sourceType}->${link.targetType}`; 127 127 + counts[key] = (counts[key] || 0) + 1; 128 128 + } 129 129 + return counts; 130 130 + } 131 131 + 132 132 + /** 133 133 + * Get unique document IDs in the graph. 134 134 + */ 135 135 + export function allDocIds(graph: LinkGraph): string[] { 136 136 + const ids = new Set<string>(); 137 137 + for (const link of graph.links) { 138 138 + ids.add(link.sourceId); 139 139 + ids.add(link.targetId); 140 140 + } 141 141 + return [...ids]; 142 142 + } 143 143 + 144 144 + /** 145 145 + * Find orphan documents (no incoming links). 146 146 + */ 147 147 + export function orphanDocs(graph: LinkGraph, allDocs: string[]): string[] { 148 148 + const hasIncoming = new Set<string>(); 149 149 + for (const link of graph.links) { 150 150 + hasIncoming.add(link.targetId); 151 151 + } 152 152 + return allDocs.filter(id => !hasIncoming.has(id)); 153 153 + } 154 154 + 155 155 + /** 156 156 + * Remove all links involving a document (when document is deleted). 157 157 + */ 158 158 + export function removeDocLinks(graph: LinkGraph, docId: string): LinkGraph { 159 159 + return { 160 160 + links: graph.links.filter(l => l.sourceId !== docId && l.targetId !== docId), 161 161 + }; 162 162 + } 163 163 + 164 164 + /** 165 165 + * Update a link's label. 166 166 + */ 167 167 + export function updateLinkLabel( 168 168 + graph: LinkGraph, 169 169 + linkId: string, 170 170 + label: string, 171 171 + ): LinkGraph { 172 172 + return { 173 173 + links: graph.links.map(l => (l.id === linkId ? { ...l, label } : l)), 174 174 + }; 175 175 + } 176 176 + 177 177 + /** 178 178 + * Total link count. 179 179 + */ 180 180 + export function totalLinks(graph: LinkGraph): number { 181 181 + return graph.links.length; 182 182 + }

+185

src/lib/sheet-embed.ts

reviewed

··· 1 1 + /** 2 2 + * Sheet Range Embed — embed live sheet ranges in documents. 3 3 + * 4 4 + * Pure logic module: embed config, range parsing, data snapshot. 5 5 + * DOM rendering and live sync handled by the UI/provider layer. 6 6 + */ 7 7 + 8 8 + export interface CellRange { 9 9 + startCol: number; 10 10 + startRow: number; 11 11 + endCol: number; 12 12 + endRow: number; 13 13 + } 14 14 + 15 15 + export interface SheetEmbed { 16 16 + id: string; 17 17 + /** Source sheet document ID */ 18 18 + sheetId: string; 19 19 + /** Human-readable range like "A1:D10" */ 20 20 + rangeStr: string; 21 21 + /** Parsed range */ 22 22 + range: CellRange; 23 23 + /** Position in target document (character offset) */ 24 24 + position: number; 25 25 + /** Show column headers */ 26 26 + showHeaders: boolean; 27 27 + /** Show row numbers */ 28 28 + showRowNumbers: boolean; 29 29 + } 30 30 + 31 31 + export interface EmbedSnapshot { 32 32 + embedId: string; 33 33 + /** 2D array of display values [row][col] */ 34 34 + values: string[][]; 35 35 + /** Column headers */ 36 36 + headers: string[]; 37 37 + updatedAt: number; 38 38 + } 39 39 + 40 40 + let _embedCounter = 0; 41 41 + 42 42 + /** 43 43 + * Parse a range string like "A1:D10" into a CellRange. 44 44 + */ 45 45 + export function parseRange(rangeStr: string): CellRange | null { 46 46 + const match = rangeStr.match(/^([A-Z]+)(\d+):([A-Z]+)(\d+)$/i); 47 47 + if (!match) return null; 48 48 + 49 49 + const startCol = letterToCol(match[1].toUpperCase()); 50 50 + const startRow = parseInt(match[2], 10); 51 51 + const endCol = letterToCol(match[3].toUpperCase()); 52 52 + const endRow = parseInt(match[4], 10); 53 53 + 54 54 + if (startCol > endCol || startRow > endRow) return null; 55 55 + 56 56 + return { startCol, startRow, endCol, endRow }; 57 57 + } 58 58 + 59 59 + /** 60 60 + * Convert column letter(s) to zero-based index. 61 61 + */ 62 62 + export function letterToCol(letter: string): number { 63 63 + let col = 0; 64 64 + for (let i = 0; i < letter.length; i++) { 65 65 + col = col * 26 + (letter.charCodeAt(i) - 64); 66 66 + } 67 67 + return col - 1; 68 68 + } 69 69 + 70 70 + /** 71 71 + * Convert zero-based column index to letter(s). 72 72 + */ 73 73 + export function colToLetter(col: number): string { 74 74 + let result = ''; 75 75 + let c = col; 76 76 + while (c >= 0) { 77 77 + result = String.fromCharCode((c % 26) + 65) + result; 78 78 + c = Math.floor(c / 26) - 1; 79 79 + } 80 80 + return result; 81 81 + } 82 82 + 83 83 + /** 84 84 + * Format a CellRange back to string. 85 85 + */ 86 86 + export function formatRange(range: CellRange): string { 87 87 + return `${colToLetter(range.startCol)}${range.startRow}:${colToLetter(range.endCol)}${range.endRow}`; 88 88 + } 89 89 + 90 90 + /** 91 91 + * Create a sheet embed. 92 92 + */ 93 93 + export function createSheetEmbed( 94 94 + sheetId: string, 95 95 + rangeStr: string, 96 96 + position: number, 97 97 + options: { showHeaders?: boolean; showRowNumbers?: boolean } = {}, 98 98 + ): SheetEmbed | null { 99 99 + const range = parseRange(rangeStr); 100 100 + if (!range) return null; 101 101 + 102 102 + return { 103 103 + id: `embed-${Date.now()}-${++_embedCounter}`, 104 104 + sheetId, 105 105 + rangeStr: rangeStr.toUpperCase(), 106 106 + range, 107 107 + position, 108 108 + showHeaders: options.showHeaders ?? true, 109 109 + showRowNumbers: options.showRowNumbers ?? false, 110 110 + }; 111 111 + } 112 112 + 113 113 + /** 114 114 + * Extract a snapshot of values from sheet data for an embed. 115 115 + */ 116 116 + export function extractSnapshot( 117 117 + embed: SheetEmbed, 118 118 + cellValues: Map<string, unknown>, 119 119 + colHeaders: string[], 120 120 + ): EmbedSnapshot { 121 121 + const { range } = embed; 122 122 + const values: string[][] = []; 123 123 + const headers: string[] = []; 124 124 + 125 125 + // Build headers 126 126 + for (let c = range.startCol; c <= range.endCol; c++) { 127 127 + headers.push(colHeaders[c] ?? colToLetter(c)); 128 128 + } 129 129 + 130 130 + // Build value rows 131 131 + for (let r = range.startRow; r <= range.endRow; r++) { 132 132 + const row: string[] = []; 133 133 + for (let c = range.startCol; c <= range.endCol; c++) { 134 134 + const cellId = `${colToLetter(c)}${r}`; 135 135 + const val = cellValues.get(cellId); 136 136 + row.push(val !== undefined && val !== null ? String(val) : ''); 137 137 + } 138 138 + values.push(row); 139 139 + } 140 140 + 141 141 + return { 142 142 + embedId: embed.id, 143 143 + values, 144 144 + headers, 145 145 + updatedAt: Date.now(), 146 146 + }; 147 147 + } 148 148 + 149 149 + /** 150 150 + * Get the dimensions of an embed range. 151 151 + */ 152 152 + export function embedDimensions(embed: SheetEmbed): { rows: number; cols: number } { 153 153 + const { range } = embed; 154 154 + return { 155 155 + rows: range.endRow - range.startRow + 1, 156 156 + cols: range.endCol - range.startCol + 1, 157 157 + }; 158 158 + } 159 159 + 160 160 + /** 161 161 + * Update the range of an embed. 162 162 + */ 163 163 + export function updateEmbedRange( 164 164 + embed: SheetEmbed, 165 165 + rangeStr: string, 166 166 + ): SheetEmbed | null { 167 167 + const range = parseRange(rangeStr); 168 168 + if (!range) return null; 169 169 + return { ...embed, rangeStr: rangeStr.toUpperCase(), range }; 170 170 + } 171 171 + 172 172 + /** 173 173 + * Move the embed position in the document. 174 174 + */ 175 175 + export function moveEmbed(embed: SheetEmbed, position: number): SheetEmbed { 176 176 + return { ...embed, position }; 177 177 + } 178 178 + 179 179 + /** 180 180 + * Count cells in the embed range. 181 181 + */ 182 182 + export function cellCount(embed: SheetEmbed): number { 183 183 + const dims = embedDimensions(embed); 184 184 + return dims.rows * dims.cols; 185 185 + }

+166

tests/cross-doc-links.test.ts

reviewed

··· 1 1 + import { describe, it, expect } from 'vitest'; 2 2 + import { 3 3 + createLinkGraph, 4 4 + addLink, 5 5 + removeLink, 6 6 + outgoingLinks, 7 7 + incomingLinks, 8 8 + connectedDocIds, 9 9 + areLinked, 10 10 + linksBetween, 11 11 + linkCountByType, 12 12 + allDocIds, 13 13 + orphanDocs, 14 14 + removeDocLinks, 15 15 + updateLinkLabel, 16 16 + totalLinks, 17 17 + } from '../src/lib/cross-doc-links.js'; 18 18 + 19 19 + function buildGraph() { 20 20 + let g = createLinkGraph(); 21 21 + g = addLink(g, 'd1', 'doc', 'd2', 'sheet', 'Budget Sheet'); 22 22 + g = addLink(g, 'd1', 'doc', 'd3', 'doc', 'Meeting Notes'); 23 23 + g = addLink(g, 'd2', 'sheet', 'd3', 'doc', 'Notes Link'); 24 24 + return g; 25 25 + } 26 26 + 27 27 + describe('createLinkGraph', () => { 28 28 + it('creates empty graph', () => { 29 29 + const g = createLinkGraph(); 30 30 + expect(g.links).toEqual([]); 31 31 + }); 32 32 + }); 33 33 + 34 34 + describe('addLink', () => { 35 35 + it('adds link to graph', () => { 36 36 + let g = createLinkGraph(); 37 37 + g = addLink(g, 'd1', 'doc', 'd2', 'sheet', 'My Sheet'); 38 38 + expect(g.links).toHaveLength(1); 39 39 + expect(g.links[0].sourceId).toBe('d1'); 40 40 + expect(g.links[0].targetId).toBe('d2'); 41 41 + expect(g.links[0].label).toBe('My Sheet'); 42 42 + }); 43 43 + 44 44 + it('generates unique IDs', () => { 45 45 + let g = createLinkGraph(); 46 46 + g = addLink(g, 'd1', 'doc', 'd2', 'sheet', 'A'); 47 47 + g = addLink(g, 'd1', 'doc', 'd3', 'doc', 'B'); 48 48 + expect(g.links[0].id).not.toBe(g.links[1].id); 49 49 + }); 50 50 + }); 51 51 + 52 52 + describe('removeLink', () => { 53 53 + it('removes link by ID', () => { 54 54 + const g = buildGraph(); 55 55 + const id = g.links[0].id; 56 56 + const updated = removeLink(g, id); 57 57 + expect(updated.links).toHaveLength(2); 58 58 + }); 59 59 + }); 60 60 + 61 61 + describe('outgoingLinks', () => { 62 62 + it('returns links from a document', () => { 63 63 + const g = buildGraph(); 64 64 + const out = outgoingLinks(g, 'd1'); 65 65 + expect(out).toHaveLength(2); 66 66 + }); 67 67 + 68 68 + it('returns empty for no outgoing', () => { 69 69 + const g = buildGraph(); 70 70 + expect(outgoingLinks(g, 'd3')).toHaveLength(0); 71 71 + }); 72 72 + }); 73 73 + 74 74 + describe('incomingLinks', () => { 75 75 + it('returns backlinks to a document', () => { 76 76 + const g = buildGraph(); 77 77 + const inc = incomingLinks(g, 'd3'); 78 78 + expect(inc).toHaveLength(2); 79 79 + }); 80 80 + }); 81 81 + 82 82 + describe('connectedDocIds', () => { 83 83 + it('returns all connected docs', () => { 84 84 + const g = buildGraph(); 85 85 + const connected = connectedDocIds(g, 'd1'); 86 86 + expect(connected).toContain('d2'); 87 87 + expect(connected).toContain('d3'); 88 88 + expect(connected).not.toContain('d1'); 89 89 + }); 90 90 + }); 91 91 + 92 92 + describe('areLinked', () => { 93 93 + it('detects linked documents', () => { 94 94 + const g = buildGraph(); 95 95 + expect(areLinked(g, 'd1', 'd2')).toBe(true); 96 96 + expect(areLinked(g, 'd2', 'd1')).toBe(true); 97 97 + }); 98 98 + 99 99 + it('returns false for unlinked', () => { 100 100 + const g = createLinkGraph(); 101 101 + expect(areLinked(g, 'd1', 'd2')).toBe(false); 102 102 + }); 103 103 + }); 104 104 + 105 105 + describe('linksBetween', () => { 106 106 + it('returns links in both directions', () => { 107 107 + let g = buildGraph(); 108 108 + g = addLink(g, 'd2', 'sheet', 'd1', 'doc', 'Reverse'); 109 109 + const between = linksBetween(g, 'd1', 'd2'); 110 110 + expect(between).toHaveLength(2); 111 111 + }); 112 112 + }); 113 113 + 114 114 + describe('linkCountByType', () => { 115 115 + it('counts by type pair', () => { 116 116 + const g = buildGraph(); 117 117 + const counts = linkCountByType(g); 118 118 + expect(counts['doc->sheet']).toBe(1); 119 119 + expect(counts['doc->doc']).toBe(1); 120 120 + expect(counts['sheet->doc']).toBe(1); 121 121 + }); 122 122 + }); 123 123 + 124 124 + describe('allDocIds', () => { 125 125 + it('returns all unique document IDs', () => { 126 126 + const g = buildGraph(); 127 127 + const ids = allDocIds(g); 128 128 + expect(ids).toContain('d1'); 129 129 + expect(ids).toContain('d2'); 130 130 + expect(ids).toContain('d3'); 131 131 + expect(ids).toHaveLength(3); 132 132 + }); 133 133 + }); 134 134 + 135 135 + describe('orphanDocs', () => { 136 136 + it('finds docs with no incoming links', () => { 137 137 + const g = buildGraph(); 138 138 + const orphans = orphanDocs(g, ['d1', 'd2', 'd3']); 139 139 + expect(orphans).toContain('d1'); 140 140 + expect(orphans).not.toContain('d3'); 141 141 + }); 142 142 + }); 143 143 + 144 144 + describe('removeDocLinks', () => { 145 145 + it('removes all links involving a document', () => { 146 146 + const g = buildGraph(); 147 147 + const updated = removeDocLinks(g, 'd1'); 148 148 + expect(updated.links).toHaveLength(1); 149 149 + expect(updated.links[0].sourceId).toBe('d2'); 150 150 + }); 151 151 + }); 152 152 + 153 153 + describe('updateLinkLabel', () => { 154 154 + it('updates label of a link', () => { 155 155 + const g = buildGraph(); 156 156 + const id = g.links[0].id; 157 157 + const updated = updateLinkLabel(g, id, 'New Label'); 158 158 + expect(updated.links.find(l => l.id === id)!.label).toBe('New Label'); 159 159 + }); 160 160 + }); 161 161 + 162 162 + describe('totalLinks', () => { 163 163 + it('returns total count', () => { 164 164 + expect(totalLinks(buildGraph())).toBe(3); 165 165 + }); 166 166 + });

+216

tests/form-builder.test.ts

reviewed

··· 1 1 + import { describe, it, expect } from 'vitest'; 2 2 + import { 3 3 + createForm, 4 4 + addQuestion, 5 5 + removeQuestion, 6 6 + updateQuestion, 7 7 + moveQuestion, 8 8 + createOption, 9 9 + addOption, 10 10 + setTargetSheet, 11 11 + validateAnswer, 12 12 + validateSubmission, 13 13 + questionCount, 14 14 + requiredCount, 15 15 + duplicateForm, 16 16 + type Question, 17 17 + } from '../src/forms/form-builder.js'; 18 18 + 19 19 + describe('createForm', () => { 20 20 + it('creates empty form', () => { 21 21 + const form = createForm('Survey'); 22 22 + expect(form.title).toBe('Survey'); 23 23 + expect(form.questions).toEqual([]); 24 24 + expect(form.targetSheetId).toBeNull(); 25 25 + }); 26 26 + 27 27 + it('generates unique IDs', () => { 28 28 + const f1 = createForm('A'); 29 29 + const f2 = createForm('B'); 30 30 + expect(f1.id).not.toBe(f2.id); 31 31 + }); 32 32 + }); 33 33 + 34 34 + describe('addQuestion', () => { 35 35 + it('adds question to form', () => { 36 36 + let form = createForm('Test'); 37 37 + form = addQuestion(form, 'short_text', 'Name'); 38 38 + expect(form.questions).toHaveLength(1); 39 39 + expect(form.questions[0].label).toBe('Name'); 40 40 + expect(form.questions[0].type).toBe('short_text'); 41 41 + }); 42 42 + 43 43 + it('accepts options', () => { 44 44 + let form = createForm('Test'); 45 45 + form = addQuestion(form, 'email', 'Email', { required: true, description: 'Your email' }); 46 46 + expect(form.questions[0].required).toBe(true); 47 47 + expect(form.questions[0].description).toBe('Your email'); 48 48 + }); 49 49 + }); 50 50 + 51 51 + describe('removeQuestion', () => { 52 52 + it('removes question by ID', () => { 53 53 + let form = createForm('Test'); 54 54 + form = addQuestion(form, 'short_text', 'Q1'); 55 55 + form = addQuestion(form, 'short_text', 'Q2'); 56 56 + const id = form.questions[0].id; 57 57 + form = removeQuestion(form, id); 58 58 + expect(form.questions).toHaveLength(1); 59 59 + expect(form.questions[0].label).toBe('Q2'); 60 60 + }); 61 61 + }); 62 62 + 63 63 + describe('updateQuestion', () => { 64 64 + it('updates question properties', () => { 65 65 + let form = createForm('Test'); 66 66 + form = addQuestion(form, 'short_text', 'Name'); 67 67 + const id = form.questions[0].id; 68 68 + form = updateQuestion(form, id, { label: 'Full Name', required: true }); 69 69 + expect(form.questions[0].label).toBe('Full Name'); 70 70 + expect(form.questions[0].required).toBe(true); 71 71 + }); 72 72 + }); 73 73 + 74 74 + describe('moveQuestion', () => { 75 75 + it('moves question to new index', () => { 76 76 + let form = createForm('Test'); 77 77 + form = addQuestion(form, 'short_text', 'A'); 78 78 + form = addQuestion(form, 'short_text', 'B'); 79 79 + form = addQuestion(form, 'short_text', 'C'); 80 80 + const id = form.questions[2].id; 81 81 + form = moveQuestion(form, id, 0); 82 82 + expect(form.questions[0].label).toBe('C'); 83 83 + expect(form.questions[1].label).toBe('A'); 84 84 + }); 85 85 + 86 86 + it('clamps to bounds', () => { 87 87 + let form = createForm('Test'); 88 88 + form = addQuestion(form, 'short_text', 'A'); 89 89 + form = addQuestion(form, 'short_text', 'B'); 90 90 + form = moveQuestion(form, form.questions[0].id, 100); 91 91 + expect(form.questions[1].label).toBe('A'); 92 92 + }); 93 93 + 94 94 + it('returns same form for unknown ID', () => { 95 95 + const form = createForm('Test'); 96 96 + expect(moveQuestion(form, 'unknown', 0)).toBe(form); 97 97 + }); 98 98 + }); 99 99 + 100 100 + describe('createOption / addOption', () => { 101 101 + it('creates option with unique ID', () => { 102 102 + const o1 = createOption('Yes'); 103 103 + const o2 = createOption('No'); 104 104 + expect(o1.id).not.toBe(o2.id); 105 105 + expect(o1.label).toBe('Yes'); 106 106 + }); 107 107 + 108 108 + it('adds option to question', () => { 109 109 + let form = createForm('Test'); 110 110 + form = addQuestion(form, 'single_choice', 'Color'); 111 111 + const qId = form.questions[0].id; 112 112 + form = addOption(form, qId, 'Red'); 113 113 + form = addOption(form, qId, 'Blue'); 114 114 + expect(form.questions[0].options).toHaveLength(2); 115 115 + }); 116 116 + }); 117 117 + 118 118 + describe('setTargetSheet', () => { 119 119 + it('sets target sheet', () => { 120 120 + let form = createForm('Test'); 121 121 + form = setTargetSheet(form, 'sheet-1'); 122 122 + expect(form.targetSheetId).toBe('sheet-1'); 123 123 + }); 124 124 + 125 125 + it('can clear target', () => { 126 126 + let form = createForm('Test'); 127 127 + form = setTargetSheet(form, 'sheet-1'); 128 128 + form = setTargetSheet(form, null); 129 129 + expect(form.targetSheetId).toBeNull(); 130 130 + }); 131 131 + }); 132 132 + 133 133 + describe('validateAnswer', () => { 134 134 + const textQ: Question = { id: 'q1', type: 'short_text', label: 'Name', description: '', required: true, options: [] }; 135 135 + const emailQ: Question = { id: 'q2', type: 'email', label: 'Email', description: '', required: false, options: [] }; 136 136 + const numberQ: Question = { id: 'q3', type: 'number', label: 'Age', description: '', required: false, options: [] }; 137 137 + const choiceQ: Question = { 138 138 + id: 'q4', type: 'single_choice', label: 'Pick', description: '', required: false, 139 139 + options: [{ id: 'o1', label: 'A' }, { id: 'o2', label: 'B' }], 140 140 + }; 141 141 + const ratingQ: Question = { id: 'q5', type: 'rating', label: 'Rate', description: '', required: false, options: [], scaleMin: 1, scaleMax: 5 }; 142 142 + 143 143 + it('validates required field', () => { 144 144 + expect(validateAnswer(textQ, '')).toBe('This field is required'); 145 145 + expect(validateAnswer(textQ, 'Alice')).toBeNull(); 146 146 + }); 147 147 + 148 148 + it('allows empty for non-required', () => { 149 149 + expect(validateAnswer(emailQ, '')).toBeNull(); 150 150 + }); 151 151 + 152 152 + it('validates email format', () => { 153 153 + expect(validateAnswer(emailQ, 'bad')).toBe('Invalid email address'); 154 154 + expect(validateAnswer(emailQ, 'a@b.c')).toBeNull(); 155 155 + }); 156 156 + 157 157 + it('validates number', () => { 158 158 + expect(validateAnswer(numberQ, 'abc')).toBe('Must be a number'); 159 159 + expect(validateAnswer(numberQ, '25')).toBeNull(); 160 160 + }); 161 161 + 162 162 + it('validates choice', () => { 163 163 + expect(validateAnswer(choiceQ, 'A')).toBeNull(); 164 164 + expect(validateAnswer(choiceQ, 'o1')).toBeNull(); 165 165 + expect(validateAnswer(choiceQ, 'C')).toBe('Invalid choice'); 166 166 + }); 167 167 + 168 168 + it('validates rating range', () => { 169 169 + expect(validateAnswer(ratingQ, '3')).toBeNull(); 170 170 + expect(validateAnswer(ratingQ, '0')).toBe('Must be between 1 and 5'); 171 171 + expect(validateAnswer(ratingQ, '6')).toBe('Must be between 1 and 5'); 172 172 + }); 173 173 + }); 174 174 + 175 175 + describe('validateSubmission', () => { 176 176 + it('returns errors for invalid answers', () => { 177 177 + let form = createForm('Test'); 178 178 + form = addQuestion(form, 'short_text', 'Name', { required: true }); 179 179 + form = addQuestion(form, 'email', 'Email'); 180 180 + const answers = new Map<string, unknown>([ 181 181 + [form.questions[0].id, ''], 182 182 + [form.questions[1].id, 'bad-email'], 183 183 + ]); 184 184 + const errors = validateSubmission(form, answers); 185 185 + expect(errors.size).toBe(2); 186 186 + }); 187 187 + 188 188 + it('returns empty map for valid submission', () => { 189 189 + let form = createForm('Test'); 190 190 + form = addQuestion(form, 'short_text', 'Name'); 191 191 + const answers = new Map<string, unknown>([[form.questions[0].id, 'Alice']]); 192 192 + expect(validateSubmission(form, answers).size).toBe(0); 193 193 + }); 194 194 + }); 195 195 + 196 196 + describe('questionCount / requiredCount', () => { 197 197 + it('counts questions', () => { 198 198 + let form = createForm('Test'); 199 199 + form = addQuestion(form, 'short_text', 'A', { required: true }); 200 200 + form = addQuestion(form, 'short_text', 'B'); 201 201 + form = addQuestion(form, 'short_text', 'C', { required: true }); 202 202 + expect(questionCount(form)).toBe(3); 203 203 + expect(requiredCount(form)).toBe(2); 204 204 + }); 205 205 + }); 206 206 + 207 207 + describe('duplicateForm', () => { 208 208 + it('creates copy with new ID', () => { 209 209 + let form = createForm('Original'); 210 210 + form = addQuestion(form, 'short_text', 'Q1'); 211 211 + const copy = duplicateForm(form); 212 212 + expect(copy.id).not.toBe(form.id); 213 213 + expect(copy.title).toBe('Original (Copy)'); 214 214 + expect(copy.questions).toEqual(form.questions); 215 215 + }); 216 216 + });

+149

tests/sheet-embed.test.ts

reviewed

··· 1 1 + import { describe, it, expect } from 'vitest'; 2 2 + import { 3 3 + parseRange, 4 4 + letterToCol, 5 5 + colToLetter, 6 6 + formatRange, 7 7 + createSheetEmbed, 8 8 + extractSnapshot, 9 9 + embedDimensions, 10 10 + updateEmbedRange, 11 11 + moveEmbed, 12 12 + cellCount, 13 13 + } from '../src/lib/sheet-embed.js'; 14 14 + 15 15 + describe('letterToCol', () => { 16 16 + it('converts single letters', () => { 17 17 + expect(letterToCol('A')).toBe(0); 18 18 + expect(letterToCol('B')).toBe(1); 19 19 + expect(letterToCol('Z')).toBe(25); 20 20 + }); 21 21 + 22 22 + it('converts multi-letter columns', () => { 23 23 + expect(letterToCol('AA')).toBe(26); 24 24 + expect(letterToCol('AZ')).toBe(51); 25 25 + }); 26 26 + }); 27 27 + 28 28 + describe('colToLetter', () => { 29 29 + it('converts single digit columns', () => { 30 30 + expect(colToLetter(0)).toBe('A'); 31 31 + expect(colToLetter(25)).toBe('Z'); 32 32 + }); 33 33 + 34 34 + it('converts multi-letter columns', () => { 35 35 + expect(colToLetter(26)).toBe('AA'); 36 36 + expect(colToLetter(51)).toBe('AZ'); 37 37 + }); 38 38 + 39 39 + it('round-trips with letterToCol', () => { 40 40 + for (let i = 0; i < 100; i++) { 41 41 + expect(letterToCol(colToLetter(i))).toBe(i); 42 42 + } 43 43 + }); 44 44 + }); 45 45 + 46 46 + describe('parseRange', () => { 47 47 + it('parses valid range', () => { 48 48 + const range = parseRange('A1:D10'); 49 49 + expect(range).toEqual({ startCol: 0, startRow: 1, endCol: 3, endRow: 10 }); 50 50 + }); 51 51 + 52 52 + it('is case insensitive', () => { 53 53 + const range = parseRange('a1:d10'); 54 54 + expect(range).toEqual({ startCol: 0, startRow: 1, endCol: 3, endRow: 10 }); 55 55 + }); 56 56 + 57 57 + it('returns null for invalid range', () => { 58 58 + expect(parseRange('invalid')).toBeNull(); 59 59 + expect(parseRange('A1')).toBeNull(); 60 60 + }); 61 61 + 62 62 + it('returns null for reversed range', () => { 63 63 + expect(parseRange('D10:A1')).toBeNull(); 64 64 + }); 65 65 + }); 66 66 + 67 67 + describe('formatRange', () => { 68 68 + it('formats range to string', () => { 69 69 + expect(formatRange({ startCol: 0, startRow: 1, endCol: 3, endRow: 10 })).toBe('A1:D10'); 70 70 + }); 71 71 + }); 72 72 + 73 73 + describe('createSheetEmbed', () => { 74 74 + it('creates embed from valid range', () => { 75 75 + const embed = createSheetEmbed('s1', 'A1:C5', 100); 76 76 + expect(embed).not.toBeNull(); 77 77 + expect(embed!.sheetId).toBe('s1'); 78 78 + expect(embed!.rangeStr).toBe('A1:C5'); 79 79 + expect(embed!.showHeaders).toBe(true); 80 80 + expect(embed!.showRowNumbers).toBe(false); 81 81 + }); 82 82 + 83 83 + it('returns null for invalid range', () => { 84 84 + expect(createSheetEmbed('s1', 'invalid', 0)).toBeNull(); 85 85 + }); 86 86 + 87 87 + it('accepts display options', () => { 88 88 + const embed = createSheetEmbed('s1', 'A1:B2', 0, { showHeaders: false, showRowNumbers: true }); 89 89 + expect(embed!.showHeaders).toBe(false); 90 90 + expect(embed!.showRowNumbers).toBe(true); 91 91 + }); 92 92 + }); 93 93 + 94 94 + describe('extractSnapshot', () => { 95 95 + it('extracts values from cell data', () => { 96 96 + const embed = createSheetEmbed('s1', 'A1:B2', 0)!; 97 97 + const values = new Map<string, unknown>([ 98 98 + ['A1', 'Hello'], ['B1', 42], 99 99 + ['A2', 'World'], ['B2', 99], 100 100 + ]); 101 101 + const snap = extractSnapshot(embed, values, ['Name', 'Score']); 102 102 + expect(snap.headers).toEqual(['Name', 'Score']); 103 103 + expect(snap.values).toEqual([['Hello', '42'], ['World', '99']]); 104 104 + }); 105 105 + 106 106 + it('handles missing values', () => { 107 107 + const embed = createSheetEmbed('s1', 'A1:A2', 0)!; 108 108 + const snap = extractSnapshot(embed, new Map(), []); 109 109 + expect(snap.values).toEqual([[''], ['']]); 110 110 + }); 111 111 + }); 112 112 + 113 113 + describe('embedDimensions', () => { 114 114 + it('returns rows and cols', () => { 115 115 + const embed = createSheetEmbed('s1', 'A1:C5', 0)!; 116 116 + const dims = embedDimensions(embed); 117 117 + expect(dims.rows).toBe(5); 118 118 + expect(dims.cols).toBe(3); 119 119 + }); 120 120 + }); 121 121 + 122 122 + describe('updateEmbedRange', () => { 123 123 + it('updates range', () => { 124 124 + const embed = createSheetEmbed('s1', 'A1:B2', 0)!; 125 125 + const updated = updateEmbedRange(embed, 'C3:E10'); 126 126 + expect(updated).not.toBeNull(); 127 127 + expect(updated!.rangeStr).toBe('C3:E10'); 128 128 + }); 129 129 + 130 130 + it('returns null for invalid range', () => { 131 131 + const embed = createSheetEmbed('s1', 'A1:B2', 0)!; 132 132 + expect(updateEmbedRange(embed, 'invalid')).toBeNull(); 133 133 + }); 134 134 + }); 135 135 + 136 136 + describe('moveEmbed', () => { 137 137 + it('updates position', () => { 138 138 + const embed = createSheetEmbed('s1', 'A1:B2', 0)!; 139 139 + const moved = moveEmbed(embed, 500); 140 140 + expect(moved.position).toBe(500); 141 141 + }); 142 142 + }); 143 143 + 144 144 + describe('cellCount', () => { 145 145 + it('computes total cells', () => { 146 146 + const embed = createSheetEmbed('s1', 'A1:C5', 0)!; 147 147 + expect(cellCount(embed)).toBe(15); 148 148 + }); 149 149 + });