jekyll-component-mcp 0.0.0-stage → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/.github/skills/.gitkeep +0 -0
  2. package/.github/skills/jekyll-component-mcp/SKILL.md +98 -0
  3. package/CHANGELOG.md +18 -0
  4. package/LICENSE +21 -0
  5. package/README.md +167 -2
  6. package/dist/config/constants.d.ts +46 -0
  7. package/dist/config/constants.d.ts.map +1 -0
  8. package/dist/config/constants.js +75 -0
  9. package/dist/config/constants.js.map +1 -0
  10. package/dist/config/environment.d.ts +51 -0
  11. package/dist/config/environment.d.ts.map +1 -0
  12. package/dist/config/environment.js +102 -0
  13. package/dist/config/environment.js.map +1 -0
  14. package/dist/index.d.ts +7 -0
  15. package/dist/index.d.ts.map +1 -0
  16. package/dist/index.js +86 -0
  17. package/dist/index.js.map +1 -0
  18. package/dist/parsers/frontmatter-parser.d.ts +19 -0
  19. package/dist/parsers/frontmatter-parser.d.ts.map +1 -0
  20. package/dist/parsers/frontmatter-parser.js +71 -0
  21. package/dist/parsers/frontmatter-parser.js.map +1 -0
  22. package/dist/parsers/liquid-parser.d.ts +33 -0
  23. package/dist/parsers/liquid-parser.d.ts.map +1 -0
  24. package/dist/parsers/liquid-parser.js +98 -0
  25. package/dist/parsers/liquid-parser.js.map +1 -0
  26. package/dist/parsers/project-scanner.d.ts +29 -0
  27. package/dist/parsers/project-scanner.d.ts.map +1 -0
  28. package/dist/parsers/project-scanner.js +194 -0
  29. package/dist/parsers/project-scanner.js.map +1 -0
  30. package/dist/parsers/scss-parser.d.ts +26 -0
  31. package/dist/parsers/scss-parser.d.ts.map +1 -0
  32. package/dist/parsers/scss-parser.js +90 -0
  33. package/dist/parsers/scss-parser.js.map +1 -0
  34. package/dist/security/command-policy.d.ts +21 -0
  35. package/dist/security/command-policy.d.ts.map +1 -0
  36. package/dist/security/command-policy.js +48 -0
  37. package/dist/security/command-policy.js.map +1 -0
  38. package/dist/security/path-policy.d.ts +31 -0
  39. package/dist/security/path-policy.d.ts.map +1 -0
  40. package/dist/security/path-policy.js +127 -0
  41. package/dist/security/path-policy.js.map +1 -0
  42. package/dist/security/validation.d.ts +18 -0
  43. package/dist/security/validation.d.ts.map +1 -0
  44. package/dist/security/validation.js +59 -0
  45. package/dist/security/validation.js.map +1 -0
  46. package/dist/server/context.d.ts +18 -0
  47. package/dist/server/context.d.ts.map +1 -0
  48. package/dist/server/context.js +34 -0
  49. package/dist/server/context.js.map +1 -0
  50. package/dist/server/create-server.d.ts +8 -0
  51. package/dist/server/create-server.d.ts.map +1 -0
  52. package/dist/server/create-server.js +546 -0
  53. package/dist/server/create-server.js.map +1 -0
  54. package/dist/services/build-service.d.ts +27 -0
  55. package/dist/services/build-service.d.ts.map +1 -0
  56. package/dist/services/build-service.js +85 -0
  57. package/dist/services/build-service.js.map +1 -0
  58. package/dist/services/component-service.d.ts +74 -0
  59. package/dist/services/component-service.d.ts.map +1 -0
  60. package/dist/services/component-service.js +422 -0
  61. package/dist/services/component-service.js.map +1 -0
  62. package/dist/services/documentation-service.d.ts +64 -0
  63. package/dist/services/documentation-service.d.ts.map +1 -0
  64. package/dist/services/documentation-service.js +186 -0
  65. package/dist/services/documentation-service.js.map +1 -0
  66. package/dist/services/liquid-service.d.ts +31 -0
  67. package/dist/services/liquid-service.d.ts.map +1 -0
  68. package/dist/services/liquid-service.js +103 -0
  69. package/dist/services/liquid-service.js.map +1 -0
  70. package/dist/services/project-service.d.ts +30 -0
  71. package/dist/services/project-service.d.ts.map +1 -0
  72. package/dist/services/project-service.js +102 -0
  73. package/dist/services/project-service.js.map +1 -0
  74. package/dist/services/scss-service.d.ts +37 -0
  75. package/dist/services/scss-service.d.ts.map +1 -0
  76. package/dist/services/scss-service.js +82 -0
  77. package/dist/services/scss-service.js.map +1 -0
  78. package/dist/services/token-service.d.ts +29 -0
  79. package/dist/services/token-service.d.ts.map +1 -0
  80. package/dist/services/token-service.js +97 -0
  81. package/dist/services/token-service.js.map +1 -0
  82. package/dist/services/validation-service.d.ts +33 -0
  83. package/dist/services/validation-service.d.ts.map +1 -0
  84. package/dist/services/validation-service.js +101 -0
  85. package/dist/services/validation-service.js.map +1 -0
  86. package/dist/utils/filesystem.d.ts +38 -0
  87. package/dist/utils/filesystem.d.ts.map +1 -0
  88. package/dist/utils/filesystem.js +131 -0
  89. package/dist/utils/filesystem.js.map +1 -0
  90. package/dist/utils/json.d.ts +6 -0
  91. package/dist/utils/json.d.ts.map +1 -0
  92. package/dist/utils/json.js +20 -0
  93. package/dist/utils/json.js.map +1 -0
  94. package/dist/utils/logger.d.ts +14 -0
  95. package/dist/utils/logger.d.ts.map +1 -0
  96. package/dist/utils/logger.js +58 -0
  97. package/dist/utils/logger.js.map +1 -0
  98. package/dist/utils/shell.d.ts +23 -0
  99. package/dist/utils/shell.d.ts.map +1 -0
  100. package/dist/utils/shell.js +96 -0
  101. package/dist/utils/shell.js.map +1 -0
  102. package/dist/utils/yaml.d.ts +15 -0
  103. package/dist/utils/yaml.d.ts.map +1 -0
  104. package/dist/utils/yaml.js +34 -0
  105. package/dist/utils/yaml.js.map +1 -0
  106. package/package.json +65 -4
  107. package/skills/SKILL.md +98 -0
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Jekyll build execution via allowlisted commands.
3
+ */
4
+ import { runAllowedCommand } from "../utils/shell.js";
5
+ import { safeExists } from "../utils/filesystem.js";
6
+ import { logger } from "../utils/logger.js";
7
+ export class BuildService {
8
+ ctx;
9
+ constructor(ctx) {
10
+ this.ctx = ctx;
11
+ }
12
+ async build(options = {}) {
13
+ const { root, build } = this.ctx.config;
14
+ let command = build.command;
15
+ // Prefer bundle exec when Gemfile present and command is plain jekyll
16
+ if (safeExists(root, "Gemfile") && command === "jekyll build") {
17
+ command = "bundle exec jekyll build";
18
+ }
19
+ if (options.clean) {
20
+ const cleanCmd = command.includes("bundle exec")
21
+ ? "bundle exec jekyll clean"
22
+ : "jekyll clean";
23
+ logger.info("Running jekyll clean first");
24
+ await runAllowedCommand(cleanCmd, {
25
+ cwd: root,
26
+ timeoutMs: Math.min(build.timeout, 60_000),
27
+ });
28
+ }
29
+ logger.info("Running Jekyll build", { command });
30
+ const result = await runAllowedCommand(command, {
31
+ cwd: root,
32
+ timeoutMs: build.timeout,
33
+ });
34
+ const sitePath = safeExists(root, this.ctx.config.paths.site)
35
+ ? this.ctx.config.paths.site
36
+ : null;
37
+ if (result.timedOut) {
38
+ return {
39
+ success: false,
40
+ ...result,
41
+ sitePath,
42
+ error: {
43
+ code: "BUILD_TIMEOUT",
44
+ message: `Jekyll build timed out after ${build.timeout}ms`,
45
+ },
46
+ };
47
+ }
48
+ if (result.exitCode !== 0) {
49
+ return {
50
+ success: false,
51
+ ...result,
52
+ sitePath,
53
+ error: {
54
+ code: "BUILD_FAILED",
55
+ message: `Jekyll build exited with code ${result.exitCode}`,
56
+ },
57
+ };
58
+ }
59
+ return {
60
+ success: true,
61
+ ...result,
62
+ sitePath,
63
+ };
64
+ }
65
+ async doctor() {
66
+ const { root, build } = this.ctx.config;
67
+ let command = "jekyll doctor";
68
+ if (safeExists(root, "Gemfile")) {
69
+ command = "bundle exec jekyll doctor";
70
+ }
71
+ const result = await runAllowedCommand(command, {
72
+ cwd: root,
73
+ timeoutMs: Math.min(build.timeout, 60_000),
74
+ });
75
+ return {
76
+ success: result.exitCode === 0 && !result.timedOut,
77
+ ...result,
78
+ sitePath: null,
79
+ error: result.exitCode !== 0
80
+ ? { code: "DOCTOR_FAILED", message: "jekyll doctor reported issues" }
81
+ : undefined,
82
+ };
83
+ }
84
+ }
85
+ //# sourceMappingURL=build-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-service.js","sourceRoot":"","sources":["../../src/services/build-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Component CRUD, validation, and generation for the Jekyll Component Framework.
3
+ */
4
+ import type { ServerContext } from "../server/context.js";
5
+ import { analyzeLiquid } from "../parsers/liquid-parser.js";
6
+ export interface ComponentDescriptor {
7
+ name: string;
8
+ liquid?: string;
9
+ scss?: string;
10
+ javascript?: string;
11
+ documentation?: string;
12
+ example?: string;
13
+ }
14
+ export interface ComponentDetail extends ComponentDescriptor {
15
+ liquidSource?: string;
16
+ scssSource?: string;
17
+ javascriptSource?: string;
18
+ documentationSource?: string;
19
+ parameters: ReturnType<typeof analyzeLiquid>["parameters"];
20
+ variants: string[];
21
+ accessibilityNotes: string[];
22
+ classNames: string[];
23
+ }
24
+ export interface CreateComponentInput {
25
+ name: string;
26
+ category?: string;
27
+ variants?: string[];
28
+ javascript?: boolean;
29
+ documentation?: boolean;
30
+ example?: boolean;
31
+ dry_run?: boolean;
32
+ }
33
+ export interface MutationResult {
34
+ success: boolean;
35
+ operation: string;
36
+ component?: string;
37
+ files_created?: string[];
38
+ files_modified?: string[];
39
+ dry_run?: boolean;
40
+ operations?: Array<{
41
+ type: string;
42
+ path: string;
43
+ }>;
44
+ warnings?: string[];
45
+ error?: {
46
+ code: string;
47
+ message: string;
48
+ details?: unknown;
49
+ };
50
+ }
51
+ export interface ValidateResult {
52
+ valid: boolean;
53
+ component: string;
54
+ errors: Array<{
55
+ file?: string;
56
+ message: string;
57
+ }>;
58
+ warnings: Array<{
59
+ file?: string;
60
+ message: string;
61
+ }>;
62
+ }
63
+ export declare class ComponentService {
64
+ private readonly ctx;
65
+ private project;
66
+ constructor(ctx: ServerContext);
67
+ list(): ComponentDescriptor[];
68
+ get(name: string): ComponentDetail | null;
69
+ create(input: CreateComponentInput): MutationResult;
70
+ private ensureScssImport;
71
+ validate(name: string): ValidateResult;
72
+ delete(name: string, confirm: boolean): MutationResult;
73
+ }
74
+ //# sourceMappingURL=component-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"component-service.d.ts","sourceRoot":"","sources":["../../src/services/component-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAS1D,OAAO,EAAE,aAAa,EAAqB,MAAM,6BAA6B,CAAC;AAK/E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,YAAY,CAAC,CAAC;IAC3D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAqGD,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,OAAO,CAAiB;gBAEH,GAAG,EAAE,aAAa;IAI/C,IAAI,IAAI,mBAAmB,EAAE;IAK7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAuDzC,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc;IAkJnD,OAAO,CAAC,gBAAgB;IA2CxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IA2CtC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc;CAqDvD"}
@@ -0,0 +1,422 @@
1
+ /**
2
+ * Component CRUD, validation, and generation for the Jekyll Component Framework.
3
+ */
4
+ import path from "node:path";
5
+ import { assertWriteAllowed } from "../server/context.js";
6
+ import { normalizeComponentName } from "../security/validation.js";
7
+ import { safeExists, safeReadFile, safeWriteFile, safeUnlink, } from "../utils/filesystem.js";
8
+ import { analyzeLiquid, checkLiquidSyntax } from "../parsers/liquid-parser.js";
9
+ import { findImportForComponent } from "../parsers/scss-parser.js";
10
+ import { ProjectService } from "./project-service.js";
11
+ import { logger } from "../utils/logger.js";
12
+ function defaultLiquidTemplate(name, variants) {
13
+ const classBase = name;
14
+ const variantList = variants.length ? variants.join(", ") : "default";
15
+ return `{% comment %}
16
+ Component: ${name}
17
+ Variants: ${variantList}
18
+ Usage: {% include components/${name}.html label="Click me" variant="default" %}
19
+ {% endcomment %}
20
+ {% assign variant = include.variant | default: "default" %}
21
+ {% assign label = include.label | default: "" %}
22
+ {% assign extra_class = include.class | default: "" %}
23
+
24
+ <div class="${classBase} ${classBase}--{{ variant }} {{ extra_class }}"{% if include.id %} id="{{ include.id }}"{% endif %}>
25
+ {% if label != blank %}
26
+ <span class="${classBase}__label">{{ label }}</span>
27
+ {% endif %}
28
+ {{ include.content }}
29
+ </div>
30
+ `;
31
+ }
32
+ function defaultScssTemplate(name, variants) {
33
+ const lines = [
34
+ `// Component: ${name}`,
35
+ `.${name} {`,
36
+ ` // Base styles`,
37
+ ``,
38
+ ` &__label {`,
39
+ ` display: inline-block;`,
40
+ ` }`,
41
+ ``,
42
+ ];
43
+ for (const v of variants) {
44
+ lines.push(` &--${v} {`);
45
+ lines.push(` // variant: ${v}`);
46
+ lines.push(` }`);
47
+ lines.push(``);
48
+ }
49
+ lines.push(`}`);
50
+ lines.push(``);
51
+ return lines.join("\n");
52
+ }
53
+ function defaultDocsTemplate(name, variants) {
54
+ return `---
55
+ title: ${name}
56
+ ---
57
+
58
+ # ${name}
59
+
60
+ ## Overview
61
+
62
+ Reusable \`${name}\` component for the Jekyll Component Framework.
63
+
64
+ ## Usage
65
+
66
+ \`\`\`liquid
67
+ {% include components/${name}.html label="Example" variant="default" %}
68
+ \`\`\`
69
+
70
+ ## Parameters
71
+
72
+ | Name | Type | Default | Description |
73
+ |------|------|---------|-------------|
74
+ | label | string | \`""\` | Visible label text |
75
+ | variant | string | \`"default"\` | Visual variant |
76
+ | class | string | \`""\` | Extra CSS classes |
77
+ | id | string | — | Optional element id |
78
+ | content | string | — | Nested content |
79
+
80
+ ## Variants
81
+
82
+ ${variants.map((v) => `- \`${v}\``).join("\n")}
83
+
84
+ ## Example
85
+
86
+ See \`examples/components/${name}.html\`.
87
+
88
+ ## Accessibility
89
+
90
+ - Ensure interactive variants expose keyboard support and focus styles.
91
+ - Prefer semantic HTML over ARIA when possible.
92
+
93
+ ## Notes
94
+
95
+ Generated by jekyll-component-mcp.
96
+ `;
97
+ }
98
+ function defaultExampleTemplate(name) {
99
+ return `---
100
+ layout: default
101
+ title: ${name} example
102
+ ---
103
+
104
+ {% include components/${name}.html label="Example ${name}" variant="default" %}
105
+ `;
106
+ }
107
+ export class ComponentService {
108
+ ctx;
109
+ project;
110
+ constructor(ctx) {
111
+ this.ctx = ctx;
112
+ this.project = new ProjectService(ctx);
113
+ }
114
+ list() {
115
+ const scan = this.project.getScan();
116
+ return scan.components;
117
+ }
118
+ get(name) {
119
+ const normalized = normalizeComponentName(name);
120
+ const scan = this.project.getScan();
121
+ const desc = scan.components.find((c) => c.name === normalized);
122
+ if (!desc)
123
+ return null;
124
+ const root = this.ctx.config.root;
125
+ const maxSize = this.ctx.config.maxFileSize;
126
+ let liquidSource;
127
+ let scssSource;
128
+ let javascriptSource;
129
+ let documentationSource;
130
+ if (desc.liquid && safeExists(root, desc.liquid)) {
131
+ liquidSource = safeReadFile(root, desc.liquid, { maxSize });
132
+ }
133
+ if (desc.scss && safeExists(root, desc.scss)) {
134
+ scssSource = safeReadFile(root, desc.scss, { maxSize });
135
+ }
136
+ if (desc.javascript && safeExists(root, desc.javascript)) {
137
+ javascriptSource = safeReadFile(root, desc.javascript, { maxSize });
138
+ }
139
+ if (desc.documentation && safeExists(root, desc.documentation)) {
140
+ documentationSource = safeReadFile(root, desc.documentation, { maxSize });
141
+ }
142
+ const analysis = liquidSource ? analyzeLiquid(liquidSource) : null;
143
+ const variants = [];
144
+ if (liquidSource) {
145
+ const variantMatches = liquidSource.matchAll(/--([a-z0-9-]+)/gi);
146
+ for (const m of variantMatches) {
147
+ if (m[1] && !variants.includes(m[1]))
148
+ variants.push(m[1]);
149
+ }
150
+ }
151
+ if (scssSource) {
152
+ const scssVars = scssSource.matchAll(/&--([a-z0-9-]+)/gi);
153
+ for (const m of scssVars) {
154
+ if (m[1] && !variants.includes(m[1]))
155
+ variants.push(m[1]);
156
+ }
157
+ }
158
+ return {
159
+ ...desc,
160
+ liquidSource,
161
+ scssSource,
162
+ javascriptSource,
163
+ documentationSource,
164
+ parameters: analysis?.parameters ?? [],
165
+ variants: variants.length ? variants : ["default"],
166
+ accessibilityNotes: analysis?.accessibilityHints ?? [],
167
+ classNames: analysis?.classNames ?? [],
168
+ };
169
+ }
170
+ create(input) {
171
+ const name = normalizeComponentName(input.name);
172
+ const variants = (input.variants?.length ? input.variants : ["default"]).map((v) => v.toLowerCase().replace(/[^a-z0-9-]/g, "-"));
173
+ const dryRun = input.dry_run === true;
174
+ const paths = this.ctx.config.paths;
175
+ const root = this.ctx.config.root;
176
+ try {
177
+ assertWriteAllowed(this.ctx, "create");
178
+ }
179
+ catch (err) {
180
+ return {
181
+ success: false,
182
+ operation: "component_create",
183
+ error: {
184
+ code: err.code ?? "WRITE_MODE_DENIED",
185
+ message: err.message,
186
+ },
187
+ };
188
+ }
189
+ const liquidPath = path.posix.join(paths.components, `${name}.html`);
190
+ const scssPath = path.posix.join(paths.scssComponents ?? path.posix.join(paths.scss, "components"), `_${name}.scss`);
191
+ const docsPath = input.documentation !== false
192
+ ? path.posix.join(paths.docsComponents ?? path.posix.join(paths.docs, "components"), `${name}.md`)
193
+ : null;
194
+ const examplePath = input.example !== false
195
+ ? path.posix.join(paths.examplesComponents ?? path.posix.join(paths.examples, "components"), `${name}.html`)
196
+ : null;
197
+ const jsPath = input.javascript === true
198
+ ? path.posix.join(paths.jsComponents ?? path.posix.join(paths.js, "components"), `${name}.js`)
199
+ : null;
200
+ const planned = [
201
+ { type: "create", path: liquidPath },
202
+ { type: "create", path: scssPath },
203
+ ];
204
+ if (docsPath)
205
+ planned.push({ type: "create", path: docsPath });
206
+ if (examplePath)
207
+ planned.push({ type: "create", path: examplePath });
208
+ if (jsPath)
209
+ planned.push({ type: "create", path: jsPath });
210
+ // Check collisions
211
+ const warnings = [];
212
+ for (const p of planned) {
213
+ if (safeExists(root, p.path)) {
214
+ warnings.push(`File already exists and will be overwritten: ${p.path}`);
215
+ }
216
+ }
217
+ if (dryRun) {
218
+ return {
219
+ success: true,
220
+ operation: "component_create",
221
+ component: name,
222
+ dry_run: true,
223
+ operations: planned,
224
+ warnings,
225
+ };
226
+ }
227
+ const filesCreated = [];
228
+ const filesModified = [];
229
+ try {
230
+ const liquidResult = safeWriteFile(root, liquidPath, defaultLiquidTemplate(name, variants), { maxSize: this.ctx.config.maxFileSize });
231
+ if (liquidResult.created)
232
+ filesCreated.push(liquidResult.path);
233
+ else if (liquidResult.modified)
234
+ filesModified.push(liquidResult.path);
235
+ const scssResult = safeWriteFile(root, scssPath, defaultScssTemplate(name, variants), { maxSize: this.ctx.config.maxFileSize });
236
+ if (scssResult.created)
237
+ filesCreated.push(scssResult.path);
238
+ else if (scssResult.modified)
239
+ filesModified.push(scssResult.path);
240
+ if (docsPath) {
241
+ const r = safeWriteFile(root, docsPath, defaultDocsTemplate(name, variants), {
242
+ maxSize: this.ctx.config.maxFileSize,
243
+ });
244
+ if (r.created)
245
+ filesCreated.push(r.path);
246
+ else if (r.modified)
247
+ filesModified.push(r.path);
248
+ }
249
+ if (examplePath) {
250
+ const r = safeWriteFile(root, examplePath, defaultExampleTemplate(name), {
251
+ maxSize: this.ctx.config.maxFileSize,
252
+ });
253
+ if (r.created)
254
+ filesCreated.push(r.path);
255
+ else if (r.modified)
256
+ filesModified.push(r.path);
257
+ }
258
+ if (jsPath) {
259
+ const r = safeWriteFile(root, jsPath, `// Component: ${name}\nexport function init${name.replace(/(^|-)(\w)/g, (_, __, c) => c.toUpperCase())}() {\n // TODO\n}\n`, { maxSize: this.ctx.config.maxFileSize });
260
+ if (r.created)
261
+ filesCreated.push(r.path);
262
+ else if (r.modified)
263
+ filesModified.push(r.path);
264
+ }
265
+ // Try to register SCSS import in common entry points
266
+ this.ensureScssImport(name, scssPath, warnings);
267
+ this.ctx.invalidateCache();
268
+ logger.info("component_create", { name, filesCreated });
269
+ return {
270
+ success: true,
271
+ operation: "component_create",
272
+ component: name,
273
+ files_created: filesCreated,
274
+ files_modified: filesModified,
275
+ warnings,
276
+ };
277
+ }
278
+ catch (err) {
279
+ return {
280
+ success: false,
281
+ operation: "component_create",
282
+ component: name,
283
+ error: {
284
+ code: "CREATE_FAILED",
285
+ message: err.message,
286
+ },
287
+ };
288
+ }
289
+ }
290
+ ensureScssImport(name, scssPath, warnings) {
291
+ const root = this.ctx.config.root;
292
+ const paths = this.ctx.config.paths;
293
+ const candidates = [
294
+ path.posix.join(paths.scss, "components", "_index.scss"),
295
+ path.posix.join(paths.scss, "_components.scss"),
296
+ path.posix.join(paths.scss, "main.scss"),
297
+ path.posix.join(paths.scss, "app.scss"),
298
+ path.posix.join(paths.scss, "style.scss"),
299
+ path.posix.join(paths.scss, "styles.scss"),
300
+ path.posix.join(paths.scss, "index.scss"),
301
+ ];
302
+ for (const entry of candidates) {
303
+ if (!safeExists(root, entry))
304
+ continue;
305
+ try {
306
+ const source = safeReadFile(root, entry, { maxSize: this.ctx.config.maxFileSize });
307
+ const found = findImportForComponent(source, name);
308
+ if (found.present) {
309
+ logger.debug("SCSS import already present", { entry, name });
310
+ return;
311
+ }
312
+ // Prefer @use with relative path from entry
313
+ const entryDir = path.posix.dirname(entry);
314
+ let importPath = path.posix.relative(entryDir, scssPath).replace(/\.scss$/, "");
315
+ if (!importPath.startsWith("."))
316
+ importPath = `./${importPath}`;
317
+ // Strip leading underscore for Sass convention
318
+ importPath = importPath.replace(/\/_([^/]+)$/, "/$1");
319
+ const line = `@use "${importPath}";\n`;
320
+ const next = source.endsWith("\n") ? source + line : source + "\n" + line;
321
+ safeWriteFile(root, entry, next, { maxSize: this.ctx.config.maxFileSize });
322
+ warnings.push(`Added SCSS import to ${entry}`);
323
+ return;
324
+ }
325
+ catch (err) {
326
+ warnings.push(`Could not update SCSS entry ${entry}: ${err.message}`);
327
+ }
328
+ }
329
+ warnings.push("No SCSS entry point found to register the component import. Add the import manually.");
330
+ }
331
+ validate(name) {
332
+ const normalized = normalizeComponentName(name);
333
+ const detail = this.get(normalized);
334
+ const errors = [];
335
+ const warnings = [];
336
+ if (!detail) {
337
+ return {
338
+ valid: false,
339
+ component: normalized,
340
+ errors: [{ message: `Component not found: ${normalized}` }],
341
+ warnings: [],
342
+ };
343
+ }
344
+ if (!detail.liquid) {
345
+ errors.push({ message: "Missing Liquid include file" });
346
+ }
347
+ else if (detail.liquidSource) {
348
+ const syntax = checkLiquidSyntax(detail.liquidSource);
349
+ for (const e of syntax.errors)
350
+ errors.push({ file: detail.liquid, message: e });
351
+ for (const w of syntax.warnings)
352
+ warnings.push({ file: detail.liquid, message: w });
353
+ const analysis = analyzeLiquid(detail.liquidSource);
354
+ for (const h of analysis.accessibilityHints) {
355
+ warnings.push({ file: detail.liquid, message: h });
356
+ }
357
+ }
358
+ if (!detail.scss) {
359
+ warnings.push({ message: "No associated SCSS file detected" });
360
+ }
361
+ if (!detail.documentation) {
362
+ warnings.push({ message: "No documentation file detected" });
363
+ }
364
+ return {
365
+ valid: errors.length === 0,
366
+ component: normalized,
367
+ errors,
368
+ warnings,
369
+ };
370
+ }
371
+ delete(name, confirm) {
372
+ if (!confirm) {
373
+ return {
374
+ success: false,
375
+ operation: "component_delete",
376
+ error: {
377
+ code: "CONFIRMATION_REQUIRED",
378
+ message: "Destructive delete requires confirm: true",
379
+ },
380
+ };
381
+ }
382
+ try {
383
+ assertWriteAllowed(this.ctx, "destructive");
384
+ }
385
+ catch (err) {
386
+ return {
387
+ success: false,
388
+ operation: "component_delete",
389
+ error: {
390
+ code: err.code ?? "WRITE_MODE_DENIED",
391
+ message: err.message,
392
+ },
393
+ };
394
+ }
395
+ const normalized = normalizeComponentName(name);
396
+ const detail = this.get(normalized);
397
+ if (!detail) {
398
+ return {
399
+ success: false,
400
+ operation: "component_delete",
401
+ error: { code: "NOT_FOUND", message: `Component not found: ${normalized}` },
402
+ };
403
+ }
404
+ const root = this.ctx.config.root;
405
+ const deleted = [];
406
+ for (const key of ["liquid", "scss", "javascript", "documentation", "example"]) {
407
+ const p = detail[key];
408
+ if (p && safeExists(root, p)) {
409
+ safeUnlink(root, p);
410
+ deleted.push(p);
411
+ }
412
+ }
413
+ this.ctx.invalidateCache();
414
+ return {
415
+ success: true,
416
+ operation: "component_delete",
417
+ component: normalized,
418
+ files_modified: deleted,
419
+ };
420
+ }
421
+ }
422
+ //# sourceMappingURL=component-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"component-service.js","sourceRoot":"","sources":["../../src/services/component-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAmD5C,SAAS,qBAAqB,CAAC,IAAY,EAAE,QAAkB;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC;IACvB,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,OAAO;eACM,IAAI;cACL,WAAW;iCACQ,IAAI;;;;;;cAMvB,SAAS,IAAI,SAAS;;mBAEjB,SAAS;;;;CAI3B,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,QAAkB;IAC3D,MAAM,KAAK,GAAG;QACZ,iBAAiB,IAAI,EAAE;QACvB,IAAI,IAAI,IAAI;QACZ,kBAAkB;QAClB,EAAE;QACF,cAAc;QACd,4BAA4B;QAC5B,KAAK;QACL,EAAE;KACH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,QAAkB;IAC3D,OAAO;SACA,IAAI;;;IAGT,IAAI;;;;aAIK,IAAI;;;;;wBAKO,IAAI;;;;;;;;;;;;;;;EAe1B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;4BAIlB,IAAI;;;;;;;;;;CAU/B,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,OAAO;;SAEA,IAAI;;;wBAGW,IAAI,wBAAwB,IAAI;CACvD,CAAC;AACF,CAAC;AAED,MAAM,OAAO,gBAAgB;IAGE;IAFrB,OAAO,CAAiB;IAEhC,YAA6B,GAAkB;QAAlB,QAAG,GAAH,GAAG,CAAe;QAC7C,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC;QAE5C,IAAI,YAAgC,CAAC;QACrC,IAAI,UAA8B,CAAC;QACnC,IAAI,gBAAoC,CAAC;QACzC,IAAI,mBAAuC,CAAC;QAE5C,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACjD,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,UAAU,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,gBAAgB,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/D,mBAAmB,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;YACjE,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;gBAC/B,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAC1D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,OAAO;YACL,GAAG,IAAI;YACP,YAAY;YACZ,UAAU;YACV,gBAAgB;YAChB,mBAAmB;YACnB,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,EAAE;YACtC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAClD,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,IAAI,EAAE;YACtD,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,EAAE;SACvC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAA2B;QAChC,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACjF,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAC5C,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAElC,IAAI,CAAC;YACH,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,kBAAkB;gBAC7B,KAAK,EAAE;oBACL,IAAI,EAAG,GAAyB,CAAC,IAAI,IAAI,mBAAmB;oBAC5D,OAAO,EAAG,GAAa,CAAC,OAAO;iBAChC;aACF,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAC9B,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,EACjE,IAAI,IAAI,OAAO,CAChB,CAAC;QACF,MAAM,QAAQ,GACZ,KAAK,CAAC,aAAa,KAAK,KAAK;YAC3B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,GAAG,IAAI,KAAK,CAAC;YAClG,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,WAAW,GACf,KAAK,CAAC,OAAO,KAAK,KAAK;YACrB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CACb,KAAK,CAAC,kBAAkB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,EACzE,GAAG,IAAI,OAAO,CACf;YACH,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,MAAM,GACV,KAAK,CAAC,UAAU,KAAK,IAAI;YACvB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,GAAG,IAAI,KAAK,CAAC;YAC9F,CAAC,CAAC,IAAI,CAAC;QAEX,MAAM,OAAO,GAA0C;YACrD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE;YACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;SACnC,CAAC;QACF,IAAI,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/D,IAAI,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACrE,IAAI,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3D,mBAAmB;QACnB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,kBAAkB;gBAC7B,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,OAAO;gBACnB,QAAQ;aACT,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,aAAa,CAChC,IAAI,EACJ,UAAU,EACV,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,EACrC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CACzC,CAAC;YACF,IAAI,YAAY,CAAC,OAAO;gBAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;iBAC1D,IAAI,YAAY,CAAC,QAAQ;gBAAE,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAEtE,MAAM,UAAU,GAAG,aAAa,CAC9B,IAAI,EACJ,QAAQ,EACR,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,EACnC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CACzC,CAAC;YACF,IAAI,UAAU,CAAC,OAAO;gBAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;iBACtD,IAAI,UAAU,CAAC,QAAQ;gBAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAElE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;oBAC3E,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW;iBACrC,CAAC,CAAC;gBACH,IAAI,CAAC,CAAC,OAAO;oBAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBACpC,IAAI,CAAC,CAAC,QAAQ;oBAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,sBAAsB,CAAC,IAAI,CAAC,EAAE;oBACvE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW;iBACrC,CAAC,CAAC;gBACH,IAAI,CAAC,CAAC,OAAO;oBAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBACpC,IAAI,CAAC,CAAC,QAAQ;oBAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,GAAG,aAAa,CACrB,IAAI,EACJ,MAAM,EACN,iBAAiB,IAAI,yBAAyB,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,sBAAsB,EACrI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CACzC,CAAC;gBACF,IAAI,CAAC,CAAC,OAAO;oBAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBACpC,IAAI,CAAC,CAAC,QAAQ;oBAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,qDAAqD;YACrD,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAEhD,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,kBAAkB;gBAC7B,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,YAAY;gBAC3B,cAAc,EAAE,aAAa;gBAC7B,QAAQ;aACT,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,kBAAkB;gBAC7B,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE;oBACL,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAG,GAAa,CAAC,OAAO;iBAChC;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,QAAkB;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QACpC,MAAM,UAAU,GAAG;YACjB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,CAAC;YACxD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,kBAAkB,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC;SAC1C,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC;gBAAE,SAAS;YACvC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;gBACnF,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACnD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC7D,OAAO;gBACT,CAAC;gBACD,4CAA4C;gBAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC3C,IAAI,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAChF,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,UAAU,GAAG,KAAK,UAAU,EAAE,CAAC;gBAChE,+CAA+C;gBAC/C,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;gBAEtD,MAAM,IAAI,GAAG,SAAS,UAAU,MAAM,CAAC;gBACvC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;gBAC1E,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC3E,QAAQ,CAAC,IAAI,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;gBAC/C,OAAO;YACT,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,+BAA+B,KAAK,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,IAAI,CACX,sFAAsF,CACvF,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,MAAM,GAA6B,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAA+B,EAAE,CAAC;QAEhD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,wBAAwB,UAAU,EAAE,EAAE,CAAC;gBAC3D,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACtD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YAChF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YACpF,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACpD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;gBAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,SAAS,EAAE,UAAU;YACrB,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,OAAgB;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,kBAAkB;gBAC7B,KAAK,EAAE;oBACL,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,2CAA2C;iBACrD;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,kBAAkB;gBAC7B,KAAK,EAAE;oBACL,IAAI,EAAG,GAAyB,CAAC,IAAI,IAAI,mBAAmB;oBAC5D,OAAO,EAAG,GAAa,CAAC,OAAO;iBAChC;aACF,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,kBAAkB;gBAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,wBAAwB,UAAU,EAAE,EAAE;aAC5E,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAClC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,CAAU,EAAE,CAAC;YACxF,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC7B,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,kBAAkB;YAC7B,SAAS,EAAE,UAAU;YACrB,cAAc,EAAE,OAAO;SACxB,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * Component documentation create / update.
3
+ */
4
+ import type { ServerContext } from "../server/context.js";
5
+ export declare class DocumentationService {
6
+ private readonly ctx;
7
+ private components;
8
+ constructor(ctx: ServerContext);
9
+ create(input: {
10
+ name: string;
11
+ overview?: string;
12
+ variants?: string[];
13
+ parameters?: Array<{
14
+ name: string;
15
+ type?: string;
16
+ default?: string;
17
+ description?: string;
18
+ }>;
19
+ dry_run?: boolean;
20
+ }): {
21
+ success: boolean;
22
+ operation: string;
23
+ path?: string;
24
+ dry_run?: boolean;
25
+ operations?: Array<{
26
+ type: string;
27
+ path: string;
28
+ }>;
29
+ error?: {
30
+ code: string;
31
+ message: string;
32
+ };
33
+ };
34
+ update(input: {
35
+ name: string;
36
+ overview?: string;
37
+ variants?: string[];
38
+ parameters?: Array<{
39
+ name: string;
40
+ type?: string;
41
+ default?: string;
42
+ description?: string;
43
+ }>;
44
+ accessibility?: string;
45
+ notes?: string;
46
+ dry_run?: boolean;
47
+ }): {
48
+ success: boolean;
49
+ operation: string;
50
+ path?: string;
51
+ created?: boolean;
52
+ modified?: boolean;
53
+ dry_run?: boolean;
54
+ error?: {
55
+ code: string;
56
+ message: string;
57
+ };
58
+ };
59
+ get(name: string): {
60
+ path: string;
61
+ source: string;
62
+ } | null;
63
+ }
64
+ //# sourceMappingURL=documentation-service.d.ts.map