@usefragment/core 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Julien Bernard
+
+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,54 @@
+# @usefragment/core
+
+Le **contrat de types public** de [Fragment](https://github.com/RebornFlamme/Fragment)
+(alias Promethium) — le module hôte `fragment` que les plugins importent.
+
+Package **de types uniquement** : il ne contient aucun JavaScript. À l'exécution,
+l'hôte injecte les vraies valeurs (`fragmentApi`) via son shim `require('fragment')`
+— exactement comme le package `obsidian`. Ton bundler laisse donc `fragment` en
+*external* ; ce package ne sert qu'à ton compilateur pour typer l'import.
+
+## Installation
+
+```bash
+npm install --save-dev @usefragment/core
+```
+
+## Configuration
+
+Ajoute le package à `types` dans ton `tsconfig.json` pour charger les modules
+ambiants (`fragment`, et les alias `promethium` / `obsidian`) :
+
+```jsonc
+{
+  "compilerOptions": {
+    "types": ["@usefragment/core"]
+  }
+}
+```
+
+Et marque `fragment` en external dans ton bundler (esbuild) :
+
+```js
+esbuild.build({ /* … */ external: ['fragment', 'electron', '@codemirror/*'] });
+```
+
+## Utilisation
+
+```ts
+import { Plugin, Notice, type Command } from 'fragment';
+
+export default class MonPlugin extends Plugin {
+  async onload() {
+    this.addCommand({ id: 'hello', name: 'Dire bonjour', callback: () => new Notice('👋') });
+  }
+}
+```
+
+Les auteurs qui écrivent des extensions CodeMirror installent en plus
+`@codemirror/state` (peer dependency optionnelle).
+
+## Versionnage
+
+Publié depuis le monorepo Fragment via [Changesets](https://github.com/changesets/changesets),
+indépendamment des versions du client. Voir le `CHANGELOG.md`.