@freegridjs/react 0.0.0-stage → 0.7.0

package/LICENSE

@@ -0,0 +1,79 @@
+FreeGrid License
+Version 1.0, 2026-10-15
+
+Copyright (c) 2026 2nd Korea (세컨드코리아). All rights reserved.
+Contact: help@2nd-korea.com · https://freegrid.app/pricing/
+
+This license covers the FreeGrid software, including the packages @freegridjs/core,
+@freegridjs/react and @freegridjs/vue, their source code and the files built from them
+(the "Software").
+
+1. Personal use is free
+
+   An individual may use, copy and modify the Software free of charge for personal,
+   educational, research or other non-commercial purposes, including personal websites,
+   open-source projects that are not run by a company, and learning or evaluation.
+
+2. Company use needs a domain license
+
+   Any use by or for a company, organization, public body or other business ("Company"),
+   whether the product is sold, used internally or offered to customers, requires a paid
+   Company License. A Company may evaluate the Software for up to 30 days without a license.
+
+   - A Company License is issued for one domain (for example example.com) and covers that
+     domain and its subdomains. Applications without a domain (desktop apps, intranets
+     reached by address) count as one domain per installation site.
+   - The fee is KRW 200,000 per domain per year. The license is valid for one year from the
+     date it is issued and may be renewed.
+   - A license key is provided with each Company License. Setting the key removes the
+     console notice described in section 5.
+
+3. Conditions for all users
+
+   - Keep this license and the copyright notice in copies of the Software.
+   - Do not sell, rent or sublicense the Software itself, or offer it as a standalone grid
+     component or library, with or without changes.
+   - Do not remove or work around the license check, or share license keys outside the
+     licensed domain.
+
+4. No warranty
+
+   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 ARISING FROM THE SOFTWARE OR ITS USE.
+
+5. Usage report
+
+   When the Software runs on a public domain (not localhost or a private network address),
+   it sends the domain name, the page address without query string, the Software version
+   and whether a license key is set to freegrid.app once a day. No data shown in the grid
+   and no information about end users is sent. Without a license key on such a domain it
+   also prints a notice in the browser developer console.
+
+6. Earlier versions
+
+   Version 0.1.0 of the packages was published under the MIT License and remains available
+   under that license. This license applies to version 0.7.0 and later.
+
+---------------------------------------------------------------------------------------
+
+FreeGrid 라이선스 (요약, 한국어)
+
+- 개인: 개인적·교육·연구 등 비상업적 용도로 무료로 사용, 복제, 수정할 수 있습니다.
+- 회사: 회사, 단체, 공공기관 등 업무용으로 쓰려면 판매용·내부용·고객 제공용 모두 유료
+  회사 라이선스가 필요합니다. 30일 동안은 평가 목적으로 라이선스 없이 써 볼 수 있습니다.
+  - 도메인 1개(하위 도메인 포함) 기준 연 200,000원이며, 발급일로부터 1년간 유효하고
+    갱신할 수 있습니다.
+  - 라이선스마다 키를 발급하며, 키를 설정하면 콘솔 안내가 사라집니다.
+- 모든 사용자: 저작권과 이 라이선스 문구를 유지해야 하며, 소프트웨어 자체를 판매하거나
+  별도 그리드 라이브러리로 재배포할 수 없고, 라이선스 확인을 제거하거나 키를 다른
+  도메인에 공유할 수 없습니다.
+- 보증 없음: 소프트웨어는 있는 그대로 제공됩니다.
+- 사용 보고: 공개 도메인에서 실행되면 하루 한 번 도메인 이름, 쿼리 문자열을 뺀 페이지
+  주소, 버전, 라이선스 키 설정 여부를 freegrid.app으로 보냅니다. 그리드의 데이터나 최종
+  사용자 정보는 보내지 않습니다.
+- 0.1.0 버전은 MIT 라이선스로 배포되었으며 그 버전에는 MIT가 계속 적용됩니다. 이 라이선스는
+  0.7.0 버전부터 적용됩니다.
+
+문의: help@2nd-korea.com · 대표번호 070-7768-1326

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# @freegridjs/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React component for [FreeGrid](https://freegrid.app).
+
+```bash
+npm i @freegridjs/core @freegridjs/react
+```
+
+```tsx
+import { FreeGrid } from '@freegridjs/react';
+import '@freegridjs/core/styles.css';
+
+<FreeGrid
+  columns={columns}
+  data={rows}
+  rowSelection="multiple"
+  onCellClick={e => console.log(e.row)}
+  style={{ height: 480 }}
+/>;
+```
+
+Every grid option is a prop, every event an `on…` prop, and the ref is the grid API. Docs: https://freegrid.app/docs/#react
+
+## License
+
+Free for personal use. Company use needs a domain license: KRW 200,000 per domain per year
+(subdomains included). See https://freegrid.app/pricing/ and the LICENSE file.
+
+개인은 무료, 회사는 도메인당 연 20만 원입니다. 자세한 내용은 https://freegrid.app/pricing/
+
+```js
+import { setLicenseKey } from '@freegridjs/core';
+setLicenseKey('FG1....');   // or createGrid(el, { licenseKey: 'FG1....', ... })
+```

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import * as react from 'react';
+import { CSSProperties } from 'react';
+import { GridOptions, ColumnDef, Row, GridEvents, GridApi } from '@freegridjs/core';
+
+type Handler<K extends keyof GridEvents> = (payload: GridEvents[K]) => void;
+interface FreeGridProps extends Omit<GridOptions, 'columns' | 'data'> {
+    columns: ColumnDef[];
+    data: Row[];
+    className?: string;
+    /** The host needs a height; defaults to 400px. */
+    style?: CSSProperties;
+    onCellClick?: Handler<'cellClick'>;
+    onCellDoubleClick?: Handler<'cellDoubleClick'>;
+    onSelectionChange?: Handler<'selectionChange'>;
+    onSortChange?: Handler<'sortChange'>;
+    onFilterChange?: Handler<'filterChange'>;
+    onColumnResize?: Handler<'columnResize'>;
+    onColumnMove?: Handler<'columnMove'>;
+    onFocusChange?: Handler<'focusChange'>;
+    onColumnVisible?: Handler<'columnVisible'>;
+    onRangeChange?: Handler<'rangeChange'>;
+    onCellValueChanged?: Handler<'cellValueChanged'>;
+    onPaste?: Handler<'paste'>;
+    onEditStart?: Handler<'editStart'>;
+    onEditStop?: Handler<'editStop'>;
+    onValidationFailed?: Handler<'validationFailed'>;
+    onRowsAdded?: Handler<'rowsAdded'>;
+    onRowsRemoved?: Handler<'rowsRemoved'>;
+    onGroupChange?: Handler<'groupChange'>;
+    onGroupToggle?: Handler<'groupToggle'>;
+    onDetailToggle?: Handler<'detailToggle'>;
+    onRowDragEnd?: Handler<'rowDragEnd'>;
+    onPageChange?: Handler<'pageChange'>;
+    onRowsLoaded?: Handler<'rowsLoaded'>;
+    onRowsLoadFailed?: Handler<'rowsLoadFailed'>;
+    onPivotChange?: Handler<'pivotChange'>;
+}
+declare const FreeGrid: react.ForwardRefExoticComponent<FreeGridProps & react.RefAttributes<GridApi | null>>;
+
+export { FreeGrid, type FreeGridProps };

package/dist/index.js

@@ -0,0 +1,80 @@
+// src/index.tsx
+import { createGrid } from "@freegridjs/core";
+import { forwardRef, useEffect, useImperativeHandle, useLayoutEffect, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+var EVENT_PROPS = {
+  cellClick: "onCellClick",
+  cellDoubleClick: "onCellDoubleClick",
+  selectionChange: "onSelectionChange",
+  sortChange: "onSortChange",
+  filterChange: "onFilterChange",
+  columnResize: "onColumnResize",
+  columnMove: "onColumnMove",
+  focusChange: "onFocusChange",
+  columnVisible: "onColumnVisible",
+  rangeChange: "onRangeChange",
+  cellValueChanged: "onCellValueChanged",
+  paste: "onPaste",
+  editStart: "onEditStart",
+  editStop: "onEditStop",
+  validationFailed: "onValidationFailed",
+  rowsAdded: "onRowsAdded",
+  rowsRemoved: "onRowsRemoved",
+  groupChange: "onGroupChange",
+  groupToggle: "onGroupToggle",
+  detailToggle: "onDetailToggle",
+  rowDragEnd: "onRowDragEnd",
+  pageChange: "onPageChange",
+  rowsLoaded: "onRowsLoaded",
+  rowsLoadFailed: "onRowsLoadFailed",
+  pivotChange: "onPivotChange"
+};
+var FreeGrid = forwardRef(function FreeGrid2(props, ref) {
+  const host = useRef(null);
+  const api = useRef(null);
+  const latest = useRef(props);
+  latest.current = props;
+  const applied = useRef({});
+  useLayoutEffect(() => {
+    const p = latest.current;
+    const options = Object.fromEntries(
+      Object.entries(p).filter(([k]) => k !== "className" && k !== "style" && !/^on[A-Z]/.test(k))
+    );
+    const grid = createGrid(host.current, options);
+    api.current = grid;
+    applied.current = { data: p.data, columns: p.columns, locale: p.locale, theme: p.theme, fontSize: p.fontSize, fontFamily: p.fontFamily, summary: p.summary, groupBy: p.groupBy, pivot: p.pivot };
+    const offs = Object.keys(EVENT_PROPS).map(
+      (type) => grid.on(type, (payload) => {
+        const handler = latest.current[EVENT_PROPS[type]];
+        handler?.(payload);
+      })
+    );
+    return () => {
+      offs.forEach((off) => off());
+      grid.destroy();
+      api.current = null;
+    };
+  }, []);
+  useImperativeHandle(ref, () => api.current, []);
+  useEffect(() => {
+    const grid = api.current;
+    const a = applied.current;
+    if (!grid) return;
+    if (props.columns !== a.columns) grid.setColumns(a.columns = props.columns);
+    if (props.data !== a.data) grid.setData(a.data = props.data);
+    if (props.locale !== void 0 && props.locale !== a.locale) grid.setLocale(a.locale = props.locale);
+    if (props.theme !== void 0 && props.theme !== a.theme) grid.setTheme(a.theme = props.theme);
+    if (props.summary !== a.summary) grid.setSummary((a.summary = props.summary) ?? null);
+    if (props.groupBy !== a.groupBy) grid.setGroupBy((a.groupBy = props.groupBy) ?? []);
+    if (props.pivot !== a.pivot) grid.setPivot((a.pivot = props.pivot) ?? null);
+    if (props.fontSize !== a.fontSize || props.fontFamily !== a.fontFamily) {
+      a.fontSize = props.fontSize;
+      a.fontFamily = props.fontFamily;
+      grid.setFont({ size: props.fontSize, family: props.fontFamily ?? null });
+    }
+  });
+  return /* @__PURE__ */ jsx("div", { ref: host, className: props.className, style: { height: 400, ...props.style } });
+});
+export {
+  FreeGrid
+};

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@freegridjs/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.7.0",
+  "description": "React component for FreeGrid, the fast data grid (free for personal use).",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@freegridjs/core": "^0.7.0",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@freegridjs/core": "^0.7.0",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "jsdom": "^30.1.2",
+    "react": ">=18",
+    "react-dom": "^19.3.0",
+    "tsup": "^8.5.1",
+    "typescript": "~5.9.3",
+    "vitest": "^5.0.4"
+  },
+  "keywords": [
+    "data-grid",
+    "react",
+    "grid",
+    "table",
+    "@freegridjs/core"
+  ],
+  "homepage": "https://freegrid.app",
+  "author": "secondkorea",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }