Initial import from garrytan/gstack@026751e (main snapshot via local relay)

Source: https://github.com/garrytan/gstack/commit/026751e

scripts/resolvers/make-pdf.ts

@@ -0,0 +1,50 @@
+import type { TemplateContext } from './types';
+
+/**
+ * {{MAKE_PDF_SETUP}} — emits the shell preamble that resolves $P to the
+ * make-pdf binary. Mirrors generateBrowseSetup / generateDesignSetup.
+ *
+ * $P = make-pdf/dist/pdf.
+ *
+ * Resolution order (matches src/browseClient.ts::resolveBrowseBin):
+ *   1. Local skill root: $_ROOT/{localSkillRoot}/make-pdf/dist/pdf
+ *   2. Global: ~/{globalRoot}/make-pdf/dist/pdf
+ *   3. Env override (MAKE_PDF_BIN) — for contributor dev builds
+ */
+export function generateMakePdfSetup(ctx: TemplateContext): string {
+  return `## MAKE-PDF SETUP (run this check BEFORE any make-pdf command)
+
+\`\`\`bash
+_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
+P=""
+[ -n "$MAKE_PDF_BIN" ] && [ -x "$MAKE_PDF_BIN" ] && P="$MAKE_PDF_BIN"
+[ -z "$P" ] && [ -n "$_ROOT" ] && [ -x "$_ROOT/${ctx.paths.localSkillRoot}/make-pdf/dist/pdf" ] && P="$_ROOT/${ctx.paths.localSkillRoot}/make-pdf/dist/pdf"
+[ -z "$P" ] && P="$HOME${ctx.paths.makePdfDir.replace(/^~/, '')}/pdf"
+if [ -x "$P" ]; then
+  echo "MAKE_PDF_READY: $P"
+  alias _p_="$P"   # shellcheck alias helper (not exported)
+  export P   # available as $P in subsequent blocks within the same skill invocation
+else
+  echo "MAKE_PDF_NOT_AVAILABLE (run './setup' in the gstack repo to build it)"
+fi
+\`\`\`
+
+If \`MAKE_PDF_NOT_AVAILABLE\` is printed: tell the user the binary is not
+built. Have them run \`./setup\` from the gstack repo, then retry.
+
+If \`MAKE_PDF_READY\` is printed: \`$P\` is the binary path for the rest of
+the skill. Use \`$P\` (not an explicit path) so the skill body stays portable.
+
+Core commands:
+- \`$P generate <input.md> [output.pdf]\` — render markdown to PDF (80% use case)
+- \`$P generate --cover --toc essay.md out.pdf\` — full publication layout
+- \`$P generate --watermark DRAFT memo.md draft.pdf\` — diagonal DRAFT watermark
+- \`$P preview <input.md>\` — render HTML and open in browser (fast iteration)
+- \`$P setup\` — verify browse + Chromium + pdftotext and run a smoke test
+- \`$P --help\` — full flag reference
+
+Output contract:
+- \`stdout\`: ONLY the output path on success. One line.
+- \`stderr\`: progress (\`Rendering HTML... Generating PDF...\`) unless \`--quiet\`.
+- Exit 0 success / 1 bad args / 2 render error / 3 Paged.js timeout / 4 browse unavailable.`;
+}