codepen-commander 1.2.0 → 1.4.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 (93) hide show
  1. package/README.md +104 -10
  2. package/api/client.js +129 -106
  3. package/cli.js +34 -29
  4. package/commands/auth/default.js +40 -0
  5. package/commands/auth/index.js +83 -0
  6. package/commands/auth/list.js +78 -0
  7. package/commands/auth/login.js +136 -0
  8. package/commands/auth/logout.js +186 -0
  9. package/commands/auth/status.js +212 -0
  10. package/commands/build.js +256 -0
  11. package/commands/clone.js +13 -581
  12. package/commands/delete.js +553 -37
  13. package/commands/deploy.js +164 -154
  14. package/commands/domains.js +83 -39
  15. package/commands/fork.js +13 -317
  16. package/commands/info.js +152 -0
  17. package/commands/init.js +375 -0
  18. package/commands/list.js +95 -78
  19. package/commands/new.js +155 -83
  20. package/commands/open.js +29 -19
  21. package/commands/privacy.js +52 -36
  22. package/commands/pull.js +123 -110
  23. package/commands/push.js +222 -365
  24. package/commands/restore.js +251 -0
  25. package/commands/rollback.js +141 -0
  26. package/commands/serve.js +119 -0
  27. package/commands/settings.js +126 -0
  28. package/commands/shell.js +305 -0
  29. package/commands/status.js +133 -39
  30. package/commands/sync.js +330 -0
  31. package/commands/undeploy.js +102 -0
  32. package/commands/unlink.js +191 -0
  33. package/commands/versions.js +100 -163
  34. package/config/auth.js +4 -374
  35. package/config/pen-blocks.js +166 -0
  36. package/config/project.js +179 -240
  37. package/config/user-store.js +364 -0
  38. package/constants.js +42 -0
  39. package/errors.js +17 -0
  40. package/package.json +1 -1
  41. package/shell/index.html +79 -0
  42. package/shell/scripts.js +276 -0
  43. package/shell/styles.css +492 -0
  44. package/site/blocks/classic.js +270 -0
  45. package/site/blocks/context.js +63 -0
  46. package/site/blocks/index.js +4 -0
  47. package/site/blocks/packages.js +242 -0
  48. package/site/blocks/unsupported-page.js +328 -0
  49. package/site/builder.js +475 -0
  50. package/site/detect.js +65 -0
  51. package/site/ignore-files.js +90 -0
  52. package/site/manifest.js +227 -0
  53. package/site/server.js +483 -0
  54. package/site/shell.js +363 -0
  55. package/sync/fs.js +19 -17
  56. package/sync/info.js +6 -81
  57. package/utils/browser.js +17 -10
  58. package/utils/cli-options.js +79 -0
  59. package/utils/codepen-url.js +183 -0
  60. package/utils/format.js +39 -30
  61. package/utils/fs-safe.js +95 -0
  62. package/utils/html.js +40 -1
  63. package/utils/json.js +4 -19
  64. package/utils/output.js +37 -0
  65. package/utils/package-paths.js +51 -0
  66. package/utils/prompts/index.js +5 -0
  67. package/utils/prompts/multi-select.js +185 -0
  68. package/utils/prompts/secret.js +65 -0
  69. package/utils/prompts/select.js +141 -0
  70. package/utils/prompts/text.js +99 -0
  71. package/utils/prompts/tty-list.js +165 -0
  72. package/utils/prompts/types.js +35 -0
  73. package/utils/strings.js +98 -0
  74. package/utils/watcher.js +82 -0
  75. package/{commands → workflows}/auth-context.js +13 -7
  76. package/workflows/batch-pens.js +1647 -0
  77. package/workflows/batch-target.js +184 -0
  78. package/workflows/classic-convert.js +241 -0
  79. package/workflows/clone-pen.js +381 -0
  80. package/workflows/create-pen.js +254 -0
  81. package/workflows/discover-pens.js +91 -0
  82. package/workflows/fork-pen.js +314 -0
  83. package/workflows/missing-pen.js +212 -0
  84. package/workflows/pull-pen.js +204 -0
  85. package/workflows/push-pen.js +318 -0
  86. package/{commands → workflows}/scaffold.js +4 -3
  87. package/workflows/sync-pen.js +227 -0
  88. package/{commands → workflows}/unowned-pen.js +16 -12
  89. package/commands/auth.js +0 -593
  90. package/commands/create-pen.js +0 -251
  91. package/commands/meta.js +0 -184
  92. package/utils/prompts.js +0 -316
  93. /package/{types.js → api/types.js} +0 -0
@@ -0,0 +1,328 @@
1
+ import { createHash } from 'node:crypto';
2
+ import path from 'node:path';
3
+ import { PROJECT_CONFIG_FILENAME } from '../../constants.js';
4
+ import { sanitizeCodePenUrl } from '../../utils/codepen-url.js';
5
+ import { readSafeJsonObject } from '../../utils/fs-safe.js';
6
+ import { escapeHtml } from '../../utils/html.js';
7
+ import { findPenContext } from './context.js';
8
+ const UNSUPPORTED_BLOCK_PAGE_STYLE = `
9
+ @layer reset, base, components;
10
+
11
+ :root {
12
+ color-scheme: light dark;
13
+
14
+ --surface-page: light-dark(oklch(98.5% 0.004 250), oklch(15% 0.012 260));
15
+ --surface-card: light-dark(oklch(100% 0 0), oklch(20% 0.014 260));
16
+ --surface-code: light-dark(oklch(94.5% 0.008 255), oklch(25% 0.016 260));
17
+
18
+ --text-primary: light-dark(oklch(20% 0.015 260), oklch(94% 0.008 250));
19
+ --text-muted: light-dark(oklch(46% 0.016 260), oklch(72% 0.014 255));
20
+ --text-subtle: light-dark(oklch(56% 0.014 260), oklch(62% 0.014 255));
21
+
22
+ --border-subtle: light-dark(oklch(88% 0.01 255), oklch(30% 0.018 260));
23
+
24
+ --accent: light-dark(oklch(48% 0.2 260), oklch(75% 0.15 250));
25
+ --accent-fg: light-dark(oklch(99% 0 0), oklch(15% 0.015 260));
26
+
27
+ --radius-card: 0.875rem;
28
+ --radius-code: 0.375rem;
29
+ accent-color: var(--accent);
30
+ }
31
+
32
+ @layer reset {
33
+ html,
34
+ body,
35
+ main,
36
+ article,
37
+ header,
38
+ footer,
39
+ div,
40
+ ul,
41
+ li {
42
+ box-sizing: border-box;
43
+ }
44
+
45
+ body,
46
+ h1,
47
+ p,
48
+ ul {
49
+ margin: 0;
50
+ }
51
+ }
52
+
53
+ @layer base {
54
+ body {
55
+ min-block-size: 100dvb;
56
+ display: grid;
57
+ grid-template-columns: minmax(0, 1fr);
58
+ place-items: center;
59
+ padding: clamp(1.5rem, 5vw, 3rem) clamp(1.25rem, 4vw, 2rem);
60
+ background-color: var(--surface-page);
61
+ color: var(--text-primary);
62
+ font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
63
+ line-height: 1.55;
64
+ }
65
+
66
+ main {
67
+ inline-size: min(100%, 38rem);
68
+ }
69
+
70
+ h1 {
71
+ font-size: clamp(1.4rem, 3vw, 1.75rem);
72
+ line-height: 1.25;
73
+ letter-spacing: -0.02em;
74
+ text-wrap: balance;
75
+ }
76
+
77
+ p {
78
+ text-wrap: pretty;
79
+ }
80
+
81
+ a:focus-visible {
82
+ outline: 2px solid var(--accent);
83
+ outline-offset: 3px;
84
+ border-radius: 0.25rem;
85
+ }
86
+
87
+ code {
88
+ font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
89
+ font-size: 0.875em;
90
+ padding-block: 0.125em;
91
+ padding-inline: 0.4em;
92
+ border-radius: var(--radius-code);
93
+ background-color: var(--surface-code);
94
+ }
95
+ }
96
+
97
+ @layer components {
98
+ .error-card {
99
+ inline-size: 100%;
100
+ display: grid;
101
+ gap: 1.15rem;
102
+ padding: clamp(1.5rem, 4vw, 2.25rem);
103
+ background-color: var(--surface-card);
104
+ border: 1px solid var(--border-subtle);
105
+ border-radius: var(--radius-card);
106
+ corner-shape: squircle;
107
+ }
108
+
109
+ .error-header {
110
+ display: grid;
111
+ gap: 0.45rem;
112
+ justify-items: start;
113
+ min-inline-size: 0;
114
+ }
115
+
116
+ .demo-path {
117
+ padding: 0;
118
+ background: none;
119
+ color: var(--text-subtle);
120
+ font-size: 0.8rem;
121
+ max-inline-size: 100%;
122
+ overflow-wrap: anywhere;
123
+ }
124
+
125
+ .error-body {
126
+ display: grid;
127
+ gap: 1.25rem;
128
+ min-inline-size: 0;
129
+ color: var(--text-muted);
130
+ font-size: 0.95rem;
131
+ }
132
+
133
+ .block-list {
134
+ display: flex;
135
+ flex-wrap: wrap;
136
+ gap: 0.45rem;
137
+ list-style: none;
138
+ padding: 0;
139
+ }
140
+
141
+ .block-list code {
142
+ color: var(--text-primary);
143
+ font-weight: 500;
144
+ }
145
+
146
+ .error-illustration {
147
+ display: block;
148
+ inline-size: 7rem;
149
+ block-size: 7rem;
150
+ margin-block: 0.5rem;
151
+ margin-inline: auto;
152
+ color: light-dark(#000, var(--text-primary));
153
+ }
154
+
155
+ .error-actions {
156
+ display: flex;
157
+ flex-wrap: wrap;
158
+ align-items: center;
159
+ justify-content: space-between;
160
+ gap: 0.65rem;
161
+ padding-block-start: 1rem;
162
+ border-block-start: 1px solid color-mix(in oklch, var(--border-subtle) 70%, transparent);
163
+ }
164
+
165
+ .btn {
166
+ display: inline-flex;
167
+ align-items: center;
168
+ justify-content: center;
169
+ gap: 0.45em;
170
+ padding-block: 0.55em;
171
+ padding-inline: 0.95em;
172
+ border-radius: var(--radius-code);
173
+ border: 1px solid transparent;
174
+ font-size: 0.875rem;
175
+ font-weight: 500;
176
+ line-height: 1.3;
177
+ text-decoration: none;
178
+ white-space: nowrap;
179
+ transition: background-color 150ms ease, border-color 150ms ease, color 150ms ease;
180
+ }
181
+
182
+ .btn-primary {
183
+ background-color: var(--accent);
184
+ color: var(--accent-fg);
185
+
186
+ &:hover {
187
+ background-color: color-mix(in oklch, var(--accent) 88%, var(--text-primary));
188
+ }
189
+ }
190
+
191
+ .btn-secondary {
192
+ border-color: var(--border-subtle);
193
+ background-color: var(--surface-page);
194
+ color: var(--text-primary);
195
+
196
+ &:hover {
197
+ border-color: color-mix(in oklch, var(--accent) 60%, var(--border-subtle));
198
+ color: var(--accent);
199
+ }
200
+ }
201
+
202
+ .btn-codepen {
203
+ margin-inline-start: auto;
204
+ }
205
+
206
+ .btn-icon {
207
+ flex-shrink: 0;
208
+ inline-size: 0.95rem;
209
+ block-size: 0.95rem;
210
+ }
211
+
212
+ @media (prefers-reduced-motion: reduce) {
213
+ .btn {
214
+ transition: none;
215
+ }
216
+ }
217
+ }
218
+ `;
219
+ const UNSUPPORTED_BLOCK_PAGE_STYLE_HASH = createHash('sha256')
220
+ .update(UNSUPPORTED_BLOCK_PAGE_STYLE, 'utf8')
221
+ .digest('base64');
222
+ export const UNSUPPORTED_BLOCK_PAGE_CSP = `default-src 'none'; style-src 'sha256-${UNSUPPORTED_BLOCK_PAGE_STYLE_HASH}'; img-src 'none'; script-src 'none'; object-src 'none'; base-uri 'self'; frame-ancestors 'self'`;
223
+ const UNSUPPORTED_BLOCK_EMOJI_SVG = `<svg class="error-illustration" viewBox="0 0 120 120" fill="none" stroke="currentColor" stroke-width="6.5" stroke-linecap="butt" stroke-linejoin="miter" aria-hidden="true">
224
+ <circle cx="60" cy="60" r="52" />
225
+ <line x1="33.5" y1="37.5" x2="50.5" y2="54.5" />
226
+ <line x1="50.5" y1="37.5" x2="33.5" y2="54.5" />
227
+ <line x1="69.5" y1="37.5" x2="86.5" y2="54.5" />
228
+ <line x1="86.5" y1="37.5" x2="69.5" y2="54.5" />
229
+ <line x1="32" y1="72" x2="88" y2="72" />
230
+ <path d="M 58 72 V 83 A 11 11 0 0 0 80 83 V 72" />
231
+ <line x1="69" y1="72" x2="69" y2="84" />
232
+ </svg>`;
233
+ /**
234
+ * Renders a self-contained HTML error page explaining which CodePen block(s) in
235
+ * `.codepen/pen.config.json` are not supported, with links back to the homepage
236
+ * and/or to open the demo on CodePen.
237
+ */
238
+ export async function renderUnsupportedBlocksPage(options) {
239
+ const { penContext, rootRealpath, demoRelPath = null, homeHref = null } = options;
240
+ const cdpnConfig = (await readSafeJsonObject(path.join(penContext.penDir, PROJECT_CONFIG_FILENAME), rootRealpath)) ?? {};
241
+ const codepenUrl = sanitizeCodePenUrl(cdpnConfig.url);
242
+ const blocks = penContext.unsupportedBlocks;
243
+ const isPlural = blocks.length > 1;
244
+ const headingText = isPlural ? 'Unsupported CodePen Blocks' : 'Unsupported CodePen Block';
245
+ const displayPath = demoRelPath ?? `${path.basename(penContext.penDir)}/`;
246
+ const blockItemsHtml = blocks
247
+ .map((name) => `<li><code>${escapeHtml(name)}</code></li>`)
248
+ .join('');
249
+ const explanationHtml = isPlural
250
+ ? `<p>This demo uses blocks configured in <code>.codepen/pen.config.json</code> that are not supported locally by <code>codepen-commander</code>:</p>
251
+ <ul class="block-list" aria-label="Unsupported blocks">${blockItemsHtml}</ul>`
252
+ : `<p>This demo uses the <code>${escapeHtml(blocks[0] ?? '')}</code> block in <code>.codepen/pen.config.json</code>, which is not supported locally by <code>codepen-commander</code>.</p>`;
253
+ const actions = [];
254
+ if (homeHref) {
255
+ const homeBtnClass = codepenUrl ? 'btn btn-secondary' : 'btn btn-primary';
256
+ actions.push(`<a class="${homeBtnClass}" href="${escapeHtml(homeHref)}">
257
+ <svg class="btn-icon" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
258
+ <path d="M10.5 3.5 6 8l4.5 4.5" />
259
+ </svg>
260
+ <span>Back to Homepage</span>
261
+ </a>`);
262
+ }
263
+ if (codepenUrl) {
264
+ actions.push(`<a class="btn btn-primary btn-codepen" href="${escapeHtml(codepenUrl)}" target="_blank" rel="noopener noreferrer">
265
+ <svg class="btn-icon" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
266
+ <polygon points="8,1.5 14.5,5.5 8,9.5 1.5,5.5" />
267
+ <polygon points="8,6.5 14.5,10.5 8,14.5 1.5,10.5" />
268
+ <line x1="1.5" y1="5.5" x2="1.5" y2="10.5" />
269
+ <line x1="14.5" y1="5.5" x2="14.5" y2="10.5" />
270
+ <line x1="8" y1="1.5" x2="8" y2="6.5" />
271
+ <line x1="8" y1="9.5" x2="8" y2="14.5" />
272
+ </svg>
273
+ <span>Open on CodePen</span>
274
+ </a>`);
275
+ }
276
+ const actionsHtml = actions.length > 0
277
+ ? `\n <footer class="error-actions">\n ${actions.join('\n ')}\n </footer>`
278
+ : '';
279
+ const html = `<!DOCTYPE html>
280
+ <html lang="en">
281
+ <head>
282
+ <meta charset="utf-8">
283
+ <meta name="viewport" content="width=device-width, initial-scale=1">
284
+ <meta name="color-scheme" content="light dark">
285
+ <title>${escapeHtml(headingText)}</title>
286
+ <style>${UNSUPPORTED_BLOCK_PAGE_STYLE}</style>
287
+ </head>
288
+ <body>
289
+ <main>
290
+ <article class="error-card">
291
+ <header class="error-header">
292
+ <code class="demo-path">${escapeHtml(displayPath)}</code>
293
+ <h1>${escapeHtml(headingText)}</h1>
294
+ </header>
295
+ <div class="error-body">
296
+ ${explanationHtml}
297
+ ${UNSUPPORTED_BLOCK_EMOJI_SVG}
298
+ </div>${actionsHtml}
299
+ </article>
300
+ </main>
301
+ </body>
302
+ </html>
303
+ `;
304
+ return { html, csp: UNSUPPORTED_BLOCK_PAGE_CSP };
305
+ }
306
+ /**
307
+ * Checks whether `dirRealpath` belongs to a Pen with unsupported active blocks and,
308
+ * if so, returns `{ html, csp }` for the error page.
309
+ */
310
+ export async function resolveUnsupportedBlocksPage(options) {
311
+ const { dirRealpath, rootRealpath, isRootServe = true } = options;
312
+ const penContext = await findPenContext(dirRealpath, rootRealpath);
313
+ if (!penContext || penContext.unsupportedBlocks.length === 0) {
314
+ return null;
315
+ }
316
+ const relDir = path.relative(rootRealpath, dirRealpath);
317
+ const dirSegments = relDir ? relDir.split(path.sep).filter(Boolean) : [];
318
+ const homeHref = isRootServe && dirSegments.length > 0 ? '../'.repeat(dirSegments.length) : null;
319
+ const relPen = path.relative(rootRealpath, penContext.penDir);
320
+ const penSegments = relPen ? relPen.split(path.sep).filter(Boolean) : [];
321
+ const demoRelPath = penSegments.length > 0 ? `${penSegments.join('/')}/` : `${path.basename(penContext.penDir)}/`;
322
+ return renderUnsupportedBlocksPage({
323
+ penContext,
324
+ rootRealpath,
325
+ demoRelPath,
326
+ homeHref,
327
+ });
328
+ }