@universal-pwa/core 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 UniversalPWA
+
+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,151 @@
+# @universal-pwa/core
+
+Moteur de scan, génération et injection pour UniversalPWA.
+
+## Installation
+
+```bash
+npm install @universal-pwa/core
+```
+
+## Utilisation
+
+### Scanner un projet
+
+```typescript
+import { scanProject } from '@universal-pwa/core'
+
+const result = await scanProject({
+  projectPath: './my-project',
+  includeAssets: true,
+  includeArchitecture: true,
+})
+
+console.log(result.framework.framework) // 'react', 'wordpress', etc.
+console.log(result.architecture.architecture) // 'spa', 'ssr', 'static'
+```
+
+### Générer un manifest
+
+```typescript
+import { generateManifest, writeManifest } from '@universal-pwa/core'
+
+const manifest = generateManifest({
+  name: 'My App',
+  shortName: 'MyApp',
+  startUrl: '/',
+  scope: '/',
+  display: 'standalone',
+  themeColor: '#2c3e50',
+  backgroundColor: '#ffffff',
+  icons: [
+    {
+      src: '/icon-192x192.png',
+      sizes: '192x192',
+      type: 'image/png',
+    },
+  ],
+})
+
+writeManifest(manifest, './public')
+```
+
+### Générer des icônes
+
+```typescript
+import { generateIcons } from '@universal-pwa/core'
+
+const result = await generateIcons({
+  sourceImage: './logo.png',
+  outputDir: './public/icons',
+})
+
+console.log(result.icons) // Array of ManifestIcon
+console.log(result.splashScreens) // Array of ManifestSplashScreen
+```
+
+### Générer un service worker
+
+```typescript
+import { generateServiceWorker } from '@universal-pwa/core'
+
+const result = await generateServiceWorker({
+  projectPath: './my-project',
+  outputDir: './public',
+  architecture: 'spa',
+  framework: 'react',
+  globDirectory: './public',
+  globPatterns: ['**/*.{html,js,css,png,jpg,svg}'],
+})
+
+console.log(result.swPath) // Chemin du service worker généré
+```
+
+### Injecter des meta-tags
+
+```typescript
+import { injectMetaTagsInFile } from '@universal-pwa/core'
+
+const result = injectMetaTagsInFile('./index.html', {
+  manifestPath: '/manifest.json',
+  themeColor: '#2c3e50',
+  appleTouchIcon: '/apple-touch-icon.png',
+  serviceWorkerPath: '/sw.js',
+})
+
+console.log(result.injected) // Tags injectés
+console.log(result.skipped) // Tags déjà présents
+```
+
+## API
+
+### Scanner
+
+- `scanProject(options)` : Scanne un projet et retourne un rapport complet
+- `detectFramework(projectPath)` : Détecte le framework utilisé
+- `detectAssets(projectPath)` : Détecte les assets (JS, CSS, images, fonts)
+- `detectArchitecture(projectPath)` : Détecte l'architecture (SPA, SSR, static)
+
+### Générateur
+
+- `generateManifest(options)` : Génère un manifest.json
+- `writeManifest(manifest, outputDir)` : Écrit le manifest dans un fichier
+- `generateIcons(options)` : Génère les icônes PWA à partir d'une image source
+- `generateServiceWorker(options)` : Génère un service worker avec Workbox
+- `checkProjectHttps(options)` : Vérifie le statut HTTPS d'un projet
+
+### Injecteur
+
+- `parseHTML(htmlContent)` : Parse du HTML
+- `parseHTMLFile(filePath)` : Parse un fichier HTML
+- `injectMetaTags(htmlContent, options)` : Injecte des meta-tags PWA
+- `injectMetaTagsInFile(filePath, options)` : Injecte des meta-tags dans un fichier
+
+## Types
+
+```typescript
+import type {
+  Framework,
+  Architecture,
+  ScannerResult,
+  Manifest,
+  ManifestIcon,
+  ServiceWorkerGenerationResult,
+} from '@universal-pwa/core'
+```
+
+## Développement
+
+```bash
+# Installer les dépendances
+pnpm install
+
+# Build
+pnpm build
+
+# Tests
+pnpm test
+
+# Lint
+pnpm lint
+```