create-sl-ide 0.1.0 → 0.1.2

package/README.md

@@ -5,10 +5,13 @@ the IDE for building slides with Claude Code or Codex.
 
 ```sh
 pnpm create sl-ide my-deck
+pnpm create sl-ide my-memo --memo   # a memo on US Letter pages instead of slides
+pnpm create sl-ide .                # in the current (empty) folder, named after it
 # or: npm create sl-ide@latest my-deck · bun create sl-ide my-deck
 ```
 
-It asks a few questions, then:
+It asks a few questions (slides or a memo; with no name in an empty
+folder, whether to build right there; the repo; publishing), then:
 
 1. Clones the **latest** sl-ide template from GitHub, keeping its history as
    the `upstream` remote, so `git pull upstream main` brings later editor
@@ -27,6 +30,7 @@ Then `cd my-deck && pnpm dev`, open Claude Code or Codex there, and run
 ## Options
 
 ```
+--format <slides|memo>          16:9 slides, or a US Letter memo (default slides; --memo for short)
 --dir <path>                    folder for the deck (default ./<name>)
 --github <private|public|none>  the deck's repo (default private)
 --team <slug>                   the sl-ide cloud team that owns the deck

package/index.mjs

@@ -7,6 +7,7 @@
 // cloud, and installs dependencies. The editor itself is never bundled here,
 // so a new deck always starts from the template's main.
 //
+//   pnpm create sl-ide .         start the deck in this (empty) folder, named after it
 //   pnpm create sl-ide login     sign in to sl-ide cloud and save a team token
 //   pnpm create sl-ide logout    forget saved tokens
 import fs from 'node:fs';
@@ -21,10 +22,13 @@ const SLUG_RE = /^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/;
 
 const HELP = `
   pnpm create sl-ide [name] [options]
+  pnpm create sl-ide . [options]     in this empty folder, named after it
 
-  Start a new deck from the latest sl-ide template.
+  Start a new deck (or memo) from the latest sl-ide template.
 
   Options
+    --format <slides|memo>   16:9 slides, or a memo on US Letter pages (default: slides)
+    --memo                   short for --format memo
     --dir <path>             folder to create the deck in (default: ./<name>)
     --github <private|public|none>   the deck's GitHub repo (default: private)
     --team <slug>            the sl-ide cloud team that owns the deck
@@ -45,6 +49,8 @@ const HELP = `
 const { values: o, positionals } = parseArgs({
   allowPositionals: true,
   options: {
+    format: { type: 'string' },
+    memo: { type: 'boolean' },
     dir: { type: 'string' },
     github: { type: 'string' },
     team: { type: 'string' },
@@ -62,6 +68,7 @@ const { values: o, positionals } = parseArgs({
 if (o['no-publish']) o.publish = false;
 if (o['no-install']) o.install = false;
 if (o['no-open']) o.open = false;
+if (o.memo) o.format = 'memo';
 if (o.help) { console.log(HELP); process.exit(0); }
 
 const interactive = process.stdin.isTTY && !o.yes;
@@ -141,7 +148,20 @@ function logout() {
 async function create() {
   p.intro('sl-ide · new deck');
 
-  let name = positionals[0];
+  // `.` builds the deck in the current folder and names it after the folder.
+  // Asked too, when no name is given and this folder is empty.
+  const cwdEmpty = fs.readdirSync(process.cwd()).every((f) => f === '.DS_Store');
+  let here = positionals[0] === '.';
+  if (!positionals[0] && !o.dir && interactive && cwdEmpty) {
+    here = await ask(p.select({
+      message: 'Where should it go?',
+      options: [
+        { value: true, label: 'This folder', hint: path.basename(process.cwd()) },
+        { value: false, label: 'A new folder inside this one' },
+      ],
+    }));
+  }
+  let name = here ? path.basename(process.cwd()) : positionals[0];
   if (!name) {
     if (!interactive) bail('Give the deck a name: pnpm create sl-ide my-deck');
     name = await ask(p.text({
@@ -154,8 +174,27 @@ async function create() {
   const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
   if (!SLUG_RE.test(slug)) bail(`can't make a link name from "${name}"`);
 
-  const dest = path.resolve(o.dir ?? name);
-  if (fs.existsSync(dest) && fs.readdirSync(dest).length) bail(`${dest} already exists and isn't empty`);
+  // Slides or a memo. A memo is the same template with the memo starter
+  // swapped in by its own script (scripts/use-format.mjs).
+  let format = o.format;
+  if (!format) {
+    format = interactive ? await ask(p.select({
+      message: 'What are you making?',
+      options: [
+        { value: 'slides', label: 'Slides', hint: '16:9 pages' },
+        { value: 'memo', label: 'A memo', hint: 'US Letter pages, text flows from page to page' },
+      ],
+    })) : 'slides';
+  }
+  if (!['slides', 'memo'].includes(format)) bail('--format is slides or memo');
+
+  const dest = path.resolve(o.dir ?? (here ? '.' : name));
+  if (fs.existsSync(dest)) {
+    // Finder leaves .DS_Store in folders it opens; it would stop git clone.
+    const left = fs.readdirSync(dest).filter((f) => f !== '.DS_Store');
+    if (left.length) bail(`${dest} already exists and isn't empty`);
+    fs.rmSync(path.join(dest, '.DS_Store'), { force: true });
+  }
 
   for (const tool of ['git', 'pnpm']) {
     if (!has(tool)) bail(tool === 'pnpm' ? 'pnpm is needed: corepack enable pnpm' : 'git is needed');
@@ -221,6 +260,16 @@ async function create() {
     const head = await run('git', ['log', '-1', '--format=%h %s'], { cwd: dest });
     s.stop(`Cloned sl-ide (${head.split(' ')[0]})`);
 
+    if (format !== 'slides') {
+      if (!fs.existsSync(path.join(dest, 'scripts', 'use-format.mjs'))) {
+        throw new Error(`this sl-ide template has no ${format} format yet`);
+      }
+      await run('node', ['scripts/use-format.mjs', format], { cwd: dest });
+      await run('git', ['add', '-A'], { cwd: dest });
+      await run('git', ['-c', 'core.hooksPath=/dev/null', 'commit', '-q', '-m', `Start from the ${format} starter`], { cwd: dest });
+      p.log.success(`Set up as a ${format}`);
+    }
+
     if (pub) {
       const config = { slug, team: pub.team, visibility: share };
       fs.writeFileSync(path.join(dest, 'sl-ide.config.json'), `${JSON.stringify(config, null, 2)}\n`);
@@ -249,12 +298,12 @@ async function create() {
 
   const rel = path.relative(process.cwd(), dest) || '.';
   const lines = [
-    `cd ${rel}`,
+    ...(rel === '.' ? [] : [`cd ${rel}`]),
     ...(o.install ? [] : ['pnpm install']),
     'pnpm dev',
     '',
     'Then open Claude Code or Codex in that folder and run /new-deck',
-    '(Codex: $new-deck) to learn your style and outline the story.',
+    `(Codex: $new-deck) to learn your style and outline the ${format === 'memo' ? 'memo' : 'story'}.`,
   ];
   p.note(lines.join('\n'), 'Next');
   if (pub) {
@@ -262,7 +311,7 @@ async function create() {
   } else {
     p.log.info('Not publishing. To publish later, add sl-ide.config.json (see the deck\'s README).');
   }
-  p.outro('Deck ready.');
+  p.outro(format === 'memo' ? 'Memo ready.' : 'Deck ready.');
 }
 
 const cmd = positionals[0];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-sl-ide",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Start a slide deck with sl-ide: pnpm create sl-ide",
   "type": "module",
   "bin": {