@freegridjs/svelte 0.0.0-stage → 0.8.0

package/LICENSE

@@ -0,0 +1,72 @@
+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.
+
+---------------------------------------------------------------------------------------
+
+FreeGrid 라이선스 (요약, 한국어)
+
+- 개인: 개인적·교육·연구 등 비상업적 용도로 무료로 사용, 복제, 수정할 수 있습니다.
+- 회사: 회사, 단체, 공공기관 등 업무용으로 쓰려면 판매용·내부용·고객 제공용 모두 유료
+  회사 라이선스가 필요합니다. 30일 동안은 평가 목적으로 라이선스 없이 써 볼 수 있습니다.
+  - 도메인 1개(하위 도메인 포함) 기준 연 200,000원이며, 발급일로부터 1년간 유효하고
+    갱신할 수 있습니다.
+  - 라이선스마다 키를 발급하며, 키를 설정하면 콘솔 안내가 사라집니다.
+- 모든 사용자: 저작권과 이 라이선스 문구를 유지해야 하며, 소프트웨어 자체를 판매하거나
+  별도 그리드 라이브러리로 재배포할 수 없고, 라이선스 확인을 제거하거나 키를 다른
+  도메인에 공유할 수 없습니다.
+- 보증 없음: 소프트웨어는 있는 그대로 제공됩니다.
+- 사용 보고: 공개 도메인에서 실행되면 하루 한 번 도메인 이름, 쿼리 문자열을 뺀 페이지
+  주소, 버전, 라이선스 키 설정 여부를 freegrid.app으로 보냅니다. 그리드의 데이터나 최종
+  사용자 정보는 보내지 않습니다.
+
+문의: help@2nd-korea.com · 대표번호 070-7768-1326

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# @freegridjs/svelte
 
-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.
+Svelte 5 component and action for [FreeGrid](https://freegrid.app).
+
+```bash
+npm i @freegridjs/core @freegridjs/svelte
+```
+
+```svelte
+<script>
+  import { FreeGrid } from '@freegridjs/svelte';
+  import '@freegridjs/core/styles.css';
+
+  let api;
+  const columns = [{ field: 'name' }, { field: 'qty', type: 'number' }];
+  let rows = $state([{ name: 'Pen', qty: 3 }]);
+</script>
+
+<FreeGrid {columns} data={rows} rowSelection="multiple" height={480}
+          onReady={a => (api = a)} onCellClick={e => console.log(e.row)} />
+```
+
+Every grid option is a prop; events are `on` + the event name (`onSortChange`, `onCellValueChanged`, …).
+`columns`, `data`, `theme`, `locale`, `summary`, `groupBy`, `pivot`, `fontSize` and `fontFamily` update the grid
+when they change. Without a component, use the action:
+
+```svelte
+<script>
+  import { freegrid } from '@freegridjs/svelte';
+</script>
+
+<div use:freegrid={{ columns, data: rows }} style="height: 400px"></div>
+```
+
+Docs: https://freegrid.app/docs/#svelte
+
+## 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/

package/dist/FreeGrid.svelte

@@ -0,0 +1,57 @@
+<script lang="ts">
+  import { createGrid, type GridApi } from '@freegridjs/core';
+  import { onMount } from 'svelte';
+  import { EVENT_TYPES, handlerName, splitProps, type FreeGridProps } from './events.js';
+
+  interface Props extends FreeGridProps {
+    /** Host height; number = px. */
+    height?: number | string;
+    class?: string;
+  }
+
+  let { height = 400, class: className = '', ...props }: Props = $props();
+  let host: HTMLDivElement;
+  let api = $state<GridApi | null>(null);
+
+  onMount(() => {
+    const grid = createGrid(host, splitProps(props as Record<string, unknown>).options);
+    for (const type of EVENT_TYPES) {
+      // read the prop at call time so a replaced callback is used
+      grid.on(type, payload => {
+        const fn = (props as Record<string, unknown>)[handlerName(type)];
+        if (typeof fn === 'function') fn(payload);
+      });
+    }
+    api = grid;
+    props.onReady?.(grid);
+    return () => {
+      grid.destroy();
+      api = null;
+    };
+  });
+
+  // props that can change after creation; the first run only records the starting value
+  const watch = <T,>(read: () => T, apply: (grid: GridApi, value: T) => void) => {
+    let first = true;
+    $effect(() => {
+      const value = read();
+      const grid = api;
+      if (!grid) return;
+      if (first) {
+        first = false;
+        return;
+      }
+      apply(grid, value);
+    });
+  };
+  watch(() => props.columns, (g, c) => g.setColumns(c));
+  watch(() => props.data, (g, d) => { if (d) g.setData(d); });
+  watch(() => props.theme, (g, t) => { if (t) g.setTheme(t); });
+  watch(() => props.locale, (g, l) => { if (l !== undefined) g.setLocale(l); });
+  watch(() => props.summary, (g, s) => g.setSummary(s ?? null));
+  watch(() => props.groupBy, (g, v) => g.setGroupBy(v ?? []));
+  watch(() => props.pivot, (g, p) => g.setPivot(p ?? null));
+  watch(() => [props.fontSize, props.fontFamily] as const, (g, [size, family]) => g.setFont({ size, family: family ?? null }));
+</script>
+
+<div bind:this={host} class={className} style:height={typeof height === 'number' ? `${height}px` : height}></div>

package/dist/FreeGrid.svelte.d.ts

@@ -0,0 +1,9 @@
+import { type FreeGridProps } from './events.js';
+interface Props extends FreeGridProps {
+    /** Host height; number = px. */
+    height?: number | string;
+    class?: string;
+}
+declare const FreeGrid: import("svelte").Component<Props, {}, "">;
+type FreeGrid = ReturnType<typeof FreeGrid>;
+export default FreeGrid;

package/dist/action.d.ts

@@ -0,0 +1,9 @@
+import { type FreeGridProps } from './events.js';
+/**
+ * `<div use:freegrid={{ columns, data }} style="height: 400px"></div>`: a grid on any element.
+ * Changes to `columns`, `data`, `theme` and `locale` are applied; other options apply at creation.
+ */
+export declare function freegrid(node: HTMLElement, props: FreeGridProps): {
+    update(next: FreeGridProps): void;
+    destroy(): void;
+};

package/dist/action.js

@@ -0,0 +1,35 @@
+import { createGrid } from '@freegridjs/core';
+import { EVENT_TYPES, handlerName, splitProps } from './events.js';
+/**
+ * `<div use:freegrid={{ columns, data }} style="height: 400px"></div>`: a grid on any element.
+ * Changes to `columns`, `data`, `theme` and `locale` are applied; other options apply at creation.
+ */
+export function freegrid(node, props) {
+    let current = props;
+    const { options } = splitProps(props);
+    const api = createGrid(node, options);
+    for (const type of EVENT_TYPES) {
+        api.on(type, payload => {
+            const fn = current[handlerName(type)];
+            if (typeof fn === 'function')
+                fn(payload);
+        });
+    }
+    props.onReady?.(api);
+    return {
+        update(next) {
+            if (next.columns !== current.columns)
+                api.setColumns(next.columns);
+            if (next.data !== current.data && next.data)
+                api.setData(next.data);
+            if (next.theme && next.theme !== current.theme)
+                api.setTheme(next.theme);
+            if (next.locale !== undefined && next.locale !== current.locale)
+                api.setLocale(next.locale);
+            current = next;
+        },
+        destroy() {
+            api.destroy();
+        },
+    };
+}

package/dist/events.d.ts

@@ -0,0 +1,17 @@
+import type { GridApi, GridEvents, GridOptions } from '@freegridjs/core';
+export declare const EVENT_TYPES: (keyof GridEvents)[];
+/** 'sortChange' → 'onSortChange' */
+export declare const handlerName: (type: string) => string;
+/** `onSortChange`, `onCellClick`, … one optional callback per grid event. */
+export type GridHandlers = {
+    [K in keyof GridEvents as `on${Capitalize<K & string>}`]?: (payload: GridEvents[K]) => void;
+};
+export interface FreeGridProps extends GridOptions, GridHandlers {
+    /** Called once with the grid API after the grid is created. */
+    onReady?: (api: GridApi) => void;
+}
+/** Split props into grid options and event callbacks. */
+export declare function splitProps(props: Record<string, unknown>): {
+    options: GridOptions;
+    handlers: Record<string, unknown>;
+};

package/dist/events.js

@@ -0,0 +1,22 @@
+/** Every grid event; the record type makes the compiler flag a missing one. */
+const ALL = {
+    cellClick: true, cellDoubleClick: true, selectionChange: true, sortChange: true, filterChange: true,
+    columnResize: true, columnMove: true, focusChange: true, columnVisible: true, rangeChange: true,
+    cellValueChanged: true, paste: true, editStart: true, editStop: true, validationFailed: true,
+    rowsAdded: true, rowsRemoved: true, groupChange: true, groupToggle: true, detailToggle: true,
+    rowDragEnd: true, pageChange: true, rowsLoaded: true, rowsLoadFailed: true, pivotChange: true,
+    rowDrop: true, scroll: true, childrenLoaded: true, childrenLoadFailed: true, beforeSort: true, beforeFilter: true, beforePageChange: true,
+    beforeEdit: true, beforeCellChange: true,
+};
+export const EVENT_TYPES = Object.keys(ALL);
+/** 'sortChange' → 'onSortChange' */
+export const handlerName = (type) => `on${type[0].toUpperCase()}${type.slice(1)}`;
+/** Split props into grid options and event callbacks. */
+export function splitProps(props) {
+    const options = {};
+    const handlers = {};
+    const names = new Set(EVENT_TYPES.map(handlerName).concat('onReady'));
+    for (const [k, v] of Object.entries(props))
+        (names.has(k) ? handlers : options)[k] = v;
+    return { options: options, handlers };
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as FreeGrid } from './FreeGrid.svelte';
+export { freegrid } from './action.js';
+export type { FreeGridProps, GridHandlers } from './events.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { default as FreeGrid } from './FreeGrid.svelte';
+export { freegrid } from './action.js';

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@freegridjs/svelte",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.8.0",
+  "description": "Svelte component and action for FreeGrid, the fast data grid (free for personal use).",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "svelte": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@freegridjs/core": "^0.8.0",
+    "svelte": "^5.0.0"
+  },
+  "keywords": [
+    "data-grid",
+    "svelte",
+    "grid",
+    "table",
+    "@freegridjs/core"
+  ],
+  "homepage": "https://freegrid.app",
+  "author": "secondkorea",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@freegridjs/core": "^0.8.0",
+    "@sveltejs/package": "^3.0.0",
+    "@sveltejs/vite-plugin-svelte": "^7.3.1",
+    "jsdom": "^30.1.2",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.7.6",
+    "typescript": "~5.9.3",
+    "vitest": "^5.0.4"
+  },
+  "scripts": {
+    "build": "svelte-package -i src -o dist",
+    "test": "vitest run",
+    "typecheck": "svelte-check --tsconfig ./tsconfig.json --threshold error"
+  }
 }