@svadmin/app 0.2.0

package/README.md

@@ -0,0 +1,40 @@
+# @svadmin/app
+
+Application composition layer for svadmin.
+
+[`@svadmin/core`](https://www.npmjs.com/package/@svadmin/core) owns contracts and
+runtime hooks; `@svadmin/app` owns how an application is assembled:
+
+- `defineAdminConfig` / `defineSvadminPlugin` — typed application config and
+  machine-readable plugin manifests.
+- `resolveAdminConfig` / `assertAdminConfig` — fold plugin contributions into a
+  deterministic snapshot plus diagnostics.
+- `createAdminApp` — one-call convenience returning the provider bundle and
+  normalized resource definitions.
+- `provideAdminConfig` — install the resolved config into the scoped
+  `AdminContext`.
+- `buildAdminManifest` — serialize the resolved config into the stable
+  `svadmin.ai.json` entrypoint that AI tooling and `svadmin doctor` read.
+- `createProviderBundle` — first-class provider configuration object.
+
+## Install
+
+```bash
+bun add @svadmin/app @svadmin/core
+```
+
+## Usage
+
+```ts
+import { createAdminApp, defineAdminConfig } from '@svadmin/app';
+
+export const app = defineAdminConfig({
+  name: 'my-admin',
+  providers: createProviderBundle({ dataProvider }),
+  resources: [ordersDefinition],
+});
+
+export default createAdminApp(app);
+```
+
+See `docs/architecture/admin-platform.md` for the full platform model.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @svadmin/app — the application composition layer.
+ *
+ * Curated public surface over `@svadmin/core` for application wiring:
+ * `defineAdminConfig`, plugin manifests, runtime binding, AI manifest building,
+ * and the `createAdminApp` convenience. Keep app-level additions here so core
+ * can stay a lean contracts/runtime package.
+ */
+export { defineAdminConfig, defineSvadminPlugin, resolveAdminConfig, assertAdminConfig, toAdminContextSource, normalizeAdminResource, buildAdminManifest, provideAdminConfig, provideResourceScope, createProviderBundle, } from '@svadmin/core';
+export type { AdminConfig, AdminConfigDiagnostic, AdminConfigDiagnosticCode, AdminConfigInput, AdminManifest, AdminManifestField, AdminManifestPlugin, AdminManifestProject, AdminManifestResource, AdminPluginCapability, AdminPluginContribution, AdminPluginDescriptor, AdminPluginDocs, AdminResourceDefinition, AdminResourceInput, ProviderBundle, ResolvedAdminConfig, ResolvedAdminContextSource, ResourceScope, } from '@svadmin/core';
+import { type AdminConfig, type ProviderBundle, type ResourceDefinition, type ResolvedAdminConfig } from '@svadmin/core';
+/** Runtime inputs derived from an application config. */
+export interface AdminAppBundle {
+    readonly config: ResolvedAdminConfig;
+    readonly providers: ProviderBundle;
+    readonly resources: readonly ResourceDefinition[];
+    readonly diagnostics: ResolvedAdminConfig['diagnostics'];
+}
+/**
+ * Resolves an application config once and exposes the provider bundle plus the
+ * normalized resource definitions. Inspect `diagnostics` before rendering; use
+ * `assertAdminConfig` when errors should throw at startup.
+ */
+export declare function createAdminApp(config: AdminConfig): AdminAppBundle;

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * @svadmin/app — the application composition layer.
+ *
+ * Curated public surface over `@svadmin/core` for application wiring:
+ * `defineAdminConfig`, plugin manifests, runtime binding, AI manifest building,
+ * and the `createAdminApp` convenience. Keep app-level additions here so core
+ * can stay a lean contracts/runtime package.
+ */
+export { defineAdminConfig, defineSvadminPlugin, resolveAdminConfig, assertAdminConfig, toAdminContextSource, normalizeAdminResource, buildAdminManifest, provideAdminConfig, provideResourceScope, createProviderBundle, } from '@svadmin/core';
+import { resolveAdminConfig, } from '@svadmin/core';
+/**
+ * Resolves an application config once and exposes the provider bundle plus the
+ * normalized resource definitions. Inspect `diagnostics` before rendering; use
+ * `assertAdminConfig` when errors should throw at startup.
+ */
+export function createAdminApp(config) {
+    const resolved = resolveAdminConfig(config);
+    return {
+        config: resolved,
+        providers: resolved.providers,
+        resources: resolved.resources,
+        diagnostics: resolved.diagnostics,
+    };
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@svadmin/app",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Application composition layer for svadmin — defineAdminConfig, plugins, runtime binding, and the AI manifest",
+  "license": "MIT",
+  "keywords": [
+    "svadmin",
+    "admin",
+    "svelte",
+    "application",
+    "plugin",
+    "ai"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vibeunion/svadmin.git",
+    "directory": "packages/app"
+  },
+  "sideEffects": false,
+  "svadmin": {
+    "capabilities": [
+      "app-config",
+      "plugin-registry",
+      "runtime-binding",
+      "ai-manifest"
+    ],
+    "core": "^0.55.0",
+    "stability": "experimental",
+    "migration": null
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@svadmin/core": "^0.57.0"
+  },
+  "peerDependenciesMeta": {
+    "@svadmin/core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "build": "bun ../../scripts/build-node-package.ts"
+  }
+}