@nexia/sdk 0.8.7 → 0.8.8

package/README.md

@@ -7,3 +7,9 @@ Public frontend contracts for Nexia App Packages. Import supported contracts fro
 Report SDK, setup, CLI, Docker, AI-tool and sandbox problems in the [central developer support tracker](https://github.com/nexia-cloud-os/developer-support/issues). Search existing issues first and include package versions and minimal reproduction steps. Never attach credentials, private Core source or customer data.
 
 SDK·개발환경·CLI·Docker·AI 도구·샌드박스 문제는 [통합 이슈 창구](https://github.com/nexia-cloud-os/developer-support/issues)에 신고하세요. 기존 이슈를 먼저 검색하고 패키지 버전과 최소 재현 단계를 포함하세요. 인증 정보, 비공개 Core 소스와 고객 데이터는 첨부하지 마세요.
+
+## Standalone App styles
+
+`nexiaAppConfig(import.meta.url)` generates Tailwind utilities from the App resources, including lazy screens, and records emitted CSS in `nexia-host.json`. The build references the shared `@nexia/sdk/theme.css` token aliases; Core supplies token values and resets. Keep those aliases aligned with the Core theme contract. Do not bundle a second preflight or global theme.
+
+After adopting the SDK release containing this fix, rebuild and resubmit each standalone App. Existing deployed bundles are unchanged until replaced. Custom builds must declare every emitted stylesheet in `nexia-host.json`.

package/changelog/0.8.8/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.8
+date: 2026-10-16
+title: Standalone App stylesheet generation
+description: Restore utility styles in independently built Apps.
+---
+
+The standalone App build helper now generates utility styles for App screens, including lazy screens, and records emitted CSS in the frontend manifest. Theme aliases use Core token values without adding another reset.
+
+Update the App dependency lock to @nexia/sdk 0.8.8, rebuild, and resubmit the App. Existing published bundles do not change automatically.

package/changelog/0.8.8/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.8
+date: 2026-10-16
+title: 독립 App 스타일 생성 복구
+description: 독립 빌드한 App의 유틸리티 스타일을 복구합니다.
+---
+
+App 빌드 도구가 지연 로딩 화면을 포함한 App 화면의 유틸리티 스타일을 생성하고 프런트엔드 매니페스트에 CSS를 기록합니다. 테마 별칭은 Core 토큰 값을 사용하며 초기화 스타일을 중복 추가하지 않습니다.
+
+App의 의존성 lock에 @nexia/sdk 0.8.8을 반영한 뒤 다시 빌드하고 제출해야 합니다. 기존 게시 번들은 자동으로 변경되지 않습니다.

package/dist/theme.css

@@ -0,0 +1,112 @@
+/* Public utility aliases reference host tokens; Apps never redefine token values. */
+@theme inline {
+    --font-sans: var(--nx-font-sans);
+    --font-display: var(--nx-font-display);
+    --font-mono: var(--nx-font-mono);
+    --text-page-title: var(--nx-fontsize-page-title);
+    --text-page-title--line-height: var(--nx-leading-page-title);
+    --text-section-title: var(--nx-fontsize-section-title);
+    --text-section-title--line-height: var(--nx-leading-section-title);
+    --text-card-title: var(--nx-fontsize-card-title);
+    --text-card-title--line-height: var(--nx-leading-card-title);
+    --text-row-label: var(--nx-fontsize-row-label);
+    --text-row-label--line-height: var(--nx-leading-row-label);
+    --text-description: var(--nx-fontsize-description);
+    --text-description--line-height: var(--nx-leading-description);
+    --text-meta: var(--nx-fontsize-meta);
+    --text-meta--line-height: var(--nx-leading-meta);
+    --text-chat-body: var(--nx-fontsize-chat-body);
+    --text-chat-body--line-height: var(--nx-leading-chat-body);
+    --text-eyebrow: var(--nx-fontsize-eyebrow);
+    --text-eyebrow--line-height: var(--nx-leading-eyebrow);
+    --font-weight-page-title: var(--nx-weight-page-title);
+    --font-weight-section-title: var(--nx-weight-section-title);
+    --font-weight-card-title: var(--nx-weight-card-title);
+    --font-weight-row-label: var(--nx-weight-row-label);
+    --font-weight-description: var(--nx-weight-description);
+    --font-weight-meta: var(--nx-weight-meta);
+    --font-weight-chat-body: var(--nx-weight-chat-body);
+    --font-weight-eyebrow: var(--nx-weight-eyebrow);
+    --tracking-eyebrow: var(--nx-tracking-eyebrow);
+    --radius-sm: var(--nx-radius-sm);
+    --radius-md: var(--nx-radius-md);
+    --radius-lg: var(--nx-radius-lg);
+    --radius-xl: var(--nx-radius-xl);
+    --radius-2xl: var(--nx-radius-2xl);
+    --radius-3xl: var(--nx-radius-3xl);
+    --radius-full: var(--nx-radius-full);
+    --radius-control: var(--nx-radius-md);
+    --radius-card: var(--nx-radius-md);
+    --radius-pill: var(--nx-radius-full);
+    --radius-bubble: var(--nx-radius-2xl);
+    --radius-composer: var(--nx-radius-2xl);
+    --radius-panel: var(--nx-radius-2xl);
+    --shadow-sm: var(--nx-outline-hairline);
+    --shadow-hairline: var(--nx-outline-hairline);
+    --shadow-lg: var(--nx-shadow-lg);
+    --shadow-xl: var(--nx-shadow-xl);
+    --shadow-card: var(--nx-outline-hairline);
+    --shadow-overlay: var(--nx-shadow-lg);
+    --spacing-page: var(--nx-spacing-page);
+    --spacing-section: var(--nx-spacing-section);
+    --spacing-inset: var(--nx-spacing-inset);
+    --spacing-row: var(--nx-spacing-row);
+    --spacing-stack: var(--nx-spacing-stack);
+    --color-bg: var(--nx-bg);
+    --color-surface: var(--nx-surface);
+    --color-surface-elevated: var(--nx-surface-elevated);
+    --color-surface-control: var(--nx-surface-control);
+    --color-surface-overlay: var(--nx-surface-overlay);
+    --color-surface-hover: var(--nx-surface-hover);
+    --color-surface-active: var(--nx-surface-active);
+    --color-surface-selected: var(--nx-surface-selected);
+    --color-backdrop: var(--nx-backdrop);
+    --color-border: var(--nx-border);
+    --color-border-subtle: var(--nx-border-subtle);
+    --color-divider: var(--nx-divider);
+    --color-divider-hover: var(--nx-divider-hover);
+    --color-divider-track-hover: var(--nx-divider-track-hover);
+    --color-text-primary: var(--nx-text-primary);
+    --color-text-secondary: var(--nx-text-secondary);
+    --color-text-tertiary: var(--nx-text-tertiary);
+    --color-text-disabled: var(--nx-text-disabled);
+    --color-accent: var(--nx-accent);
+    --color-accent-hover: var(--nx-accent-hover);
+    --color-accent-text: var(--nx-accent-text);
+    --color-token-neutral: var(--nx-token-neutral);
+    --color-token-accent: var(--nx-token-accent);
+    --color-token-accent-text: var(--nx-token-accent-text);
+    --color-info: var(--nx-info);
+    --color-info-surface: var(--nx-info-surface);
+    --color-destructive: var(--nx-destructive);
+    --color-destructive-surface: var(--nx-destructive-surface);
+    --color-warning: var(--nx-warning);
+    --color-warning-surface: var(--nx-warning-surface);
+    --color-success: var(--nx-success);
+    --color-success-surface: var(--nx-success-surface);
+    --color-chart-1: var(--nx-chart-1);
+    --color-chart-2: var(--nx-chart-2);
+    --color-chart-3: var(--nx-chart-3);
+    --color-chart-4: var(--nx-chart-4);
+    --color-chart-5: var(--nx-chart-5);
+    --color-chart-6: var(--nx-chart-6);
+    --color-chart-7: var(--nx-chart-7);
+    --color-chart-8: var(--nx-chart-8);
+    --color-chart-other: var(--nx-chart-other);
+    --color-background: var(--background);
+    --color-foreground: var(--foreground);
+    --color-card: var(--card);
+    --color-card-foreground: var(--card-foreground);
+    --color-popover: var(--popover);
+    --color-popover-foreground: var(--popover-foreground);
+    --color-primary: var(--primary);
+    --color-primary-foreground: var(--primary-foreground);
+    --color-secondary: var(--secondary);
+    --color-secondary-foreground: var(--secondary-foreground);
+    --color-muted: var(--muted);
+    --color-muted-foreground: var(--muted-foreground);
+    --color-accent-foreground: var(--accent-foreground);
+    --color-destructive-foreground: var(--nx-accent-text);
+    --color-input: var(--input);
+    --color-ring: var(--ring);
+}

package/dist/vite.d.mts

@@ -5,5 +5,5 @@ export function nexiaAppFrontend(apps: { appKey: string; root: string } | Array<
     enforce: 'pre';
     resolveId(source: string, importer?: string): string | undefined;
     load(id: string): string | undefined;
-    generateBundle(this: { emitFile(file: { type: 'asset'; fileName: string; source: string }): unknown }, options: unknown, bundle: Record<string, unknown>): void;
+    generateBundle: { order: 'post'; handler(this: { emitFile(file: { type: 'asset'; fileName: string; source: string }): unknown }, options: unknown, bundle: Record<string, unknown>): void };
 };

package/dist/vite.mjs

@@ -1,5 +1,7 @@
 import path from 'node:path';
-import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import tailwindcss from '@tailwindcss/vite';
+import { readFileSync, realpathSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 
 // Only these modules are supplied by Core's import map. Other App dependencies
@@ -9,10 +11,26 @@ export const nexiaHostPeers = ['react', 'react/jsx-runtime', 'react/jsx-dev-runt
 
 /** The same standalone build contract for generated and existing Apps. */
 export function nexiaAppConfig(configUrl) {
-    const root = fileURLToPath(new URL('.', configUrl));
+    const root = realpathSync(fileURLToPath(new URL('.', configUrl)));
     const manifest = JSON.parse(readFileSync(new URL('./nexia.json', configUrl), 'utf8'));
+    const utilities = '\0nexia-app-utilities.css';
+    const theme = createRequire(import.meta.url).resolve('tailwindcss/theme.css').replaceAll('\\', '/');
+    const aliases = fileURLToPath(new URL('./theme.css', import.meta.url)).replaceAll('\\', '/');
+    const entry = path.join(root, 'resources/js/index.ts');
     return {
-        root, base: './', plugins: [nexiaAppFrontend({ appKey: manifest.app.app_key, root })],
+        root, base: './', plugins: [nexiaAppFrontend({ appKey: manifest.app.app_key, root }), ...tailwindcss(), {
+            name: 'nexia:app-utilities',
+            resolveId(id) { if (id === utilities) return id; },
+            load(id) {
+                if (id === utilities) return `@reference ${JSON.stringify(theme)};
+@reference ${JSON.stringify(aliases)};
+@layer utilities { @tailwind utilities source(none); }
+@source ${JSON.stringify(path.join(root, 'resources').replaceAll('\\', '/'))};`;
+            },
+            transform(code, id) {
+                if (id === entry) return { code: `import ${JSON.stringify(utilities)};\n${code}`, map: null };
+            },
+        }],
         publicDir: false, envDir: false, esbuild: { jsx: 'automatic' },
         resolve: { alias: { '#app': path.join(root, 'resources/js'), '#lang': path.join(root, 'resources/lang') } },
         build: {
@@ -56,13 +74,13 @@ export const { api, openFile, sendUserInvitation, useDataMigrationBackgroundOper
     processUserTaskFormRegistry, dataMigrationRegistry,
     registerAgentComponent, registerLazyAgentComponent } = services;`;
         },
-        generateBundle(_options, bundle) {
+        generateBundle: { order: 'post', handler(_options, bundle) {
             // Standalone App builds expose compatibility before executing their entry.
             if (owners.length === 1) this.emitFile({
                 type: 'asset', fileName: 'nexia-host.json',
                 source: JSON.stringify({ version: 1, development_updates: 1, app_key: owners[0].appKey,
                     styles: Object.keys(bundle).filter(file => file.endsWith('.css')) }),
             });
-        },
+        } },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.8.7",
+    "version": "0.8.8",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",
@@ -27,13 +27,14 @@
             "development": "./dist/testing.js",
             "types": "./dist/testing.d.ts",
             "import": "./dist/testing.js"
-        }
+        },
+        "./theme.css": "./dist/theme.css"
     },
     "sideEffects": false,
     "scripts": {
         "build": "node scripts/build.mjs",
         "prepack": "npm run build",
-        "test": "npm run build && node tests/WireValuesTest.mjs && node tests/ResourceCompositionFrontendContractsTest.mjs && node scripts/organization-target-contract.mjs && node tests/ResourceInspectorRegistrationTest.mjs && node tests/SettingsPrimitivesTest.mjs && node tests/AppServicesTest.mjs",
+        "test": "npm run build && node tests/WireValuesTest.mjs && node tests/ResourceCompositionFrontendContractsTest.mjs && node scripts/organization-target-contract.mjs && node tests/ResourceInspectorRegistrationTest.mjs && node tests/SettingsPrimitivesTest.mjs && node tests/AppServicesTest.mjs && node tests/AppStylesTest.mjs",
         "test:wire-values": "node tests/WireValuesTest.mjs",
         "typecheck": "tsc -p tsconfig.json --noEmit",
         "test:resource-composition": "pnpm run build && node tests/ResourceCompositionFrontendContractsTest.mjs",
@@ -51,7 +52,8 @@
         "@types/react": "^19.1.0",
         "axios": "^1.11.0",
         "react": "^19.1.0",
-        "typescript": "^5.8.3"
+        "typescript": "^5.8.3",
+        "vite": "^7.0.7"
     },
     "publishConfig": {
         "registry": "https://registry.npmjs.org/",
@@ -64,5 +66,9 @@
     },
     "bugs": {
         "url": "https://github.com/nexia-cloud-os/developer-support/issues"
+    },
+    "dependencies": {
+        "@tailwindcss/vite": "4.2.1",
+        "tailwindcss": "4.2.1"
     }
 }