@forumone/throughline 1.0.0-next.0 → 1.0.0-next.2

package/dist/mcp/meta.d.ts

@@ -9,13 +9,13 @@ export declare const McpMetaSchema: z.ZodOptional<z.ZodObject<{
     reasoning: z.ZodOptional<z.ZodString>;
     changesSummary: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    userPrompt?: string | undefined;
     reasoning?: string | undefined;
     changesSummary?: string | undefined;
-}, {
     userPrompt?: string | undefined;
+}, {
     reasoning?: string | undefined;
     changesSummary?: string | undefined;
+    userPrompt?: string | undefined;
 }>>;
 export type McpMeta = z.infer<typeof McpMetaSchema>;
 /**
@@ -34,13 +34,13 @@ export declare function withMeta<Shape extends z.ZodRawShape>(shape: Shape): z.Z
         reasoning: z.ZodOptional<z.ZodString>;
         changesSummary: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        userPrompt?: string | undefined;
         reasoning?: string | undefined;
         changesSummary?: string | undefined;
-    }, {
         userPrompt?: string | undefined;
+    }, {
         reasoning?: string | undefined;
         changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<Shape & {
     _meta: z.ZodOptional<z.ZodObject<{
@@ -48,13 +48,13 @@ export declare function withMeta<Shape extends z.ZodRawShape>(shape: Shape): z.Z
         reasoning: z.ZodOptional<z.ZodString>;
         changesSummary: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        userPrompt?: string | undefined;
         reasoning?: string | undefined;
         changesSummary?: string | undefined;
-    }, {
         userPrompt?: string | undefined;
+    }, {
         reasoning?: string | undefined;
         changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
     }>>;
 }>, any> extends infer T ? { [k in keyof T]: T[k]; } : never, z.baseObjectInputType<Shape & {
     _meta: z.ZodOptional<z.ZodObject<{
@@ -62,13 +62,13 @@ export declare function withMeta<Shape extends z.ZodRawShape>(shape: Shape): z.Z
         reasoning: z.ZodOptional<z.ZodString>;
         changesSummary: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        userPrompt?: string | undefined;
         reasoning?: string | undefined;
         changesSummary?: string | undefined;
-    }, {
         userPrompt?: string | undefined;
+    }, {
         reasoning?: string | undefined;
         changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
     }>>;
 }> extends infer T_1 ? { [k_1 in keyof T_1]: T_1[k_1]; } : never>;
 //# sourceMappingURL=meta.d.ts.map

package/dist/migrate/cli.d.ts

@@ -0,0 +1,9 @@
+interface Write {
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+}
+export declare function migrateImports(args: readonly string[], out?: Write): Promise<number>;
+/** The `throughline` bin: one subcommand so far. */
+export declare function main(argv: readonly string[]): Promise<number>;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/migrate/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/migrate/cli.ts"],"names":[],"mappings":"AA0BA,UAAU,KAAK;IACb,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AAgBD,wBAAsB,cAAc,CAClC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,GAAE,KAAsD,GAC1D,OAAO,CAAC,MAAM,CAAC,CAyDjB;AAED,oDAAoD;AACpD,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAKnE"}

package/dist/migrate/cli.js

@@ -0,0 +1,105 @@
+/* eslint-disable no-console -- a command-line tool, whose output is the console */
+import { readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { join, relative, resolve } from 'node:path';
+import { COUNTERPARTS, rewriteSource } from './rewrite.js';
+/*
+`throughline migrate-imports [paths…] [--dry-run]`
+
+Rewrites every 0.x Throughline import under the given paths (default: the
+working directory) to its 1.0 home, and reports what it could not place. Exits 1
+when anything is left unresolved, so a migration can gate on it.
+*/
+const SOURCE = /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs)$/;
+const SKIP = new Set(['node_modules', 'dist', '.next', '.turbo', 'build', 'coverage', '.git']);
+const OLD_PACKAGES = [
+    ...new Set(Object.keys(COUNTERPARTS).map((s) => s.split('/').slice(0, 2).join('/'))),
+];
+const USAGE = `Usage: throughline migrate-imports [paths…] [--dry-run]
+
+Rewrites imports of the 0.x @forumone/throughline-* packages to
+@forumone/throughline and @forumone/throughline-design-system 1.0.
+
+  --dry-run   report what would change, and write nothing`;
+async function* walk(path) {
+    const info = await stat(path);
+    if (info.isFile()) {
+        yield path;
+        return;
+    }
+    for (const entry of await readdir(path, { withFileTypes: true })) {
+        if (SKIP.has(entry.name))
+            continue;
+        const full = join(path, entry.name);
+        if (entry.isDirectory())
+            yield* walk(full);
+        else
+            yield full;
+    }
+}
+export async function migrateImports(args, out = { stdout: console.log, stderr: console.error }) {
+    if (args.includes('--help') || args.includes('-h')) {
+        out.stdout(USAGE);
+        return 0;
+    }
+    const dryRun = args.includes('--dry-run');
+    const roots = args.filter((a) => !a.startsWith('--'));
+    const cwd = process.cwd();
+    let changed = 0;
+    const review = [];
+    const unresolved = [];
+    const manifests = [];
+    for (const root of roots.length > 0 ? roots : ['.']) {
+        for await (const file of walk(resolve(root))) {
+            const name = relative(cwd, file) || file;
+            if (file.endsWith('package.json')) {
+                const manifest = JSON.parse(await readFile(file, 'utf8'));
+                const deps = ['dependencies', 'devDependencies', 'peerDependencies'].flatMap((field) => Object.keys(manifest[field] ?? {}).filter((dep) => OLD_PACKAGES.includes(dep)));
+                if (deps.length > 0)
+                    manifests.push({ file: name, deps });
+                continue;
+            }
+            if (!SOURCE.test(file))
+                continue;
+            const text = await readFile(file, 'utf8');
+            if (!text.includes('@forumone/throughline-'))
+                continue;
+            const result = rewriteSource(text);
+            for (const finding of result.review)
+                review.push({ file: name, ...finding });
+            for (const finding of result.unresolved)
+                unresolved.push({ file: name, ...finding });
+            if (result.changed) {
+                changed++;
+                if (!dryRun)
+                    await writeFile(file, result.text);
+            }
+        }
+    }
+    out.stdout(`${dryRun ? 'Would rewrite' : 'Rewrote'} ${changed} file${changed === 1 ? '' : 's'}.`);
+    if (review.length > 0) {
+        out.stdout(`\nRewritten, but check (${review.length}):`);
+        for (const f of review)
+            out.stdout(`  ${f.file}:${f.line}  ${f.message}`);
+    }
+    if (manifests.length > 0) {
+        out.stdout('\nDependencies to replace with @forumone/throughline (and @forumone/throughline-design-system for design-contract and design-system-payload):');
+        for (const m of manifests)
+            out.stdout(`  ${m.file}: ${m.deps.join(', ')}`);
+    }
+    if (unresolved.length > 0) {
+        out.stderr(`\nLeft as they were (${unresolved.length}):`);
+        for (const f of unresolved)
+            out.stderr(`  ${f.file}:${f.line}  ${f.message}`);
+        return 1;
+    }
+    return 0;
+}
+/** The `throughline` bin: one subcommand so far. */
+export async function main(argv) {
+    const [command, ...rest] = argv;
+    if (command === 'migrate-imports')
+        return migrateImports(rest);
+    console.error(command ? `Unknown command: ${command}\n\n${USAGE}` : USAGE);
+    return command ? 2 : 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/migrate/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/migrate/cli.ts"],"names":[],"mappings":"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"}