@norskvideo/ctl-sdk 0.1.0 → 0.1.1

package/frontend-spec.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Ways a frontend's `index.css` drifts from deferring to the shared base. Empty
+ * means compliant. Each string is human-readable for a test failure message.
+ */
+export declare function stylingViolations(indexCss: string): string[];
+/** The sdk's vendored fonts directory, located relative to this module so it
+ *  resolves whether the sdk is a workspace sibling or an installed dependency —
+ *  the product no longer has to guess a `packages/sdk` monorepo path. */
+export declare function sharedFontsDir(): string;
+/**
+ * Whether a Vite dev server's `server.fs.allow` reaches the shared fonts. base.css
+ * lives outside a product's own Vite root, so without an allow entry covering it
+ * the dev server 403s the sibling font and the browser silently falls back to a
+ * system font (the guide-screenshot mismatch). True iff some allow base is an
+ * ancestor of the fonts dir. Allow bases that don't resolve are ignored.
+ */
+export declare function fsAllowCoversFonts(allow: readonly string[]): boolean;

package/frontend-spec.js

@@ -0,0 +1,53 @@
+// The shared styling-deference contract for product frontends: an app states no
+// styling opinion of its own beyond embed-specific rules — font, theme tokens and
+// resets all come from @norskvideo/ctl-sdk/base.css, whose @font-face url()s
+// resolve to the fonts vendored here. Three products carried a byte-identical
+// theme.test.ts asserting this; the judgment (what counts as drift, where the
+// shared fonts live) is centralised here so a fourth product can't fork it. The
+// vitest wrapper stays in each product's own theme.test.ts — it reads that
+// product's index.css and resolves that product's vite config — but delegates
+// every assertion to these pure helpers.
+import { realpathSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const BASE_IMPORT = /@import\s+["']@norskvideo\/ctl-sdk\/base\.css["']/;
+/**
+ * Ways a frontend's `index.css` drifts from deferring to the shared base. Empty
+ * means compliant. Each string is human-readable for a test failure message.
+ */
+export function stylingViolations(indexCss) {
+    const out = [];
+    if (!BASE_IMPORT.test(indexCss))
+        out.push("does not @import @norskvideo/ctl-sdk/base.css");
+    if (/@font-face/.test(indexCss))
+        out.push("declares a local @font-face (fonts belong to the shared base)");
+    if (/--font-sans/.test(indexCss))
+        out.push("declares a local --font-sans (font tokens belong to the shared base)");
+    if (/fonts\.(googleapis|gstatic)\.com/.test(indexCss))
+        out.push("pulls a font from a CDN instead of the shared base");
+    return out;
+}
+/** The sdk's vendored fonts directory, located relative to this module so it
+ *  resolves whether the sdk is a workspace sibling or an installed dependency —
+ *  the product no longer has to guess a `packages/sdk` monorepo path. */
+export function sharedFontsDir() {
+    return realpathSync(join(dirname(fileURLToPath(import.meta.url)), "fonts"));
+}
+/**
+ * Whether a Vite dev server's `server.fs.allow` reaches the shared fonts. base.css
+ * lives outside a product's own Vite root, so without an allow entry covering it
+ * the dev server 403s the sibling font and the browser silently falls back to a
+ * system font (the guide-screenshot mismatch). True iff some allow base is an
+ * ancestor of the fonts dir. Allow bases that don't resolve are ignored.
+ */
+export function fsAllowCoversFonts(allow) {
+    const fonts = sharedFontsDir();
+    return allow.some((base) => {
+        try {
+            return fonts.startsWith(realpathSync(base));
+        }
+        catch {
+            return false;
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "exports": {
     ".": {
@@ -15,6 +15,10 @@
       "types": "./components/index.d.ts",
       "default": "./components/index.js"
     },
+    "./frontend-spec": {
+      "types": "./frontend-spec.d.ts",
+      "default": "./frontend-spec.js"
+    },
     "./manifest-seed": {
       "types": "./manifest-seed.d.ts",
       "default": "./manifest-seed.js"