@gradial/aci 0.1.40 → 0.1.41

package/CHANGELOG.md

@@ -1,16 +1,20 @@
 # Changelog
 
-## 0.1.40 - 2026-07-21
+## 0.1.41 - 2026-07-22
 
-### Added
+### Fixed
+
+- First published release to actually ship the layout-default preservation and
+  validation fix in the CLI binary. Earlier binaries (through 0.1.39) predated
+  the fix, and the 0.1.40 meta package pinned platform CLI packages that were
+  never published, leaving its `aci` command unresolvable. The publish process
+  now stamps one release version into the SDK, all six platform packages, and
+  the README in lockstep, and gates publishing on registry verification of
+  every platform package.
 
-- First-party consent banner component (`mountConsentBanner`) for sites without
-  an external CMP. Checks for the `aci_consent` cookie, renders a banner with
-  accept/reject buttons, and calls `applyConsent()` on user decision.
-- `ConsentBanner.astro` wrapper component for Astro sites, importable from
-  `@gradial/aci/astro/ConsentBanner`.
-- Base CSS styles for the consent banner in `@gradial/aci/consent-banner/styles.css`.
-  Sites override with their own CSS.
+After upgrading, delete any `.aci/compiled` directory produced by an older
+compiler and rerun `aci content compile`. Existing compiled output is derived
+state and is not repaired in place.
 
 ## 0.1.34 - 2026-07-20
 

package/README.md

@@ -1,6 +1,6 @@
 # Agentic Content Infrastructure SDK
 
-`@gradial/aci` `0.1.33` is a pre-1.0 public-surface reset for the ACI
+`@gradial/aci` `0.1.41` is a pre-1.0 public-surface reset for the ACI
 client SDK. Breaking changes from the old `0.1.x` accidental surface are
 intentional: the root import is framework-neutral, framework runtime behavior is
 behind explicit subpaths, and the first required customer path is React/Next.
@@ -8,7 +8,7 @@ behind explicit subpaths, and the first required customer path is React/Next.
 ## Install
 
 ```bash
-npm install @gradial/aci@0.1.33 zod@^4
+npm install @gradial/aci@0.1.41 zod@^4
 ```
 
 ## Root Import
@@ -85,13 +85,13 @@ go through an app-owned HTTP endpoint backed server-side by a `ContentProvider`.
 The first RC scaffold path is Next:
 
 ```bash
-npx @gradial/aci@0.1.33 init my-site --template next-starter
+npx @gradial/aci@0.1.41 init my-site --template next-starter
 ```
 
 List available templates:
 
 ```bash
-npx @gradial/aci@0.1.33 init --list
+npx @gradial/aci@0.1.41 init --list
 ```
 
 ## Personalization: The One-Tag Install

package/dist/index.d.ts

@@ -15,4 +15,3 @@ export { AssetSchema, isImage, isAsset, } from './types/media.js';
 export * from './audience-data-models.js';
 export * from './define-data-model.js';
 export * from './types/index.js';
-export { mountConsentBanner, hasConsentCookie, type ConsentBannerOptions, } from './consent-banner/index.js';

package/dist/index.js

@@ -9,7 +9,6 @@ export { AssetSchema, isImage, isAsset, } from './types/media.js';
 export * from './audience-data-models.js';
 export * from './define-data-model.js';
 export * from './types/index.js';
-export { mountConsentBanner, hasConsentCookie, } from './consent-banner/index.js';
 // Note: content/ is NOT re-exported here because it imports node:path,
 // making it incompatible with client-side bundlers. Import server-only
 // content utilities from '@gradial/aci/content' explicitly.

package/dist/react/VideoPlayer.d.ts

@@ -16,10 +16,10 @@ export declare function VideoPlayer({ video, ...attrs }: VideoPlayerProps): impo
     title: string;
     rel?: string | undefined | undefined;
     content?: string | undefined | undefined;
-    slot?: string | undefined | undefined;
-    style?: import("react").CSSProperties | undefined;
     dir?: string | undefined | undefined;
     hidden?: boolean | undefined | undefined;
+    slot?: string | undefined | undefined;
+    style?: import("react").CSSProperties | undefined;
     children?: import("react").ReactNode;
     className?: string | undefined | undefined;
     crossOrigin?: "" | "anonymous" | "use-credentials" | undefined;

package/dist/react/index.d.ts

@@ -25,10 +25,10 @@ export declare function Image({ image, value, ...attrs }: ImageProps): import("r
     rel?: string | undefined | undefined;
     content?: string | undefined | undefined;
     referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;
-    slot?: string | undefined | undefined;
-    style?: import("react").CSSProperties | undefined;
     dir?: string | undefined | undefined;
     hidden?: boolean | undefined | undefined;
+    slot?: string | undefined | undefined;
+    style?: import("react").CSSProperties | undefined;
     children?: ReactNode;
     className?: string | undefined | undefined;
     crossOrigin?: "" | "anonymous" | "use-credentials" | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -9,8 +9,6 @@
     "bin/aci.js",
     "src/cli/*.mjs",
     "src/types/*.ts",
-    "src/astro/*.astro",
-    "src/consent-banner/*.css",
     "templates/common",
     "templates/nextjs",
     "templates/astro",
@@ -86,26 +84,11 @@
       "import": "./dist/astro/index.js",
       "default": "./dist/astro/index.js"
     },
-    "./astro/ConsentBanner": {
-      "import": "./src/astro/ConsentBanner.astro"
-    },
-    "./consent-banner": {
-      "types": "./dist/consent-banner/index.d.ts",
-      "import": "./dist/consent-banner/index.js"
-    },
     "./testing": {
       "types": "./dist/testing/conformance/index.d.ts",
       "import": "./dist/testing/conformance/index.js"
     }
   },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
-    "test": "node --import tsx --test \"src/**/*.test.ts\"",
-    "build:cli": "cd ../.. && ./scripts/build-cli.sh",
-    "generate-starters": "cd ../.. && tsx scripts/generate-starters.ts",
-    "compile-registry": "tsx src/cli/compile-registry.mjs",
-    "prepack": "npm run generate-starters && npm run build && node scripts/ensure-bin-modes.mjs"
-  },
   "dependencies": {
     "markdown-it": "^14.1.0",
     "sanitize-html": "^2.13.1",
@@ -145,11 +128,18 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.40",
-    "@gradial/aci-cli-darwin-x64": "0.1.40",
-    "@gradial/aci-cli-linux-arm64": "0.1.40",
-    "@gradial/aci-cli-linux-x64": "0.1.40",
-    "@gradial/aci-cli-win32-arm64": "0.1.40",
-    "@gradial/aci-cli-win32-x64": "0.1.40"
+    "@gradial/aci-cli-darwin-arm64": "0.1.41",
+    "@gradial/aci-cli-darwin-x64": "0.1.41",
+    "@gradial/aci-cli-linux-arm64": "0.1.41",
+    "@gradial/aci-cli-linux-x64": "0.1.41",
+    "@gradial/aci-cli-win32-arm64": "0.1.41",
+    "@gradial/aci-cli-win32-x64": "0.1.41"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
+    "test": "node --import tsx --test \"src/**/*.test.ts\"",
+    "build:cli": "cd ../.. && ./scripts/build-cli.sh",
+    "generate-starters": "cd ../.. && tsx scripts/generate-starters.ts",
+    "compile-registry": "tsx src/cli/compile-registry.mjs"
   }
-}
+}

package/dist/consent-banner/index.d.ts

@@ -1,33 +0,0 @@
-export interface ConsentBannerOptions {
-    /** Heading text. Default: "Privacy" */
-    heading?: string;
-    /** Body text explaining what the user is consenting to. */
-    message?: string;
-    /** Label for the accept button. Default: "Accept" */
-    acceptLabel?: string;
-    /** Label for the reject button. Default: "Reject" */
-    rejectLabel?: string;
-    /** Label for a link to the privacy policy. Optional. */
-    privacyPolicyLabel?: string;
-    /** URL to the privacy policy. Optional. */
-    privacyPolicyHref?: string;
-    /** Source identifier written to the cookie envelope. Default: "banner" */
-    source?: string;
-    /** Callback fired after a consent decision is written. */
-    onDecision?: (granted: boolean) => void;
-}
-/**
- * hasConsentCookie returns true when the aci_consent cookie exists (the user
- * has already made a decision, regardless of whether they granted or denied).
- */
-export declare function hasConsentCookie(doc: {
-    cookie: string;
-}): boolean;
-/**
- * mountConsentBanner checks for an existing consent cookie. If none exists,
- * it injects a banner into the document body and wires up accept/reject
- * buttons. If a cookie already exists, it does nothing (idempotent).
- *
- * Returns a cleanup function that removes the banner and event listeners.
- */
-export declare function mountConsentBanner(doc: Document, opts?: ConsentBannerOptions): () => void;

package/dist/consent-banner/index.js

@@ -1,99 +0,0 @@
-// First-party consent banner (design/04, preset="manual"): a self-contained
-// client-side component for sites that don't have an external CMP (c15t,
-// OneTrust, etc.). Checks for the aci_consent cookie, shows a banner if
-// absent, and calls applyConsent() on user decision.
-//
-// The banner is framework-agnostic — it renders plain DOM and is driven by
-// CSS classes so each site can style it. The Astro wrapper component
-// (packages/sdk/src/astro/ConsentBanner.astro) imports and invokes this,
-// then applies site-specific styles.
-import { applyConsent, readConsentCookie, PERSONALIZATION_PURPOSE, } from "../collect/consent/envelope.js";
-const DEFAULTS = {
-    heading: "Privacy",
-    message: "We use cookies to personalize content and improve your experience. You can accept or reject personalization.",
-    acceptLabel: "Accept",
-    rejectLabel: "Reject",
-    source: "banner",
-};
-const BANNER_ID = "aci-consent-banner";
-const BANNER_ATTR = "data-aci-consent-banner";
-const BANNER_HIDDEN = "aci-consent-banner--hidden";
-/**
- * hasConsentCookie returns true when the aci_consent cookie exists (the user
- * has already made a decision, regardless of whether they granted or denied).
- */
-export function hasConsentCookie(doc) {
-    return readConsentCookie(doc) !== undefined;
-}
-/**
- * mountConsentBanner checks for an existing consent cookie. If none exists,
- * it injects a banner into the document body and wires up accept/reject
- * buttons. If a cookie already exists, it does nothing (idempotent).
- *
- * Returns a cleanup function that removes the banner and event listeners.
- */
-export function mountConsentBanner(doc, opts = {}) {
-    if (hasConsentCookie(doc))
-        return () => { };
-    if (doc.getElementById(BANNER_ID))
-        return () => { };
-    const config = { ...DEFAULTS, ...opts };
-    const banner = createBannerElement(config, doc);
-    doc.body.appendChild(banner);
-    const cleanup = () => {
-        banner.remove();
-    };
-    const decide = (granted) => {
-        const purposes = granted ? [PERSONALIZATION_PURPOSE] : [];
-        applyConsent(purposes, config.source, { document: doc });
-        banner.classList.add(BANNER_HIDDEN);
-        setTimeout(cleanup, 300);
-        opts.onDecision?.(granted);
-    };
-    banner.querySelector("[data-aci-consent-accept]")?.addEventListener("click", () => decide(true));
-    banner.querySelector("[data-aci-consent-reject]")?.addEventListener("click", () => decide(false));
-    return cleanup;
-}
-function createBannerElement(config, doc) {
-    const banner = doc.createElement("div");
-    banner.id = BANNER_ID;
-    banner.setAttribute(BANNER_ATTR, "");
-    banner.className = BANNER_ID;
-    const content = doc.createElement("div");
-    content.className = `${BANNER_ID}__content`;
-    const text = doc.createElement("div");
-    text.className = `${BANNER_ID}__text`;
-    const heading = doc.createElement("p");
-    heading.className = `${BANNER_ID}__heading`;
-    heading.textContent = config.heading;
-    text.appendChild(heading);
-    const message = doc.createElement("p");
-    message.className = `${BANNER_ID}__message`;
-    message.textContent = config.message;
-    text.appendChild(message);
-    if (config.privacyPolicyHref && config.privacyPolicyLabel) {
-        const link = doc.createElement("a");
-        link.className = `${BANNER_ID}__privacy-link`;
-        link.href = config.privacyPolicyHref;
-        link.textContent = config.privacyPolicyLabel;
-        text.appendChild(link);
-    }
-    content.appendChild(text);
-    const actions = doc.createElement("div");
-    actions.className = `${BANNER_ID}__actions`;
-    const rejectBtn = doc.createElement("button");
-    rejectBtn.type = "button";
-    rejectBtn.className = `${BANNER_ID}__btn ${BANNER_ID}__btn--reject`;
-    rejectBtn.setAttribute("data-aci-consent-reject", "");
-    rejectBtn.textContent = config.rejectLabel;
-    actions.appendChild(rejectBtn);
-    const acceptBtn = doc.createElement("button");
-    acceptBtn.type = "button";
-    acceptBtn.className = `${BANNER_ID}__btn ${BANNER_ID}__btn--accept`;
-    acceptBtn.setAttribute("data-aci-consent-accept", "");
-    acceptBtn.textContent = config.acceptLabel;
-    actions.appendChild(acceptBtn);
-    content.appendChild(actions);
-    banner.appendChild(content);
-    return banner;
-}

package/src/astro/ConsentBanner.astro

@@ -1,62 +0,0 @@
----
-// ConsentBanner.astro — Astro wrapper around the SDK's first-party consent
-// banner. Import this into your layout and pass site-specific text/styles.
-//
-// Usage:
-//   import ConsentBanner from '@gradial/aci/astro/ConsentBanner.astro';
-//   <ConsentBanner
-//     heading="Cookie Preferences"
-//     message="We use cookies to personalize your experience."
-//     acceptLabel="Accept all"
-//     rejectLabel="Reject"
-//     privacyPolicyHref="/privacy"
-//     privacyPolicyLabel="Privacy Policy"
-//   />
-
-export interface Props {
-  heading?: string;
-  message?: string;
-  acceptLabel?: string;
-  rejectLabel?: string;
-  privacyPolicyLabel?: string;
-  privacyPolicyHref?: string;
-  source?: string;
-}
-
-const {
-  heading,
-  message,
-  acceptLabel,
-  rejectLabel,
-  privacyPolicyLabel,
-  privacyPolicyHref,
-  source,
-} = Astro.props as Props;
-
-const opts = JSON.stringify({
-  heading,
-  message,
-  acceptLabel,
-  rejectLabel,
-  privacyPolicyLabel,
-  privacyPolicyHref,
-  source,
-});
----
-
-<div
-  id="aci-consent-banner-mount"
-  data-aci-consent-banner-mount
-  data-opts={opts}
->
-</div>
-
-<script>
-  import { mountConsentBanner } from '../consent-banner/index.js';
-
-  const mount = document.getElementById('aci-consent-banner-mount');
-  if (mount) {
-    const opts = JSON.parse(mount.getAttribute('data-opts') || '{}');
-    mountConsentBanner(document, opts);
-  }
-</script>

package/src/consent-banner/styles.css

@@ -1,110 +0,0 @@
-/* Base consent banner styles — sites override with their own CSS. */
-/* The banner is injected into document.body by mountConsentBanner(). */
-
-#aci-consent-banner {
-  position: fixed;
-  bottom: 0;
-  left: 0;
-  right: 0;
-  z-index: 9999;
-  background: #1a1a2e;
-  color: #fff;
-  font-family: system-ui, -apple-system, sans-serif;
-  font-size: 14px;
-  line-height: 1.5;
-  transition: opacity 0.3s ease, transform 0.3s ease;
-  opacity: 1;
-  transform: translateY(0);
-}
-
-#aci-consent-banner.aci-consent-banner--hidden {
-  opacity: 0;
-  transform: translateY(100%);
-  pointer-events: none;
-}
-
-#aci-consent-banner .aci-consent-banner__content {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 16px;
-  max-width: 1200px;
-  margin: 0 auto;
-  padding: 16px 24px;
-}
-
-#aci-consent-banner .aci-consent-banner__text {
-  flex: 1;
-  min-width: 0;
-}
-
-#aci-consent-banner .aci-consent-banner__heading {
-  margin: 0 0 4px 0;
-  font-size: 16px;
-  font-weight: 600;
-}
-
-#aci-consent-banner .aci-consent-banner__message {
-  margin: 0;
-  font-size: 13px;
-  opacity: 0.85;
-}
-
-#aci-consent-banner .aci-consent-banner__privacy-link {
-  margin-left: 8px;
-  color: #8ecae6;
-  text-decoration: underline;
-  font-size: 13px;
-}
-
-#aci-consent-banner .aci-consent-banner__actions {
-  display: flex;
-  gap: 8px;
-  flex-shrink: 0;
-}
-
-#aci-consent-banner .aci-consent-banner__btn {
-  padding: 8px 20px;
-  border: none;
-  border-radius: 6px;
-  font-size: 14px;
-  font-weight: 500;
-  cursor: pointer;
-  transition: background-color 0.15s ease;
-}
-
-#aci-consent-banner .aci-consent-banner__btn--accept {
-  background: #2196f3;
-  color: #fff;
-}
-
-#aci-consent-banner .aci-consent-banner__btn--accept:hover {
-  background: #1976d2;
-}
-
-#aci-consent-banner .aci-consent-banner__btn--reject {
-  background: transparent;
-  color: #fff;
-  border: 1px solid rgba(255, 255, 255, 0.3);
-}
-
-#aci-consent-banner .aci-consent-banner__btn--reject:hover {
-  background: rgba(255, 255, 255, 0.1);
-}
-
-@media (max-width: 640px) {
-  #aci-consent-banner .aci-consent-banner__content {
-    flex-direction: column;
-    align-items: stretch;
-    gap: 12px;
-  }
-
-  #aci-consent-banner .aci-consent-banner__actions {
-    flex-direction: column-reverse;
-  }
-
-  #aci-consent-banner .aci-consent-banner__btn {
-    width: 100%;
-    text-align: center;
-  }
-}