editlet 0.0.0-stage → 0.1.0-alpha.0

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 (146) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +113 -2
  3. package/dist/admin/config.d.ts +22 -0
  4. package/dist/admin/config.js +75 -0
  5. package/dist/admin/dist/assets/RichEditor-BlaCRrEX.css +1 -0
  6. package/dist/admin/dist/assets/RichEditor-IZKdt6MK.js +42 -0
  7. package/dist/admin/dist/assets/blank-line-CbGzlqBI.js +1 -0
  8. package/dist/admin/dist/assets/channel-CljeMIwA.js +1 -0
  9. package/dist/admin/dist/assets/db-CCMyPgQa.js +1 -0
  10. package/dist/admin/dist/assets/index-CWoJh4H8.js +257 -0
  11. package/dist/admin/dist/assets/index-DkRMnD_M.css +1 -0
  12. package/dist/admin/dist/assets/mdast-util-from-markdown-C79q1_d8.js +3 -0
  13. package/dist/admin/dist/assets/mdast-util-gfm-cM-_xFJE.js +19 -0
  14. package/dist/admin/dist/assets/micromark-extension-gfm-Wz6-oszS.js +1 -0
  15. package/dist/admin/dist/assets/micromark-util-classify-character-BgXaGAja.js +1 -0
  16. package/dist/admin/dist/assets/micromark-util-html-tag-name-B61T18yC.js +1 -0
  17. package/dist/admin/dist/assets/rolldown-runtime-XKyaHtl9.js +1 -0
  18. package/dist/admin/dist/index.html +16 -0
  19. package/dist/admin/dist/preview.js +1 -0
  20. package/dist/admin/dist/window.js +1 -0
  21. package/dist/astro/content.d.ts +21 -0
  22. package/dist/astro/content.js +235 -0
  23. package/dist/astro/devServer.js +89 -0
  24. package/dist/astro/index.d.ts +15 -0
  25. package/dist/astro/index.js +98 -0
  26. package/dist/astro/nodeBridge.js +36 -0
  27. package/dist/astro/shared.js +10 -0
  28. package/dist/astro/stub/index.html +71 -0
  29. package/dist/auth/client.d.ts +24 -0
  30. package/dist/auth/client.js +120 -0
  31. package/dist/auth/handler.d.ts +16 -0
  32. package/dist/auth/handler.js +281 -0
  33. package/dist/auth/protocol.d.ts +25 -0
  34. package/dist/auth/protocol.js +3 -0
  35. package/dist/core/assets.d.ts +73 -0
  36. package/dist/core/assets.js +405 -0
  37. package/dist/core/devApi.d.ts +28 -0
  38. package/dist/core/devApi.js +3 -0
  39. package/dist/core/entryFile.d.ts +13 -0
  40. package/dist/core/entryFile.js +81 -0
  41. package/dist/core/fields.js +147 -0
  42. package/dist/core/generate.d.ts +3 -0
  43. package/dist/core/generate.js +70 -0
  44. package/dist/core/gitStyle.d.ts +92 -0
  45. package/dist/core/gitStyle.js +206 -0
  46. package/dist/core/index.d.ts +16 -0
  47. package/dist/core/index.js +16 -0
  48. package/dist/core/issues.d.ts +10 -0
  49. package/dist/core/issues.js +10 -0
  50. package/dist/core/paths.d.ts +31 -0
  51. package/dist/core/paths.js +114 -0
  52. package/dist/core/project.js +56 -0
  53. package/dist/core/references.d.ts +68 -0
  54. package/dist/core/references.js +103 -0
  55. package/dist/core/rename.d.ts +60 -0
  56. package/dist/core/rename.js +133 -0
  57. package/dist/core/schema.d.ts +117 -0
  58. package/dist/core/schema.js +299 -0
  59. package/dist/core/sha.d.ts +2 -0
  60. package/dist/core/sha.js +13 -0
  61. package/dist/core/source.d.ts +48 -0
  62. package/dist/core/source.js +57 -0
  63. package/dist/core/validate.d.ts +22 -0
  64. package/dist/core/validate.js +148 -0
  65. package/dist/core/walk.d.ts +23 -0
  66. package/dist/core/walk.js +94 -0
  67. package/dist/core/writes.d.ts +37 -0
  68. package/dist/core/writes.js +166 -0
  69. package/dist/github/base64.js +16 -0
  70. package/dist/github/cache.d.ts +34 -0
  71. package/dist/github/cache.js +126 -0
  72. package/dist/github/client.d.ts +38 -0
  73. package/dist/github/client.js +228 -0
  74. package/dist/github/codeowners.d.ts +23 -0
  75. package/dist/github/codeowners.js +96 -0
  76. package/dist/github/commitReader.d.ts +25 -0
  77. package/dist/github/commitReader.js +38 -0
  78. package/dist/github/deploy.d.ts +15 -0
  79. package/dist/github/deploy.js +33 -0
  80. package/dist/github/index.d.ts +9 -0
  81. package/dist/github/index.js +8 -0
  82. package/dist/github/repo.d.ts +95 -0
  83. package/dist/github/repo.js +375 -0
  84. package/dist/github/source.d.ts +115 -0
  85. package/dist/github/source.js +558 -0
  86. package/dist/loader/index.d.ts +27 -0
  87. package/dist/loader/index.js +151 -0
  88. package/dist/loader/protocol.d.ts +95 -0
  89. package/dist/loader/protocol.js +120 -0
  90. package/dist/loader/window/geometry.js +9 -0
  91. package/dist/next/EditletLoader.d.ts +5 -0
  92. package/dist/next/EditletLoader.js +33 -0
  93. package/dist/next/assetUrl.d.ts +9 -0
  94. package/dist/next/assetUrl.js +13 -0
  95. package/dist/next/buildGuard.js +26 -0
  96. package/dist/next/config.d.ts +18 -0
  97. package/dist/next/config.js +255 -0
  98. package/dist/next/devServer.js +70 -0
  99. package/dist/next/editletField.d.ts +7 -0
  100. package/dist/next/editletField.js +7 -0
  101. package/dist/next/index.d.ts +8 -0
  102. package/dist/next/index.js +6 -0
  103. package/dist/next/preview.d.ts +18 -0
  104. package/dist/next/preview.js +100 -0
  105. package/dist/next/previewCookie.d.ts +5 -0
  106. package/dist/next/previewCookie.js +72 -0
  107. package/dist/next/previewEnv.js +25 -0
  108. package/dist/next/previewRef.d.ts +8 -0
  109. package/dist/next/previewRef.js +17 -0
  110. package/dist/next/publicDir.js +65 -0
  111. package/dist/next/reader.d.ts +49 -0
  112. package/dist/next/reader.js +161 -0
  113. package/dist/next/stub/index.html +56 -0
  114. package/dist/node/devHandler.d.ts +6 -0
  115. package/dist/node/devHandler.js +430 -0
  116. package/dist/node/fs.js +37 -0
  117. package/dist/node/index.d.ts +3 -0
  118. package/dist/node/index.js +3 -0
  119. package/dist/node/project.d.ts +12 -0
  120. package/dist/node/project.js +43 -0
  121. package/package.json +187 -4
  122. package/skills/README.md +84 -0
  123. package/skills/editlet/SKILL.md +119 -0
  124. package/skills/editlet/references/content-format.md +191 -0
  125. package/skills/editlet/references/preview.md +75 -0
  126. package/skills/editlet/references/publishing.md +137 -0
  127. package/skills/editlet/references/schema-changes.md +127 -0
  128. package/skills/editlet/scripts/guard.mjs +1061 -0
  129. package/skills/editlet/scripts/link.mjs +193 -0
  130. package/skills/editlet/scripts/refs.mjs +1480 -0
  131. package/skills/editlet/scripts/schema.mjs +1340 -0
  132. package/skills/editlet/scripts/style.mjs +657 -0
  133. package/skills/editlet/scripts/types.mjs +525 -0
  134. package/skills/editlet/scripts/validate.mjs +724 -0
  135. package/skills/editlet-migrate/SKILL.md +92 -0
  136. package/skills/editlet-migrate/references/mapping.md +73 -0
  137. package/skills/editlet-migrate/references/sources.md +70 -0
  138. package/skills/editlet-setup/SKILL.md +108 -0
  139. package/skills/editlet-setup/references/astro.md +83 -0
  140. package/skills/editlet-setup/references/doctor.md +89 -0
  141. package/skills/editlet-setup/references/next.md +140 -0
  142. package/skills/editlet-setup/references/preview.md +54 -0
  143. package/skills/editlet-setup/references/production.md +153 -0
  144. package/skills/editlet-setup/references/roles.md +238 -0
  145. package/skills/editlet-setup/references/skills.md +99 -0
  146. package/skills/editlet-setup/scripts/doctor.mjs +1378 -0
@@ -0,0 +1,193 @@
1
+ // skills/editlet/scripts/link.ts
2
+ import { spawnSync } from "node:child_process";
3
+ import { existsSync } from "node:fs";
4
+ import { lstat, mkdir, readdir, readFile, readlink, realpath, rm, symlink, writeFile } from "node:fs/promises";
5
+ import { basename, dirname, join, relative, resolve, sep } from "node:path";
6
+ import { fileURLToPath } from "node:url";
7
+ var LINK_DIRS = [".claude/skills", ".agents/skills"];
8
+ var MAIN = "editlet";
9
+ var TARGETS = LINK_DIRS.map((dir) => `${dir}/${MAIN}`);
10
+ var SETTINGS = ".claude/settings.json";
11
+ var HOOK_COMMAND = 'node "$CLAUDE_PROJECT_DIR"/.claude/skills/editlet/scripts/guard.mjs';
12
+ var GUARD_MARKER = "editlet/scripts/guard.mjs";
13
+ var SettingsError = class extends Error {
14
+ };
15
+ var real = (path) => realpath(path).catch(() => null);
16
+ async function linkTarget(root, skillDir, skillReal, target, check) {
17
+ const linkPath = join(root, target);
18
+ const linkDir = dirname(linkPath);
19
+ const stat = await lstat(linkPath).catch(() => null);
20
+ if (stat && !stat.isSymbolicLink()) return `${target}: copy kept`;
21
+ if (stat && await real(linkPath) === skillReal) return `${target}: already linked`;
22
+ if (check) return `${target}: ${stat ? "wrong link" : "missing"}`;
23
+ if (stat) await rm(linkPath);
24
+ await mkdir(linkDir, { recursive: true });
25
+ let wanted = relative(linkDir, skillDir);
26
+ const lexicalWorks = await real(resolve(linkDir, wanted)) === skillReal;
27
+ if (!lexicalWorks || !skillDir.startsWith(root + sep) && root !== await real(root)) {
28
+ wanted = join(relative(await real(linkDir) ?? linkDir, dirname(skillReal)), basename(skillReal));
29
+ }
30
+ await symlink(wanted, linkPath);
31
+ return stat ? `${target}: fixed link` : `${target}: linked`;
32
+ }
33
+ async function assertNotInLinkFolders(root, skillReal) {
34
+ for (const dir of LINK_DIRS) {
35
+ const folder = await real(join(root, dir));
36
+ if (folder && (skillReal === folder || skillReal.startsWith(folder + sep))) {
37
+ throw new SettingsError(
38
+ `${dir}/${MAIN}: the skill folder resolves into a link folder, run link.mjs from the package`
39
+ );
40
+ }
41
+ }
42
+ }
43
+ async function skillNames(skillsRoot) {
44
+ const entries = await readdir(skillsRoot, { withFileTypes: true }).catch(() => []);
45
+ const names = entries.filter((e) => e.name !== MAIN && (e.isDirectory() || e.isSymbolicLink())).filter((e) => existsSync(join(skillsRoot, e.name, "SKILL.md"))).map((e) => e.name).toSorted();
46
+ return [MAIN, ...names];
47
+ }
48
+ async function staleLinks(root, skillsRoot, names, check) {
49
+ const roots = [skillsRoot, await real(skillsRoot) ?? skillsRoot];
50
+ const lines = [];
51
+ for (const dir of LINK_DIRS) {
52
+ const entries = await readdir(join(root, dir), { withFileTypes: true }).catch(() => []);
53
+ for (const entry of entries) {
54
+ if (!entry.isSymbolicLink() || names.includes(entry.name)) continue;
55
+ const linkPath = join(root, dir, entry.name);
56
+ const target = resolve(join(root, dir), await readlink(linkPath));
57
+ if (existsSync(target) || !roots.some((r) => dirname(target) === r)) continue;
58
+ if (!check) await rm(linkPath);
59
+ lines.push(`${dir}/${entry.name}: ${check ? "stale link" : "stale link removed"}`);
60
+ }
61
+ }
62
+ return lines;
63
+ }
64
+ async function readSettings(path) {
65
+ let text;
66
+ try {
67
+ text = await readFile(path, "utf8");
68
+ } catch {
69
+ return null;
70
+ }
71
+ try {
72
+ const parsed = JSON.parse(text);
73
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new Error("not an object");
74
+ return parsed;
75
+ } catch {
76
+ throw new SettingsError(`${SETTINGS}: not valid JSON, left untouched`);
77
+ }
78
+ }
79
+ function hasGuardHook(settings) {
80
+ const hooks = settings.hooks;
81
+ const entries = Array.isArray(hooks?.PreToolUse) ? hooks.PreToolUse : [];
82
+ return entries.some((entry) => {
83
+ const list = entry?.hooks;
84
+ return Array.isArray(list) && list.some((hook) => {
85
+ const command = hook?.command;
86
+ return typeof command === "string" && command.includes(GUARD_MARKER);
87
+ });
88
+ });
89
+ }
90
+ async function installHook(root, check) {
91
+ const path = join(root, SETTINGS);
92
+ const settings = await readSettings(path) ?? {};
93
+ const existing = settings.hooks;
94
+ if (existing !== void 0 && (typeof existing !== "object" || existing === null || Array.isArray(existing))) {
95
+ throw new SettingsError(`${SETTINGS}: "hooks" is not an object, left untouched`);
96
+ }
97
+ const existingPre = existing?.PreToolUse;
98
+ if (existingPre !== void 0 && !Array.isArray(existingPre)) {
99
+ throw new SettingsError(`${SETTINGS}: "hooks.PreToolUse" is not an array, left untouched`);
100
+ }
101
+ if (hasGuardHook(settings)) return `${SETTINGS}: hook present`;
102
+ if (check) return `${SETTINGS}: hook missing`;
103
+ const hooks = typeof settings.hooks === "object" && settings.hooks !== null ? settings.hooks : {};
104
+ const pre = Array.isArray(hooks.PreToolUse) ? hooks.PreToolUse : [];
105
+ hooks.PreToolUse = [...pre, { matcher: "Bash", hooks: [{ type: "command", command: HOOK_COMMAND }] }];
106
+ settings.hooks = hooks;
107
+ await mkdir(dirname(path), { recursive: true });
108
+ await writeFile(path, `${JSON.stringify(settings, null, 2)}
109
+ `);
110
+ return `${SETTINGS}: hook added`;
111
+ }
112
+ function guardState(root) {
113
+ const guard = join(root, TARGETS[0], "scripts/guard.mjs");
114
+ if (!existsSync(guard)) return "missing";
115
+ const res = spawnSync(process.execPath, [guard], { input: '{"tool_name":"Read"}', encoding: "utf8", timeout: 2e4 });
116
+ return res.status === 0 ? "ok" : "broken";
117
+ }
118
+ var under = (dir, link) => dir === link || dir.startsWith(link + sep);
119
+ async function unwrapInstalledLink(root, skillDir) {
120
+ let dir = skillDir;
121
+ for (const target of TARGETS) {
122
+ const linkPath = join(root, target);
123
+ if (!under(dir, linkPath)) continue;
124
+ const stat = await lstat(linkPath).catch(() => null);
125
+ if (!stat?.isSymbolicLink()) continue;
126
+ dir = join(resolve(dirname(linkPath), await readlink(linkPath)), dir.slice(linkPath.length));
127
+ }
128
+ for (const target of TARGETS) {
129
+ if (under(dir, join(root, target))) {
130
+ throw new SettingsError(`${target}: the skill folder resolves to a link path, run link.mjs from the package`);
131
+ }
132
+ }
133
+ return dir;
134
+ }
135
+ async function linkSkill({ root, skillDir, check = false, hooks = false }) {
136
+ skillDir = await unwrapInstalledLink(root, skillDir);
137
+ const skillReal = await real(skillDir) ?? skillDir;
138
+ await assertNotInLinkFolders(root, skillReal);
139
+ const skillsRoot = dirname(skillDir);
140
+ const names = await skillNames(skillsRoot);
141
+ const lines = [];
142
+ for (const name of names) {
143
+ const dir = name === MAIN ? skillDir : join(skillsRoot, name);
144
+ const dirReal = name === MAIN ? skillReal : await real(dir) ?? dir;
145
+ for (const linkDir of LINK_DIRS) lines.push(await linkTarget(root, dir, dirReal, `${linkDir}/${name}`, check));
146
+ }
147
+ lines.push(...await staleLinks(root, skillsRoot, names, check));
148
+ if (hooks) {
149
+ lines.push(await installHook(root, check));
150
+ const state = guardState(root);
151
+ if (state !== "ok") {
152
+ lines.push(
153
+ check ? `${SETTINGS}: guard ${state}` : `warning: ${TARGETS[0]}/scripts/guard.mjs is ${state}; the hook runs unguarded until it loads (build the skill, run npm install)`
154
+ );
155
+ }
156
+ }
157
+ return lines;
158
+ }
159
+ async function main() {
160
+ const args = process.argv.slice(2);
161
+ let root = process.cwd();
162
+ let check = false;
163
+ let hooks = false;
164
+ for (let i = 0; i < args.length; i++) {
165
+ const arg = args[i];
166
+ if (arg === "--check") check = true;
167
+ else if (arg === "--hooks") hooks = true;
168
+ else if (arg === "--root" && args[i + 1] !== void 0) root = resolve(args[++i]);
169
+ else {
170
+ process.stderr.write("usage: link.mjs [--check] [--hooks] [--root <dir>]\n");
171
+ process.exitCode = 2;
172
+ return;
173
+ }
174
+ }
175
+ const skillDir = dirname(dirname(resolve(process.argv[1] ?? fileURLToPath(import.meta.url))));
176
+ try {
177
+ const lines = await linkSkill({ root, skillDir, check, hooks });
178
+ process.stdout.write(`${lines.join("\n")}
179
+ `);
180
+ if (check && lines.some((line) => /: (missing|hook missing|wrong link|stale link|guard missing|guard broken)$/.test(line)))
181
+ process.exitCode = 1;
182
+ } catch (error) {
183
+ if (!(error instanceof SettingsError)) throw error;
184
+ process.stderr.write(`${error.message}
185
+ `);
186
+ process.exitCode = 2;
187
+ }
188
+ }
189
+ if (/^link\.(ts|mjs)$/.test(basename(process.argv[1] ?? ""))) await main();
190
+ export {
191
+ SettingsError,
192
+ linkSkill
193
+ };