@nexia/sdk 0.5.0

package/dist/spreadsheet.d.ts

@@ -0,0 +1,42 @@
+/** JSON snapshot owned by the Core spreadsheet engine. Keep unknown fields on round trips. */
+export interface SpreadsheetWorkbook {
+    id: string;
+    name: string;
+    sheetOrder: string[];
+    sheets: Record<string, SpreadsheetWorksheet>;
+    [key: string]: unknown;
+}
+export interface SpreadsheetWorksheet {
+    id: string;
+    name: string;
+    rowCount: number;
+    columnCount: number;
+    cellData: Record<string, Record<string, SpreadsheetCell>>;
+    [key: string]: unknown;
+}
+/** A formula is explicit; a string beginning with '=' remains literal text. */
+export interface SpreadsheetCell {
+    v?: string | number | boolean | null;
+    f?: string | null;
+    [key: string]: unknown;
+}
+export interface NxSpreadsheetEditorProps {
+    /** Same document ID must keep its meaning for the lifetime of the editor. */
+    value: SpreadsheetWorkbook;
+    onChange: (value: SpreadsheetWorkbook) => void;
+    ariaLabel: string;
+    readOnly?: boolean;
+    className?: string;
+    dropdowns?: Array<{
+        column: number;
+        startRow: number;
+        rowCount: number;
+        values: string[];
+    }>;
+    focusCell?: {
+        row: number;
+        column: number;
+    };
+}
+/** Build a draft without creating any server record or importing business data. */
+export declare function createSpreadsheetWorkbook(id: string, name: string, rows?: readonly (readonly (string | number | boolean | null)[])[]): SpreadsheetWorkbook;

package/dist/spreadsheet.js

@@ -0,0 +1,15 @@
+/** Build a draft without creating any server record or importing business data. */
+export function createSpreadsheetWorkbook(id, name, rows = []) {
+    const cellData = {};
+    rows.forEach((row, r) => {
+        cellData[r] = {};
+        row.forEach((v, c) => { cellData[r][c] = { v, t: typeof v === 'number' ? 2 : typeof v === 'boolean' ? 3 : 1 }; });
+    });
+    return {
+        id, name, sheetOrder: ['sheet1'],
+        sheets: { sheet1: {
+                id: 'sheet1', name, rowCount: Math.max(100, rows.length),
+                columnCount: rows.reduce((width, row) => Math.max(width, row.length), 26), cellData,
+            } },
+    };
+}

package/dist/testing.d.ts

@@ -0,0 +1,16 @@
+export interface NexiaAppFrontendTestHostBindings {
+    i18n: {
+        changeLanguage: (language: string) => unknown;
+    };
+    server: {
+        use: (...handlers: unknown[]) => void;
+    };
+}
+/** Core test setup installs its i18n and request-interception harness here. */
+export declare function configureNexiaAppFrontendTestHost(bindings: NexiaAppFrontendTestHostBindings): void;
+export declare const appTestI18n: {
+    changeLanguage: (language: string) => unknown;
+};
+export declare const appTestServer: {
+    use: (...handlers: unknown[]) => void;
+};

package/dist/testing.js

@@ -0,0 +1,17 @@
+let activeTestHost = null;
+/** Core test setup installs its i18n and request-interception harness here. */
+export function configureNexiaAppFrontendTestHost(bindings) {
+    activeTestHost = bindings;
+}
+function testHost() {
+    if (activeTestHost === null) {
+        throw new Error('Nexia App frontend test host is not configured. Core test setup must configure it before App specs run.');
+    }
+    return activeTestHost;
+}
+export const appTestI18n = {
+    changeLanguage: (language) => testHost().i18n.changeLanguage(language),
+};
+export const appTestServer = {
+    use: (...handlers) => testHost().server.use(...handlers),
+};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@nexia/sdk",
+  "version": "0.5.0",
+  "description": "Frontend contracts for Nexia App Packages",
+  "license": "UNLICENSED",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./host": {
+      "development": "./dist/host.js",
+      "types": "./dist/host.d.ts",
+      "import": "./dist/host.js"
+    },
+    "./testing": {
+      "development": "./dist/testing.js",
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    }
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.99.0",
+    "axios": "^1.11.0",
+    "react": "^19.1.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.99.0",
+    "@types/react": "^19.1.0",
+    "axios": "^1.11.0",
+    "react": "^19.1.0",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "test": "npm run build && node tests/WireValuesTest.mjs && node tests/ResourceCompositionFrontendContractsTest.mjs && node scripts/organization-target-contract.mjs",
+    "test:wire-values": "node tests/WireValuesTest.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test:resource-composition": "pnpm run build && node tests/ResourceCompositionFrontendContractsTest.mjs",
+    "test:organization-target": "pnpm run build && node scripts/organization-target-contract.mjs"
+  }
+}