@12ui/design 0.2.6 → 0.2.8

package/dist/legacy-cli-cleanup.js

@@ -94,4 +94,16 @@ export const retireRecognizedLegacyCli = async (args) => {
     await rename(removed, recovery);
     return { removed, recovery };
 };
+export const restoreRetiredLegacyCli = async (retired) => {
+    try {
+        await lstat(retired.removed);
+        throw new Error(`Refusing to overwrite ${retired.removed} while restoring legacy 12ui CLI`);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    await mkdir(path.dirname(retired.removed), { recursive: true });
+    await rename(retired.recovery, retired.removed);
+};
 //# sourceMappingURL=legacy-cli-cleanup.js.map

package/dist/legacy-cli-cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-cli-cleanup.js","sourceRoot":"","sources":["../src/legacy-cli-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,GACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAC/C,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AACxC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AACvC,MAAM,wBAAwB,GAC5B,iGAAiG,CAAC;AACpG,MAAM,yBAAyB,GAC7B,+DAA+D,CAAC;AAClE,MAAM,qBAAqB,GAAG,CAAC,cAAc,EAAE,mBAAmB,EAAE,cAAc,CAAC,CAAC;AASpF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAuB,EAAE,CAAC,CACxD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CACrE,CAAC;AAEF,MAAM,UAAU,GAAG,KAAK,EAAE,MAAc,EAAoB,EAAE;IAC5D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,KAAK,EAAE,MAAc,EAAoB,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,KAAK,EAAE,MAAc,EAA8B,EAAE;IAC1E,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACnE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,IAAI,CAAC;QAC9C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,CAC3D,QAAQ,CAAC,KAAK,CAAC;OACZ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;OAC/B,KAAK,CAAC,mBAAmB,CAAC,KAAK,oBAAoB,CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,aAAqB,EAAU,EAAE,CAAC,CAC9D,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,aAAqB,EAAoB,EAAE;IACrF,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IACE,OAAO,CAAC,MAAM,KAAK,qBAAqB,CAAC,MAAM;WAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,qBAAqB,CAAC,KAAK,CAAC,CAAC,EACzE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC/C,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACpD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;KACvD,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACnD,IACE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;WAC/B,CAAC,uBAAuB,CAAC,QAAQ,CAAC,YAAY,CAAC;WAC/C,IAAI,CAAC,IAAI,KAAK,UAAU;WACxB,IAAI,CAAC,eAAe,KAAK,CAAC;WAC1B,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IACrE,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC;WACf,uBAAuB,CAAC,QAAQ,CAAC,YAAY,CAAC;WAC9C,QAAQ,CAAC,aAAa,CAAC;WACvB,aAAa,CAAC,OAAO,KAAK,sBAAsB;WAChD,aAAa,CAAC,QAAQ,KAAK,yBAAyB;WACpD,aAAa,CAAC,SAAS,KAAK,wBAAwB;WACpD,SAAS,CAAC,IAAI,KAAK,mBAAmB;WACtC,SAAS,CAAC,OAAO,KAAK,sBAAsB,CAChD,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAAE,IAG/C,EAAoC,EAAE;IACrC,IAAI,CAAC,CAAC,MAAM,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,cAAc,EACd,uBAAuB,sBAAsB,IAAI,UAAU,EAAE,EAAE,CAChE,CAAC;IACF,MAAM,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC,CAAC"}
+{"version":3,"file":"legacy-cli-cleanup.js","sourceRoot":"","sources":["../src/legacy-cli-cleanup.ts"],"names":[],"mappings":"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"}

package/dist/legacy-npm-global-cli-cleanup.d.ts

@@ -0,0 +1,16 @@
+import { type LegacyNpmGlobalCliPaths } from './legacy-npm-global-cli-recognition.js';
+export { digestLegacyNpmGlobalPackageTree, isRecognizedNpmGlobalLegacyCli, legacyNpmGlobalCliPaths, } from './legacy-npm-global-cli-recognition.js';
+export type { LegacyNpmGlobalCliPaths } from './legacy-npm-global-cli-recognition.js';
+export type RetiredLegacyNpmGlobalCli = {
+    removed: LegacyNpmGlobalCliPaths;
+    recovery: LegacyNpmGlobalCliPaths & {
+        root: string;
+    };
+};
+export declare const retireRecognizedNpmGlobalLegacyCli: (args: {
+    dataRoot: string;
+    homeDirectory: string;
+    recognizedPackageTreeDigests?: ReadonlySet<string>;
+}) => Promise<RetiredLegacyNpmGlobalCli | null>;
+export declare const restoreRetiredNpmGlobalLegacyCli: (retired: RetiredLegacyNpmGlobalCli) => Promise<void>;
+//# sourceMappingURL=legacy-npm-global-cli-cleanup.d.ts.map

package/dist/legacy-npm-global-cli-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-npm-global-cli-cleanup.d.ts","sourceRoot":"","sources":["../src/legacy-npm-global-cli-cleanup.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,gCAAgC,EAChC,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,wCAAwC,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEtF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,uBAAuB,CAAC;IACjC,QAAQ,EAAE,uBAAuB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,CAAC;AAiCF,eAAO,MAAM,kCAAkC,GAAU,MAAM;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpD,KAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CA0C3C,CAAC;AAEF,eAAO,MAAM,gCAAgC,GAC3C,SAAS,yBAAyB,KACjC,OAAO,CAAC,IAAI,CA2Cd,CAAC"}

package/dist/legacy-npm-global-cli-cleanup.js

@@ -0,0 +1,102 @@
+import { randomUUID } from 'node:crypto';
+import { lstat, mkdir, rename, rm, } from 'node:fs/promises';
+import path from 'node:path';
+import { isRecognizedNpmGlobalLegacyCli, LEGACY_NPM_GLOBAL_PACKAGE_VERSION, legacyNpmGlobalCliPaths, } from './legacy-npm-global-cli-recognition.js';
+export { digestLegacyNpmGlobalPackageTree, isRecognizedNpmGlobalLegacyCli, legacyNpmGlobalCliPaths, } from './legacy-npm-global-cli-recognition.js';
+const pathExists = async (target) => {
+    try {
+        await lstat(target);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+};
+const restoreMovedPair = async (args) => {
+    const restorations = await Promise.allSettled([
+        ...(args.movedLauncher
+            ? [rename(args.recovery.launcher, args.original.launcher)]
+            : []),
+        ...(args.movedPackage
+            ? [rename(args.recovery.packageRoot, args.original.packageRoot)]
+            : []),
+    ]);
+    return restorations.flatMap((result) => (result.status === 'rejected'
+        ? [result.reason instanceof Error ? result.reason : new Error(String(result.reason))]
+        : []));
+};
+export const retireRecognizedNpmGlobalLegacyCli = async (args) => {
+    if (!(await isRecognizedNpmGlobalLegacyCli(args)))
+        return null;
+    const removed = legacyNpmGlobalCliPaths(args.homeDirectory);
+    const retirementRoot = path.join(args.dataRoot, 'retired');
+    const recoveryRoot = path.join(retirementRoot, `npm-global-just-every-12ui-${LEGACY_NPM_GLOBAL_PACKAGE_VERSION}-${randomUUID()}`);
+    const recovery = {
+        root: recoveryRoot,
+        launcher: path.join(recoveryRoot, '12ui'),
+        packageRoot: path.join(recoveryRoot, 'package'),
+    };
+    await mkdir(retirementRoot, { recursive: true });
+    await mkdir(recoveryRoot);
+    const moves = await Promise.allSettled([
+        rename(removed.launcher, recovery.launcher),
+        rename(removed.packageRoot, recovery.packageRoot),
+    ]);
+    const moveErrors = moves.flatMap((result) => (result.status === 'rejected'
+        ? [result.reason instanceof Error ? result.reason : new Error(String(result.reason))]
+        : []));
+    if (moveErrors.length > 0) {
+        const restoreErrors = await restoreMovedPair({
+            movedLauncher: moves[0]?.status === 'fulfilled',
+            movedPackage: moves[1]?.status === 'fulfilled',
+            original: removed,
+            recovery,
+        });
+        if (restoreErrors.length === 0) {
+            await rm(recoveryRoot, { recursive: true, force: true });
+            throw moveErrors[0];
+        }
+        throw new AggregateError([...moveErrors, ...restoreErrors], 'Legacy npm-global 12ui retirement failed and could not be restored');
+    }
+    return { removed, recovery };
+};
+export const restoreRetiredNpmGlobalLegacyCli = async (retired) => {
+    const destinationsExist = await Promise.all([
+        pathExists(retired.removed.launcher),
+        pathExists(retired.removed.packageRoot),
+    ]);
+    if (destinationsExist.some(Boolean)) {
+        throw new Error('Refusing to overwrite a path while restoring the legacy npm-global 12ui CLI');
+    }
+    await Promise.all([
+        mkdir(path.dirname(retired.removed.launcher), { recursive: true }),
+        mkdir(path.dirname(retired.removed.packageRoot), { recursive: true }),
+    ]);
+    const restorations = await Promise.allSettled([
+        rename(retired.recovery.launcher, retired.removed.launcher),
+        rename(retired.recovery.packageRoot, retired.removed.packageRoot),
+    ]);
+    const restoreErrors = restorations.flatMap((result) => (result.status === 'rejected'
+        ? [result.reason instanceof Error ? result.reason : new Error(String(result.reason))]
+        : []));
+    if (restoreErrors.length > 0) {
+        const rollbackResults = await Promise.allSettled([
+            ...(restorations[0]?.status === 'fulfilled'
+                ? [rename(retired.removed.launcher, retired.recovery.launcher)]
+                : []),
+            ...(restorations[1]?.status === 'fulfilled'
+                ? [rename(retired.removed.packageRoot, retired.recovery.packageRoot)]
+                : []),
+        ]);
+        const rollbackErrors = rollbackResults.flatMap((result) => (result.status === 'rejected'
+            ? [result.reason instanceof Error ? result.reason : new Error(String(result.reason))]
+            : []));
+        throw new AggregateError([...restoreErrors, ...rollbackErrors], rollbackErrors.length > 0
+            ? 'Retired npm-global 12ui CLI restore failed and could not be rolled back'
+            : 'Retired npm-global 12ui CLI could not be restored');
+    }
+    await rm(retired.recovery.root, { recursive: true, force: true });
+};
+//# sourceMappingURL=legacy-npm-global-cli-cleanup.js.map

package/dist/legacy-npm-global-cli-cleanup.js.map

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

package/dist/legacy-npm-global-cli-recognition.d.ts

@@ -0,0 +1,12 @@
+export declare const LEGACY_NPM_GLOBAL_PACKAGE_VERSION = "0.1.97";
+export type LegacyNpmGlobalCliPaths = {
+    launcher: string;
+    packageRoot: string;
+};
+export declare const digestLegacyNpmGlobalPackageTree: (packageRoot: string) => Promise<string | null>;
+export declare const legacyNpmGlobalCliPaths: (homeDirectory: string) => LegacyNpmGlobalCliPaths;
+export declare const isRecognizedNpmGlobalLegacyCli: (args: {
+    homeDirectory: string;
+    recognizedPackageTreeDigests?: ReadonlySet<string>;
+}) => Promise<boolean>;
+//# sourceMappingURL=legacy-npm-global-cli-recognition.d.ts.map

package/dist/legacy-npm-global-cli-recognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-npm-global-cli-recognition.d.ts","sourceRoot":"","sources":["../src/legacy-npm-global-cli-recognition.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,iCAAiC,WAAW,CAAC;AAc1D,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAUF,eAAO,MAAM,gCAAgC,GAC3C,aAAa,MAAM,KAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CA2CvB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,eAAe,MAAM,KAAG,uBAM/D,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAU,MAAM;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpD,KAAG,OAAO,CAAC,OAAO,CAqClB,CAAC"}

package/dist/legacy-npm-global-cli-recognition.js

@@ -0,0 +1,105 @@
+import { createHash } from 'node:crypto';
+import { lstat, readFile, readdir, readlink, } from 'node:fs/promises';
+import path from 'node:path';
+const LEGACY_PACKAGE_NAME = '@just-every/12ui';
+export const LEGACY_NPM_GLOBAL_PACKAGE_VERSION = '0.1.97';
+const LEGACY_LAUNCHER_TARGET = '../lib/node_modules/@just-every/12ui/dist/cli.js';
+// Canonical digest of the complete npm-global package tree observed for the
+// published @just-every/12ui@0.1.97 darwin-arm64 installation. The digest
+// includes paths, entry kinds, permission bits, file bytes, and symlink targets.
+const RECOGNIZED_PACKAGE_TREE_DIGESTS = new Set([
+    'd7cdcb6a5ebc3f729824fd429b6939c49c5215f407b652305c6bac1ddcaaed0f',
+]);
+class UnsupportedLegacyPackageEntryError extends Error {
+}
+const isRecord = (value) => (typeof value === 'object' && value !== null && !Array.isArray(value));
+const entryOrder = (left, right) => (left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
+export const digestLegacyNpmGlobalPackageTree = async (packageRoot) => {
+    const visit = async (directory, relativeDirectory = '') => {
+        const entries = (await readdir(directory, { withFileTypes: true })).sort(entryOrder);
+        const records = await Promise.all(entries.map(async (entry) => {
+            const absolute = path.join(directory, entry.name);
+            const relative = relativeDirectory
+                ? `${relativeDirectory}/${entry.name}`
+                : entry.name;
+            const metadata = await lstat(absolute);
+            const mode = (metadata.mode & 0o777).toString(8);
+            if (metadata.isSymbolicLink()) {
+                return [`symlink\0${relative}\0${mode}\0${await readlink(absolute)}\0`];
+            }
+            if (metadata.isDirectory()) {
+                return [
+                    `directory\0${relative}\0${mode}\0`,
+                    ...await visit(absolute, relative),
+                ];
+            }
+            if (metadata.isFile()) {
+                const fileDigest = createHash('sha256')
+                    .update(await readFile(absolute))
+                    .digest('hex');
+                return [`file\0${relative}\0${mode}\0${fileDigest}\0`];
+            }
+            throw new UnsupportedLegacyPackageEntryError(`Unsupported entry in legacy npm-global CLI: ${absolute}`);
+        }));
+        return records.flat();
+    };
+    try {
+        const rootMetadata = await lstat(packageRoot);
+        if (!rootMetadata.isDirectory() || rootMetadata.isSymbolicLink())
+            return null;
+        const treeDigest = createHash('sha256');
+        for (const record of await visit(packageRoot))
+            treeDigest.update(record);
+        return treeDigest.digest('hex');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        if (error instanceof UnsupportedLegacyPackageEntryError)
+            return null;
+        throw error;
+    }
+};
+export const legacyNpmGlobalCliPaths = (homeDirectory) => {
+    const prefix = path.join(homeDirectory, '.npm-global');
+    return {
+        launcher: path.join(prefix, 'bin', '12ui'),
+        packageRoot: path.join(prefix, 'lib', 'node_modules', '@just-every', '12ui'),
+    };
+};
+export const isRecognizedNpmGlobalLegacyCli = async (args) => {
+    const targets = legacyNpmGlobalCliPaths(args.homeDirectory);
+    let launcherMetadata;
+    try {
+        launcherMetadata = await lstat(targets.launcher);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+    if (!launcherMetadata.isSymbolicLink())
+        return false;
+    if (await readlink(targets.launcher) !== LEGACY_LAUNCHER_TARGET)
+        return false;
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(path.join(targets.packageRoot, 'package.json'), 'utf8'));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError
+            || error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+    if (!isRecord(manifest)
+        || manifest.name !== LEGACY_PACKAGE_NAME
+        || manifest.version !== LEGACY_NPM_GLOBAL_PACKAGE_VERSION
+        || manifest.bin !== './dist/cli.js') {
+        return false;
+    }
+    const digest = await digestLegacyNpmGlobalPackageTree(targets.packageRoot);
+    return digest !== null && (args.recognizedPackageTreeDigests ?? RECOGNIZED_PACKAGE_TREE_DIGESTS).has(digest);
+};
+//# sourceMappingURL=legacy-npm-global-cli-recognition.js.map

package/dist/legacy-npm-global-cli-recognition.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12ui/design",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "description": "The canonical 12UI CLI, SDK, MCP server, and visual interface design skills",
   "main": "dist/index.js",
@@ -24,7 +24,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@just-every/ensemble": "0.2.272",
+    "@just-every/ensemble": "0.2.274",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "sharp": "^0.34.5"
   },

package/skills/design/SKILL.md

@@ -13,7 +13,11 @@ than recreating it manually.
 
 ## Choose the route
 
-- Finished screenshot or mockup: use `design-convert` directly.
+- Finished screenshot or mockup to reproduce faithfully: use `design-convert`
+  directly.
+- Existing screenshot supplied as a redesign source: choose an exploratory
+  redesign or a structure-preserving reskin below. It is not a corpus
+  inspiration image.
 - Small visual edit: change the existing project code. Do not search, generate,
   or convert.
 - Rough brief, new interface, or major redesign: use the workflow below.
@@ -26,6 +30,19 @@ Inspect the project before designing: its instructions, framework, routes,
 components, assets, conventions, validation commands, and existing user
 changes. Create the run directory under the system temporary directory.
 
+If there is a redesign source, state a short preserve/change contract before
+searching. Choose one mode:
+
+- `exploratory-redesign`: preserve only named product/UX constraints and allow
+  layout and visual language to change.
+- `structure-preserving-reskin`: preserve the named information architecture,
+  content hierarchy, and interactions; change only the named visual qualities.
+
+If the source is a long page or contains more than the target screen, crop the
+relevant first viewport into the system temporary run directory before search
+or generation. Keep and hash both the original and prepared crop; do not make
+the image model solve a whole-page composition inside one viewport.
+
 Search with the CLI; do not make a separate brief file:
 
 ```bash
@@ -36,6 +53,20 @@ Search with the CLI; do not make a separate brief file:
   --out-dir <run-dir>/references
 ```
 
+For either redesign mode, add the existing screenshot to retrieval:
+
+```bash
+12ui corpus inspire \
+  --query "<preserve/change contract and desired direction>" \
+  --reference-image <redesign-source.png> \
+  --count 4 \
+  --aspect <landscape|portrait|square> \
+  --out-dir <run-dir>/references
+```
+
+This performs one image-and-text-conditioned search. The redesign source stays
+distinct from the four returned corpus inspirations.
+
 Use the four real downloaded images in endpoint order. `manifest.json`
 contains their IDs, paths, hashes, roles, arms, cells, relevance, relevance
 percentiles, and quality percentiles. Preserve those values; do not rerank or
@@ -50,7 +81,8 @@ imagery where useful, strong hierarchy, breathing room, and sound UX. Make the
 result striking at first glance, but keep the prompt to a few sentences and
 let the image model choose layout, style, palette, typography, and detail.
 
-Use this shape as guidance, not a form to fill mechanically:
+For new interfaces and exploratory redesigns, use this shape as guidance, not
+a form to fill mechanically:
 
 ```text
 Create one distinctive [desktop/mobile] [interface] for [product and purpose].
@@ -61,14 +93,33 @@ the visual language yourself. Fill the canvas without a device or presentation
 frame.
 ```
 
-Map reference 1 to candidate A, 2 to B, 3 to C, and 4 to D. Each candidate gets
-exactly one reference. Never combine references in a single generation.
-Before writing the prompts, derive one short, visibly grounded direction from
-each paired reference—such as airy editorial, tactile retail, cinematic, or
+For a structure-preserving reskin, be explicit about what is fixed but leave
+visual choices open:
+
+```text
+Reskin this [desktop/mobile] interface for [product and purpose]. Preserve the
+attached source's information architecture, content hierarchy, primary actions,
+and interactions. Change only [named visual qualities]. Show the first viewport
+or primary screen and choose the palette, typography, spacing, and detail.
+Fill the canvas without a device or presentation frame.
+```
+
+Map corpus reference 1 to candidate A, 2 to B, 3 to C, and 4 to D. Before
+writing the prompts, derive one short, visibly grounded direction from each
+paired corpus reference—such as airy editorial, tactile retail, cinematic, or
 playful illustration. Use that as the candidate's one desired quality, and
 make the four directions meaningfully different. Do not describe the whole
 reference or prescribe its layout, palette, or techniques.
 
+Use exactly one image reference per generation; never combine images:
+
+- New interface or `exploratory-redesign`: each candidate uses its paired
+  corpus image. The redesign source conditions search but is not also attached
+  to generation.
+- `structure-preserving-reskin`: every candidate uses the redesign source as
+  its sole image reference. Its paired corpus image contributes only the short
+  textual direction above; do not attach that corpus image to generation.
+
 Write one batch manifest in the run directory with four candidates:
 
 ```json
@@ -77,11 +128,12 @@ Write one batch manifest in the run directory with four candidates:
   "projectRoot": "<absolute-project-root>",
   "provider": "auto",
   "aspect": "landscape",
+  "referenceMode": "inspiration",
   "candidates": [
     {
       "id": "A",
       "prompt": "<short candidate prompt>",
-      "reference": "<reference-1-path>",
+      "reference": "<single-generation-reference-path>",
       "out": "<run-dir>/candidates/A.png",
       "idempotencyKey": "<stable-A-key>"
     }
@@ -89,7 +141,11 @@ Write one batch manifest in the run directory with four candidates:
 }
 ```
 
-Include A-D, each with its mapped reference, unique PNG output, and stable key.
+Include A-D, each with its one allowed image reference, unique PNG output, and
+stable key. Set the top-level `referenceMode` to `inspiration` for new and
+exploratory candidates, or `preserve-structure` when the redesign source is
+the sole reference. This is persisted semantic evidence; GPT Image 2 already
+processes image inputs at fixed high fidelity, so do not add `input_fidelity`.
 Then run one foreground command:
 
 ```bash
@@ -103,7 +159,7 @@ from one host task: that tool path may queue them serially. Never retry a failed
 or ambiguous candidate, switch providers after dispatch, use cached samples, or
 leave generation in detached background work.
 
-### 3. Select and convert
+### 3. Select
 
 Inspect all candidates at original detail. Choose the best eligible direction
 for the brief, hierarchy, usability, personality, accessibility, feasibility,
@@ -117,18 +173,47 @@ provenance or a tie-breaker between visibly strong candidates.
 
 Write `<run-dir>/selection.json` using
 [the selection contract](references/selection-contract.md). Record exact
-prompts, references, candidate paths and hashes, winner, specific rejection
-reasons, and visible rationale. Convert only that winner with `design-convert`.
+prompts, original/prepared redesign-source paths and hashes, preserve/change contract, design mode,
+reference policy, corpus directions, candidate paths and hashes, winner,
+specific rejection reasons, and visible rationale.
+
+### 4. Extend and convert
+
+If the winner represents the complete simple surface, convert only that winner
+with `design-convert` and continue to integration.
+
+When the first image intentionally omitted later page viewports, routes, or app
+states, freeze the winner as the sole visual reference for every continuation.
+Plan 2-16 useful continuations. Prompt only the state, content, actions, and
+route purpose that must change; do not redescribe palette, typography, layout,
+style, or visual techniques. Set the continuation batch `referenceMode` to
+`inspiration`: the winner supplies the visual system, not a first-viewport
+composition to clone. Never attach a corpus image, composite, prior
+continuation, or predecessor. If a particular app-state edit must preserve the
+winner's exact structure, put only those edits in a separate
+`preserve-structure` batch rather than changing the continuation default.
+
+Submit the winner's base LayerDoc conversion in detached mode, then immediately
+run one foreground `12ui image generate-batch` for all continuations so image
+generation overlaps the base conversion. Inspect every result before accepting
+it. Convert accepted continuation images concurrently with distinct stable
+idempotency keys; never retry or replace an ambiguous generation.
+
+For ordered viewports of one continuous page, use the conversion package API
+to preserve page order. Integrate independent web routes, app states, or mobile
+screens as separate surfaces. Record the run in `<run-dir>/continuations.json`
+using [the continuation contract](references/continuation-contract.md).
+
 If conversion is interrupted, resume its ID or repeat the exact create request
 with the same idempotency key; do not convert another candidate as a shortcut.
 
-### 4. Integrate and verify
+### 5. Integrate and verify
 
 Inspect generated files before merging the smallest coherent set into the
 project. Preserve routing, components, tokens, accessibility, dependencies,
 and unrelated changes. Add the exact copy, interactions, responsive behavior,
-later sections, and routes intentionally omitted from the image prompt while
-extending the winning visual system.
+later sections, and routes intentionally omitted from the first-viewport prompt
+while extending the visual system from the winner and accepted continuations.
 
 Run focused checks, launch the real interface, exercise interactions, and
 compare it with the winner at the source viewport plus representative narrower

package/skills/design/references/continuation-contract.md

@@ -0,0 +1,60 @@
+# Continuation evidence contract
+
+Write `continuations.json` when the selected first viewport does not cover the
+complete interface. The winner remains the sole reference for every generation.
+
+```json
+{
+  "version": 1,
+  "createdAt": "<ISO-8601>",
+  "selectionPath": "<absolute selection.json path>",
+  "winner": {
+    "id": "A",
+    "path": "<absolute winner PNG path>",
+    "sha256": "<winner sha256>"
+  },
+  "baseConversion": {
+    "idempotencyKey": "<stable key>",
+    "conversionId": "<base LayerDoc conversion id>",
+    "resultEvidencePath": "<absolute result evidence path>"
+  },
+  "generation": {
+    "referenceMode": "inspiration",
+    "manifestPath": "<absolute batch manifest path>",
+    "manifestSha256": "<sha256>",
+    "batchAttemptPath": "<absolute batch attempt path>"
+  },
+  "continuations": [
+    {
+      "id": "viewport-2",
+      "kind": "<continuous-page|web-route|app-state|mobile-screen>",
+      "order": 2,
+      "prompt": "<semantic content, actions, state, and route purpose only>",
+      "promptSha256": "<sha256>",
+      "referencePath": "<same winner path>",
+      "referenceSha256": "<same winner sha256>",
+      "outputPath": "<absolute generated PNG path>",
+      "outputSha256": "<sha256>",
+      "attemptEvidencePath": "<absolute attempt path>",
+      "accepted": true,
+      "rejectionReason": null,
+      "conversionId": "<accepted image conversion id or null>",
+      "conversionEvidencePath": "<absolute evidence path or null>"
+    }
+  ],
+  "integration": {
+    "mode": "<ordered-package|independent-surfaces>",
+    "packageEvidencePath": "<absolute package evidence path or null>"
+  }
+}
+```
+
+Include 2-16 continuation entries. Every entry must repeat the winner path and
+hash; never substitute a corpus image, composite, prior continuation, or
+predecessor. The default continuation batch uses `inspiration`, because the
+winner supplies a visual system rather than a first-viewport composition to
+clone. If an intentional app-state edit must preserve exact structure, record
+it in a separate `preserve-structure` batch. Preserve rejected generations
+with a visible reason and null conversion fields. For `ordered-package`,
+record the package evidence and keep continuous-page order exact. Never store
+credentials or invent IDs or hashes.

package/skills/design/references/selection-contract.md

@@ -5,10 +5,27 @@ prompt text so a resumed run cannot silently select different evidence.
 
 ```json
 {
-  "version": 3,
+  "version": 5,
   "createdAt": "<ISO-8601>",
   "requestSummary": "<concise implementation contract>",
   "viewportMode": "<first-viewport|primary-state|single-screen|complete-simple-surface>",
+  "designMode": "<new-interface|exploratory-redesign|structure-preserving-reskin>",
+  "redesignSource": {
+    "originalPath": "<absolute source path, or null when absent>",
+    "originalSha256": "<source sha256, or null when absent>",
+    "preparedPath": "<absolute crop or original path, or null when absent>",
+    "preparedSha256": "<prepared sha256, or null when absent>",
+    "preparation": "<none|first-viewport-crop>"
+  },
+  "contract": {
+    "preserve": ["<specific constraint>"],
+    "change": ["<specific intended change>"]
+  },
+  "referencePolicy": {
+    "retrieval": "<text-only|text-and-redesign-source>",
+    "generation": "<one-corpus-image-per-candidate|redesign-source-only>",
+    "imagesPerGeneration": 1
+  },
   "corpus": {
     "query": "<exact query>",
     "idempotencyKey": "<manifest value>",
@@ -28,6 +45,7 @@ prompt text so a resumed run cannot silently select different evidence.
     ]
   },
   "generation": {
+    "referenceMode": "<inspiration|preserve-structure>",
     "manifestPath": "<absolute generation manifest path>",
     "manifestSha256": "<sha256>",
     "batchAttemptPath": "<absolute batch attempt path>"
@@ -39,9 +57,11 @@ prompt text so a resumed run cannot silently select different evidence.
       "sha256": "<sha256>",
       "prompt": "<exact prompt>",
       "promptSha256": "<sha256>",
-      "referenceId": "<id-1>",
-      "referencePath": "<absolute path>",
-      "referenceSha256": "<sha256>",
+      "directionReferenceId": "<paired corpus id-1>",
+      "direction": "<short visibly grounded text direction>",
+      "generationReferencePath": "<paired corpus path or redesign-source path>",
+      "generationReferenceSha256": "<sha256>",
+      "referenceMode": "<inspiration|preserve-structure>",
       "provider": "<codex|openai>",
       "idempotencyKey": "<stable key>",
       "providerIdempotencyEnforced": false,
@@ -60,3 +80,13 @@ from the batch and candidate attempt files. Never store credentials or invent
 IDs, metrics, or provider guarantees. The winner has no rejection reasons;
 every other candidate has at least one specific visible reason. Set
 `providerIdempotencyEnforced` only to the recorded CLI value.
+
+For `new-interface`, use null redesign-source paths/hashes, `text-only` retrieval, and one
+paired corpus image per generation. For `exploratory-redesign`, record the
+original and prepared source for retrieval but still use one paired corpus
+image per generation. For `structure-preserving-reskin`, use the prepared
+redesign source as the sole generation
+image for all four candidates; each paired corpus image is represented only by
+its short textual `direction`. Never attach the redesign source and a corpus
+image to the same generation. Use `inspiration` reference mode for the first two
+cases and `preserve-structure` for the last.