@flowuent-org/diagramming-core 1.0.8 → 1.1.1

package/packages/diagrams/tsconfig.lib.json

@@ -1,25 +1,25 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../dist/out-tsc",
-    "types": [
-      "node",
-
-      "@nx/react/typings/cssmodule.d.ts",
-      "@nx/react/typings/image.d.ts"
-    ],
-    "noEmitOnError": false
-  },
-  "exclude": [
-    "jest.config.ts",
-    "src/**/*.spec.ts",
-    "src/**/*.test.ts",
-    "src/**/*.spec.tsx",
-    "src/**/*.test.tsx",
-    "src/**/*.spec.js",
-    "src/**/*.test.js",
-    "src/**/*.spec.jsx",
-    "src/**/*.test.jsx"
-  ],
-  "include": ["src/**/*.js", "src/**/*.jsx", "src/**/*.ts", "src/**/*.tsx"]
-}
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "types": [
+      "node",
+
+      "@nx/react/typings/cssmodule.d.ts",
+      "@nx/react/typings/image.d.ts"
+    ],
+    "noEmitOnError": false
+  },
+  "exclude": [
+    "jest.config.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.js",
+    "src/**/*.test.js",
+    "src/**/*.spec.jsx",
+    "src/**/*.test.jsx"
+  ],
+  "include": ["src/**/*.js", "src/**/*.jsx", "src/**/*.ts", "src/**/*.tsx"]
+}

package/tsconfig.base.json

@@ -1,30 +1,29 @@
-{
-  "compileOnSave": false,
-  "compilerOptions": {
-    "rootDir": ".",
-    "sourceMap": true,
-    "declaration": false,
-    "moduleResolution": "node",
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "importHelpers": true,
-    "target": "es2015",
-    "module": "esnext",
-    "lib": ["es2020", "dom"],
-    "skipLibCheck": true,
-    "skipDefaultLibCheck": true,
-    "baseUrl": ".",
-    "paths": {
-      "@flowuent-labs/api": ["packages/api/src/index.ts"],
-      "@flowuent-labs/atoms": ["packages/atoms/src/index.ts"],
-      "@flowuent-labs/common": ["packages/common/src/index.ts"],
-      "@flowuent-labs/contexts": ["packages/contexts/src/index.ts"],
-      "@flowuent-labs/diagrams": ["packages/diagrams/src/index.ts"],
-      "@flowuent-labs/interfaces": ["packages/interfaces/src/index.ts"],
-      "@flowuent-labs/molecules": ["packages/molecules/src/index.ts"],
-      "@flowuent-labs/organisms": ["packages/organisms/src/index.ts"],
-      "@flowuent-labs/zustand": ["packages/zustand/src/index.ts"]
-    }
-  },
-  "exclude": ["node_modules", "tmp"]
-}
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "sourceMap": true,
+    "declaration": false,
+    "moduleResolution": "node",
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "importHelpers": true,
+    "target": "es2015",
+    "module": "esnext",
+    "lib": ["es2020", "dom"],
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "baseUrl": ".",
+    "paths": {
+      "@flowuent-labs/api": ["packages/api/src/index.ts"],
+      "@flowuent-labs/atoms": ["packages/atoms/src/index.ts"],
+      "@flowuent-labs/common": ["packages/common/src/index.ts"],
+      "@flowuent-labs/contexts": ["packages/contexts/src/index.ts"],
+      "@flowuent-labs/diagrams": ["packages/diagrams/src/index.ts"],
+      "@flowuent-labs/interfaces": ["packages/interfaces/src/index.ts"],
+      "@flowuent-labs/molecules": ["packages/molecules/src/index.ts"],
+      "@flowuent-labs/organisms": ["packages/organisms/src/index.ts"],
+      "@flowuent-labs/zustand": ["packages/zustand/src/index.ts"]
+    }
+  },
+  "exclude": ["node_modules", "tmp"]
+}

package/TRANSLATION_FIX_SUMMARY.md

@@ -1,118 +0,0 @@
-# Translation Fix Summary
-
-## Problem
-Translation keys (like `tooltip.clear`, `button.save`) were showing instead of actual text when using the published npm library in another app.
-
-## Root Cause
-The translation files were in the `apps/workflow/locales` folder (not part of the library) and were not being bundled with the published npm package. The library code was using `useTranslation()` hooks but had no way to access the translation resources.
-
-## Solution Implemented
-
-### 1. Moved Translation Files to Library
-- ✅ Created `packages/diagrams/locales/en/translation.json`
-- ✅ Copied translation files from apps to library
-
-### 2. Updated Build Configuration
-- ✅ Modified `packages/diagrams/project.json` to include locales folder in build assets
-- ✅ This ensures translations are bundled with the npm package
-
-### 3. Created i18n Configuration
-- ✅ Created `packages/diagrams/src/lib/i18n.ts` with:
-  - `initDiagramsI18n()` - Function to initialize translations
-  - `translationEN` - Export of translation resources
-  - Auto-initialization if i18n not already configured
-
-### 4. Updated Package Dependencies
-- ✅ Added `i18next` and `react-i18next` to package.json dependencies
-
-### 5. Updated Exports
-- ✅ Modified `packages/diagrams/src/index.ts` to export i18n functionality
-
-### 6. Created Documentation
-- ✅ Created `I18N_SETUP.md` with detailed setup instructions
-- ✅ Updated `README.md` with quick start guide
-
-## How Consumers Should Use the Library
-
-### In their main.tsx or index.tsx (BEFORE rendering components):
-
-```typescript
-import { initDiagramsI18n } from '@flowuent-labs/diagrams';
-
-// Initialize i18n
-initDiagramsI18n();
-
-// Then render your app
-ReactDOM.createRoot(document.getElementById('root')!).render(<App />);
-```
-
-## Next Steps
-
-1. **Fix Build Issue** (Separate from i18n):
-   The build is failing due to TypeScript path configuration issues (mixing Unix `/Users` and Windows `C:` paths). This is a pre-existing issue unrelated to the i18n changes. You may need to:
-   - Check your `tsconfig.json` and `tsconfig.lib.json`
-   - Ensure consistent path separators
-   - Or build on a single platform (all Unix or all Windows paths)
-
-2. **Test the Build**:
-   Once the path issue is resolved, rebuild:
-   ```bash
-   nx build diagrams
-   ```
-
-3. **Verify Translation Files Are Included**:
-   After successful build, check `dist/packages/diagrams/locales/` exists
-
-4. **Publish Updated Package**:
-   ```bash
-   cd packages/diagrams
-   npm version patch  # or minor/major
-   npm publish
-   ```
-
-5. **Update Consumer Apps**:
-   In apps using the library:
-   ```bash
-   npm update @flowuent-labs/diagrams
-   ```
-   
-   Then add initialization:
-   ```typescript
-   import { initDiagramsI18n } from '@flowuent-labs/diagrams';
-   initDiagramsI18n(); // Add this before rendering
-   ```
-
-## Alternative: Quick Fix Without Rebuilding
-
-If you need an immediate fix before resolving the build issues, consumers can manually add translations:
-
-```typescript
-import i18n from 'i18next';
-import { initReactI18next } from 'react-i18next';
-
-// Manually import/copy the translation.json content
-const translations = { /* paste translation.json content */ };
-
-i18n.use(initReactI18next).init({
-  resources: {
-    en: {
-      translation: translations
-    }
-  },
-  fallbackLng: 'en',
-  interpolation: {
-    escapeValue: false
-  }
-});
-```
-
-## Files Modified/Created
-
-1. ✅ `packages/diagrams/locales/en/translation.json` (new)
-2. ✅ `packages/diagrams/src/lib/i18n.ts` (new)
-3. ✅ `packages/diagrams/src/index.ts` (modified)
-4. ✅ `packages/diagrams/project.json` (modified - assets config)
-5. ✅ `packages/diagrams/package.json` (modified - added i18n deps)
-6. ✅ `packages/diagrams/README.md` (updated)
-7. ✅ `packages/diagrams/I18N_SETUP.md` (new)
-

package/packages/diagrams/I18N_SETUP.md

@@ -1,126 +0,0 @@
-# Internationalization (i18n) Setup
-
-The `@flowuent-labs/diagrams` library includes built-in translation support using i18next. To ensure translations work correctly in your application, you need to initialize i18n before using the library components.
-
-## Quick Start
-
-### Option 1: Use Built-in Initialization (Recommended)
-
-Import and call the `initDiagramsI18n` function before rendering any diagram components:
-
-```typescript
-import { initDiagramsI18n } from '@flowuent-labs/diagrams';
-
-// Initialize i18n with default translations
-initDiagramsI18n();
-
-// Now you can use any diagram components
-function App() {
-  return <YourDiagramComponent />;
-}
-```
-
-### Option 2: Manual Initialization with Custom Translations
-
-If you want to customize or extend the translations:
-
-```typescript
-import { initDiagramsI18n, translationEN } from '@flowuent-labs/diagrams';
-
-// Initialize with custom translations
-initDiagramsI18n({
-  en: {
-    translation: {
-      ...translationEN,
-      // Add your custom translations or overrides here
-      customKey: 'Custom value',
-    },
-  },
-  // Add other languages
-  es: {
-    translation: {
-      // Spanish translations
-    },
-  },
-});
-```
-
-### Option 3: Use Existing i18next Instance
-
-If your app already uses i18next, you can add the library's translations to your existing configuration:
-
-```typescript
-import i18n from 'i18next';
-import { initReactI18next } from 'react-i18next';
-import { translationEN } from '@flowuent-labs/diagrams';
-
-i18n
-  .use(initReactI18next)
-  .init({
-    resources: {
-      en: {
-        translation: {
-          // Your app translations
-          ...yourAppTranslations,
-          // Library translations
-          ...translationEN,
-        },
-      },
-    },
-    fallbackLng: 'en',
-    interpolation: {
-      escapeValue: false,
-    },
-  });
-```
-
-## Available Translations
-
-The library currently includes:
-- English (en) - `translationEN`
-
-## Common Issues
-
-### Translation Keys Showing Instead of Text
-
-If you see translation keys (e.g., `tooltip.clear`, `button.save`) instead of actual text, it means i18n is not initialized. Make sure to call `initDiagramsI18n()` before rendering any components.
-
-### Translations Not Working in Production
-
-Ensure your build process includes the `locales` folder from the library. The translation files are automatically included in the npm package.
-
-## API Reference
-
-### `initDiagramsI18n(customResources?: any): i18n`
-
-Initializes or updates the i18next instance with diagram translations.
-
-**Parameters:**
-- `customResources` (optional): Custom translation resources object
-
-**Returns:**
-- The i18next instance
-
-### `translationEN`
-
-The default English translation resource object. Can be imported for customization or extension.
-
-## Example: Complete Setup
-
-```typescript
-// main.tsx or index.tsx
-import React from 'react';
-import ReactDOM from 'react-dom/client';
-import { initDiagramsI18n } from '@flowuent-labs/diagrams';
-import App from './App';
-
-// Initialize i18n before rendering
-initDiagramsI18n();
-
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>
-);
-```
-