@makroz/web 1.0.1

package/dist/theme/MkThemeProvider.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { MkTheme } from '@mk/core';
+interface ThemeContextType {
+    theme: MkTheme;
+    isDark: boolean;
+    toggleTheme: () => void;
+    setDark: (dark: boolean) => void;
+    customOverrides: Partial<Record<string, string>>;
+    updateOverride: (key: string, value: string) => void;
+    resetOverrides: () => void;
+}
+export declare function MkThemeProvider({ children, initialDark, defaultTheme, }: {
+    children: React.ReactNode;
+    initialDark?: boolean;
+    defaultTheme?: MkTheme;
+}): React.JSX.Element;
+export declare const useMkTheme: () => ThemeContextType;
+export { tokens } from '@mk/core';
+export type { MkTheme } from '@mk/core';
+//# sourceMappingURL=MkThemeProvider.d.ts.map

package/dist/theme/MkThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MkThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/MkThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkE,MAAM,OAAO,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAEjC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAID,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,WAAmB,EACnB,YAAY,GACb,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAiFpB;AAED,eAAO,MAAM,UAAU,wBAMtB,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/theme/MkThemeProvider.js

@@ -0,0 +1,91 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useState, useMemo, useEffect } from 'react';
+import { tokens } from '@mk/core';
+const ThemeContext = createContext(undefined);
+export function MkThemeProvider({ children, initialDark = false, defaultTheme, }) {
+    const [isDark, setIsDark] = useState(initialDark);
+    const [customOverrides, setCustomOverrides] = useState({});
+    // Initial Sync from LocalStorage
+    useEffect(() => {
+        if (typeof window !== 'undefined') {
+            const savedDark = localStorage.getItem('mk-theme-dark');
+            if (savedDark !== null) {
+                setIsDark(savedDark === 'true');
+            }
+            const savedOverrides = localStorage.getItem('mk-theme-custom');
+            if (savedOverrides) {
+                try {
+                    setCustomOverrides(JSON.parse(savedOverrides));
+                }
+                catch (e) {
+                    console.error('Failed to load custom theme', e);
+                }
+            }
+        }
+    }, []);
+    const theme = useMemo(() => {
+        if (defaultTheme)
+            return defaultTheme;
+        const baseTheme = isDark ? tokens.dark : tokens.light;
+        // Apply overrides on top of base theme
+        return Object.assign(Object.assign({}, baseTheme), customOverrides);
+    }, [isDark, defaultTheme, customOverrides]);
+    const value = {
+        theme,
+        isDark,
+        toggleTheme: () => {
+            const next = !isDark;
+            setIsDark(next);
+            if (typeof window !== 'undefined') {
+                localStorage.setItem('mk-theme-dark', String(next));
+            }
+        },
+        setDark: (dark) => {
+            setIsDark(dark);
+            if (typeof window !== 'undefined') {
+                localStorage.setItem('mk-theme-dark', String(dark));
+            }
+        },
+        customOverrides,
+        updateOverride: (key, value) => {
+            setCustomOverrides(prev => {
+                const next = Object.assign(Object.assign({}, prev), { [key]: value });
+                if (typeof window !== 'undefined') {
+                    localStorage.setItem('mk-theme-custom', JSON.stringify(next));
+                }
+                return next;
+            });
+        },
+        resetOverrides: () => {
+            setCustomOverrides({});
+            if (typeof window !== 'undefined') {
+                localStorage.removeItem('mk-theme-custom');
+            }
+        }
+    };
+    useEffect(() => {
+        const root = document.documentElement;
+        // Helper to convert camelCase to kebab-case
+        const toKebab = (str) => str.replace(/[A-Z]/g, m => '-' + m.toLowerCase());
+        // Apply entire theme
+        Object.entries(theme).forEach(([key, value]) => {
+            if (typeof value === 'string') {
+                root.style.setProperty(`--mk-${toKebab(key)}`, value);
+            }
+        });
+        // Add data-theme for extra styling flexibility
+        root.setAttribute('data-theme', isDark ? 'dark' : 'light');
+    }, [theme, isDark]);
+    return _jsx(ThemeContext.Provider, { value: value, children: children });
+}
+;
+export const useMkTheme = () => {
+    const context = useContext(ThemeContext);
+    if (!context) {
+        throw new Error('useMkTheme must be used within a MkThemeProvider');
+    }
+    return context;
+};
+export { tokens } from '@mk/core';
+//# sourceMappingURL=MkThemeProvider.js.map

package/dist/theme/MkThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MkThemeProvider.js","sourceRoot":"","sources":["../../src/theme/MkThemeProvider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAalC,MAAM,YAAY,GAAG,aAAa,CAA+B,SAAS,CAAC,CAAC;AAE5E,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,WAAW,GAAG,KAAK,EACnB,YAAY,GAKb;IACC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAU,WAAW,CAAC,CAAC;IAC3D,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAkC,EAAE,CAAC,CAAC;IAE5F,iCAAiC;IACjC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACxD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,SAAS,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC;YAClC,CAAC;YAED,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YAC/D,IAAI,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACH,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;gBACjD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;QACzB,IAAI,YAAY;YAAE,OAAO,YAAY,CAAC;QACtC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACtD,uCAAuC;QACvC,uCAAY,SAAS,GAAK,eAAe,EAAG;IAC9C,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAG;QACZ,KAAK;QACL,MAAM;QACN,WAAW,EAAE,GAAG,EAAE;YAChB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;YACrB,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,YAAY,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC,IAAa,EAAE,EAAE;YACzB,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,YAAY,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,eAAe;QACf,cAAc,EAAE,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;YAC7C,kBAAkB,CAAC,IAAI,CAAC,EAAE;gBACxB,MAAM,IAAI,mCAAQ,IAAI,KAAE,CAAC,GAAG,CAAC,EAAE,KAAK,GAAE,CAAC;gBACvC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClC,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChE,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QACD,cAAc,EAAE,GAAG,EAAE;YACnB,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACvB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;KACF,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;QACtC,4CAA4C;QAC5C,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAEnF,qBAAqB;QACrB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACxD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,+CAA+C;QAC/C,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAEpB,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAC;AACjF,CAAC;AAAA,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE;IAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/utils/images.d.ts

@@ -0,0 +1,9 @@
+/**
+ * mkResizeImage
+ *
+ * Frontend image resizer using Canvas.
+ * Generates a WebP version of the image with the specified constraints.
+ * 🚀 Performance-first: Reduces upload payload size.
+ */
+export declare const mkResizeImage: (file: File | Blob, maxWidth?: number, maxHeight?: number, quality?: number) => Promise<string>;
+//# sourceMappingURL=images.d.ts.map

package/dist/utils/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/utils/images.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GACtB,MAAM,IAAI,GAAG,IAAI,EACjB,WAAU,MAAa,EACvB,YAAW,MAAa,EACxB,UAAS,MAAY,KACtB,OAAO,CAAC,MAAM,CAgDhB,CAAC"}

package/dist/utils/images.js

@@ -0,0 +1,50 @@
+/**
+ * mkResizeImage
+ *
+ * Frontend image resizer using Canvas.
+ * Generates a WebP version of the image with the specified constraints.
+ * 🚀 Performance-first: Reduces upload payload size.
+ */
+export const mkResizeImage = async (file, maxWidth = 1024, maxHeight = 1024, quality = 0.8) => {
+    return new Promise((resolve, reject) => {
+        if (typeof window === 'undefined') {
+            return reject(new Error('mkResizeImage solo puede usarse en el navegador.'));
+        }
+        const reader = new FileReader();
+        reader.onload = (event) => {
+            var _a;
+            const img = new Image();
+            img.src = (_a = event.target) === null || _a === void 0 ? void 0 : _a.result;
+            img.onload = () => {
+                let width = img.width;
+                let height = img.height;
+                // Adjust based on constraints
+                if (width > maxWidth || height > maxHeight) {
+                    const aspectRatio = width / height;
+                    if (width > height) {
+                        width = maxWidth;
+                        height = maxWidth / aspectRatio;
+                    }
+                    else {
+                        height = maxHeight;
+                        width = maxHeight * aspectRatio;
+                    }
+                }
+                const canvas = document.createElement('canvas');
+                canvas.width = width;
+                canvas.height = height;
+                const ctx = canvas.getContext('2d');
+                if (!ctx)
+                    return reject(new Error('No se pudo obtener el contexto 2d del canvas.'));
+                ctx.drawImage(img, 0, 0, width, height);
+                // Convert to WebP for modern performance
+                const resizedImage = canvas.toDataURL('image/webp', quality);
+                resolve(resizedImage);
+            };
+            img.onerror = () => reject(new Error('Error al cargar la imagen en el motor de renderizado.'));
+        };
+        reader.onerror = () => reject(new Error('Error al leer el archivo de origen.'));
+        reader.readAsDataURL(file);
+    });
+};
+//# sourceMappingURL=images.js.map

package/dist/utils/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../src/utils/images.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAC9B,IAAiB,EACjB,WAAmB,IAAI,EACvB,YAAoB,IAAI,EACxB,UAAkB,GAAG,EACN,EAAE;IACjB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAEhC,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,EAAE;;YACtB,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,GAAG,CAAC,GAAG,GAAG,MAAA,KAAK,CAAC,MAAM,0CAAE,MAAgB,CAAC;YAEzC,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE;gBACd,IAAI,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;gBACtB,IAAI,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;gBAExB,8BAA8B;gBAC9B,IAAI,KAAK,GAAG,QAAQ,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC;oBACzC,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;oBACnC,IAAI,KAAK,GAAG,MAAM,EAAE,CAAC;wBACjB,KAAK,GAAG,QAAQ,CAAC;wBACjB,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;oBACpC,CAAC;yBAAM,CAAC;wBACJ,MAAM,GAAG,SAAS,CAAC;wBACnB,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;oBACpC,CAAC;gBACL,CAAC;gBAED,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAChD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;gBACrB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBACvB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAEpC,IAAI,CAAC,GAAG;oBAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC,CAAC;gBAEpF,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAExC,yCAAyC;gBACzC,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBAC7D,OAAO,CAAC,YAAY,CAAC,CAAC;YAC1B,CAAC,CAAC;YAEF,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC,CAAC;QACnG,CAAC,CAAC;QAEF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACP,CAAC,CAAC"}

package/eslint-plugin-mk/__tests__/no-cross-module-import.test.js

@@ -0,0 +1,66 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, it, expect } from 'vitest';
+import { RuleTester } from 'eslint';
+import rule from '../rules/no-cross-module-import.js';
+
+const ruleTester = new RuleTester({
+    languageOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+    },
+});
+
+describe('no-cross-module-import', () => {
+    ruleTester.run('no-cross-module-import', rule, {
+        valid: [
+            // Same module, deep import — OK
+            {
+                filename: '/app/src/modules/payments/hooks/usePayment.ts',
+                code: "import { usePaymentForm } from '@/modules/payments/components/PaymentForm';",
+            },
+            // Cross module, but using the public index — OK
+            {
+                filename: '/app/src/modules/payments/hooks/usePayment.ts',
+                code: "import { AdminListPage } from '@/modules/admin';",
+            },
+            // File outside any module — OK
+            {
+                filename: '/app/src/app/admin/page.tsx',
+                code: "import { AdminListPage } from '@/modules/admin/pages/AdminListPage';",
+            },
+            // Non-aliased relative import is ignored (not under @/modules/)
+            {
+                filename: '/app/src/modules/payments/hooks/usePayment.ts',
+                code: "import { foo } from './useFoo';",
+            },
+        ],
+
+        invalid: [
+            // Cross-module deep import — should fail
+            {
+                filename: '/app/src/modules/payments/hooks/usePayment.ts',
+            code: "import { AdminForm } from '@/modules/admin/components/AdminForm';",
+                errors: [{ messageId: 'forbidden' }],
+            },
+            // Cross-module re-export — should fail
+            {
+                filename: '/app/src/modules/payments/index.ts',
+                code: "export { AdminForm } from '@/modules/admin/components/AdminForm';",
+                errors: [{ messageId: 'forbidden' }],
+            },
+            // Cross-module star re-export — should fail
+            {
+                filename: '/app/src/modules/payments/index.ts',
+                code: "export * from '@/modules/admin/components/AdminForm';",
+                errors: [{ messageId: 'forbidden' }],
+            },
+        ],
+    });
+
+    it('has expected meta', () => {
+        expect(rule.meta.type).toBe('problem');
+        expect(rule.meta.messages.forbidden).toContain('@/modules/{{source}}');
+    });
+});

package/eslint-plugin-mk/index.js

@@ -0,0 +1,29 @@
+/**
+ * @mk/eslint-plugin-mk — package root
+ *
+ * Mirrors the MME rule (R-MK-001) for JavaScript/TypeScript:
+ * blocks cross-module imports; only `@/modules/{name}` (the public
+ * index) is allowed from other modules.
+ *
+ * Consumers enable it in their eslint.config.mjs:
+ *
+ *   import mkPlugin from '@makroz/web/eslint-plugin-mk';
+ *   export default [
+ *       ...nextConfig,
+ *       { plugins: { mk: mkPlugin }, rules: { '@mk/no-cross-module-import': 'error' } },
+ *   ];
+ */
+
+import noCrossModuleImport from './rules/no-cross-module-import.js';
+
+const plugin = {
+    meta: {
+        name: '@mk/eslint-plugin-mk',
+        version: '1.0.0',
+    },
+    rules: {
+        'no-cross-module-import': noCrossModuleImport,
+    },
+};
+
+export default plugin;

package/eslint-plugin-mk/rules/no-cross-module-import.js

@@ -0,0 +1,71 @@
+/**
+ * Rule: no-cross-module-import
+ *
+ * Forbids files inside `src/modules/{X}/` from importing deep paths
+ * inside another module. Only `@/modules/{X}` (the index/public API)
+ * is allowed.
+ *
+ * Scenarios:
+ *   Given file src/modules/payments/hooks/usePayment.ts
+ *   When it imports '@/modules/admin/components/AdminForm'
+ *   Then the lint fails:
+ *     "Cross-module import is forbidden. Use '@/modules/admin' public API instead."
+ *
+ *   Given the same file imports '@/modules/admin'
+ *   Then the lint passes.
+ *
+ *   Given a file OUTSIDE any module (e.g. src/app/admin/page.tsx)
+ *   When it imports '@/modules/admin/...'
+ *   Then the lint passes — the app is the consumer of the public API.
+ */
+
+const MODULE_PATH_RE = /[\\/]modules[\\/]([\w-]+)(?:[\\/](.*))?/;
+
+const MESSAGE = "Cross-module import is forbidden. Use '@/modules/{{source}}' public API instead. Got: '{{imported}}'.";
+
+export default {
+    meta: {
+        type: 'problem',
+        docs: {
+            description:
+                'Forbid deep cross-module imports in favor of the public module index.',
+        },
+        schema: [],
+        messages: {
+            forbidden: MESSAGE,
+        },
+    },
+
+    create(context) {
+        const filename = context.getFilename();
+        const moduleMatch = filename.match(MODULE_PATH_RE);
+        if (!moduleMatch) {
+            // File is outside any module — app-level code, ignore.
+            return {};
+        }
+        const sourceModule = moduleMatch[1];
+
+        function checkImport(node) {
+            const importPath = node.source?.value;
+            if (typeof importPath !== 'string') return;
+            const importMatch = importPath.match(/^@\/modules\/([\w-]+)(?:\/(.+))?$/);
+            if (!importMatch) return;
+            const [, targetModule, subPath] = importMatch;
+            if (targetModule === sourceModule) return; // same module, OK
+            if (!subPath) return; // bare '@/modules/admin' (the index), OK
+
+            context.report({
+                node,
+                messageId: 'forbidden',
+                data: { source: targetModule, imported: importPath },
+            });
+        }
+
+        return {
+            ImportDeclaration: checkImport,
+            // Also catch `export ... from '...'` re-exports.
+            ExportNamedDeclaration: checkImport,
+            ExportAllDeclaration: checkImport,
+        };
+    },
+};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@makroz/web",
+  "version": "1.0.1",
+  "description": "React UI components and hooks for MK-Director web applications",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles/*": "./dist/styles/*",
+    "./styles/*.css": "./dist/styles/*.css",
+    "./eslint-plugin-mk": "./eslint-plugin-mk/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "eslint-plugin-mk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/condaty/mk-director.git",
+    "directory": "packages/mk-web"
+  },
+  "dependencies": {
+    "@tanstack/react-query": "^5.62.0",
+    "@makroz/core": "1.0.1"
+  },
+  "peerDependencies": {
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "next": "^16.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "19.2.3",
+    "@types/react-dom": "19.2.3",
+    "@vitest/coverage-v8": "^3.0.0",
+    "eslint": "^9.20.0",
+    "jsdom": "^24.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc && rm -f dist/**/*.test.* && cp -r src/components/*.css dist/components/ && cp -r src/styles dist/",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}