@decantr/content 3.8.0

package/patterns/recipefork-chef-instruction-editor.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-chef-instruction-editor",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Chef Instruction Editor",
+  "description": "Hierarchical Chef Mode instruction editor with grouped instruction sets, stand-alone advanced steps, step images, per-step timing, and ingredient-step linkage. Stand-alone advanced steps retain the same deep controls as grouped sub-steps.",
+  "dependencies": {
+    "patterns": {
+      "recipefork-chef-ingredients-editor": "^1.0.0"
+    },
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Button",
+        "Input",
+        "Card",
+        "Badge",
+        "Label",
+        "Textarea",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Button",
+    "Input",
+    "Card",
+    "Badge",
+    "Label",
+    "Textarea",
+    "icon"
+  ],
+  "default_preset": "hierarchical",
+  "presets": {
+    "hierarchical": {
+      "description": "Advanced instruction editor that supports parent instruction groups with nested sub-steps as well as stand-alone advanced steps in the same workflow. Stand-alone steps still expose image, timing, and ingredient-link controls.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4",
+        "slots": {
+          "header": "Section heading with add-simple and add-group actions",
+          "instruction-group": "Parent instruction card",
+          "simple-step": "Standalone advanced step row",
+          "group-image": "Optional parent image surface",
+          "step-image": "Optional sub-step image surface",
+          "timing": "Prep and cook minute controls",
+          "ingredient-links": "Selectable ingredient badges for required ingredient mapping",
+          "substeps": "Nested step stack with add-sub-step action"
+        }
+      }
+    }
+  },
+  "visual_brief": "A hierarchical instruction builder where parent instruction sets expand into nested sub-step cards. Each group can carry a title, optional description, optional image, and one or more timed sub-steps. Stand-alone advanced steps are also supported when a parent grouping would be too heavy, but they should still surface image upload, prep/cook timing, and ingredient-link controls instead of collapsing into a plain textarea. Ingredient badges beneath each sub-step create explicit links between structured ingredients and step execution.",
+  "composition": {
+    "ChefInstructionEditor": "Card(recipefork-card) > [Header + InstructionGroup* + SimpleStep*]"
+  }
+}

package/patterns/recipefork-chef-instructions-display.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-chef-instructions-display",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Chef Instructions Display",
+  "description": "Chef Mode instruction presentation surface with collapsible parent groups, sub-step badges, optional imagery, timing metadata, and required ingredient chips.",
+  "dependencies": {
+    "patterns": {
+      "recipefork-chef-ingredients-display": "^1.0.0"
+    },
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Badge",
+        "Button",
+        "Card",
+        "Label",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Badge",
+    "Button",
+    "Card",
+    "Label",
+    "icon"
+  ],
+  "default_preset": "hierarchical",
+  "presets": {
+    "hierarchical": {
+      "description": "Display grouped Chef Mode instruction sets with optional simple stand-alone steps mixed into the flow.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap6",
+        "slots": {
+          "header": "Section label and Chef Mode badge",
+          "group": "Collapsible instruction group",
+          "group-image": "Parent image surface",
+          "substep": "Nested numbered sub-step row",
+          "timing": "Prep/cook detail row",
+          "ingredient-chips": "Required ingredient chips",
+          "simple-step": "Standalone advanced step layout"
+        }
+      }
+    }
+  },
+  "visual_brief": "A layered instruction display that preserves the hierarchy of Chef Mode recipes. Parent instruction groups act like collapsible teaching sections, with nested numbered sub-steps, optional hero imagery, timing chips, and ingredient references inline beneath the relevant sub-step.",
+  "composition": {
+    "ChefInstructionsDisplay": "Card(recipefork-card) > [Header + InstructionGroupDisplay* + SimpleStepDisplay*]"
+  }
+}

package/patterns/recipefork-cookbook-assignment.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-cookbook-assignment",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Cookbook Assignment",
+  "description": "Inline cookbook assignment block for Recipefork authoring flows with cookbook loading state, multi-select assignment, and inline new-cookbook creation.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Button",
+        "Input",
+        "Label",
+        "Badge",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card",
+    "Button",
+    "Input",
+    "Label",
+    "Badge",
+    "icon"
+  ],
+  "default_preset": "inline-assignment",
+  "presets": {
+    "inline-assignment": {
+      "description": "Authoring-side cookbook assignment section with skeleton loading, cookbook chips/cards, and inline create-new-cookbook controls that run before final redirect.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4",
+        "slots": {
+          "loading-state": "Skeleton or spinner state while cookbooks are fetched",
+          "cookbook-list": "Selectable cookbook rows with visibility and recipe counts",
+          "new-cookbook": "Inline title input and create/cancel controls for a new cookbook",
+          "assignment-feedback": "Success or partial-failure messaging when the recipe save succeeds but cookbook assignment fails"
+        }
+      }
+    }
+  },
+  "visual_brief": "This should feel like a natural part of publishing or saving a recipe, not an afterthought modal. The loading state should be obvious, the selection affordances should be light, and the new-cookbook path should not derail the primary authoring flow.",
+  "composition": {
+    "RecipeforkCookbookAssignment": "Card(recipefork-assignment) > [LoadingState | CookbookList + NewCookbookInline + Feedback]"
+  }
+}

package/patterns/recipefork-cooking-tips-display.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-cooking-tips-display",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Cooking Tips Display",
+  "description": "Display card for recipe-specific cooking tips on Recipefork detail pages, replacing generic static tips with author-provided notes.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Label",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card",
+    "Label",
+    "icon"
+  ],
+  "default_preset": "bullet-list",
+  "presets": {
+    "bullet-list": {
+      "description": "Sidebar or support-surface bullet list of recipe-specific cooking tips.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap2",
+        "slots": {
+          "tips-header": "Cooking tips section title",
+          "tip-items": "Bullet list of concise author-provided tips"
+        }
+      }
+    }
+  },
+  "visual_brief": "This should feel practical and low-friction. It replaces generic filler with real creator knowledge, so it should read like trusted notes rather than a decorative sidebar.",
+  "composition": {
+    "RecipeforkCookingTipsDisplay": "Card(recipefork-cooking-tips-display) > [TipsHeader + TipItems]"
+  }
+}

package/patterns/recipefork-cooking-tips-editor.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-cooking-tips-editor",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Cooking Tips Editor",
+  "description": "Reusable cooking tips editor for both Simple Mode and Chef Mode recipes, supporting optional bullet-style tips with ordering and removal controls.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Button",
+        "Label",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card",
+    "Button",
+    "Label",
+    "icon"
+  ],
+  "default_preset": "bullet-editor",
+  "presets": {
+    "bullet-editor": {
+      "description": "Optional bullet-note editor with add, reorder, and remove controls.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap3",
+        "slots": {
+          "tips-header": "Section title and description",
+          "tips-list": "List of bullet-style textarea rows",
+          "empty-state": "Prompt that explains there are no tips yet"
+        }
+      }
+    }
+  },
+  "visual_brief": "This should feel lighter than the main recipe instructions: quick, practical, and easy to scan, like the author's final notes to another cook.",
+  "composition": {
+    "RecipeforkCookingTipsEditor": "Card(recipefork-cooking-tips-editor) > [TipsHeader + TipsList + EmptyState?]"
+  }
+}

package/patterns/recipefork-fork-provenance.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-fork-provenance",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Fork Provenance",
+  "description": "Lineage-aware provenance block for Recipefork recipes showing the immediate parent and root original publicly, while reserving branch stats, history, and descendant activity for owner-facing contexts.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Avatar",
+        "Button",
+        "Badge",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card",
+    "Avatar",
+    "Button",
+    "Badge",
+    "icon"
+  ],
+  "default_preset": "lineage-card",
+  "presets": {
+    "lineage-card": {
+      "description": "Inline provenance card that keeps the direct parent visible and exposes the root original when different for all viewers. Branch metrics, history stacks, and descendant timelines are owner-facing expansions rather than public browsing defaults.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap3",
+        "slots": {
+          "immediate-parent": "Primary attribution row for the recipe version directly forked",
+          "root-original": "Secondary attribution row for the original source recipe when it differs from the parent",
+          "branch-stats": "Owner-facing metrics for direct forks, branch variations, and contributors",
+          "fork-history": "Owner-facing accordion list of ancestor recipes in order with links and timestamps",
+          "branch-timeline": "Owner-facing descendant activity list of published branch variations with depth, author, and creation time"
+        }
+      }
+    }
+  },
+  "visual_brief": "A provenance surface that feels native to Recipefork rather than bolted on. Public viewers should get clear creator credit, while owners can expand into richer branch analytics and network history without exposing internal branch management data to everyone.",
+  "composition": {
+    "RecipeforkForkProvenance": "Card(recipefork-provenance) > [ImmediateParent + RootOriginal? + BranchStats + ForkHistoryAccordion? + BranchTimeline?]"
+  }
+}

package/patterns/recipefork-kitchen-chat.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-kitchen-chat",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Kitchen Chat",
+  "description": "AI cooking assistant chat for RecipeFork-style apps. Covers persistent conversation history, recipe-aware responses, ingredient constraints, image references, and save/fork actions from assistant output.",
+  "tags": [
+    "recipe",
+    "food",
+    "ai",
+    "chat",
+    "assistant",
+    "claude",
+    "cooking",
+    "ingredients",
+    "conversation",
+    "brownfield",
+    "ai-food"
+  ],
+  "components": [
+    "Card",
+    "Avatar",
+    "Button",
+    "Textarea",
+    "Badge",
+    "ScrollArea",
+    "icon"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Threaded AI kitchen chat with history rail, message list, citations/recipe chips, and composer.",
+      "components": [
+        "Card",
+        "Avatar",
+        "Button",
+        "Textarea",
+        "Badge",
+        "ScrollArea",
+        "icon"
+      ],
+      "layout": {
+        "layout": "chat",
+        "atoms": "_grid _gc1 _lg:grid-cols-[280px_1fr] _gap4",
+        "slots": {
+          "history": "Conversation history and saved generations",
+          "thread": "User/assistant cooking messages",
+          "composer": "Prompt input with image or ingredient context controls",
+          "recipe-actions": "Save, fork, assign to cookbook, or regenerate actions"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "chat",
+    "atoms": "_flex _col _gap4",
+    "slots": {
+      "thread": "Cooking conversation",
+      "composer": "Message input"
+    }
+  },
+  "visual_brief": "A focused product chat, not a standalone chatbot demo. The conversation should inherit RecipeFork navigation, cards, and typography; assistant outputs should turn into recipe-aware blocks with ingredients, steps, tips, and save/fork controls.",
+  "composition": {
+    "KitchenChat": "Shell > [HistoryRail? + ChatThread + Composer]",
+    "AssistantRecipeMessage": "MessageCard > [Summary + Ingredients? + Instructions? + Tips? + RecipeActions]",
+    "Composer": "Textarea + OptionalContextChips + SendButton"
+  },
+  "layout_hints": {
+    "brownfield_fit": "Preserve existing chat persistence, Claude/Vision integration, and auth boundaries. Do not replace working app behavior with static demo messages.",
+    "output_structure": "Assistant recipe responses should be structured enough for save/fork flows, not just markdown blobs.",
+    "history": "History is a product surface: show useful titles, dates, generated/saved states, and empty states."
+  },
+  "motion": {
+    "micro": {
+      "stream": "Streaming text may reveal linearly while preserving layout stability.",
+      "send": "Send button may show a compact pending state during request dispatch."
+    },
+    "transitions": {
+      "message": "New messages may enter with a subtle fade/slide; avoid large motion inside long threads."
+    }
+  },
+  "interactions": [
+    "animate-on-mount",
+    "shimmer-skeleton",
+    "keyboard-navigation"
+  ],
+  "responsive": {
+    "mobile": "History collapses behind a drawer or segmented view. Composer remains reachable at the bottom.",
+    "tablet": "Thread first; history can be a narrow rail.",
+    "desktop": "History rail plus main conversation area."
+  },
+  "accessibility": {
+    "role": "log",
+    "aria-label": "AI kitchen conversation",
+    "keyboard": [
+      "Composer submit, history navigation, and recipe action buttons must be keyboard reachable."
+    ],
+    "announcements": [
+      "Announce new assistant messages and generation errors without interrupting typing."
+    ]
+  }
+}

package/patterns/recipefork-photo-generator.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-photo-generator",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Photo Generator",
+  "description": "Photo-to-recipe generation surface for AI food apps. Combines image upload/drop zone, preview, prompt/context controls, generation status, and generated recipe result panel.",
+  "tags": [
+    "recipe",
+    "food",
+    "ai",
+    "vision",
+    "photo",
+    "image-upload",
+    "upload",
+    "generation",
+    "claude",
+    "brownfield",
+    "ai-food"
+  ],
+  "components": [
+    "Card",
+    "Image",
+    "Button",
+    "Input",
+    "Textarea",
+    "Progress",
+    "Badge",
+    "icon"
+  ],
+  "default_preset": "split",
+  "presets": {
+    "split": {
+      "description": "Upload/preview panel beside generated recipe preview on desktop, stacked on mobile.",
+      "components": [
+        "Card",
+        "Image",
+        "Button",
+        "Textarea",
+        "Progress",
+        "Badge",
+        "icon"
+      ],
+      "layout": {
+        "layout": "split",
+        "atoms": "_grid _gc1 _lg:gc2 _gap6",
+        "slots": {
+          "upload": "Drop zone, file picker, image preview, and remove/replace controls",
+          "controls": "Optional prompt, cuisine, dietary, or serving controls",
+          "status": "Generation progress, streaming status, and error state",
+          "result": "Generated recipe title, ingredients, instructions, and save/fork actions"
+        }
+      }
+    },
+    "single": {
+      "description": "Single-column mobile-first generator with upload first and result below.",
+      "components": [
+        "Card",
+        "Image",
+        "Button",
+        "Progress",
+        "Badge",
+        "icon"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap5",
+        "slots": {
+          "upload": "Large image upload zone",
+          "status": "Generation status and retry",
+          "result": "Generated recipe preview"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "split",
+    "atoms": "_grid _gc1 _lg:gc2 _gap6",
+    "slots": {
+      "upload": "Image upload and preview",
+      "result": "Generated recipe panel"
+    }
+  },
+  "visual_brief": "A utility-first AI kitchen page where the food photo and generated recipe are the two anchors. The upload state should feel trustworthy and obvious; the generated result should look like an editable RecipeFork recipe, not a detached AI transcript.",
+  "composition": {
+    "PhotoGenerator": "Split > [UploadPanel + GeneratedRecipePanel]",
+    "UploadPanel": "Card > [DropZone + ImagePreview? + PromptControls + GenerateButton + Status]",
+    "GeneratedRecipePanel": "Card > [Title + Ingredients + Instructions + SaveToCookbook + ForkMetadata?]"
+  },
+  "layout_hints": {
+    "brownfield_fit": "If the existing project already uses shadcn upload/card controls, keep them and map Decantr intent into those classes.",
+    "status_visibility": "Generation status must remain visible after upload; do not hide loading/errors inside the image region only.",
+    "result_editability": "Generated recipe sections should be structured so they can be saved, edited, or assigned to a cookbook."
+  },
+  "motion": {
+    "micro": {
+      "drop": "Drop zone border may strengthen on drag-over.",
+      "loading": "Generation status may use shimmer or progress pulse without animating the uploaded image."
+    },
+    "transitions": {
+      "result": "Generated result may fade in once the first useful recipe fields are available."
+    }
+  },
+  "interactions": [
+    "shimmer-skeleton",
+    "animate-on-mount"
+  ],
+  "responsive": {
+    "mobile": "Stack upload, status, and result. Keep the primary generate action reachable without horizontal scrolling.",
+    "tablet": "Stack or split depending on available width.",
+    "desktop": "Two-column split with upload controls left and generated recipe right."
+  },
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Photo to recipe generator",
+    "keyboard": [
+      "File input, generate, retry, remove image, save, and edit controls must be keyboard reachable."
+    ],
+    "announcements": [
+      "Announce upload success, generation start, generation errors, and generated recipe readiness."
+    ]
+  }
+}

package/patterns/recipefork-presentation-display.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-presentation-display",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Presentation Display",
+  "description": "Recipe detail presentation block for Recipefork showing numbered plating steps, optional step imagery, and whether the plating guide was AI-generated or author-guided.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Badge",
+        "Label",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card",
+    "Badge",
+    "Label",
+    "icon"
+  ],
+  "default_preset": "numbered-steps",
+  "presets": {
+    "numbered-steps": {
+      "description": "Presentation card inserted after recipe instructions, with clear numbering, optional imagery, and an AI/manual provenance badge.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap5",
+        "slots": {
+          "presentation-header": "Section title and AI/manual badge",
+          "presentation-step": "Single plating step row with numbered marker and optional image"
+        }
+      }
+    }
+  },
+  "visual_brief": "This should feel like a refined serving guide rather than another cooking block. It belongs after the cooking instructions and before the story, acting as the bridge between technique and presentation.",
+  "composition": {
+    "RecipeforkPresentationDisplay": "Card(recipefork-presentation-display) > [PresentationHeader + PresentationStep*]"
+  }
+}

package/patterns/recipefork-presentation-editor.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-presentation-editor",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Presentation Editor",
+  "description": "Optional Chef Mode plating presentation editor for Recipefork with three intent states: AI-generated plating steps, manual plating steps, or no plating instructions, plus a readiness checklist that gates AI generation until the recipe has enough context to plate.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Button",
+        "Badge",
+        "Label",
+        "Input",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card",
+    "Button",
+    "Badge",
+    "Label",
+    "Input",
+    "icon"
+  ],
+  "default_preset": "ai-assisted",
+  "presets": {
+    "ai-assisted": {
+      "description": "Chef Mode presentation section with segmented AI/manual/none controls, an AI generation call-to-action that is disabled until the recipe passes a plating-readiness checklist, and a numbered plating-step editor that supports images and ordering.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4",
+        "slots": {
+          "mode-switch": "Three-way selection for AI-generated plating guidance, manual plating guidance, or no presentation",
+          "ai-callout": "Context block explaining that Recipefork can generate plating instructions from the final recipe",
+          "readiness-checklist": "Checklist showing the minimum context needed before AI plating generation is enabled",
+          "presentation-steps": "Ordered plating steps with description and image upload only",
+          "empty-state": "Guidance when the user has not added or generated presentation steps yet"
+        }
+      }
+    }
+  },
+  "visual_brief": "This should feel like the final polish layer of Chef Mode authoring. It is optional, but when used it should read like the finishing pass of a serious recipe workflow rather than a novelty toggle. The AI path should feel responsibly gated, not mysteriously disabled.",
+  "composition": {
+    "RecipeforkPresentationEditor": "Card(recipefork-presentation) > [ModeSwitch + AICallout? + PresentationSteps + EmptyState?]"
+  }
+}