@soulcraft/kits 1.0.0

package/src/kits/match-3-puzzle.ts

@@ -0,0 +1,248 @@
+/**
+ * @module @soulcraft/kits/kits/match-3-puzzle
+ * @description Colorful gem-matching puzzle with cascading combos and power-ups
+ *
+ * Generated from: kits/match-3-puzzle/kit.json
+ * Do not edit this file directly — edit the source kit.json and re-run `bun run build:kits`.
+ */
+
+import type { SoulcraftKitConfig } from '@soulcraft/kit-schema';
+
+/**
+ * Match 3 Puzzle kit configuration.
+ *
+ * @description Colorful gem-matching puzzle with cascading combos and power-ups
+ * @see {@link SoulcraftKitConfig}
+ */
+const match3Puzzle: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "match-3-puzzle",
+	"name": "Match 3 Puzzle",
+	"description": "Colorful gem-matching puzzle with cascading combos and power-ups",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "💎",
+	"longDescription": "A polished match-3 puzzle game with smooth animations and satisfying cascades.\n\n**Features:**\n- PixiJS WebGL rendering for 60fps animations\n- Cascading chain reactions\n- Special gems (bombs, row clearers, rainbow)\n- Timed and moves-limited modes\n- High score leaderboard\n- Level progression\n\n**Gameplay:**\n- Swap adjacent gems to make 3+ matches\n- Create special gems with 4+ matches\n- Chain cascades for bonus points\n- Beat the target score to advance\n\n**Controls:**\n- Click a gem, then click an adjacent gem to swap\n- Or drag to swap",
+	"tags": [
+		"game",
+		"puzzle",
+		"match-3",
+		"casual",
+		"pixi",
+		"webgl",
+		"brainy",
+		"sveltekit"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "appName",
+			"label": "App Name",
+			"description": "The slug name for the application",
+			"type": "string",
+			"required": true,
+			"example": "gem-puzzle"
+		},
+		{
+			"key": "description",
+			"label": "Description",
+			"description": "A short description of the game",
+			"type": "string",
+			"required": false,
+			"example": "A colorful gem-matching puzzle game"
+		}
+	],
+	"shared": {
+		"industry": "games-entertainment",
+		"category": "games",
+		"glossary": {
+			"cascade": "A chain reaction where falling gems create additional matches",
+			"special gem": "A gem with unique powers created by matching 4+ gems"
+		},
+		"aiExpertise": [
+			"Match-3 puzzle game mechanics",
+			"Game balance and progression design",
+			"PixiJS and WebGL rendering",
+			"SvelteKit game development",
+			"Score system and leaderboard design"
+		],
+		"dataModelHints": [
+			"event",
+			"thing",
+			"topic"
+		],
+		"suggestions": [
+			{
+				"label": "Play a game",
+				"prompt": "Run the Match 3 game so I can play"
+			},
+			{
+				"label": "Explain mechanics",
+				"prompt": "Explain how the match-3 mechanics work - matching, cascades, special gems"
+			},
+			{
+				"label": "Add a new gem type",
+				"prompt": "Help me add a new special gem type with a unique effect"
+			},
+			{
+				"label": "High scores",
+				"prompt": "Show me the high score leaderboard"
+			},
+			{
+				"label": "Customize board",
+				"prompt": "Help me customize the board size or gem colors"
+			},
+			{
+				"label": "Debug an issue",
+				"prompt": "Help me debug an issue with the game"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "score",
+					"type": "Measurement",
+					"description": "A player's score for a completed game session",
+					"products": {
+						"workshop": {
+							"view": "stats",
+							"icon": "📊"
+						},
+						"academy": {
+							"mapsTo": "assessment-criterion",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "level",
+					"type": "Event",
+					"description": "A game level with target score and board configuration",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "🎮"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "achievement",
+					"type": "Concept",
+					"description": "A milestone or challenge unlocked through gameplay",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🏆"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "score",
+					"to": "level",
+					"verb": "PartOf",
+					"description": "Score belongs to this game level session"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "creative",
+			"defaultTab": "app",
+			"defaultView": "app"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"typeMapping": {
+					"score": "measurement",
+					"level": "event",
+					"achievement": "concept"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "measurement",
+					"to": "event",
+					"verb": "partOf",
+					"description": "Score belongs to game session"
+				}
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "package.json",
+					"required": [
+						"svelte",
+						"@sveltejs/kit",
+						"pixi.js"
+					]
+				},
+				{
+					"path": "src/lib/game/Board.ts",
+					"required": [
+						"Board",
+						"swap",
+						"findMatches"
+					]
+				}
+			],
+			"projectChecks": [
+				"App starts with npm run dev",
+				"Board renders at 60fps",
+				"Gem swapping works smoothly",
+				"Matches cascade correctly"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert game developer and designer helping build and extend a match-3 puzzle game with smooth animations and compelling progression.",
+			"expertise": [
+				"Match-3 game mechanics and design",
+				"PixiJS WebGL rendering",
+				"Game balance and level design",
+				"SvelteKit application development",
+				"Performance optimization for games"
+			],
+			"tone": "collaborator"
+		},
+		"difficulty": "intermediate",
+		"templateTier": 4,
+		"templateMetadata": {
+			"runnable": true,
+			"runnableCommand": "npm run dev"
+		}
+	},
+	"academy": {
+		"skillPath": "web-development",
+		"level": "beginner",
+		"learningObjectives": [
+			"Use a WebGL canvas library (PixiJS) to render and animate 2D game objects at 60fps",
+			"Implement a grid-based data structure with swap, match detection, and cascade logic",
+			"Design a special-item system where 4+ matches produce power-ups with distinct behaviors",
+			"Persist game state and high scores to a backend and display a live leaderboard"
+		],
+		"assessmentTypes": [
+			"demo",
+			"code-review"
+		],
+		"certificationSlug": "web-game-developer"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default match3Puzzle;

package/src/kits/mind-map.ts

@@ -0,0 +1,356 @@
+/**
+ * @module @soulcraft/kits/kits/mind-map
+ * @description Radial mind map for brainstorming and idea organization
+ *
+ * Generated from: kits/mind-map/kit.json
+ * Do not edit this file directly — edit the source kit.json and re-run `bun run build:kits`.
+ */
+
+import type { SoulcraftKitConfig } from '@soulcraft/kit-schema';
+
+/**
+ * Mind Map kit configuration.
+ *
+ * @description Radial mind map for brainstorming and idea organization
+ * @see {@link SoulcraftKitConfig}
+ */
+const mindMap: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "mind-map",
+	"name": "Mind Map",
+	"description": "Radial mind map for brainstorming and idea organization",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🧠",
+	"longDescription": "Create a beautiful mind map that automatically visualizes your ideas in radial layout. Perfect for brainstorming sessions, project planning, learning new topics, or organizing complex information. The central idea branches out to main topics, which connect to sub-ideas.",
+	"tags": [
+		"brainstorming",
+		"ideas",
+		"planning",
+		"visualization"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "centralTopic",
+			"label": "Central Topic",
+			"description": "The main idea at the center of your mind map",
+			"type": "string",
+			"required": true,
+			"example": "My Project Idea"
+		},
+		{
+			"key": "purpose",
+			"label": "Purpose",
+			"description": "What you are using this mind map for",
+			"type": "string",
+			"required": false,
+			"example": "Brainstorming new features"
+		}
+	],
+	"shared": {
+		"industry": "personal-productivity",
+		"category": "knowledge",
+		"glossary": {
+			"branch": "A main subtopic radiating from the central idea",
+			"cross-link": "A connection between branches that are not directly related by hierarchy"
+		},
+		"aiExpertise": [
+			"Mind mapping methodology",
+			"Brainstorming facilitation",
+			"Idea organization and clustering",
+			"Creative thinking techniques",
+			"Visual thinking and spatial reasoning"
+		],
+		"dataModelHints": [
+			"topic",
+			"thing",
+			"document"
+		],
+		"suggestions": [
+			{
+				"label": "Add a central idea",
+				"prompt": "Help me define and add a central idea for my mind map"
+			},
+			{
+				"label": "Branch out",
+				"prompt": "Help me expand a branch of my mind map with new sub-topics"
+			},
+			{
+				"label": "Brainstorm freely",
+				"prompt": "Let's brainstorm ideas and I'll help organize them into a mind map"
+			},
+			{
+				"label": "Find connections",
+				"prompt": "Analyze my mind map and suggest cross-branch connections"
+			},
+			{
+				"label": "Prioritize ideas",
+				"prompt": "Help me prioritize the ideas in my mind map"
+			},
+			{
+				"label": "View mind map",
+				"prompt": "Show me my ideas in the mind map view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "topic",
+					"type": "Concept",
+					"description": "A main topic or branch radiating from the central idea",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "💡"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "branch",
+					"type": "Concept",
+					"description": "A sub-branch expanding on a parent topic",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🌿"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "idea",
+					"type": "Concept",
+					"description": "A leaf-level idea or insight",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "✨"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "category",
+					"type": "Concept",
+					"description": "A grouping category that clusters related branches",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🗂️"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "branch",
+					"to": "topic",
+					"verb": "PartOf",
+					"description": "Branch is a subdivision of this topic"
+				},
+				{
+					"from": "topic",
+					"to": "topic",
+					"verb": "RelatedTo",
+					"description": "Cross-branch association between topics"
+				},
+				{
+					"from": "topic",
+					"to": "idea",
+					"verb": "Contains",
+					"description": "Topic contains this leaf idea"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "creative",
+			"defaultTab": "explore",
+			"defaultView": "mindmap",
+			"defaultFile": "topics/central.md"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"When user adds a new topic branch",
+					"When user expands an idea",
+					"When user identifies a category",
+					"When user makes an association"
+				],
+				"typeMapping": {
+					"topic": "concept",
+					"branch": "concept",
+					"idea": "concept",
+					"category": "concept"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "partOf",
+					"description": "Branch of topic"
+				},
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "relatedTo",
+					"description": "Associated ideas"
+				},
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "contains",
+					"description": "Topic contains subtopic"
+				}
+			],
+			"rules": [
+				"Create concept entities for each branch",
+				"Link branches to their parent topics",
+				"Track associations between branches",
+				"Note color-coded groupings"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "central-idea.md",
+					"required": [
+						"Core Concept"
+					],
+					"optional": [
+						"Goals",
+						"Next Steps"
+					]
+				},
+				{
+					"path": "branches/*.md",
+					"required": [
+						"Overview"
+					],
+					"optional": [
+						"Sub-Ideas",
+						"Connections"
+					]
+				}
+			],
+			"projectChecks": [
+				"Central topic is clearly defined",
+				"At least 3 main branches exist",
+				"Branches have sub-ideas",
+				"Some cross-connections are documented"
+			],
+			"exportReady": [
+				"All branches have keywords (not sentences)",
+				"Cross-links are documented",
+				"Main themes are identified",
+				"Summary is complete"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert brainstorming facilitator and creative thinking coach helping people map and organize ideas visually using mind mapping techniques.",
+			"expertise": [
+				"Mind mapping methodology and best practices",
+				"Brainstorming and ideation techniques",
+				"Idea clustering and pattern recognition",
+				"Visual thinking frameworks",
+				"Creative problem solving"
+			],
+			"tone": "collaborator"
+		},
+		"difficulty": "beginner",
+		"templateTier": 4,
+		"deploy": {
+			"provider": "cloud-run",
+			"buildCommand": "npm run build",
+			"outputDir": "build",
+			"config": {
+				"port": 3000,
+				"memory": "512Mi"
+			},
+			"oneClickCommand": "gcloud run deploy"
+		},
+		"sampleData": {
+			"description": "Sample mind map for brainstorming a mobile app startup idea",
+			"entities": [
+				{
+					"type": "concept",
+					"name": "Mobile App Idea",
+					"properties": {
+						"description": "Central topic: Brainstorming a new mobile app product.",
+						"status": "in_progress",
+						"createdAt": "2025-01-10"
+					}
+				},
+				{
+					"type": "concept",
+					"name": "Target Users",
+					"properties": {
+						"description": "Who will use this app? Demographics and user personas.",
+						"status": "in_progress",
+						"createdAt": "2025-01-10"
+					}
+				},
+				{
+					"type": "concept",
+					"name": "Core Features",
+					"properties": {
+						"description": "Essential functionality the app must have.",
+						"status": "todo",
+						"createdAt": "2025-01-10"
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Target Users",
+					"verb": "relatedTo",
+					"to": "Mobile App Idea"
+				},
+				{
+					"from": "Core Features",
+					"verb": "relatedTo",
+					"to": "Mobile App Idea"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "visual-thinking",
+		"level": "beginner",
+		"learningObjectives": [
+			"Define a focused central idea that anchors all branches of the map",
+			"Generate branches rapidly using divergent thinking without premature filtering",
+			"Identify clusters and cross-links that reveal hidden structure in a topic",
+			"Distill a mind map into a prioritized list of actionable next steps"
+		],
+		"assessmentTypes": [
+			"portfolio"
+		],
+		"certificationSlug": "visual-thinker"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default mindMap;