Kochwas
+ +Phase 1: Foundations — Suche folgt in Phase 3.
+Coming soon.
+``` + +- [ ] **Step 6: Install & verify** + +Run: +```bash +npm install +npx svelte-kit sync +npm run check +``` + +Expected: no type errors. + +- [ ] **Step 7: Commit** + +```bash +git add -A +git commit -m "feat(scaffold): init SvelteKit + TypeScript project" +``` + +--- + +## Task 2: Set up Vitest with a smoke test + +**Files:** +- Create: `tests/unit/smoke.test.ts` + +- [ ] **Step 1: Write smoke test** + +```ts +// tests/unit/smoke.test.ts +import { describe, it, expect } from 'vitest'; + +describe('smoke', () => { + it('runs', () => { + expect(1 + 1).toBe(2); + }); +}); +``` + +- [ ] **Step 2: Run** + +```bash +npm test +``` + +Expected: 1 test passes. + +- [ ] **Step 3: Commit** + +```bash +git add tests/ +git commit -m "test(infra): add vitest smoke test" +``` + +--- + +## Task 3: ISO8601 duration parser + +**Files:** +- Create: `src/lib/server/parsers/iso8601-duration.ts` +- Test: `tests/unit/iso8601-duration.test.ts` + +Purpose: JSON-LD recipes use ISO8601 durations like `PT1H30M`. We need minutes as an integer. + +- [ ] **Step 1: Write failing tests** + +```ts +// tests/unit/iso8601-duration.test.ts +import { describe, it, expect } from 'vitest'; +import { parseIso8601Duration } from '../../src/lib/server/parsers/iso8601-duration'; + +describe('parseIso8601Duration', () => { + it.each([ + ['PT30M', 30], + ['PT1H', 60], + ['PT1H30M', 90], + ['PT2H15M', 135], + ['PT0M', 0], + ['P1DT2H', 26 * 60], + ['PT90M', 90] + ])('parses %s to %i minutes', (input, expected) => { + expect(parseIso8601Duration(input)).toBe(expected); + }); + + it.each([[''], [null], [undefined], ['garbage'], ['30 min'], ['PT']])( + 'returns null for invalid input %j', + (input) => { + expect(parseIso8601Duration(input as string)).toBeNull(); + } + ); +}); +``` + +- [ ] **Step 2: Run — should fail** + +```bash +npm test -- iso8601-duration +``` + +Expected: fails with "parseIso8601Duration is not a function" or similar. + +- [ ] **Step 3: Implement** + +```ts +// src/lib/server/parsers/iso8601-duration.ts +const PATTERN = /^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/; + +export function parseIso8601Duration(input: string | null | undefined): number | null { + if (typeof input !== 'string' || input.length === 0) return null; + const m = PATTERN.exec(input); + if (!m) return null; + const [, d, h, min] = m; + if (!d && !h && !min && !input.includes('S')) { + // Must have at least one component to count; reject bare "PT"/"P" + if (input === 'P' || input === 'PT') return null; + } + const days = d ? parseInt(d, 10) : 0; + const hours = h ? parseInt(h, 10) : 0; + const mins = min ? parseInt(min, 10) : 0; + return days * 24 * 60 + hours * 60 + mins; +} +``` + +- [ ] **Step 4: Run — should pass** + +```bash +npm test -- iso8601-duration +``` + +Expected: all tests pass. + +- [ ] **Step 5: Commit** + +```bash +git add src/lib/server/parsers/iso8601-duration.ts tests/unit/iso8601-duration.test.ts +git commit -m "feat(parser): add ISO8601 duration parser" +``` + +--- + +## Task 4: Shared types + +**Files:** +- Create: `src/lib/types.ts` + +Purpose: Central type definitions shared between server and client. + +- [ ] **Step 1: Write types** + +```ts +// src/lib/types.ts +export type Ingredient = { + position: number; + quantity: number | null; + unit: string | null; + name: string; + note: string | null; + raw_text: string; +}; + +export type Step = { + position: number; + text: string; +}; + +export type Recipe = { + id: number | null; // null for preview (not saved yet) + title: string; + description: string | null; + source_url: string | null; + source_domain: string | null; + image_path: string | null; + servings_default: number | null; + servings_unit: string | null; + prep_time_min: number | null; + cook_time_min: number | null; + total_time_min: number | null; + cuisine: string | null; + category: string | null; + ingredients: Ingredient[]; + steps: Step[]; + tags: string[]; +}; + +export type Profile = { + id: number; + name: string; + avatar_emoji: string | null; +}; + +export type AllowedDomain = { + id: number; + domain: string; + display_name: string | null; +}; +``` + +- [ ] **Step 2: Commit** + +```bash +git add src/lib/types.ts +git commit -m "feat(types): add shared type definitions" +``` + +--- + +## Task 5: Ingredient parser + +**Files:** +- Create: `src/lib/server/parsers/ingredient.ts` +- Test: `tests/unit/ingredient.test.ts` + +Purpose: Convert free-text lines like `"200 g Mehl"` to a structured `{ quantity, unit, name, note, raw_text }`. + +- [ ] **Step 1: Write failing tests** + +```ts +// tests/unit/ingredient.test.ts +import { describe, it, expect } from 'vitest'; +import { parseIngredient } from '../../src/lib/server/parsers/ingredient'; + +describe('parseIngredient', () => { + it.each([ + ['200 g Mehl', { quantity: 200, unit: 'g', name: 'Mehl' }], + ['1 kg Kartoffeln', { quantity: 1, unit: 'kg', name: 'Kartoffeln' }], + ['500 ml Milch', { quantity: 500, unit: 'ml', name: 'Milch' }], + ['1 TL Salz', { quantity: 1, unit: 'TL', name: 'Salz' }], + ['2 EL Olivenöl', { quantity: 2, unit: 'EL', name: 'Olivenöl' }], + ['3 Eier', { quantity: 3, unit: null, name: 'Eier' }], + ['1/2 Zitrone', { quantity: 0.5, unit: null, name: 'Zitrone' }], + ['1,5 l Wasser', { quantity: 1.5, unit: 'l', name: 'Wasser' }] + ])('parses %s', (input, expected) => { + const parsed = parseIngredient(input); + expect(parsed.quantity).toBe(expected.quantity); + expect(parsed.unit).toBe(expected.unit); + expect(parsed.name).toBe(expected.name); + expect(parsed.raw_text).toBe(input); + }); + + it('handles notes', () => { + const p = parseIngredient('200 g Mehl (Type 550)'); + expect(p.quantity).toBe(200); + expect(p.name).toBe('Mehl'); + expect(p.note).toBe('Type 550'); + }); + + it('falls back to raw_text when unparsable', () => { + const p = parseIngredient('etwas frischer Pfeffer'); + expect(p.quantity).toBeNull(); + expect(p.unit).toBeNull(); + expect(p.name).toBe('etwas frischer Pfeffer'); + expect(p.raw_text).toBe('etwas frischer Pfeffer'); + }); + + it('handles ranges by taking the lower bound', () => { + const p = parseIngredient('2-3 Tomaten'); + expect(p.quantity).toBe(2); + expect(p.name).toBe('Tomaten'); + }); +}); +``` + +- [ ] **Step 2: Run — should fail** + +- [ ] **Step 3: Implement** + +```ts +// src/lib/server/parsers/ingredient.ts +import type { Ingredient } from '$lib/types'; + +const UNITS = new Set([ + 'g', 'kg', 'ml', 'l', 'cl', 'dl', + 'TL', 'EL', 'Prise', 'Pck.', 'Pkg', 'Becher', 'Stk', 'Stück', 'Bund', 'Tasse', 'Dose' +]); + +const FRACTION_MAP: Recordno recipe
'; + expect(extractRecipeFromHtml(html)).toBeNull(); + }); +}); +``` + +- [ ] **Step 3: Run — should fail** + +- [ ] **Step 4: Implement** + +```ts +// src/lib/server/parsers/json-ld-recipe.ts +import { parseHTML } from 'linkedom'; +import { parseIso8601Duration } from './iso8601-duration'; +import { parseIngredient } from './ingredient'; +import type { Recipe, Step } from '$lib/types'; + +type JsonLdNode = RecordPhase 1: Foundations — Suche folgt in Phase 3.
+