replace-all-mustaches 0.0.1

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jjkubik
+
+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/README.md

@@ -0,0 +1,2 @@
+# replace-all-mustaches
+Replace all mustache templates in a string, including recursive mustache values

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "replace-all-mustaches",
+  "version": "0.0.1",
+  "description": "Replace all mustache templates in a string, including recursive mustache values",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "devDependencies": {
+    "@types/mustache": "^4.2.6",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "mustache": "^4.2.0"
+  },
+  "allowScripts": {
+    "esbuild@0.27.7": true,
+    "fsevents@2.3.3": true
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./nodes/helperFunctions"
+export * from "./nodes/renderUntilStable"
+export * from "./nodes/Variable"
+export * from "./nodes/VariableView"

package/src/nodes/Variable.ts

@@ -0,0 +1,14 @@
+export type MustacheValue = string|string[]|Function;
+
+/**
+ * A key-value pair for a variable name and its value.
+ */
+export class Variable{
+    key:string;
+    value:MustacheValue;
+
+    constructor(key:string,value:MustacheValue){
+        this.key = key;
+        this.value = value;
+    }
+};

package/src/nodes/VariableView.ts

@@ -0,0 +1,50 @@
+import { Variable, type MustacheValue } from "./Variable"
+import { hasDuplicates } from "./helperFunctions"
+
+/**
+ * A generic class to create a view (the context for a Mustache.render() call). This class's _collection property holds all the names in any subsequently created variable registry via the allKeys getter.
+ * @todo Prevent duplicates
+ */
+export class VariableView {
+    private static _collection:VariableView[] = [];
+
+    static get all(): Record<string, MustacheValue> {
+        return Object.fromEntries(
+            VariableView._collection.flatMap(view => Object.entries(view))
+        );
+    };
+    static get allNames(){
+        return VariableView._collection.map(variable=>Object.keys(variable)).flat();
+    };    
+
+    [key: string]: MustacheValue;  // [key:string] gives permission for arbitrary string keys
+
+    constructor(...variableValuePairs:Variable[]){
+        variableValuePairs.forEach(pair=>{
+            this[pair.key] = pair.value;
+
+            if (VariableView.allNames.includes(pair.key)){
+                console.warn(`Master variable list already contains the variable ${pair.key} being added by ${this.constructor.name}.`);
+
+                console.trace();
+            }
+        });
+
+        VariableView._collection.push(this);
+
+        if (hasDuplicates(variableValuePairs.map(pair=>pair.key))){
+            console.warn(`Duplicated values in ${this.constructor.name}. (And yes, I should and will add where those occur.)`)
+        };
+    };
+
+    add(...variableValuePair:Variable[]){
+        variableValuePair.forEach(pair=>{
+            // It would be a good idea to include a check for duplicate keys
+            this[pair.key] = pair.value
+        })
+    };
+    
+    replace(variableKey:string,value:string|Function){
+        this[variableKey] = value;
+    };
+};

package/src/nodes/helperFunctions.ts

@@ -0,0 +1,12 @@
+/**
+ * Confirm whether there are valid mustache tags remaining in the template string.
+ * @param template
+ * @returns 
+ */
+export function hasMustacheTags(template: string): boolean {
+  return template.includes("{{") || template.includes("}}");
+};
+
+export function hasDuplicates(arr:any[]){
+    return new Set(arr).size !== arr.length;
+};

package/src/nodes/renderUntilStable.ts

@@ -0,0 +1,44 @@
+import Mustache from "mustache";
+import { VariableView } from "./VariableView";
+import { hasMustacheTags } from "./helperFunctions";
+
+type RenderLoopOptions = {
+  maxPasses?: number;
+  detectCycles?: boolean;
+};
+
+export function renderUntilStable(
+    template: string,
+    view: VariableView,
+    { maxPasses = 20, detectCycles = true }: RenderLoopOptions = {},
+    ): string {
+        let current = template;
+        const seen = new Set<string>();
+
+        let pass = 0
+        for (pass; pass < maxPasses; pass += 1) {
+            if (hasMustacheTags(current)){
+                if (detectCycles) {
+                    if (seen.has(current)) {
+                        throw new Error(`Render cycle detected at pass ${pass}: "${current}"`);
+                    };
+
+                    seen.add(current);
+                };
+
+                const next = Mustache.render(current, VariableView.all);
+
+                if (next === current) {
+                    return next; // no more substitutions happened
+                };
+
+                current = next;
+            } else {
+                console.log("passes:",pass)
+                return current;
+            }
+        };
+
+        console.log("passes:",pass)
+        return current;
+};

package/tsconfig.json

@@ -0,0 +1,46 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    // "rootDir": "./src",
+    // "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "es2022",
+    "target": "es2022",
+    "types": [],
+    // For nodejs:
+    // "lib": ["esnext"],
+    // "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+  },
+  "include": ["src"],
+  "exclude": ["node_modules"]
+}

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+ 
+export default defineConfig({
+    format: ['cjs', 'esm'],
+    entry: ['./src/index.ts'],
+    dts: true,
+    shims: true,
+    skipNodeModulesBundle: true,
+    clean: true,
+});