@astrale-os/cli 1.0.0-beta.21 → 1.0.0-beta.22

package/dist/astrale.js

@@ -2578,7 +2578,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@astrale-os/cli",
-    version: "1.0.0-beta.21",
+    version: "1.0.0-beta.22",
     description: "Astrale CLI — connect to existing Astrale kernels",
     keywords: [
       "astrale",
@@ -85157,6 +85157,9 @@ async function addLocalTheme(address, project2, options) {
   }
   const source2 = await readFile18(sourcePath, "utf8");
   admitLocalThemeCss(source2, slug);
+  return installThemeCss(slug, source2, digest5(source2), address, project2, options);
+}
+async function installThemeCss(slug, source2, sourceDigest, sourceLabel, project2, options) {
   const lock = await readUiLock(project2.uiLockPath);
   const canonicalAddress = "theme/" + slug;
   const relativeTarget = "components/astrale/theme/" + slug + ".css";
@@ -85178,7 +85181,7 @@ async function addLocalTheme(address, project2, options) {
     items: [canonicalAddress],
     files: { [canonicalAddress]: { [relativeTarget]: digest5(source2) } },
     activation: { file: projectRelative(project2, project2.cssPath), import: statement },
-    source: address
+    source: sourceLabel
   };
   if (options.dryRun)
     return result;
@@ -85193,7 +85196,7 @@ async function addLocalTheme(address, project2, options) {
     await writeFile6(project2.cssPath, activateTheme(css, statement), "utf8");
     lock.items[canonicalAddress] = {
       address: canonicalAddress,
-      sourceDigest: digest5(source2),
+      sourceDigest,
       files: { [relativeTarget]: digest5(source2) }
     };
     await writeJson(project2.uiLockPath, lock);
@@ -85208,6 +85211,15 @@ async function addLocalTheme(address, project2, options) {
     throw error52;
   }
 }
+async function addReleasedTheme(item, document, project2, options) {
+  const slug = item.meta.canonicalAddress.slice("theme/".length);
+  const source2 = document.files[0]?.content;
+  if (typeof source2 !== "string") {
+    throw new UiError("UI_REGISTRY_UNAVAILABLE", "The released theme has no admitted CSS source.");
+  }
+  admitLocalThemeCss(source2, slug);
+  return installThemeCss(slug, source2, digest5(JSON.stringify(document)), item.meta.canonicalAddress, project2, options);
+}
 async function addUi(addresses, options, dependencies = {}) {
   if (addresses.length === 0) {
     throw new UiError("UI_ITEM_NOT_FOUND", "No UI item was provided.");
@@ -85231,6 +85243,12 @@ async function addUi(addresses, options, dependencies = {}) {
     throw new UiError("UI_ITEM_CONFLICT", "Only one theme can be activated per add operation.");
   }
   const itemDocuments = await Promise.all(items.map((item) => readUiRegistryItem(release, item, dependencies.fetcher)));
+  if (themes.length === 1) {
+    if (items.length !== 1) {
+      throw new UiError("UI_ITEM_CONFLICT", "Install a released theme separately from patterns and blocks.");
+    }
+    return addReleasedTheme(themes[0], itemDocuments[0], project2, options);
+  }
   await rejectLocalChanges(project2, lock, items, options.overwrite === true);
   const targets = (await Promise.all(items.flatMap((item) => item.files.filter((file2) => file2.target).map((file2) => assertSafePlannedTarget(project2, file2.target))))).filter((target2, index3, all) => all.indexOf(target2) === index3);
   const invocation3 = shadcnInvocation(project2.manager, release.compatibility.shadcn, [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/cli",
-  "version": "1.0.0-beta.21",
+  "version": "1.0.0-beta.22",
   "description": "Astrale CLI — connect to existing Astrale kernels",
   "keywords": [
     "astrale",

package/src/ui/.spec/architecture.md

@@ -5,8 +5,9 @@ does not add React, Base UI, Tailwind, shadcn, or the UI runtime to the installe
 graph.
 
 One registry operation resolves one immutable UI commit. Package compatibility and registry reads
-use that commit, and the detected package manager invokes the release-qualified shadcn CLI on
-demand. A local playground-exported theme is instead admitted and copied without network or
-shadcn. Both paths install consumer-owned source, activate themes through one project-relative CSS
+use that commit. Patterns and blocks invoke the release-qualified shadcn CLI on demand through the
+detected package manager. Released themes copy the exact admitted embedded CSS directly, while a
+local playground export is admitted and copied without registry or shadcn. Both theme paths install
+consumer-owned source and activate it through one project-relative CSS
 import, and complete application writes before the lock advances. Dry-run, list, and doctor do not
 claim a file mutation.

package/src/ui/.spec/laws.ts

@@ -24,7 +24,7 @@ export const CLI_UI_BOUNDED_REMOTE_DOCUMENTS = defineLaw({
 export const CLI_UI_EXACT_ITEM_SOURCE = defineLaw({
   id: 'CLI-UI-EXACT-ITEM-SOURCE',
   statement:
-    'An add operation admits the exact built item document against the release index and records a content-bearing source digest before invoking project tooling.',
+    'An add operation admits the exact built item document against the release index and records its content-bearing source digest before any consumer mutation; only patterns and blocks invoke project tooling.',
   tests: [{ file: '../__tests__/ui.test.ts', id: 'TEST-CLI-UI-EXACT-ITEM-SOURCE' }],
 })
 

package/src/ui/__tests__/ui.test.ts

@@ -183,21 +183,25 @@ function themeFetch(seen: string[] = []): typeof fetch {
     }
     if (url.endsWith('/registry/themes/registry.json')) return Response.json(themeRegistry)
     if (url.endsWith('/registry/public/r/theme-observatory.json')) {
-      return Response.json({
-        ...themeRegistry.items[0],
-        files: [
-          {
-            ...themeRegistry.items[0]!.files[0],
-            path: 'registry/themes/observatory.css',
-            content: themeCss,
-          },
-        ],
-      })
+      return Response.json(builtThemeItem())
     }
     return new Response('not found', { status: 404 })
   }) as typeof fetch
 }
 
+function builtThemeItem() {
+  return {
+    ...themeRegistry.items[0],
+    files: [
+      {
+        ...themeRegistry.items[0]!.files[0],
+        path: 'registry/themes/observatory.css',
+        content: themeCss,
+      },
+    ],
+  }
+}
+
 function builtItem(item: UiRegistry['items'][number]) {
   return {
     ...item,
@@ -887,26 +891,29 @@ describe('UI source operations', () => {
       "@import '@astrale-os/ui/theme.css';\n@import '@astrale-os/ui/presets/astrale.css';\n",
     )
     const target = path.join(root, 'components/astrale/theme/observatory.css')
+    let invoked = false
     const result = await addUi(
       ['theme/observatory'],
       { project: root, yes: true },
       {
         fetcher: themeFetch(),
         runner: async () => {
-          await mkdir(path.dirname(target), { recursive: true })
-          await writeFile(target, themeCss)
+          invoked = true
           return { code: 0, stdout: '', stderr: '' }
         },
       },
     )
 
+    expect(invoked).toBe(false)
     expect(result).toMatchObject({ status: 'installed', items: ['theme/observatory'] })
+    expect(await readFile(target, 'utf8')).toBe(themeCss)
     expect(await readFile(path.join(root, 'src/index.css'), 'utf8')).toContain(
       "@import '../components/astrale/theme/observatory.css';",
     )
     const written = JSON.parse(await readFile(path.join(root, 'astrale-ui.lock.json'), 'utf8'))
     expect(written.items['theme/observatory']).toMatchObject({
       address: 'theme/observatory',
+      sourceDigest: digest(JSON.stringify(builtThemeItem())),
       files: { 'components/astrale/theme/observatory.css': digest(themeCss) },
     })
     expect((await doctorUi(root)).healthy).toBe(true)

package/src/ui/operations.ts

@@ -544,6 +544,17 @@ async function addLocalTheme(
   const source = await readFile(sourcePath, 'utf8')
   admitLocalThemeCss(source, slug)
 
+  return installThemeCss(slug, source, digest(source), address, project, options)
+}
+
+async function installThemeCss(
+  slug: string,
+  source: string,
+  sourceDigest: string,
+  sourceLabel: string,
+  project: UiProject,
+  options: { dryRun?: boolean; overwrite?: boolean },
+): Promise<Record<string, unknown>> {
   const lock = await readUiLock(project.uiLockPath)
   const canonicalAddress = 'theme/' + slug
   const relativeTarget = 'components/astrale/theme/' + slug + '.css'
@@ -573,7 +584,7 @@ async function addLocalTheme(
     items: [canonicalAddress],
     files: { [canonicalAddress]: { [relativeTarget]: digest(source) } },
     activation: { file: projectRelative(project, project.cssPath), import: statement },
-    source: address,
+    source: sourceLabel,
   }
   if (options.dryRun) return result
 
@@ -588,7 +599,7 @@ async function addLocalTheme(
     await writeFile(project.cssPath, activateTheme(css, statement), 'utf8')
     lock.items[canonicalAddress] = {
       address: canonicalAddress,
-      sourceDigest: digest(source),
+      sourceDigest,
       files: { [relativeTarget]: digest(source) },
     }
     await writeJson(project.uiLockPath, lock)
@@ -602,6 +613,28 @@ async function addLocalTheme(
   }
 }
 
+async function addReleasedTheme(
+  item: UiRegistryItem,
+  document: UiRegistryItem,
+  project: UiProject,
+  options: { dryRun?: boolean; overwrite?: boolean },
+): Promise<Record<string, unknown>> {
+  const slug = item.meta.canonicalAddress.slice('theme/'.length)
+  const source = document.files[0]?.content
+  if (typeof source !== 'string') {
+    throw new UiError('UI_REGISTRY_UNAVAILABLE', 'The released theme has no admitted CSS source.')
+  }
+  admitLocalThemeCss(source, slug)
+  return installThemeCss(
+    slug,
+    source,
+    digest(JSON.stringify(document)),
+    item.meta.canonicalAddress,
+    project,
+    options,
+  )
+}
+
 export async function addUi(
   addresses: string[],
   options: { project?: string; dryRun?: boolean; overwrite?: boolean; yes?: boolean },
@@ -638,6 +671,15 @@ export async function addUi(
   const itemDocuments = await Promise.all(
     items.map((item) => readUiRegistryItem(release, item, dependencies.fetcher)),
   )
+  if (themes.length === 1) {
+    if (items.length !== 1) {
+      throw new UiError(
+        'UI_ITEM_CONFLICT',
+        'Install a released theme separately from patterns and blocks.',
+      )
+    }
+    return addReleasedTheme(themes[0]!, itemDocuments[0]!, project, options)
+  }
   await rejectLocalChanges(project, lock, items, options.overwrite === true)
   const targets = (
     await Promise.all(