@thangdevalone/meet-layout-grid-core 1.0.0 → 1.0.4

package/LICENSE

@@ -0,0 +1,44 @@
+MIT License with Attribution Requirement
+
+Copyright (c) 2024-2026 ThangDevAlone
+
+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:
+
+1. The above copyright notice and this permission notice shall be included in 
+   all copies or substantial portions of the Software.
+
+2. ATTRIBUTION REQUIREMENT: Any project using this Software must include 
+   visible attribution to the original author in one of the following ways:
+   
+   a) In the project's README or documentation file, include:
+      "This project uses meet-layout-grid by @thangdevalone 
+       (https://github.com/thangdevalone/meet-layout-grid)"
+   
+   b) In an "About" or "Credits" section of the application, include:
+      "Powered by meet-layout-grid - https://github.com/thangdevalone/meet-layout-grid"
+   
+   c) In the project's package.json or equivalent dependency manifest, ensure 
+      the package is listed with its original name and author information intact.
+
+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.
+
+---
+
+TL;DR - Bạn được phép:
+✅ Sử dụng miễn phí cho dự án cá nhân và thương mại
+✅ Chỉnh sửa và phân phối lại
+✅ Sử dụng trong các dự án closed-source
+
+Yêu cầu duy nhất:
+📝 Ghi nguồn/credit cho tác giả gốc trong README hoặc phần About của dự án

package/README.md

@@ -1,95 +1,95 @@
-# @meet-layout-grid/core
-
-Core grid calculation logic for meet-layout-grid library. Zero dependencies, framework-agnostic.
-
-## Installation
-
-```bash
-npm install @meet-layout-grid/core
-```
-
-## Usage
-
-```typescript
-import { createMeetGrid, createGrid } from '@meet-layout-grid/core'
-
-// Basic grid
-const grid = createGrid({
-  dimensions: { width: 800, height: 600 },
-  count: 6,
-  aspectRatio: '16:9',
-  gap: 8,
-})
-
-console.log(`Item size: ${grid.width}x${grid.height}`)
-console.log(`Grid: ${grid.cols} cols, ${grid.rows} rows`)
-
-// Position each item
-for (let i = 0; i < 6; i++) {
-  const { top, left } = grid.getPosition(i)
-  console.log(`Item ${i}: top=${top}, left=${left}`)
-}
-
-// Meet-style grid with layout modes
-const meetGrid = createMeetGrid({
-  dimensions: { width: 800, height: 600 },
-  count: 6,
-  aspectRatio: '16:9',
-  gap: 8,
-  layoutMode: 'speaker', // 'gallery' | 'speaker' | 'spotlight' | 'sidebar'
-  speakerIndex: 0,
-})
-
-// Items may have different sizes in speaker mode
-for (let i = 0; i < 6; i++) {
-  const { width, height } = meetGrid.getItemDimensions(i)
-  const isMain = meetGrid.isMainItem(i)
-  console.log(`Item ${i}: ${width}x${height}, main: ${isMain}`)
-}
-```
-
-## API
-
-### `createGrid(options)`
-
-Creates a basic responsive grid.
-
-**Options:**
-- `dimensions: { width, height }` - Container dimensions
-- `count: number` - Number of items
-- `aspectRatio: string` - Aspect ratio (e.g., "16:9")
-- `gap: number` - Gap between items in pixels
-
-**Returns:**
-- `width: number` - Item width
-- `height: number` - Item height
-- `rows: number` - Number of rows
-- `cols: number` - Number of columns
-- `getPosition(index): { top, left }` - Position getter
-
-### `createMeetGrid(options)`
-
-Creates a meet-style grid with layout modes.
-
-**Additional Options:**
-- `layoutMode: 'gallery' | 'speaker' | 'spotlight' | 'sidebar'`
-- `pinnedIndex?: number` - Index of pinned item
-- `speakerIndex?: number` - Index of active speaker
-- `sidebarPosition?: 'left' | 'right' | 'bottom'`
-- `sidebarRatio?: number` - Sidebar width ratio (0-1)
-
-**Additional Returns:**
-- `layoutMode: LayoutMode` - Current layout mode
-- `getItemDimensions(index): { width, height }` - Per-item dimensions
-- `isMainItem(index): boolean` - Check if item is featured
-
-## Layout Modes
-
-- **Gallery** - Equal-sized tiles in a responsive grid
-- **Speaker** - Active speaker takes larger space (65% height)
-- **Spotlight** - Single participant in focus, others hidden
-- **Sidebar** - Main view with thumbnail strip
-
-## License
-
-MIT
+# @thangdevalone/meet-layout-grid-core
+
+Core grid calculation logic for meet-layout-grid library. Zero dependencies, framework-agnostic.
+
+## Installation
+
+```bash
+npm install @thangdevalone/meet-layout-grid-core
+```
+
+## Usage
+
+```typescript
+import { createMeetGrid, createGrid } from '@thangdevalone/meet-layout-grid-core'
+
+// Basic grid
+const grid = createGrid({
+  dimensions: { width: 800, height: 600 },
+  count: 6,
+  aspectRatio: '16:9',
+  gap: 8,
+})
+
+console.log(`Item size: ${grid.width}x${grid.height}`)
+console.log(`Grid: ${grid.cols} cols, ${grid.rows} rows`)
+
+// Position each item
+for (let i = 0; i < 6; i++) {
+  const { top, left } = grid.getPosition(i)
+  console.log(`Item ${i}: top=${top}, left=${left}`)
+}
+
+// Meet-style grid with layout modes
+const meetGrid = createMeetGrid({
+  dimensions: { width: 800, height: 600 },
+  count: 6,
+  aspectRatio: '16:9',
+  gap: 8,
+  layoutMode: 'speaker', // 'gallery' | 'speaker' | 'spotlight' | 'sidebar'
+  speakerIndex: 0,
+})
+
+// Items may have different sizes in speaker mode
+for (let i = 0; i < 6; i++) {
+  const { width, height } = meetGrid.getItemDimensions(i)
+  const isMain = meetGrid.isMainItem(i)
+  console.log(`Item ${i}: ${width}x${height}, main: ${isMain}`)
+}
+```
+
+## API
+
+### `createGrid(options)`
+
+Creates a basic responsive grid.
+
+**Options:**
+- `dimensions: { width, height }` - Container dimensions
+- `count: number` - Number of items
+- `aspectRatio: string` - Aspect ratio (e.g., "16:9")
+- `gap: number` - Gap between items in pixels
+
+**Returns:**
+- `width: number` - Item width
+- `height: number` - Item height
+- `rows: number` - Number of rows
+- `cols: number` - Number of columns
+- `getPosition(index): { top, left }` - Position getter
+
+### `createMeetGrid(options)`
+
+Creates a meet-style grid with layout modes.
+
+**Additional Options:**
+- `layoutMode: 'gallery' | 'speaker' | 'spotlight' | 'sidebar'`
+- `pinnedIndex?: number` - Index of pinned item
+- `speakerIndex?: number` - Index of active speaker
+- `sidebarPosition?: 'left' | 'right' | 'bottom'`
+- `sidebarRatio?: number` - Sidebar width ratio (0-1)
+
+**Additional Returns:**
+- `layoutMode: LayoutMode` - Current layout mode
+- `getItemDimensions(index): { width, height }` - Per-item dimensions
+- `isMainItem(index): boolean` - Check if item is featured
+
+## Layout Modes
+
+- **Gallery** - Equal-sized tiles in a responsive grid
+- **Speaker** - Active speaker takes larger space (65% height)
+- **Spotlight** - Single participant in focus, others hidden
+- **Sidebar** - Main view with thumbnail strip
+
+## License
+
+MIT