obsidian-plugin-config 1.0.4 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "obsidian-plugin-config",
-	"version": "1.0.4",
+	"version": "1.0.5",
 	"description": "Système d'injection pour plugins Obsidian autonomes",
 	"type": "module",
 	"main": "src/index.ts",

package/scripts/help.ts

@@ -1,46 +1,162 @@
 #!/usr/bin/env tsx
 
 console.log(`
-Obsidian Plugin Config - Command Reference
+🎯 Obsidian Plugin Config - Guide Complet
 Système d'injection pour plugins Obsidian autonomes
 
-STRATÉGIE NPM GLOBAL:
-  npm install -g obsidian-plugin-config    # Installation globale (une seule fois)
-  obsidian-inject                          # Injection depuis n'importe où
-  obsidian-inject /chemin/vers/plugin      # Injection par chemin
+═══════════════════════════════════════════════════════════════════
 
-INJECTION LOCALE (développement):
-  yarn inject-path <chemin>        Injection par chemin depuis plugin-config
-  yarn inject <chemin>             Alias pour inject-path
+🚀 UTILISATION RAPIDE (NPM Global)
 
-MIGRATION (développement):
-  yarn migrate, m <chemin>         Migration plugin vers architecture centralisée
-  yarn migrate --dry-run           Aperçu des changements sans appliquer
+Installation globale (une seule fois):
+  npm install -g obsidian-plugin-config
+
+Injection dans un plugin:
+  cd mon-plugin && obsidian-inject
+  obsidian-inject ../autre-plugin
+  obsidian-inject "C:\\chemin\\vers\\plugin"
+
+═══════════════════════════════════════════════════════════════════
+
+🔧 DÉVELOPPEMENT LOCAL
+
+Structure recommandée:
+  mes-plugins/
+  ├── obsidian-plugin-config/     # Ce repo
+  ├── mon-plugin-1/
+  ├── mon-plugin-2/
+  └── test-sample-plugin/         # Pour tests
+
+Installation:
+  git clone https://github.com/3C0D/obsidian-plugin-config
+  cd obsidian-plugin-config
+  yarn install
+
+Test injection locale:
+  yarn inject ../mon-plugin --yes
+  yarn inject-prompt "../mon-plugin"
+
+═══════════════════════════════════════════════════════════════════
+
+📦 WORKFLOW COMPLET : Local → NPM Package
+
+ÉTAPE 1 - Développement Local:
+  cd obsidian-plugin-config
+  # Modifier scripts/ selon vos besoins
+  yarn inject ../test-plugin --yes
+
+ÉTAPE 2 - Corrections Obligatoires:
+  # Corriger TOUS les imports dans scripts/
+  # Changer .ts → .js dans les imports
+  # Exemple: "./utils.ts" → "./utils.js"
+
+ÉTAPE 3 - Build NPM:
+  yarn build-npm                  # Corrige automatiquement
+  yarn update-version              # Choisir p/min/maj
+
+ÉTAPE 4 - Test Local Package:
+  npm pack
+  npm install -g ./obsidian-plugin-config-X.X.X.tgz
+  obsidian-inject ../test-plugin  # Tester commande globale
+
+ÉTAPE 5 - Publication NPM:
+  npm login                       # OBLIGATOIRE !
+  npm publish                     # Après connexion réussie
+
+═══════════════════════════════════════════════════════════════════
+
+🔑 CONNEXION NPM - Points Critiques
+
+PRÉREQUIS OBLIGATOIRES:
+  ✅ Compte NPM sur https://www.npmjs.com
+  ✅ Email vérifié
+  ✅ 2FA activé (obligatoire pour publier)
+  ✅ Nom de package disponible
+
+RÉSOLUTION PROBLÈMES:
+  npm logout
+  npm login --registry https://registry.npmjs.org/
+  npm whoami                      # Vérifier connexion
+  npm profile enable-2fa auth-and-writes
+
+CONTOURNEMENTS TESTÉS:
+  ✅ Développement local : Fonctionne sans connexion
+  ✅ Test npm pack : Fonctionne sans connexion
+  ❌ Publication : Connexion NPM OBLIGATOIRE (pas de contournement)
+
+═══════════════════════════════════════════════════════════════════
+
+🔄 WORKFLOW MISE À JOUR
+
+Pour futures modifications:
+  1. cd obsidian-plugin-config
+  2. Modifier scripts/...
+  3. yarn inject ../test-plugin --yes
+  4. Corriger imports (.ts → .js)
+  5. yarn build-npm
+  6. yarn update-version
+  7. npm pack && npm install -g ./package.tgz
+  8. npm publish
+
+═══════════════════════════════════════════════════════════════════
+
+🏗️ ADAPTATION PERSONNALISÉE
+
+Pour créer votre propre version:
+  1. git clone https://github.com/3C0D/obsidian-plugin-config
+  2. Modifier package.json (nom, version, etc.)
+  3. Adapter scripts/ selon vos besoins
+  4. Adapter templates/ (configurations par défaut)
+  5. Tester: yarn inject ../votre-plugin --yes
+  6. Publier votre package: npm publish
+
+═══════════════════════════════════════════════════════════════════
+
+📋 COMMANDES DISPONIBLES
+
+INJECTION:
+  yarn inject <chemin> --yes      # Injection automatique
+  yarn inject-prompt <chemin>     # Injection avec prompts
 
 MAINTENANCE:
-  yarn acp                         Add, commit, and push changes
-  yarn update-version, v           Update version
-  yarn help, h                     Afficher cette aide
+  yarn acp                        # Add, commit, push
+  yarn update-version, v          # Mise à jour version
+  yarn build-npm                  # Build package NPM
+  yarn help, h                    # Cette aide
 
-EXEMPLES D'UTILISATION:
-  # Installation globale (recommandée)
-  npm install -g obsidian-plugin-config
-  cd mon-plugin && obsidian-inject
+═══════════════════════════════════════════════════════════════════
+
+✅ CE QUI EST INJECTÉ
+
+Scripts locaux autonomes:
+  ✅ esbuild.config.ts (build production/dev)
+  ✅ acp.ts (add-commit-push)
+  ✅ update-version.ts (gestion versions)
+  ✅ release.ts (releases GitHub)
+  ✅ help.ts (aide locale)
+  ✅ utils.ts (utilitaires partagés)
+
+Configuration:
+  ✅ package.json (scripts, dépendances, protection yarn)
+  ✅ tsconfig.json (configuration TypeScript optimisée)
+  ✅ Installation automatique dépendances
+
+Résultat:
+  ✅ Plugin 100% AUTONOME
+  ✅ Aucune dépendance externe
+  ✅ Mise à jour via re-injection
+  ✅ Compatible tous plugins Obsidian
 
-  # Développement local
-  yarn inject-path "../mon-plugin"
-  yarn inject "C:\\Users\\dev\\plugins\\mon-plugin"
+═══════════════════════════════════════════════════════════════════
 
-CE QUI EST INJECTÉ:
-  ✅ Scripts locaux (esbuild.config.ts, acp.ts, utils.ts, etc.)
-  ✅ Configuration package.json (scripts, dépendances)
-  ✅ Protection yarn obligatoire
-  ✅ Installation automatique des dépendances
+⚠️  POINTS IMPORTANTS
 
-ARCHITECTURE:
-  - Plugin devient AUTONOME avec scripts locaux
-  - Aucune dépendance externe requise après injection
-  - Mise à jour possible via re-injection
+- Toujours tester localement avant publication NPM
+- Corriger les extensions .ts → .js dans les imports
+- Connexion NPM obligatoire pour publier
+- Sauvegarder vos modifications avant re-injection
+- Utiliser yarn (protection intégrée)
 
 COMPTE NPM: 3c0d (connecté)
+VERSION: 1.0.4
 `);

package/scripts/inject-path.ts

@@ -286,6 +286,9 @@ async function updatePackageJson(targetPath: string): Promise<void> {
     packageJson.engines.npm = "please-use-yarn";
     packageJson.engines.yarn = ">=1.22.0";
 
+    // Ensure ESM module type for modern configuration
+    packageJson.type = "module";
+
     // Write updated package.json
     fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2), 'utf8');
     console.log(`   ✅ Updated package.json (${addedDeps} new, ${updatedDeps} updated dependencies)`);

package/scripts/inject-prompt.ts

@@ -249,6 +249,9 @@ async function updatePackageJson(targetPath: string): Promise<void> {
     packageJson.engines.npm = "please-use-yarn";
     packageJson.engines.yarn = ">=1.22.0";
 
+    // Ensure ESM module type for modern configuration
+    packageJson.type = "module";
+
     // Write updated package.json
     fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2), 'utf8');
     console.log(`   ✅ Updated package.json (${addedDeps} new, ${updatedDeps} updated dependencies)`);

package/versions.json

@@ -3,5 +3,6 @@
 	"1.0.1": "1.8.9",
 	"1.0.2": "1.8.9",
 	"1.0.3": "1.8.9",
-	"1.0.4": "1.8.9"
+	"1.0.4": "1.8.9",
+	"1.0.5": "1.8.9"
 }

package/scripts/open-editor.mjs

@@ -1,18 +0,0 @@
-import { execSync } from 'child_process';
-import { platform } from 'os';
-
-const isWindows = platform() === 'win32';
-
-console.log(`Starting the ${process.env.npm_lifecycle_event} process...\n`);
-console.log('- Dependencies installed');
-
-try {
-    if (isWindows) {
-        execSync("start /B code .", { stdio: "ignore", shell: true });
-    } else {
-        execSync("code .", { stdio: "ignore" });
-    }
-    console.log('- Opened current folder in VSCode');
-} catch (error) {
-    console.warn('Warning: Could not open VSCode');
-}