@devdogsuga/devtools 0.1.26 → 0.1.27

package/dist/help.js

@@ -1,169 +0,0 @@
-/**
- * `--help`, one level at a time.
- *
- * ## Why this is small
- *
- * The help this replaced was ~200 lines and printed the whole tree: every
- * subcommand of every group, the Bitwarden target table, the four places an
- * access token is looked for, the grants `migration_planner` holds, and which
- * deploy steps must avoid the `with-env` wrapper. A contributor running
- * `pnpm devtools --help` to find out how to start a database read all of it.
- *
- * Two rules now:
- *
- *   1. **A level prints its own children and stops.** `--help` lists the
- *      top-level commands; `env --help` lists env's subcommands; `env pull
- *      --help` lists that command's options. Depth is reached by asking for
- *      it.
- *   2. **No more than the caller needs to choose.** Operator internals are
- *      `docs/`'s job: which project a target maps to, how a credential is
- *      resolved, what a deploy job's environment holds. Help says what a
- *      command does and what it takes.
- *
- * Both fall out of rendering `commands.ts` rather than hand-writing prose, so
- * neither can rot back into a wall of text one paragraph at a time.
- */
-import { findCommand, GROUPS, SCOPES, } from "./commands.js";
-const INDENT = "  ";
-/** `--target <t>`, or `--prune` for a boolean. */
-function optionLabel(option) {
-    return option.value ? `${option.flag} ${option.value}` : option.flag;
-}
-/**
- * Two columns, with the gutter sized to the widest label in THIS block.
- *
- * Per-block rather than one width for the whole file: `deploy`'s labels are
- * long and `setup`'s are not, and a shared width would indent the short list
- * halfway across the terminal to accommodate a group the reader is not
- * looking at.
- */
-function columns(rows) {
-    const width = Math.max(...rows.map(([label]) => label.length));
-    return rows.map(([label, text]) => `${INDENT}${label.padEnd(width)}  ${text}`);
-}
-/**
- * A list of commands, split into scope blocks when any of them declares one.
- *
- * Used at two levels: a GROUP's own commands (no group has scoped commands
- * today — `db` folded the old "Supabase" group's scopes into itself), and a
- * command's own SUBCOMMANDS (`db`'s: `start`/`connect`/`stop`/`restart` on
- * this machine, `migration` in the repo, `status`/`migrate`/`reset`/… on an
- * endpoint, `planner`/`signing-key` naming their own connection). Either way,
- * a flat list leaves the reader to work out which of `restart` and `reset` is
- * which, the distinction that costs people an afternoon. A list with no
- * scopes renders as it always did: one block, one indent, no headings.
- *
- * The blocks follow declaration order rather than `SCOPES` order, so the tree
- * stays the one place that decides how the list reads. The gutter is sized
- * across the whole list, not per block, so every block lines up with the
- * others rather than each finding its own column.
- */
-function scopedBody(commands) {
-    if (!commands.some((command) => command.scope)) {
-        return columns(childRows(commands));
-    }
-    const width = Math.max(...commands.map((command) => command.name.length));
-    const lines = [];
-    let open;
-    for (const command of commands) {
-        if (command.scope && command.scope !== open) {
-            open = command.scope;
-            lines.push(`${INDENT}${SCOPES[open].help}:`);
-        }
-        lines.push(`${INDENT.repeat(2)}${command.name.padEnd(width)}  ${command.summary}`);
-    }
-    return lines;
-}
-function optionRows(options) {
-    return options.map((option) => [optionLabel(option), option.summary]);
-}
-function childRows(children) {
-    return children.map((child) => [child.name, child.summary]);
-}
-// ── The three levels ─────────────────────────────────────────────────────────
-/** `pnpm devtools --help`: the groups, and nothing below them. */
-function renderRoot() {
-    const lines = [
-        "pnpm devtools [command] [options]",
-        "",
-        "Run with no command to choose from a menu.",
-        "",
-        "Common tasks:",
-        ...columns([
-            ["setup", "Prepare a new checkout"],
-            ["run dev", "Start development servers"],
-            ["db start", "Start Supabase on this machine"],
-            ["db reset", "Rebuild the local database"],
-            ["cron run", "Choose and run a scheduled job"],
-        ]),
-    ];
-    for (const group of GROUPS) {
-        lines.push("", `${group.title}:`, ...scopedBody(group.commands));
-    }
-    lines.push("", "Options:", ...columns([
-        ["--help, -h", "Show this message"],
-        [
-            "--tier <t>",
-            "Deploy tier for this whole invocation (development, staging, production)",
-        ],
-    ]), "", "`pnpm devtools <command> --help` shows what that command takes.");
-    return lines.join("\n");
-}
-/** `pnpm devtools <path…> --help`: one command's own children and options. */
-function renderCommand(path, node) {
-    const children = node.subcommands ?? [];
-    const options = node.options ?? [];
-    const trail = path.join(" ");
-    const usage = [
-        "pnpm devtools",
-        trail,
-        children.length > 0 ? "<subcommand>" : "",
-        options.length > 0 ? "[options]" : "",
-    ]
-        .filter(Boolean)
-        .join(" ");
-    const lines = [usage, "", node.summary];
-    if (children.length > 0) {
-        lines.push("", "Subcommands:", ...scopedBody(children));
-    }
-    if (options.length > 0) {
-        lines.push("", "Options:", ...columns(optionRows(options)));
-    }
-    if (children.length > 0) {
-        lines.push("", `\`pnpm devtools ${trail} <subcommand> --help\` shows what that one takes.`);
-    }
-    return lines.join("\n");
-}
-/**
- * Renders help for a path, falling back to the root.
- *
- * An unknown path renders the root rather than an error: this is only reached
- * when `--help` was asked for, and answering a mistyped command with the list
- * it was mistyped from is more use than a refusal.
- */
-export function renderHelp(path = []) {
-    if (path.length === 0)
-        return renderRoot();
-    const node = findCommand(path);
-    if (!node)
-        return renderRoot();
-    return renderCommand(path, node);
-}
-/**
- * The command names in `argv` that precede any flag.
- *
- * `env pull --help` asks about `["env", "pull"]`; `--help env` asks about
- * nothing, because a flag's value is not a command path. Kept separate from
- * `positionals()`: that one strips a known set of value-taking flags to find a
- * subcommand, and here anything after the first flag is not part of the path at
- * all.
- */
-export function helpPath(argv) {
-    const path = [];
-    for (const arg of argv) {
-        if (arg.startsWith("-"))
-            break;
-        path.push(arg);
-    }
-    return path;
-}

package/dist/images/commands.d.ts

@@ -1,32 +0,0 @@
-import type { Format } from "./open-graph-types.js";
-import { type EventReader } from "./events.js";
-import { type Selection } from "./select.js";
-export interface ImagesOptions {
-    /** Graphic patterns. Empty means ask. */
-    patterns: string[];
-    /** Format names. Empty with `allFormats` false means ask. */
-    formats: string[];
-    allFormats: boolean;
-    /** An explicit directory; everything lands in it, flat. */
-    out?: string;
-    /** Use each graphic's own default directory. */
-    defaultOut: boolean;
-    /** List what would be written, and write nothing. */
-    noOutput: boolean;
-}
-export declare function parseImagesArgs(argv: readonly string[]): ImagesOptions;
-/** `~/images` when the shell did not expand it, which quoting prevents. */
-export declare function expandHome(path: string): string;
-/** Whether anything asked for could be an event, so whether to reach for a database. */
-export declare function wantsEvents(patterns: readonly string[]): boolean;
-/** Whether a pattern names events specifically, rather than sweeping them up. */
-export declare function namesEvents(patterns: readonly string[]): boolean;
-export interface ImagesDeps {
-    /** Overridden in tests so nothing reads the peer package or the filesystem. */
-    reader?: () => EventReader;
-}
-/** Where one selection is written. */
-export declare function destinationOf({ graphic, format }: Selection, out: string | undefined): string;
-export declare function runImages(argv: string[], deps?: ImagesDeps): Promise<void>;
-/** Re-exported so `render.ts`'s options type is the format's own shape. */
-export type { Format };

package/dist/images/commands.js

@@ -1,231 +0,0 @@
-/**
- * `pnpm devtools images [graphic…] [--format …] [--out …]`
- *
- * Renders the club's pictures from the templates in `@devdogsuga/open-graph`. Two axes,
- * asked for separately: WHICH picture (`event/2026-09-08`, `page/events`,
- * `app/dogdays`) and at WHAT SIZE (`gdgc-square`, `og`, `icon-512`). That split
- * is the point of the command — an event poster for the GDG on Campus platform
- * is exactly the pairing "this meeting" x "that platform's banner", and it
- * could not be asked for while the two were one hard-coded list.
- *
- * Anything the command line leaves out, it asks for; anything it names, it does
- * not. So an officer can type `pnpm devtools images` and be walked through it,
- * and a script can pass every flag and never see a prompt.
- *
- * Event graphics used to be the one group backed by a database rather than by
- * files in this repo — and the one group that could therefore be unavailable
- * without one. They no longer are: `configEvents()` (`events.ts`) reads
- * `@devdogsuga/events`'s committed config directly, the same source a
- * reconcile job used to copy into the database first, so this command needs
- * no running stack at all any more. See {@link loadEvents} for what remains
- * of the "unavailable" branch — a repo `@devdogsuga/events` cannot resolve
- * in, rather than a database that is not up.
- */
-import { mkdir, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, isAbsolute, relative, resolve } from "node:path";
-import { log, note } from "@clack/prompts";
-import { loadOpenGraph } from "../repo/source.js";
-import { findRepoRoot } from "../repo/root.js";
-import { positionals } from "../args.js";
-import { errorMessage, explain, explainError, UsageError } from "../ui.js";
-import { configEvents } from "./events.js";
-import { assertUniqueStems, eventGraphics, staticGraphics, } from "./graphics.js";
-import { pickFormats, pickGraphics, pickOutput } from "./prompts.js";
-import { render } from "./render.js";
-import { commaList, formatsFor, matchGraphics, normalizeArgv, pair, } from "./select.js";
-/**
- * The workspace root. Every default directory is written relative to it, and
- * resolving those against `process.cwd()` would put the club's icons wherever
- * the contributor happened to be standing.
- */
-function flagValue(argv, flag) {
-    const index = argv.indexOf(flag);
-    if (index === -1)
-        return undefined;
-    const value = argv[index + 1];
-    return value && !value.startsWith("--") ? value : undefined;
-}
-export function parseImagesArgs(argv) {
-    const normalized = normalizeArgv(argv);
-    return {
-        patterns: positionals(normalized),
-        formats: commaList(flagValue(normalized, "--format")),
-        allFormats: normalized.includes("--all-formats"),
-        out: flagValue(normalized, "--out"),
-        defaultOut: normalized.includes("--default-out"),
-        noOutput: normalized.includes("--dry-run") || normalized.includes("--no-output"),
-    };
-}
-/** `~/images` when the shell did not expand it, which quoting prevents. */
-export function expandHome(path) {
-    return path === "~" || path.startsWith("~/")
-        ? resolve(homedir(), path.slice(2))
-        : path;
-}
-/** Whether anything asked for could be an event, so whether to reach for a database. */
-export function wantsEvents(patterns) {
-    // No pattern means the picker, and the picker should list meetings.
-    if (patterns.length === 0)
-        return true;
-    return patterns.some((pattern) => pattern === "*" ||
-        pattern === "*/*" ||
-        pattern === "event" ||
-        pattern.startsWith("event/"));
-}
-/** Whether a pattern names events specifically, rather than sweeping them up. */
-export function namesEvents(patterns) {
-    return patterns.some((pattern) => pattern === "event" || pattern.startsWith("event/"));
-}
-/**
- * Meetings, or a clear account of why there are none.
- *
- * `@devdogsuga/events` is an optional peer (see `repo/peers.ts`'s header), so
- * loading it can still fail — outside a DevDogsUGA checkout, or one where
- * nothing depends on it. That is the one way this command still needs an
- * account of what went wrong, and two failures are treated differently,
- * matching what each one means:
- *
- *   - **Unavailable, under a wildcard.** `images *` means "everything", and
- *     everything else is renderable. It renders, and reports the events it
- *     could not.
- *   - **Unavailable, named.** `images 'event/*'` asked for exactly the thing
- *     that is missing. Nothing to degrade to, so it fails.
- */
-async function loadEvents(patterns, deps) {
-    const required = namesEvents(patterns);
-    const reader = (deps.reader ?? configEvents)();
-    let meetings;
-    try {
-        meetings = await reader.meetings();
-    }
-    catch (err) {
-        if (required)
-            throw err;
-        return { graphics: [], skipped: errorMessage(err) };
-    }
-    return {
-        graphics: eventGraphics(await loadOpenGraph(), meetings),
-        skipped: null,
-    };
-}
-/** Where one selection is written. */
-export function destinationOf({ graphic, format }, out) {
-    if (out) {
-        // Flat, and always `<stem>-<format>.png`: the pinned filenames a graphic
-        // uses in its own directory (`icon.png`, `opengraph-image.png`) are only
-        // unambiguous BECAUSE the directories differ. Side by side they collide.
-        return resolve(expandHome(out), `${graphic.stem}-${format.name}.png`);
-    }
-    const { dir, file } = graphic.destination(format);
-    return resolve(findRepoRoot(), dir, file);
-}
-/** Repo-relative where possible, so the log reads as paths in this project. */
-function display(file) {
-    const rel = relative(findRepoRoot(), file);
-    return rel.startsWith("..") || isAbsolute(rel) ? file : rel;
-}
-export async function runImages(argv, deps = {}) {
-    const options = parseImagesArgs(argv);
-    if (options.out && options.defaultOut) {
-        explain("Two answers to one question.", "--out names a directory and --default-out says to use each graphic's own.", [
-            "pnpm devtools images 'event/*' --out ~/images",
-            "pnpm devtools images '*' --default-out",
-        ]);
-        process.exitCode = 1;
-        return;
-    }
-    try {
-        await images(options, deps);
-    }
-    catch (err) {
-        explainError("Could not render that.", err, [
-            "pnpm devtools images                      # pick from a list",
-            "pnpm devtools images 'event/*' --all-formats --out ~/images",
-            "pnpm devtools images '*' --default-out",
-        ]);
-        process.exitCode = 1;
-    }
-}
-async function images(options, deps) {
-    // ── Which pictures ────────────────────────────────────────────────────────
-    const registry = await staticGraphics();
-    let skipped = null;
-    if (wantsEvents(options.patterns)) {
-        const events = await loadEvents(options.patterns, deps);
-        registry.push(...events.graphics);
-        skipped = events.skipped;
-    }
-    assertUniqueStems(registry);
-    const graphics = options.patterns.length === 0
-        ? await pickGraphics(registry)
-        : resolvePatterns(options.patterns, registry);
-    if (graphics.length === 0) {
-        throw new UsageError("Nothing to render.");
-    }
-    // ── At what sizes ─────────────────────────────────────────────────────────
-    const { FORMATS } = await loadOpenGraph();
-    const requested = options.allFormats
-        ? (await formatsFor(graphics)).map((format) => format.name)
-        : options.formats.length > 0
-            ? options.formats
-            : await pickFormats(graphics);
-    const unknown = requested.filter((name) => !FORMATS[name]);
-    if (unknown.length > 0) {
-        throw new UsageError(`No format called ${unknown.join(", ")}. Try one of ${Object.keys(FORMATS).join(", ")}.`);
-    }
-    const { selections, unsupported } = await pair(graphics, requested);
-    // Naming one graphic and one format it cannot do is a mistake worth saying
-    // out loud; sweeping up combinations that do not exist under a wildcard is
-    // not, and reporting every one of those would bury the output.
-    if (selections.length === 0 && unsupported.length > 0) {
-        throw new UsageError(unsupported
-            .map((miss) => `${miss.graphic} has no ${miss.format} rendition`)
-            .join("; "));
-    }
-    if (selections.length === 0)
-        throw new UsageError("Nothing to render.");
-    // ── Where ─────────────────────────────────────────────────────────────────
-    // An empty `--out` counts as absent, exactly as the old truthiness test did.
-    const explicitOut = options.out === "" ? undefined : options.out;
-    const out = options.defaultOut
-        ? undefined
-        : (explicitOut ??
-            (options.noOutput ? undefined : await pickOutput(graphics)));
-    if (skipped)
-        log.warn(`event graphics skipped — ${skipped}`);
-    if (options.noOutput) {
-        note(selections
-            .map((selection) => `${selection.graphic.name}  ${selection.format.name}\n  ${display(destinationOf(selection, out))}\n  ${selection.format.why}`)
-            .join("\n"), `${selections.length} image${selections.length === 1 ? "" : "s"}`);
-        return;
-    }
-    // ── Render ────────────────────────────────────────────────────────────────
-    let bytes = 0;
-    for (const selection of selections) {
-        const file = destinationOf(selection, out);
-        const { png, width, height } = await render(selection.graphic.render(selection.format), selection.format);
-        await mkdir(dirname(file), { recursive: true });
-        await writeFile(file, png);
-        bytes += png.length;
-        log.success(`${display(file)}  ${width}x${height}  (${Math.round(png.length / 1024)} KB)`);
-    }
-    log.info(`${selections.length} image${selections.length === 1 ? "" : "s"}, ${Math.round(bytes / 1024)} KB total.`);
-}
-function resolvePatterns(patterns, registry) {
-    const { matched, unmatched } = matchGraphics(patterns, registry);
-    if (unmatched.length === 0)
-        return matched;
-    // An event pattern that matched nothing is almost never a typo — it is a
-    // database with no meetings in it. Saying "try brand/*, page/*" sends the
-    // reader hunting for a spelling mistake that is not there.
-    const askedForEvents = unmatched.some((pattern) => pattern === "event" || pattern.startsWith("event/"));
-    const haveEvents = registry.some((graphic) => graphic.group === "event");
-    if (askedForEvents && !haveEvents) {
-        throw new UsageError("This database has no meetings, so there are no event images to render. " +
-            "Reconcile it from `@devdogsuga/events`, or point at a database that has been.");
-    }
-    const groups = [...new Set(registry.map((graphic) => `${graphic.group}/*`))];
-    throw new UsageError(`Nothing called ${unmatched.join(", ")}. Names are group/name — try ` +
-        `${groups.join(", ")}, or * for all of them.`);
-}

package/dist/images/events.d.ts

@@ -1,47 +0,0 @@
-import type { Meeting } from "@devdogsuga/events";
-import type { EventGraphicSource } from "./graphics.js";
-/**
- * Meetings, for the one group of graphics that cannot be drawn from files
- * alone.
- *
- * Every other graphic is a function of committed files. An event poster used
- * to be a function of meetings RECONCILED into the database from
- * `@devdogsuga/events` — which meant `devtools images event/*` needed a
- * running local stack just to draw a picture that comes entirely out of this
- * repo. It no longer does: `@devdogsuga/events`'s `getClubConfig()` is the
- * authored source those database rows were always reconciled FROM (see
- * `apps/platform/src/server/config/reconcile.ts` in the target repo), so
- * reading it directly here skips the round trip through Postgres rather than
- * duplicating it. {@link EventReader} is the seam the command talks to, so
- * tests never touch the filesystem or the network.
- */
-/** The seam the command talks to, so tests never open a socket. */
-export interface EventReader {
-    meetings(): Promise<EventGraphicSource[]>;
-}
-/**
- * Builds the reader from `@devdogsuga/events`'s committed data file.
- *
- * Replaces `supabaseEvents`, which read the `meetings`/`workshops` tables a
- * reconcile job had already copied this same config into. The config's shape
- * (`schema.ts`) is deliberately a near-mirror of those tables' columns for
- * exactly this reason — see that file's header — so the mapping below is
- * closer to a rename than a translation: `Meeting.id` is the row's `slug`,
- * `Meeting.title` is what the DB called `nameOverride`, and a workshop's
- * `project` (free text in the config) stands in for the DB's
- * `projects.displayName` join.
- */
-export declare function configEvents(): EventReader;
-/**
- * The meeting's name, in descending order of how much somebody meant it.
- *
- * Mirrors `apps/platform/src/lib/meetingTitle.ts`: an authored name, then the
- * kind, then the workshops it teaches, then the date. Two named workshops read
- * as a heading; three do not, and the date carries it while the agenda below
- * shows the detail.
- *
- * Duplicated rather than imported because it lives in the Next app, which this
- * package cannot depend on. `events.test.ts` pins the chain so a change to one
- * shows up as a failure rather than as a differently-titled poster.
- */
-export declare function meetingTitle(nameOverride: string | null, kind: Meeting["kind"], startsAt: Date, agenda: readonly string[]): string;

package/dist/images/events.js

@@ -1,116 +0,0 @@
-import { loadBrandEvent, loadEvents } from "../repo/peers.js";
-/**
- * Builds the reader from `@devdogsuga/events`'s committed data file.
- *
- * Replaces `supabaseEvents`, which read the `meetings`/`workshops` tables a
- * reconcile job had already copied this same config into. The config's shape
- * (`schema.ts`) is deliberately a near-mirror of those tables' columns for
- * exactly this reason — see that file's header — so the mapping below is
- * closer to a rename than a translation: `Meeting.id` is the row's `slug`,
- * `Meeting.title` is what the DB called `nameOverride`, and a workshop's
- * `project` (free text in the config) stands in for the DB's
- * `projects.displayName` join.
- */
-export function configEvents() {
-    return {
-        async meetings() {
-            const { getClubConfig } = await loadEvents();
-            const { EVENT_SEGMENT_VISUALS, meetingCardDetail, meetingLocation } = await loadBrandEvent();
-            // Newest first, matching the DB reader's `order("startsAt", {
-            // ascending: false })` — the picker should offer the most recent
-            // meeting first, not whatever order the config file happens to list
-            // them in.
-            const meetings = [...getClubConfig().meetings].sort((a, b) => Date.parse(b.startsAt) - Date.parse(a.startsAt));
-            return meetings.map((row) => {
-                const meeting = {
-                    slug: row.id,
-                    startsAt: new Date(row.startsAt),
-                    endsAt: new Date(row.endsAt),
-                    building: row.building,
-                    location: row.location,
-                    kind: row.kind,
-                    cancelledAt: row.cancelledAt ? new Date(row.cancelledAt) : null,
-                    cancellationReason: row.cancellationReason,
-                };
-                // No competitions here either, for the same reason `supabaseEvents`
-                // dropped them: a competition is a mirrored GitHub issue now, not
-                // config a meeting kicks off. Every agenda item is plain "workshop".
-                const items = row.agenda.map((workshop) => ({
-                    label: workshopLabel(workshop),
-                    segment: "workshop",
-                }));
-                const detail = meetingCardDetail({
-                    meeting,
-                    title: meetingTitle(row.title, row.kind, meeting.startsAt, items.map((item) => item.label)),
-                    agenda: items.map((item) => `${EVENT_SEGMENT_VISUALS[item.segment].label}: ${item.label}`),
-                    location: meetingLocation(row.building, row.location),
-                });
-                return {
-                    slug: row.id,
-                    hint: describeMeeting(meeting),
-                    detail,
-                    items: items.map((item) => {
-                        const visual = EVENT_SEGMENT_VISUALS[item.segment];
-                        return {
-                            stem: slugPart(item.label),
-                            detail: {
-                                ...detail,
-                                title: item.label,
-                                agenda: undefined,
-                                badge: { label: visual.label, accent: visual.accent },
-                            },
-                        };
-                    }),
-                };
-            });
-        },
-    };
-}
-/** A readable path component for a workshop card. */
-function slugPart(label) {
-    return (label
-        .toLowerCase()
-        .normalize("NFKD")
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-|-$/g, "") || "agenda-item");
-}
-/** Unlike the old DB `WorkshopRow`, `Workshop.title` is non-nullable in the
- * config schema (`workshopSchema`), so there is no `projects.displayName`
- * fallback left to reach for. */
-function workshopLabel(row) {
-    return row.title;
-}
-/**
- * The meeting's name, in descending order of how much somebody meant it.
- *
- * Mirrors `apps/platform/src/lib/meetingTitle.ts`: an authored name, then the
- * kind, then the workshops it teaches, then the date. Two named workshops read
- * as a heading; three do not, and the date carries it while the agenda below
- * shows the detail.
- *
- * Duplicated rather than imported because it lives in the Next app, which this
- * package cannot depend on. `events.test.ts` pins the chain so a change to one
- * shows up as a failure rather than as a differently-titled poster.
- */
-export function meetingTitle(nameOverride, kind, startsAt, agenda) {
-    if (nameOverride !== null)
-        return nameOverride;
-    if (kind !== null)
-        return kind;
-    if (agenda.length === 1)
-        return `Workshop: ${agenda[0]}`;
-    if (agenda.length === 2)
-        return `Workshop: ${agenda[0]} & ${agenda[1]}`;
-    return startsAt.toLocaleDateString("en-US", {
-        timeZone: "America/New_York",
-        dateStyle: "long",
-    });
-}
-/** One line for the picker: when it is, and whether it is still on. */
-function describeMeeting(meeting) {
-    const when = meeting.startsAt.toLocaleDateString("en-US", {
-        timeZone: "America/New_York",
-        dateStyle: "medium",
-    });
-    return meeting.cancelledAt === null ? when : `${when}, cancelled`;
-}

package/dist/images/graphics.d.ts

@@ -1,70 +0,0 @@
-import type { EventDetail, Format, OpenGraphModule } from "./open-graph-types.js";
-import type { ReactElement } from "react";
-/**
- * What the club draws pictures OF, as opposed to what size it draws them at.
- *
- * Those are two axes and this file owns one of them; `@devdogsuga/open-graph`'s
- * `formats.ts` owns the other. Keeping them apart is the point: an event poster
- * for the GDG on Campus platform is the pairing "this meeting" x "that
- * platform's banner", and while they were one flat list of hard-coded
- * (content, size) targets, no such pairing could be asked for — only the ones
- * somebody had already written down existed.
- *
- * The matrix is SPARSE, and each graphic declares its own column of it. Every
- * graphic supports the two GDG renditions, because anything the club makes may
- * end up on that platform. Beyond that: `savvycal` is one cover on one
- * scheduling page and belongs to the club lockup alone, the email densities
- * belong to the lockup too, and the icon sizes belong to the apps.
- */
-/** Where a rendered file goes, relative to the repo root. */
-export interface Destination {
-    dir: string;
-    file: string;
-}
-export interface Graphic {
-    /** `group/name`, which is what the CLI matches and globs against. */
-    name: string;
-    group: string;
-    /** The leaf. Unique across every graphic — `assertUniqueStems` enforces it. */
-    stem: string;
-    /** Format names this can be rendered at. */
-    formats: string[];
-    /** One line: what this picture is. */
-    why: string;
-    render: (format: Format) => ReactElement;
-    /** Where `--default-out` puts it. */
-    destination: (format: Format) => Destination;
-}
-/** A meeting, already loaded and formatted, ready to be drawn. */
-export interface EventGraphicSource {
-    slug: string;
-    detail: EventDetail;
-    /** For the picker's hint: when it is, and whether it is on. */
-    hint: string;
-    /** Separate cards generated only when the night contains multiple items. */
-    items?: Array<{
-        detail: EventDetail;
-        stem: string;
-    }>;
-}
-/**
- * One graphic per meeting.
- *
- * These are the reason the two axes were split at all: "this meeting" x "the
- * GDG platform's banner" is a pairing nobody could have enumerated in advance.
- *
- * Their default directory is the one that is NOT in the repo. Every other
- * graphic is a committed asset the club re-renders; an event poster is an
- * export headed somewhere else, made once for one night. Writing those into
- * `public/brand` would fill a tracked directory with a growing pile of
- * one-offs, so they go to {@link EVENT_SCRATCH_DIR}, which `.gitignore` covers.
- */
-export declare const EVENT_SCRATCH_DIR = ".images/events";
-export declare function eventGraphics(og: OpenGraphModule, events: EventGraphicSource[]): Graphic[];
-/** Everything that does not need a database. */
-export declare function staticGraphics(): Promise<Graphic[]>;
-/**
- * Every leaf is unique, so a flat `--out` directory cannot silently overwrite
- * one graphic's file with another's.
- */
-export declare function assertUniqueStems(graphics: Graphic[]): void;