refactoring and type fixing part 1 of 2

Author: db-developer

.config/esbuild.config.mjs.old

@@ -1,12 +1,30 @@
+import   fs            from "node:fs";
+import   path          from "node:path";
 import   typescript    from "@rollup/plugin-typescript";
 import { nodeResolve } from "@rollup/plugin-node-resolve";
 import   commonjs      from "@rollup/plugin-commonjs";
 import   json          from "@rollup/plugin-json";
 import   strip         from '@rollup/plugin-strip';
 import   terser        from "@rollup/plugin-terser";
+import   replace       from "@rollup/plugin-replace";
+import   manifest      from "../manifest.json" assert { type: "json" };
+
+function readMarkdown(file) {
+  return fs.readFileSync(path.resolve(file), "utf8");
+}
 
 const isProd = ( process.env.BUILD === "production" );
 
+const namePatternDE = readMarkdown( "docs/namepattern.de.md" );
+const namePatternEN = readMarkdown( "docs/namepattern.en.md" );
+const templateDE    = readMarkdown( "docs/template.de.md"    );
+const templateEN    = readMarkdown( "docs/template.en.md"    );
+const typeDE        = readMarkdown( "docs/type.de.md"        );
+const typeEN        = readMarkdown( "docs/type.en.md"        );
+const ribbonsDE     = readMarkdown( "docs/ribbons.de.md"     );
+const ribbonsEN     = readMarkdown( "docs/ribbons.en.md"     );
+const readme        = readMarkdown( "README.md"              );
+
 const banner = 
 `/*
  *  THIS IS A GENERATED/BUNDLED FILE BY ROLLUP
@@ -33,15 +51,36 @@ export default {
     "@codemirror/autocomplete"
   ],
   plugins: [
-    json(),
+    json(), // required to import manifest.json
+    replace({
+      preventAssignment: true,
+      values: {
+        __PLUGIN_FALLBACK_LANGUAGE__:              JSON.stringify("en"),
+        __PLUGIN_NAME__:                           JSON.stringify(manifest.name),
+        __PLUGIN_VERSION__:                        JSON.stringify(manifest.version),
+        __PLUGIN_AUTHOR__:                         JSON.stringify(manifest.author),
+        __PLUGIN_AUTHOR_URL__:                     JSON.stringify(manifest.authorUrl),
+        __PLUGIN_REPOSITORY__:                     JSON.stringify(manifest.repository),
+        __PLUGIN_DESCRIPTION__:                    JSON.stringify(manifest.description),
+        __PLUGIN_README_MD__:                      JSON.stringify(readme),
+        __PLUGIN_SETTINGS_NAMEPATTERN_CTXHLP_DE__: JSON.stringify(namePatternDE),
+        __PLUGIN_SETTINGS_NAMEPATTERN_CTXHLP_EN__: JSON.stringify(namePatternEN),
+        __PLUGIN_SETTINGS_TEMPLATE_CTXHLP_DE__:    JSON.stringify(templateDE),
+        __PLUGIN_SETTINGS_TEMPLATE_CTXHLP_EN__:    JSON.stringify(templateEN),
+        __PLUGIN_SETTINGS_TYPE_CTXHLP_DE__:        JSON.stringify(typeDE),
+        __PLUGIN_SETTINGS_TYPE_CTXHLP_EN__:        JSON.stringify(typeEN),
+        __PLUGIN_SETTINGS_RIBBONS_HELP_DE__:       JSON.stringify(ribbonsDE),
+        __PLUGIN_SETTINGS_RIBBONS_HELP_EN__:       JSON.stringify(ribbonsEN)
+      },
+    }),
     typescript({tsconfig: ".config/tsconfig.build.json" }),
     nodeResolve({browser: true}),
     commonjs(),
     // Strip console and debugger statements first
     isProd && strip({
       include: '**/*.(js|ts)',
       exclude: 'src/lib/main.ts', // console.logging: "Plugin loaded" should be available!
-      functions: ['console.*'],
+      functions: [/*'console.*'*/],
       debugger: true
     }),
     // Remove all remaining comments

.config/rollup.config.mjs

@@ -1,7 +1,8 @@
 {
   "extends": "./tsconfig.json",
   "include": [
-    "../src/lib/**/*.ts"
+    "../src/lib/**/*.ts",
+    "../src/lib/types/rollup-globals.d.ts"
   ],
   "exclude": [
     "../src/test/**"

.config/tsconfig.build.json

@@ -22,6 +22,7 @@
   },
   "include": [
     "../src/lib/**/*.ts",
+    "../src/lib/types/rollup-globals.d.ts",
     "../src/test/**/*.ts",
     "../src/test/00.initial/**/*.ts",
     "../src/test/*.*/**/*.ts"

.config/tsconfig.json

@@ -1,19 +1,36 @@
-import { defineConfig } from "vitest/config";
 import path from "path";
+import { defineConfig } from "vitest/config";
+
+const projectRoot = path.resolve(__dirname, "..");
 
 export default defineConfig({
   test: {
     environment: "jsdom",
     globals: true,
 
     // Projektroot eine Ebene über .config
-    root: path.resolve(__dirname, ".."),
+    root: projectRoot,
+
     sequence: {
       shuffle: false,     // keine Zufallsreihenfolge
       concurrent: false,  // Tests NICHT parallel, sondern nacheinander
     },
-
-    // nur Tests innerhalb von src/test/
-    include: ["src/test/**/*.test.ts"],
+    setupFiles: [ path.resolve(projectRoot, "src/test/__setup__/globals.ts") ],
+    include: ["src/test/**/00.00.sequence.of.test.ts"],
+    coverage: {
+      provider: "istanbul",
+      reporter: ["text", "lcov"],
+      exclude: [
+        "**/test/**",
+        "**/*.test.ts",
+        "**/*.spec.ts"
+      ]
+    }
+  },
+  resolve: {
+    alias: {
+      obsidian:           path.resolve(projectRoot, "src/test/__mocks__/obsidian.ts"),
+      "ts-obsidian-log":  path.resolve(projectRoot, "src/test/__mocks__/ts-obsidian-log.ts")
+    },
   },
 });

.config/tsconfig.json.old

@@ -16,6 +16,25 @@ All notable changes to this project will be documented in this file.
 
 - No fixes yet
 
+## [1.4.0] - 2026-01-18
+
+### Known Issues
+
+- In some cases, the algorithm becomes inconsistent at the beginning
+  of a month when generating calendar-week-dependent patterns.
+
+### Changed
+
+- Moved logging to `ts-obsidian-log`
+- Moved i18n to `ts-obsidian-i18n`
+- Moved settings handling to `ts-obsidian-plugin`
+- Moved tabular settings UI to `ts-obsidian-ui-settings`
+- `execute.default` now consistently uses `async`
+
+### Added
+
+- Added a full test suite for `execute.default`
+
 ## [1.3.0] - 2025-12-23
 
 Reorganized and Refactored

.config/vitest.config.ts

@@ -94,6 +94,15 @@ The structure is an array of `FolderStructure` objects:
 ]
 ```
 
+> **Note on file extensions**
+>
+> File extensions are **not added implicitly**.
+> A file will only have an extension if it is explicitly included in the
+> `namepattern` (for example `{{YYYY}}-{{MM}}-{{DD}}.md`).
+>
+> In the example above, the generated file will be named `YYYY-MM-DD`
+> **without** a `.md` suffix unless the suffix is part of the pattern.
+
 ---
 
 ### Properties
@@ -105,14 +114,27 @@ Must be `"folder"` or `"file"`.
 A string containing characters and patterns.
 Patterns must follow `{{<pattern>}}`, where `<pattern>` is a valid [moment.js format](https://momentjs.com/docs/#/displaying/format/).
 
+File name patterns are resolved verbatim.
+No file extension is added automatically.
+
+If a generated file is expected to be a Markdown note, the `.md` suffix
+must be explicitly included in the `namepattern`
+(e.g. `{{YYYY}}-{{MM}}-{{DD}}.md`).
+
 Do **not** combine patterns inline (e.g., `{{YYYY-MM-DD}}`).
 Use `{{YYYY}}-{{MM}}-{{DD}}` instead.
 
 **`template`** {string} – *optional*
 Path to a markdown file used as a template.
 
 * For `type: "file"`, the generated file’s content will match the template.
-* For `type: "folder"`, a markdown file with the folder name will be created inside the folder, containing the template content.
+* For `type: "folder"`, a folder note is created **only if a `template` is specified**.
+  The folder note will be created inside the folder, containing the template content.
+  In this case, the folder note is always a Markdown file (`.md`).
+
+  The file name is derived directly from the folder name;
+  both the file name and the `.md` suffix are **implicit and not configurable**.  
+
   For best results, install a folder note plugin.
 
 **`description`** {string} – *optional*

CHANGELOG.md

@@ -0,0 +1,38 @@
+## Name Pattern
+
+Das **Name Pattern** legt fest, wie der Name einer Datei oder eines Ordners erzeugt wird.
+Es besteht aus beliebigen Zeichen und **Patterns**, die in **doppelte geschweifte Klammern**
+eingeschlossen werden: `{{<pattern>}}`.
+
+### Wichtig
+
+- Patterns müssen gültige **moment.js**-Format-Tokens sein.
+- **Keine Inline-Kombinationen**:
+  - ❌ Ungültig: `{{YYYY-MM-DD}}`
+  - ✅ Gültig: `{{YYYY}}-{{MM}}-{{DD}}`
+
+### Semantik von Dateinamen und Dateiendungen
+
+- Name Patterns werden **wortgetreu** aufgelöst.
+- Es wird **keine Dateiendung automatisch ergänzt**.
+- Eine Datei erhält **nur dann** eine Dateiendung, wenn diese explizit im
+  Name Pattern angegeben ist (z. B. `{{YYYY}}-{{MM}}-{{DD}}.md`).
+- Ist keine Dateiendung angegeben, wird die Datei **ohne Suffix** erzeugt.
+
+> **Ausnahme: Folder Notes**  
+> Eine Folder Note wird **nur dann erzeugt**, wenn für einen Ordner ein
+> **`template`** angegeben ist.  
+> In diesem Fall ist die Folder Note **immer** eine Markdown-Datei (`.md`).
+> Sowohl der Dateiname als auch die `.md`-Endung sind dabei **implizit festgelegt
+> und nicht konfigurierbar**.
+
+### Beispiele
+
+- `Tägliche Notiz - {{YYYY}}-{{MM}}-{{DD}}`  
+  → Erzeugt täglich eine Datei, z. B. `Tägliche Notiz - 2026-01-15`
+
+- `Tägliche Notiz - {{YYYY}}-{{MM}}-{{DD}}.md`  
+  → Erzeugt täglich eine Markdown-Datei, z. B. `Tägliche Notiz - 2026-01-15.md`
+
+- `Projekt_{{YYYY}}-{{MM}}_Zusammenfassung`  
+  → Erzeugt monatlich eine Datei, z. B. `Projekt_2026-01_Zusammenfassung`

README.md

@@ -0,0 +1,37 @@
+## Name Pattern
+
+The **name pattern** defines how the name of a file or folder is generated.
+It consists of arbitrary characters and **patterns** enclosed in **double curly braces**:
+`{{<pattern>}}`.
+
+### Important
+
+- Patterns must be valid **moment.js** format tokens.
+- **No inline combinations** are allowed:
+  - ❌ Invalid: `{{YYYY-MM-DD}}`
+  - ✅ Valid: `{{YYYY}}-{{MM}}-{{DD}}`
+
+### File name and extension semantics
+
+- Name patterns are resolved **verbatim**.
+- No file extension is added automatically.
+- A generated file will only have an extension if it is explicitly included
+  in the name pattern (for example: `{{YYYY}}-{{MM}}-{{DD}}.md`).
+- If no extension is specified, the resulting file will be created **without**
+  a suffix.
+
+> Folder notes are an exception:
+> A folder note is created **only if a `template` is specified for a folder**.
+> In this case, the folder note is always a Markdown file (`.md`), and both the
+> file name and the `.md` suffix are implicit and not configurable.
+
+### Examples
+
+- `Daily Note - {{YYYY}}-{{MM}}-{{DD}}`  
+  → Generates a file daily, for example: `Daily Note - 2026-01-15`
+
+- `Daily Note - {{YYYY}}-{{MM}}-{{DD}}.md`  
+  → Generates a Markdown file daily, for example: `Daily Note - 2026-01-15.md`
+
+- `Project_{{YYYY}}-{{MM}}_Summary`  
+  → Generates a file updated monthly, for example: `Project_2026-01_Summary`