emoji-space-shim 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Uladzimir Kasacheuski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/contract/sdk/shimConsoleLog.d.ts

@@ -0,0 +1,10 @@
+import type { TerminalChoice } from '../../domain.objects/TerminalChoice';
+/**
+ * .what = apply the console.log shim for emoji space adjustment
+ * .why = enables automatic emoji space fix across different terminals
+ */
+export declare const shimConsoleLog: (input?: {
+    terminal?: TerminalChoice;
+}) => {
+    restore: () => void;
+};

package/dist/contract/sdk/shimConsoleLog.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shimConsoleLog = void 0;
+const detectTerminalChoice_1 = require("../../domain.operations/detectTerminalChoice");
+const transformConsoleArgs_1 = require("../../domain.operations/transformConsoleArgs");
+/**
+ * .what = apply the console.log shim for emoji space adjustment
+ * .why = enables automatic emoji space fix across different terminals
+ */
+const shimConsoleLog = (input) => {
+    // detect or use provided terminal
+    const terminal = input?.terminal ?? (0, detectTerminalChoice_1.detectTerminalChoice)();
+    // store original console.log
+    const originalLog = console.log;
+    // replace console.log with transform wrapper
+    console.log = (...args) => {
+        const transformed = (0, transformConsoleArgs_1.transformConsoleArgs)({ args, terminal });
+        originalLog.apply(console, transformed);
+    };
+    // return restore function
+    return {
+        restore: () => {
+            console.log = originalLog;
+        },
+    };
+};
+exports.shimConsoleLog = shimConsoleLog;
+//# sourceMappingURL=shimConsoleLog.js.map

package/dist/contract/sdk/shimConsoleLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shimConsoleLog.js","sourceRoot":"","sources":["../../../src/contract/sdk/shimConsoleLog.ts"],"names":[],"mappings":";;;AACA,sFAAmF;AACnF,sFAAmF;AAEnF;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,KAE9B,EAA2B,EAAE;IAC5B,kCAAkC;IAClC,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,IAAI,IAAA,2CAAoB,GAAE,CAAC;IAE3D,6BAA6B;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAEhC,6CAA6C;IAC7C,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;QACnC,MAAM,WAAW,GAAG,IAAA,2CAAoB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7D,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,0BAA0B;IAC1B,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,OAAO,CAAC,GAAG,GAAG,WAAW,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AArBW,QAAA,cAAc,kBAqBzB"}

package/dist/contract/sdk/withEmojiSpaceShim.d.ts

@@ -0,0 +1,7 @@
+/**
+ * .what = wrapper that applies emoji space shim for duration of logic execution
+ * .why = abstracts shim lifecycle; guarantees restore via finally block
+ */
+export declare const withEmojiSpaceShim: <T>(input: {
+    logic: () => Promise<T>;
+}) => Promise<T>;

package/dist/contract/sdk/withEmojiSpaceShim.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withEmojiSpaceShim = void 0;
+const shimConsoleLog_1 = require("./shimConsoleLog");
+/**
+ * .what = wrapper that applies emoji space shim for duration of logic execution
+ * .why = abstracts shim lifecycle; guarantees restore via finally block
+ */
+const withEmojiSpaceShim = async (input) => {
+    // apply the shim before logic executes
+    const shim = (0, shimConsoleLog_1.shimConsoleLog)();
+    try {
+        // execute the wrapped logic
+        return await input.logic();
+    }
+    finally {
+        // restore original console.log (runs on normal exit, error exit, or signal)
+        shim.restore();
+    }
+};
+exports.withEmojiSpaceShim = withEmojiSpaceShim;
+//# sourceMappingURL=withEmojiSpaceShim.js.map

package/dist/contract/sdk/withEmojiSpaceShim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withEmojiSpaceShim.js","sourceRoot":"","sources":["../../../src/contract/sdk/withEmojiSpaceShim.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAElD;;;GAGG;AACI,MAAM,kBAAkB,GAAG,KAAK,EAAK,KAE3C,EAAc,EAAE;IACf,uCAAuC;IACvC,MAAM,IAAI,GAAG,IAAA,+BAAc,GAAE,CAAC;IAE9B,IAAI,CAAC;QACH,4BAA4B;QAC5B,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,4EAA4E;QAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;AACH,CAAC,CAAC;AAbW,QAAA,kBAAkB,sBAa7B"}

package/dist/domain.objects/EmojiSpaceRegistry.d.ts

@@ -0,0 +1,6 @@
+import type { TerminalChoice } from './TerminalChoice';
+/**
+ * .what = dictionary of emoji space consumption per terminal
+ * .why = terminals disagree on emoji width; this maps emoji → terminal → consumed spaces
+ */
+export declare const EMOJI_SPACE_REGISTRY: Record<string, Partial<Record<TerminalChoice, number>>>;

package/dist/domain.objects/EmojiSpaceRegistry.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMOJI_SPACE_REGISTRY = void 0;
+/**
+ * .what = dictionary of emoji space consumption per terminal
+ * .why = terminals disagree on emoji width; this maps emoji → terminal → consumed spaces
+ */
+exports.EMOJI_SPACE_REGISTRY = {
+    // emojis that consume 1 extra space in vscode only
+    '🦫': { vscode: 1, default: 0 },
+    '🪨': { vscode: 1, default: 0 },
+    // emojis that consume 1 extra space in both vscode and standard terminals
+    '🌩️': { vscode: 1, default: 1 },
+    '⛈️': { vscode: 1, default: 1 },
+};
+//# sourceMappingURL=EmojiSpaceRegistry.js.map

package/dist/domain.objects/EmojiSpaceRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmojiSpaceRegistry.js","sourceRoot":"","sources":["../../src/domain.objects/EmojiSpaceRegistry.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACU,QAAA,oBAAoB,GAG7B;IACF,mDAAmD;IACnD,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;IAC/B,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;IAE/B,0EAA0E;IAC1E,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;IAChC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;CAChC,CAAC"}

package/dist/domain.objects/TerminalChoice.d.ts

@@ -0,0 +1,5 @@
+/**
+ * .what = terminal type enum for space adjustment rules
+ * .why = different terminals render emoji widths differently
+ */
+export type TerminalChoice = 'vscode' | 'xterm' | 'gnome' | 'default';

package/dist/domain.objects/TerminalChoice.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TerminalChoice.js.map

package/dist/domain.objects/TerminalChoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalChoice.js","sourceRoot":"","sources":["../../src/domain.objects/TerminalChoice.ts"],"names":[],"mappings":""}

package/dist/domain.operations/computeSpaceAdjustment.d.ts

@@ -0,0 +1,11 @@
+import { EMOJI_SPACE_REGISTRY } from '../domain.objects/EmojiSpaceRegistry';
+import type { TerminalChoice } from '../domain.objects/TerminalChoice';
+/**
+ * .what = compute how many spaces to add after an emoji for correct render
+ * .why = different terminals consume different space widths for emojis
+ */
+export declare const computeSpaceAdjustment: (input: {
+    emoji: string;
+    terminal: TerminalChoice;
+    registry?: typeof EMOJI_SPACE_REGISTRY;
+}) => number;

package/dist/domain.operations/computeSpaceAdjustment.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeSpaceAdjustment = void 0;
+const EmojiSpaceRegistry_1 = require("../domain.objects/EmojiSpaceRegistry");
+/**
+ * .what = compute how many spaces to add after an emoji for correct render
+ * .why = different terminals consume different space widths for emojis
+ */
+const computeSpaceAdjustment = (input) => {
+    const rules = input.registry ?? EmojiSpaceRegistry_1.EMOJI_SPACE_REGISTRY;
+    // lookup terminal-specific rule, fallback to default, fallback to 0
+    return (rules[input.emoji]?.[input.terminal] ?? rules[input.emoji]?.default ?? 0);
+};
+exports.computeSpaceAdjustment = computeSpaceAdjustment;
+//# sourceMappingURL=computeSpaceAdjustment.js.map

package/dist/domain.operations/computeSpaceAdjustment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeSpaceAdjustment.js","sourceRoot":"","sources":["../../src/domain.operations/computeSpaceAdjustment.ts"],"names":[],"mappings":";;;AAAA,+EAA8E;AAG9E;;;GAGG;AACI,MAAM,sBAAsB,GAAG,CAAC,KAItC,EAAU,EAAE;IACX,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,IAAI,yCAAoB,CAAC;IAErD,oEAAoE;IACpE,OAAO,CACL,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,IAAI,CAAC,CACzE,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,sBAAsB,0BAWjC"}

package/dist/domain.operations/detectTerminalChoice.d.ts

@@ -0,0 +1,6 @@
+import type { TerminalChoice } from '../domain.objects/TerminalChoice';
+/**
+ * .what = detect the current terminal type from environment
+ * .why = enables auto-detection for space adjustment rules
+ */
+export declare const detectTerminalChoice: () => TerminalChoice;

package/dist/domain.operations/detectTerminalChoice.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTerminalChoice = void 0;
+/**
+ * .what = detect the current terminal type from environment
+ * .why = enables auto-detection for space adjustment rules
+ */
+const detectTerminalChoice = () => {
+    // check TERM_PROGRAM first (most specific)
+    if (process.env.TERM_PROGRAM === 'vscode')
+        return 'vscode';
+    if (process.env.TERM_PROGRAM === 'gnome-terminal')
+        return 'gnome';
+    // check TERM for xterm variants
+    if (process.env.TERM?.includes('xterm'))
+        return 'xterm';
+    // fallback to default
+    return 'default';
+};
+exports.detectTerminalChoice = detectTerminalChoice;
+//# sourceMappingURL=detectTerminalChoice.js.map

package/dist/domain.operations/detectTerminalChoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectTerminalChoice.js","sourceRoot":"","sources":["../../src/domain.operations/detectTerminalChoice.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACI,MAAM,oBAAoB,GAAG,GAAmB,EAAE;IACvD,2CAA2C;IAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,gBAAgB;QAAE,OAAO,OAAO,CAAC;IAElE,gCAAgC;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAExD,sBAAsB;IACtB,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAVW,QAAA,oBAAoB,wBAU/B"}

package/dist/domain.operations/transformConsoleArgs.d.ts

@@ -0,0 +1,9 @@
+import type { TerminalChoice } from '../domain.objects/TerminalChoice';
+/**
+ * .what = transform console.log arguments for emoji space adjustment
+ * .why = handles mixed argument types (strings, objects, etc)
+ */
+export declare const transformConsoleArgs: (input: {
+    args: unknown[];
+    terminal: TerminalChoice;
+}) => unknown[];

package/dist/domain.operations/transformConsoleArgs.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformConsoleArgs = void 0;
+const transformMessageForTerminal_1 = require("./transformMessageForTerminal");
+/**
+ * .what = transform console.log arguments for emoji space adjustment
+ * .why = handles mixed argument types (strings, objects, etc)
+ */
+const transformConsoleArgs = (input) => {
+    return input.args.map((arg) => {
+        // only transform string arguments
+        if (typeof arg === 'string') {
+            return (0, transformMessageForTerminal_1.transformMessageForTerminal)({
+                message: arg,
+                terminal: input.terminal,
+            });
+        }
+        // pass through non-strings unchanged
+        return arg;
+    });
+};
+exports.transformConsoleArgs = transformConsoleArgs;
+//# sourceMappingURL=transformConsoleArgs.js.map

package/dist/domain.operations/transformConsoleArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformConsoleArgs.js","sourceRoot":"","sources":["../../src/domain.operations/transformConsoleArgs.ts"],"names":[],"mappings":";;;AAEA,+EAA4E;AAE5E;;;GAGG;AACI,MAAM,oBAAoB,GAAG,CAAC,KAGpC,EAAa,EAAE;IACd,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5B,kCAAkC;QAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAA,yDAA2B,EAAC;gBACjC,OAAO,EAAE,GAAG;gBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;QACL,CAAC;QAED,qCAAqC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAhBW,QAAA,oBAAoB,wBAgB/B"}

package/dist/domain.operations/transformMessageForTerminal.d.ts

@@ -0,0 +1,11 @@
+import { EMOJI_SPACE_REGISTRY } from '../domain.objects/EmojiSpaceRegistry';
+import type { TerminalChoice } from '../domain.objects/TerminalChoice';
+/**
+ * .what = transform a message by add spaces after registered emojis
+ * .why = adjusts emoji space consumption for correct terminal render
+ */
+export declare const transformMessageForTerminal: (input: {
+    message: string;
+    terminal: TerminalChoice;
+    registry?: typeof EMOJI_SPACE_REGISTRY;
+}) => string;

package/dist/domain.operations/transformMessageForTerminal.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformMessageForTerminal = void 0;
+const EmojiSpaceRegistry_1 = require("../domain.objects/EmojiSpaceRegistry");
+const computeSpaceAdjustment_1 = require("./computeSpaceAdjustment");
+/**
+ * .what = transform a message by add spaces after registered emojis
+ * .why = adjusts emoji space consumption for correct terminal render
+ */
+const transformMessageForTerminal = (input) => {
+    const registry = input.registry ?? EmojiSpaceRegistry_1.EMOJI_SPACE_REGISTRY;
+    let result = input.message;
+    // iterate through registered emojis and add spaces where needed
+    for (const emoji of Object.keys(registry)) {
+        const adjustment = (0, computeSpaceAdjustment_1.computeSpaceAdjustment)({
+            emoji,
+            terminal: input.terminal,
+            registry,
+        });
+        // skip if no adjustment needed
+        if (adjustment === 0)
+            continue;
+        // insert spaces after each occurrence of the emoji
+        const spaces = ' '.repeat(adjustment);
+        result = result.split(emoji).join(emoji + spaces);
+    }
+    return result;
+};
+exports.transformMessageForTerminal = transformMessageForTerminal;
+//# sourceMappingURL=transformMessageForTerminal.js.map

package/dist/domain.operations/transformMessageForTerminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformMessageForTerminal.js","sourceRoot":"","sources":["../../src/domain.operations/transformMessageForTerminal.ts"],"names":[],"mappings":";;;AAAA,+EAA8E;AAG9E,qEAAkE;AAElE;;;GAGG;AACI,MAAM,2BAA2B,GAAG,CAAC,KAI3C,EAAU,EAAE;IACX,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,yCAAoB,CAAC;IACxD,IAAI,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;IAE3B,gEAAgE;IAChE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAA,+CAAsB,EAAC;YACxC,KAAK;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ;SACT,CAAC,CAAC;QAEH,+BAA+B;QAC/B,IAAI,UAAU,KAAK,CAAC;YAAE,SAAS;QAE/B,mDAAmD;QACnD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAzBW,QAAA,2BAA2B,+BAyBtC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * emoji-space-shim
+ *
+ * shim console.log to fix emoji space render issues across terminals.
+ */
+export { shimConsoleLog } from './contract/sdk/shimConsoleLog';
+export { withEmojiSpaceShim } from './contract/sdk/withEmojiSpaceShim';
+export { EMOJI_SPACE_REGISTRY } from './domain.objects/EmojiSpaceRegistry';
+export type { TerminalChoice } from './domain.objects/TerminalChoice';
+export { computeSpaceAdjustment } from './domain.operations/computeSpaceAdjustment';
+export { detectTerminalChoice } from './domain.operations/detectTerminalChoice';
+export { transformMessageForTerminal } from './domain.operations/transformMessageForTerminal';

package/dist/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * emoji-space-shim
+ *
+ * shim console.log to fix emoji space render issues across terminals.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformMessageForTerminal = exports.detectTerminalChoice = exports.computeSpaceAdjustment = exports.EMOJI_SPACE_REGISTRY = exports.withEmojiSpaceShim = exports.shimConsoleLog = void 0;
+// main shim
+var shimConsoleLog_1 = require("./contract/sdk/shimConsoleLog");
+Object.defineProperty(exports, "shimConsoleLog", { enumerable: true, get: function () { return shimConsoleLog_1.shimConsoleLog; } });
+var withEmojiSpaceShim_1 = require("./contract/sdk/withEmojiSpaceShim");
+Object.defineProperty(exports, "withEmojiSpaceShim", { enumerable: true, get: function () { return withEmojiSpaceShim_1.withEmojiSpaceShim; } });
+// registry (for extension by consumers)
+var EmojiSpaceRegistry_1 = require("./domain.objects/EmojiSpaceRegistry");
+Object.defineProperty(exports, "EMOJI_SPACE_REGISTRY", { enumerable: true, get: function () { return EmojiSpaceRegistry_1.EMOJI_SPACE_REGISTRY; } });
+var computeSpaceAdjustment_1 = require("./domain.operations/computeSpaceAdjustment");
+Object.defineProperty(exports, "computeSpaceAdjustment", { enumerable: true, get: function () { return computeSpaceAdjustment_1.computeSpaceAdjustment; } });
+// operations (for advanced use cases)
+var detectTerminalChoice_1 = require("./domain.operations/detectTerminalChoice");
+Object.defineProperty(exports, "detectTerminalChoice", { enumerable: true, get: function () { return detectTerminalChoice_1.detectTerminalChoice; } });
+var transformMessageForTerminal_1 = require("./domain.operations/transformMessageForTerminal");
+Object.defineProperty(exports, "transformMessageForTerminal", { enumerable: true, get: function () { return transformMessageForTerminal_1.transformMessageForTerminal; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,YAAY;AACZ,gEAA+D;AAAtD,gHAAA,cAAc,OAAA;AACvB,wEAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAC3B,wCAAwC;AACxC,0EAA2E;AAAlE,0HAAA,oBAAoB,OAAA;AAG7B,qFAAoF;AAA3E,gIAAA,sBAAsB,OAAA;AAC/B,sCAAsC;AACtC,iFAAgF;AAAvE,4HAAA,oBAAoB,OAAA;AAC7B,+FAA8F;AAArF,0IAAA,2BAA2B,OAAA"}

package/license.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 ehmpathy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "emoji-space-shim",
+  "author": "ehmpathy",
+  "description": "shim console.log to fix emoji space render issues across terminals",
+  "version": "0.0.0",
+  "repository": "ehmpathy/emoji-space-shim",
+  "homepage": "https://github.com/ehmpathy/emoji-space-shim",
+  "keywords": [
+    "emoji",
+    "terminal",
+    "console",
+    "shim",
+    "vscode",
+    "xterm",
+    "unicode",
+    "character-width"
+  ],
+  "bugs": "https://github.com/ehmpathy/emoji-space-shim/issues",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=8.0.0"
+  },
+  "files": [
+    "/dist"
+  ],
+  "dependencies": {
+    "as-procedure": "1.1.11",
+    "domain-objects": "0.31.9",
+    "find-up": "5.0.0",
+    "hash-fns": "1.1.0",
+    "helpful-errors": "1.5.3",
+    "iso-time": "1.10.1",
+    "rhachet-artifact": "1.0.3",
+    "serde-fns": "1.3.0",
+    "type-fns": "1.21.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.8",
+    "@commitlint/cli": "19.5.0",
+    "@commitlint/config-conventional": "19.5.0",
+    "@swc/core": "1.15.3",
+    "@swc/jest": "0.2.39",
+    "@tsconfig/node20": "20.1.5",
+    "@tsconfig/strictest": "2.0.5",
+    "@types/jest": "30.0.0",
+    "@types/node": "22.15.21",
+    "cz-conventional-changelog": "3.3.0",
+    "declapract": "0.13.14",
+    "declapract-typescript-ehmpathy": "0.47.16",
+    "declastruct": "1.7.3",
+    "declastruct-github": "1.3.0",
+    "depcheck": "1.4.3",
+    "esbuild-register": "3.6.0",
+    "husky": "8.0.3",
+    "jest": "30.2.0",
+    "rhachet": "1.21.3",
+    "rhachet-roles-bhrain": "0.5.9",
+    "rhachet-roles-bhuild": "0.6.3",
+    "rhachet-roles-ehmpathy": "1.17.15",
+    "test-fns": "1.5.0",
+    "tsc-alias": "1.8.10",
+    "tsx": "4.20.6",
+    "typescript": "5.4.5",
+    "yalc": "1.0.0-pre.53"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "scripts": {
+    "build:ts": "tsc -p ./tsconfig.build.json",
+    "commit:with-cli": "npx cz",
+    "fix:format:biome": "biome check --write",
+    "fix:format": "npm run fix:format:biome",
+    "fix:lint": "biome check --write",
+    "fix": "npm run fix:format && npm run fix:lint",
+    "build:clean:bun": "rm -f ./bin/*.bc",
+    "build:clean:tsc": "(chmod -R u+w dist 2>/dev/null || true) && rm -rf dist/",
+    "build:clean": "npm run build:clean:tsc && npm run build:clean:bun",
+    "build:compile:tsc": "tsc -p ./tsconfig.build.json && tsc-alias -p ./tsconfig.build.json",
+    "build:compile": "npm run build:compile:tsc && npm run build:compile:bun --if-present",
+    "build": "npm run build:clean && npm run build:compile && npm run build:complete --if-present",
+    "test:commits": "LAST_TAG=$(git describe --tags --abbrev=0 @^ 2> /dev/null || git rev-list --max-parents=0 HEAD) && npx commitlint --from $LAST_TAG --to HEAD --verbose",
+    "test:types": "tsc -p ./tsconfig.json --noEmit",
+    "test:format:biome": "biome format",
+    "test:format": "npm run test:format:biome",
+    "test:lint:deps": "npx depcheck -c ./.depcheckrc.yml",
+    "test:lint:biome": "biome check --diagnostic-level=error",
+    "test:lint:biome:all": "biome check",
+    "test:lint": "npm run test:lint:biome && npm run test:lint:deps",
+    "test:unit": "jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test:integration": "jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test:acceptance:locally": "npm run build && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test": "npm run test:commits && npm run test:types && npm run test:format && npm run test:lint && npm run test:unit && npm run test:integration && npm run test:acceptance:locally",
+    "test:acceptance": "npm run build && jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "prepush": "npm run test && npm run build",
+    "prepublish": "npm run build",
+    "preversion": "npm run prepush",
+    "postversion": "git push origin HEAD --tags --no-verify",
+    "prepare:husky": "husky install && chmod ug+x .husky/*",
+    "prepare:rhachet": "rhachet init --mode upsert && rhachet roles link --repo ehmpathy --role mechanic && rhachet roles link --repo bhuild --role behaver && rhachet roles link --repo bhrain --role reviewer && rhachet roles init --role mechanic && rhachet roles init --role behaver"
+  }
+}

package/readme.md

@@ -0,0 +1,110 @@
+# emoji-space-shim
+
+shim console.log to fix emoji space render issues across terminals.
+
+## problem
+
+some emojis render incorrectly across different terminals due to character width inconsistencies. for example, the beaver emoji (`🦫`) may appear to "eat" the space after it in VS Code's terminal, while it renders correctly in other terminals.
+
+## solution
+
+this package provides a shim that automatically adjusts space after emojis based on the detected terminal. this ensures consistent visual output.
+
+## install
+
+```sh
+npm install emoji-space-shim
+```
+
+## usage
+
+### basic usage
+
+```ts
+import { shimConsoleLog } from 'emoji-space-shim';
+
+// apply the shim (auto-detects terminal)
+const shim = shimConsoleLog();
+
+// console.log now adjusts emoji space automatically
+console.log('🦫 hello world');
+
+// restore original behavior when done
+shim.restore();
+```
+
+### explicit terminal
+
+```ts
+import { shimConsoleLog } from 'emoji-space-shim';
+
+// specify terminal explicitly
+const shim = shimConsoleLog({ terminal: 'vscode' });
+
+console.log('🦫 hello world'); // outputs: "🦫  hello world" (extra space added)
+```
+
+### scoped usage with automatic cleanup
+
+```ts
+import { withEmojiSpaceShim } from 'emoji-space-shim';
+
+// shim is applied for duration of logic, then automatically restored
+const result = await withEmojiSpaceShim({
+  logic: async () => {
+    console.log('🦫 hello world'); // emoji space adjusted
+    return await doWork();
+  },
+});
+
+// console.log is restored to original behavior here
+console.log('normal log'); // no emoji adjustment
+```
+
+this is useful when you want to:
+- ensure the shim is always cleaned up (even if errors occur)
+- scope the shim to a specific block of code
+- avoid manual restore() calls
+
+## terminal support
+
+| terminal | detection                           |
+| -------- | ----------------------------------- |
+| vscode   | `TERM_PROGRAM === 'vscode'`         |
+| xterm    | `TERM.includes('xterm')`            |
+| gnome    | `TERM_PROGRAM === 'gnome-terminal'` |
+| default  | fallback                            |
+
+## extend the registry
+
+you can extend the emoji registry for custom emoji support:
+
+```ts
+import { EMOJI_SPACE_REGISTRY, shimConsoleLog } from 'emoji-space-shim';
+
+// add custom emoji rules
+EMOJI_SPACE_REGISTRY['🎉'] = { vscode: 1, default: 0 };
+
+// now shim will handle this emoji too
+const shim = shimConsoleLog();
+console.log('🎉 celebration');
+```
+
+## exports
+
+| export                        | description                        |
+| ----------------------------- | ---------------------------------- |
+| `shimConsoleLog`              | main shim function                 |
+| `withEmojiSpaceShim`          | scoped wrapper with auto-cleanup   |
+| `TerminalChoice`              | type for terminal variants         |
+| `EMOJI_SPACE_REGISTRY`        | emoji space rules dictionary       |
+| `detectTerminalChoice`        | terminal detection function        |
+| `computeSpaceAdjustment`      | space calculation function         |
+| `transformMessageForTerminal` | message transform function         |
+
+## how it works
+
+1. `detectTerminalChoice()` determines the current terminal from environment variables
+2. `computeSpaceAdjustment()` looks up the required space for each emoji in the registry
+3. `transformMessageForTerminal()` applies the space adjustments to strings
+4. `shimConsoleLog()` wraps `console.log` to automatically transform all string arguments