@shrkcrft/presets 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/builtin/shared-snippets.d.ts

@@ -7,9 +7,9 @@ export declare const COMMON_TEMPLATE_SERVICE = "defineTemplate({\n    id: 'types
 export declare const COMMON_TEMPLATE_UTILITY = "defineTemplate({\n    id: 'typescript.utility',\n    name: 'typescript-utility',\n    description: 'A pure utility module (one exported function per file).',\n    tags: ['typescript', 'utility'],\n    scope: ['app'],\n    appliesWhen: ['generate-utility'],\n    variables: [\n      {\n        name: 'functionName',\n        required: true,\n        description: 'camelCase function name (e.g. formatDate).',\n        pattern: /^[a-z][A-Za-z0-9]+$/,\n      },\n    ],\n    targetPath: (v) => `src/utils/${v.functionName}.ts`,\n    content: (v) => `export function ${v.functionName}(): void {\\n  // TODO\\n}\\n`,\n  })";
 export declare const COMMON_TEMPLATE_TEST = "defineTemplate({\n    id: 'typescript.unit-test',\n    name: 'typescript-unit-test',\n    description: 'A bun:test unit-test skeleton for an existing module.',\n    tags: ['typescript', 'testing'],\n    scope: ['app'],\n    appliesWhen: ['generate-test'],\n    variables: [\n      {\n        name: 'subject',\n        required: true,\n        description: 'Subject name (used in describe + filename).',\n        pattern: /^[A-Za-z][A-Za-z0-9]+$/,\n      },\n    ],\n    targetPath: (v) => `tests/${v.subject}.spec.ts`,\n    content: (v) =>\n      `import { describe, expect, test } from 'bun:test';\\n\\ndescribe('${v.subject}', () => {\\n  test('placeholder', () => {\\n    expect(true).toBe(true);\\n  });\\n});\\n`,\n  })";
 export declare const TEMPLATE_HELPERS = "function kebab(s: string): string {\n  return s\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/[^A-Za-z0-9]+/g, '-')\n    .toLowerCase();\n}";
-export declare const COMMON_PATH_SERVICES = "defineKnowledgeEntry({\n    id: 'paths.services',\n    title: 'Services live in src/services/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'services'],\n    scope: ['app'],\n    appliesWhen: ['generate-service'],\n    content: 'Service classes live in src/services/. One service per file.',\n  })";
-export declare const COMMON_PATH_UTILS = "defineKnowledgeEntry({\n    id: 'paths.utils',\n    title: 'Utilities live in src/utils/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'utils'],\n    appliesWhen: ['generate-utility'],\n    content: 'Pure helpers live in src/utils/. One function per file.',\n  })";
-export declare const COMMON_PATH_TESTS = "defineKnowledgeEntry({\n    id: 'paths.tests',\n    title: 'Tests live in tests/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'tests'],\n    appliesWhen: ['generate-test'],\n    content: 'Unit tests live under tests/, mirroring src/. Use *.spec.ts.',\n  })";
+export declare const COMMON_PATH_SERVICES = "defineKnowledgeEntry({\n    id: 'paths.services',\n    title: 'Services live in src/services/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.High,\n    tags: ['paths', 'services'],\n    scope: ['app'],\n    appliesWhen: ['generate-service'],\n    content: 'Service classes live in src/services/. One service per file.',\n    metadata: { path: 'src/services' },\n  })";
+export declare const COMMON_PATH_UTILS = "defineKnowledgeEntry({\n    id: 'paths.utils',\n    title: 'Utilities live in src/utils/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'utils'],\n    appliesWhen: ['generate-utility'],\n    content: 'Pure helpers live in src/utils/. One function per file.',\n    metadata: { path: 'src/utils' },\n  })";
+export declare const COMMON_PATH_TESTS = "defineKnowledgeEntry({\n    id: 'paths.tests',\n    title: 'Tests live in tests/',\n    type: KnowledgeType.Path,\n    priority: KnowledgePriority.Medium,\n    tags: ['paths', 'tests'],\n    appliesWhen: ['generate-test'],\n    content: 'Unit tests live under tests/, mirroring src/. Use *.spec.ts.',\n    metadata: { path: 'tests' },\n  })";
 export declare const COMMON_RULE_INTERFACE_PREFIX = "defineKnowledgeEntry({\n    id: 'typescript.interfaces.i-prefix',\n    title: 'Prefix interfaces with I',\n    type: KnowledgeType.Rule,\n    priority: KnowledgePriority.High,\n    tags: ['typescript', 'naming'],\n    appliesWhen: ['generate-code', 'refactor'],\n    content: 'Interfaces use an I-prefix (IUser, IConfig). Enums are preferred over unions for closed sets.',\n  })";
 export declare const COMMON_RULE_ONE_EXPORT = "defineKnowledgeEntry({\n    id: 'typescript.files.one-export',\n    title: 'One exported construct per file',\n    type: KnowledgeType.Rule,\n    priority: KnowledgePriority.High,\n    tags: ['typescript', 'structure'],\n    appliesWhen: ['generate-code'],\n    content: 'Each TypeScript file exports exactly one top-level construct. Helpers live in their own file.',\n  })";
 export declare const COMMON_RULE_NO_LOGIC_CONSTRUCTORS = "defineKnowledgeEntry({\n    id: 'typescript.constructors.no-logic',\n    title: 'No business logic in constructors',\n    type: KnowledgeType.Rule,\n    priority: KnowledgePriority.High,\n    tags: ['typescript'],\n    appliesWhen: ['generate-code'],\n    content: 'Constructors wire dependencies only. Initialization belongs in init().',\n  })";

package/dist/builtin/shared-snippets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/shared-snippets.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,m9BAuB7B,CAAC;AAEN,eAAO,MAAM,kBAAkB,45BAoB1B,CAAC;AAEN,eAAO,MAAM,2BAA2B,s9CA6CnC,CAAC;AAEN,eAAO,MAAM,4BAA4B,s5BA6BpC,CAAC;AAEN,eAAO,MAAM,yBAAyB,yVAajC,CAAC;AAEN,eAAO,MAAM,uBAAuB,mtBAkB/B,CAAC;AAEN,eAAO,MAAM,uBAAuB,8mBAiB/B,CAAC;AAEN,eAAO,MAAM,oBAAoB,ytBAkB5B,CAAC;AAKN,eAAO,MAAM,gBAAgB,8JAK3B,CAAC;AAEH,eAAO,MAAM,oBAAoB,6VAS5B,CAAC;AAEN,eAAO,MAAM,iBAAiB,6TAQzB,CAAC;AAEN,eAAO,MAAM,iBAAiB,uTAQzB,CAAC;AAEN,eAAO,MAAM,4BAA4B,+XAQpC,CAAC;AAEN,eAAO,MAAM,sBAAsB,0XAQ9B,CAAC;AAEN,eAAO,MAAM,iCAAiC,6VAQzC,CAAC;AAEN,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,KAAG,MAK1D,CAAC"}
+{"version":3,"file":"shared-snippets.d.ts","sourceRoot":"","sources":["../../src/builtin/shared-snippets.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,m9BAuB7B,CAAC;AAEN,eAAO,MAAM,kBAAkB,45BAoB1B,CAAC;AAEN,eAAO,MAAM,2BAA2B,s9CA6CnC,CAAC;AAEN,eAAO,MAAM,4BAA4B,s5BA6BpC,CAAC;AAEN,eAAO,MAAM,yBAAyB,yVAajC,CAAC;AAEN,eAAO,MAAM,uBAAuB,mtBAkB/B,CAAC;AAEN,eAAO,MAAM,uBAAuB,8mBAiB/B,CAAC;AAEN,eAAO,MAAM,oBAAoB,ytBAkB5B,CAAC;AAKN,eAAO,MAAM,gBAAgB,8JAK3B,CAAC;AAEH,eAAO,MAAM,oBAAoB,sYAU5B,CAAC;AAEN,eAAO,MAAM,iBAAiB,mWASzB,CAAC;AAEN,eAAO,MAAM,iBAAiB,yVASzB,CAAC;AAEN,eAAO,MAAM,4BAA4B,+XAQpC,CAAC;AAEN,eAAO,MAAM,sBAAsB,0XAQ9B,CAAC;AAEN,eAAO,MAAM,iCAAiC,6VAQzC,CAAC;AAEN,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,KAAG,MAK1D,CAAC"}

package/dist/builtin/shared-snippets.js

@@ -210,6 +210,7 @@ export const COMMON_PATH_SERVICES = `defineKnowledgeEntry({
     scope: ['app'],
     appliesWhen: ['generate-service'],
     content: 'Service classes live in src/services/. One service per file.',
+    metadata: { path: 'src/services' },
   })`;
 export const COMMON_PATH_UTILS = `defineKnowledgeEntry({
     id: 'paths.utils',
@@ -219,6 +220,7 @@ export const COMMON_PATH_UTILS = `defineKnowledgeEntry({
     tags: ['paths', 'utils'],
     appliesWhen: ['generate-utility'],
     content: 'Pure helpers live in src/utils/. One function per file.',
+    metadata: { path: 'src/utils' },
   })`;
 export const COMMON_PATH_TESTS = `defineKnowledgeEntry({
     id: 'paths.tests',
@@ -228,6 +230,7 @@ export const COMMON_PATH_TESTS = `defineKnowledgeEntry({
     tags: ['paths', 'tests'],
     appliesWhen: ['generate-test'],
     content: 'Unit tests live under tests/, mirroring src/. Use *.spec.ts.',
+    metadata: { path: 'tests' },
   })`;
 export const COMMON_RULE_INTERFACE_PREFIX = `defineKnowledgeEntry({
     id: 'typescript.interfaces.i-prefix',

package/dist/emit/synthesize-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthesize-files.d.ts","sourceRoot":"","sources":["../../src/emit/synthesize-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,IAAI,EACA,QAAQ,GACR,WAAW,GACX,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,GACP,cAAc,GACd,SAAS,CAAC;CACf;AAsID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7D,GAAG,gBAAgB,EAAE,CAErB"}
+{"version":3,"file":"synthesize-files.d.ts","sourceRoot":"","sources":["../../src/emit/synthesize-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,IAAI,EACA,QAAQ,GACR,WAAW,GACX,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,GACP,cAAc,GACd,SAAS,CAAC;CACf;AAqMD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7D,GAAG,gBAAgB,EAAE,CAErB"}

package/dist/emit/synthesize-files.js

@@ -1,3 +1,62 @@
+// Self-contained preambles for each emitted file kind. Generated files
+// must work in a brand-new downstream repo where no `@shrkcrft/*`
+// packages are installed. The loaders (knowledge / templates / pipelines)
+// are shape-agnostic — they accept any object with the required string
+// fields — so we just need helpers + enum-like constants the snippets
+// reference. See `packages/knowledge/src/load/typescript-knowledge-loader.ts`
+// for the loader contract.
+const KNOWLEDGE_HELPERS = `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+const KnowledgePriority = {
+  Critical: 'critical',
+  High: 'high',
+  Medium: 'medium',
+  Low: 'low',
+} as const;
+
+const KnowledgeType = {
+  Rule: 'rule',
+  Path: 'path',
+  Template: 'template',
+  Architecture: 'architecture',
+  Technical: 'technical',
+  Business: 'business',
+  Command: 'command',
+  Environment: 'environment',
+  Dependency: 'dependency',
+  Feature: 'feature',
+  Task: 'task',
+  Warning: 'warning',
+  Decision: 'decision',
+  Convention: 'convention',
+  Workflow: 'workflow',
+  Testing: 'testing',
+  Security: 'security',
+  Deployment: 'deployment',
+  Integration: 'integration',
+  Custom: 'custom',
+} as const;
+
+function defineKnowledgeEntry<T>(entry: T): T {
+  return entry;
+}
+`;
+const TEMPLATE_HELPERS = `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+function defineTemplate<T>(template: T): T {
+  return template;
+}
+
+function kebab(s: string): string {
+  return s
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .replace(/[^A-Za-z0-9]+/g, '-')
+    .toLowerCase();
+}
+`;
+const PIPELINE_HELPERS = `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+function definePipeline<T>(pipeline: T): T {
+  return pipeline;
+}
+`;
 function recordToMap(v) {
     if (!v)
         return new Map();
@@ -11,48 +70,47 @@ function listBlock(items, indent = '  ') {
     return items.map((expr) => indent + expr.replace(/\n/g, `\n${indent}`)).join(',\n') + ',\n';
 }
 function knowledgeFile(items) {
-    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
-        'const knowledge = [\n' +
+    return (KNOWLEDGE_HELPERS +
+        '\nconst knowledge = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default knowledge;\n');
 }
 function rulesFile(items) {
-    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
-        'const rules = [\n' +
+    return (KNOWLEDGE_HELPERS +
+        '\nconst rules = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default rules;\n');
 }
 function pathsFile(items) {
-    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
-        'const paths = [\n' +
+    return (KNOWLEDGE_HELPERS +
+        '\nconst paths = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default paths;\n');
 }
 function templatesFile(items) {
-    // Inject a small kebab helper so template content() closures can use it.
-    // Generated code is self-contained — no extra runtime dependency required.
-    return ("import { defineTemplate } from '@shrkcrft/templates';\n\n" +
-        'function kebab(s: string): string {\n' +
-        "  return s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/[^A-Za-z0-9]+/g, '-').toLowerCase();\n" +
-        '}\n\n' +
-        'const templates = [\n' +
+    return (TEMPLATE_HELPERS +
+        '\nconst templates = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default templates;\n');
 }
 function pipelinesFile(items) {
-    return ("import { definePipeline } from '@shrkcrft/pipelines';\n\n" +
-        'const pipelines = [\n' +
+    return (PIPELINE_HELPERS +
+        '\nconst pipelines = [\n' +
         listBlock(items) +
         '];\n\n' +
         'export default pipelines;\n');
 }
 function configFile(preset) {
     // Generic config that points at the standard knowledge/rules/paths/etc.
-    // files. Consumers can tailor it later.
+    // files. Consumers can tailor it later. Plain default-exported object —
+    // the config loader (packages/config/src/config-loader.ts) validates the
+    // shape via zod and accepts an object literal as well as a
+    // `defineSharkCraftConfig()`-wrapped value, so the generated file does
+    // not need to import anything from `@shrkcrft/*`.
     const filesByKind = inferFiles(preset);
     const knowledgeFiles = filesByKind.has('knowledge.ts') ? ['knowledge.ts'] : [];
     const ruleFiles = filesByKind.has('rules.ts') ? ['rules.ts'] : [];
@@ -67,7 +125,8 @@ function configFile(preset) {
         ? `  surface: { profile: ${JSON.stringify(preset.surfaceProfile)} },\n`
         : '';
     return (`// Generated by \`shrk presets apply ${preset.id}\`.\n` +
-        '// Edit freely. SharkCraft does not regenerate this file.\n\n' +
+        '// Edit freely. SharkCraft does not regenerate this file.\n' +
+        '// Plain default export — no @shrkcrft/* import required.\n\n' +
         'const config = {\n' +
         `  projectName: 'shrk-project',\n` +
         `  description: ${JSON.stringify(preset.description)},\n` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/presets",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.4",
   "description": "SharkCraft presets: reusable project setups (knowledge/rules/paths/templates/pipelines/docs) that can be applied to a target repo through the CLI.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -42,9 +42,9 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.2",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.2",
-    "@shrkcrft/workspace": "^0.1.0-alpha.2"
+    "@shrkcrft/core": "^0.1.0-alpha.4",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.4",
+    "@shrkcrft/workspace": "^0.1.0-alpha.4"
   },
   "publishConfig": {
     "access": "public"