npm - @ekanos/harness - Versions diffs - 0.1.0 - Mend

@ekanos/harness 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (72) hide show

package/LICENSE +21 -0
package/README.md +879 -0
package/dist/app.d.ts +4 -0
package/dist/app.js +11 -0
package/dist/config.d.ts +18 -0
package/dist/config.js +34 -0
package/dist/internal/components/ask-assistant-bridge.d.ts +10 -0
package/dist/internal/components/ask-assistant-bridge.js +50 -0
package/dist/internal/components/dashboard-grid.d.ts +45 -0
package/dist/internal/components/dashboard-grid.js +84 -0
package/dist/internal/components/dev-toolbar.d.ts +15 -0
package/dist/internal/components/dev-toolbar.js +155 -0
package/dist/internal/components/harness-providers.d.ts +16 -0
package/dist/internal/components/harness-providers.js +83 -0
package/dist/internal/components/harness-widget-provider.d.ts +60 -0
package/dist/internal/components/harness-widget-provider.js +84 -0
package/dist/internal/components/i18n-provider.d.ts +9 -0
package/dist/internal/components/i18n-provider.js +9 -0
package/dist/internal/components/row-groups.d.ts +23 -0
package/dist/internal/components/row-groups.js +37 -0
package/dist/internal/components/surface-nav.d.ts +4 -0
package/dist/internal/components/surface-nav.js +70 -0
package/dist/internal/components/viewport-frame.d.ts +14 -0
package/dist/internal/components/viewport-frame.js +27 -0
package/dist/internal/components/widget-boundary.d.ts +25 -0
package/dist/internal/components/widget-boundary.js +44 -0
package/dist/internal/components/widget-surface.d.ts +20 -0
package/dist/internal/components/widget-surface.js +76 -0
package/dist/internal/lib/fonts.d.ts +2 -0
package/dist/internal/lib/fonts.js +22 -0
package/dist/internal/lib/harness-fetch-interceptor.d.ts +89 -0
package/dist/internal/lib/harness-fetch-interceptor.js +101 -0
package/dist/internal/lib/harness-live-fetch.d.ts +66 -0
package/dist/internal/lib/harness-live-fetch.js +121 -0
package/dist/internal/lib/harness-query-client.d.ts +43 -0
package/dist/internal/lib/harness-query-client.js +103 -0
package/dist/internal/lib/http-fixtures.d.ts +145 -0
package/dist/internal/lib/http-fixtures.js +256 -0
package/dist/internal/lib/i18n.d.ts +2 -0
package/dist/internal/lib/i18n.js +17 -0
package/dist/internal/lib/redact.d.ts +33 -0
package/dist/internal/lib/redact.js +43 -0
package/dist/internal/lib/toolbar-context.d.ts +59 -0
package/dist/internal/lib/toolbar-context.js +124 -0
package/dist/internal/registry-context.d.ts +27 -0
package/dist/internal/registry-context.js +51 -0
package/dist/internal/routes/activation-page.d.ts +33 -0
package/dist/internal/routes/activation-page.js +242 -0
package/dist/internal/routes/index-page.d.ts +13 -0
package/dist/internal/routes/index-page.js +62 -0
package/dist/internal/routes/integration-layout.d.ts +9 -0
package/dist/internal/routes/integration-layout.js +84 -0
package/dist/internal/routes/root-layout.d.ts +34 -0
package/dist/internal/routes/root-layout.js +39 -0
package/dist/internal/routes/single-widget-page.d.ts +6 -0
package/dist/internal/routes/single-widget-page.js +30 -0
package/dist/internal/routes/tile-page.d.ts +1 -0
package/dist/internal/routes/tile-page.js +88 -0
package/dist/internal/routes/triggers-page.d.ts +1 -0
package/dist/internal/routes/triggers-page.js +386 -0
package/dist/internal/routes/widgets-page.d.ts +1 -0
package/dist/internal/routes/widgets-page.js +19 -0
package/dist/internal/surfaces.d.ts +25 -0
package/dist/internal/surfaces.js +29 -0
package/dist/mocks/team-account-workspace.d.ts +78 -0
package/dist/mocks/team-account-workspace.js +86 -0
package/dist/registry.d.ts +418 -0
package/dist/registry.js +82 -0
package/dist/routes.d.ts +24 -0
package/dist/routes.js +15 -0
package/dist/styles.css +236 -0
package/package.json +101 -0

package/dist/styles.css ADDED Viewed

@@ -0,0 +1,236 @@
+/*
+ * styles.src.css — the harness's own Tailwind layer.
+ *
+ * Built into `dist/styles.css` by this package's CSS build, which is what
+ * `@ekanos/harness/styles.css` resolves to. The shell imports that ONE line and
+ * adds only the `@source` globs covering code the shell owns — its own
+ * integrations and anything they import. Everything the HARNESS renders is
+ * accounted for here, so a partner never has to know which globs the chrome
+ * needs.
+ *
+ * The `@source` block below is injected at build time rather than written
+ * here, because the two layouts this file has to serve resolve from different
+ * directories: in the monorepo consumers compile `src/`, and a partner's
+ * install compiles `dist/`.
+ */
+@import 'tailwindcss';
+/* Fusion design tokens + the Tailwind v4 @theme preset, consumed from the
+ * published package instead of a hand-maintained fork. This single import
+ * pulls in the token values, the base rules, the `dark:` variant and the full
+ * semantic @theme map. Resolves to `@ekanos/ui/dist/theme.css`, so that
+ * package must be built first. */
+@import '@ekanos/ui/theme.css';
+@import 'tw-animate-css';
+/* ── Tailwind content sources ───────────────────────────────────────────────
+ *
+ * INJECTED BY this package's CSS build — edit that, not this file.
+ *
+ * Each package is spelled twice on purpose: once for the monorepo layout and
+ * once for an installed tarball. A glob that matches nothing is a silent
+ * no-op; the missing half renders everything unstyled with no error. */
+@source '../src/**/*.{ts,tsx}'; /* this package, as workspace consumers compile it */
+@source './**/*.js'; /* this package, as a partner installs it */
+@source '../../ekanos-ui/src/**/*.{ts,tsx}'; /* @ekanos/ui, in the monorepo */
+@source '../../integration-sdk/src/**/*.{ts,tsx}'; /* @ekanos/sdk, in the monorepo */
+@source '../../ui/dist/**/*.js'; /* @ekanos/ui, installed and hoisted */
+@source '../../sdk/dist/**/*.js'; /* @ekanos/sdk, installed and hoisted */
+@source '../node_modules/@ekanos/ui/dist/**/*.js'; /* @ekanos/ui, installed nested */
+@source '../node_modules/@ekanos/sdk/dist/**/*.js'; /* @ekanos/sdk, installed nested */
+/* The `dark:` variant now comes from `@ekanos/ui/theme.css` (a richer
+ * `@custom-variant dark` covering `.dark`, `[data-theme='dark']` and the
+ * system-preference media query, all of which next-themes' `.light`/`.dark`
+ * class opts in and out of). No local re-declaration needed. */
+/* `src/internal/lib/fonts.ts` self-hosts Figtree + Bricolage Grotesque through
+ * next/font and exposes them on `--font-sans-fallback` /
+ * `--font-heading-fallback`; `RootLayout` puts those classes on `<html>`.
+ * `@ekanos/ui/tokens.css` ships a literal `'Figtree'` stack (it cannot know
+ * this package's next/font variable names); remap onto the bundled webfonts so
+ * the harness renders the self-hosted faces rather than the system fallback.
+ * Unlayered, so it wins over the `layer(base)` token import above. */
+:root {
+  --font-sans:
+    var(--font-sans-fallback), -apple-system, BlinkMacSystemFont, system-ui,
+    sans-serif;
+  --font-heading: var(--font-heading-fallback), var(--font-sans);
+}
+/* ── Font Awesome Free: missing-glyph fallback ────────────────────────────────
+ *
+ * The harness loads Font Awesome FREE (see the note in `RootLayout` — the
+ * host's Pro webfonts are commercially licensed and cannot ship in a partner's
+ * scaffold). Free has a smaller glyph set, so a Pro-only name such as
+ * `fa-aperture` or `fa-clouds-sun` never gets a `--fa` codepoint, `content:
+ * var(--fa)` computes to nothing, and the icon vanishes with no warning.
+ *
+ * `:where()` carries zero specificity, so every real `.fa-<name>{--fa:…}` rule
+ * in the vendor CSS still wins. Only genuinely-absent glyphs fall through to
+ * the question mark, which reads as "this glyph isn't in the free font" rather
+ * than as a broken layout. */
+:where(.fa-solid, .fa-regular, .fa-light, .fa-duotone, .fa-thin, .fa) {
+  --fa: '\f059'; /* fa-circle-question */
+}
+/* ── Font Awesome Free: hand `::before` back to the icon font ─────────────────
+ *
+ * `@ekanos/ui/theme.css` imports that package's `base.css`, which paints a
+ * placeholder for a host that loads NO icon font at all:
+ *
+ *     :where(i[class*='fa-'])::before {
+ *       content: var(--ekanos-icon-fallback, '\25a1');
+ *       font-family: ui-sans-serif, system-ui, sans-serif;
+ *       font-weight: 400;
+ *       opacity: 0.55;
+ *     }
+ *
+ * Its comment reasons that `:where()` at (0,0,1) loses to Font Awesome's own
+ * `:is(…)::before` at (0,1,1), so the rule "contributes nothing" the instant a
+ * Font Awesome stylesheet is present. That holds for `content` — the ONLY
+ * property FA declares on the pseudo-element (`content: var(--fa)/""`). It does
+ * NOT hold for `font-family`, `font-weight` or `opacity`: FA declares the family
+ * and weight on the ELEMENT (`.fa-solid { font-family: var(--_fa-family);
+ * font-weight: var(--fa-style, 900) }`), never on `::before`. So those three
+ * declarations have no competitor at pseudo-element level and win regardless of
+ * specificity or cascade layer — a declared value always beats an inherited one.
+ *
+ * Net effect with FA Free loaded: `content` is the CORRECT codepoint (verified
+ * in-browser: U+F043 for `fa-droplet`) but it is painted in `system-ui` at
+ * weight 400, and no system font carries a Private Use Area glyph there — so
+ * every icon rendered as the browser's missing-glyph hex box (a rectangle of
+ * tiny hex digits, which reads as a striped/barcode box) at 55% opacity.
+ *
+ * Handing the pseudo-element back to `inherit` restores FA's own family and
+ * weight off the `<i>`, which is correct for solid, regular AND brands without
+ * naming a family here. `:is()` at (0,1,0) beats the `:where()` it undoes, and
+ * being unlayered it also outranks the `layer(base)` base.css is imported into.
+ *
+ * This lives here, not in `@ekanos/ui`, because the placeholder is correct for
+ * the case it was written for — a host with no icon font. It is only wrong for a
+ * host that HAS one, which is this app. */
+:is(
+  .fa,
+  .fas,
+  .far,
+  .fab,
+  .fa-solid,
+  .fa-regular,
+  .fa-brands,
+  .fa-classic,
+  .fa-light,
+  .fa-thin,
+  .fa-duotone,
+  .fa-sharp
+)::before {
+  font-family: inherit;
+  font-weight: inherit;
+  opacity: 1;
+}
+/* The Pro-only FAMILY classes get no `font-family` from the Free stylesheet at
+ * all, so an `<i class="fa-light fa-spinner">` falls back to the body font and
+ * renders tofu even when `--fa` holds a codepoint Free ships.
+ * `IconStyleOverrideProvider value="solid"` in `RootLayout` rewrites these
+ * for everything under it, but it cannot reach an icon rendered outside that
+ * subtree — and `@ekanos/ui`'s own `Spinner` hardcodes `fa-light fa-spinner`. Pin
+ * them to the one weight Free actually ships so they degrade to the solid face
+ * instead of vanishing. Family is spelled out because `--_fa-family` is set by
+ * the very FA rule that does not match these classes. */
+i:is(.fa-light, .fa-thin, .fa-duotone, .fa-sharp) {
+  font-family: 'Font Awesome 7 Free';
+  font-weight: 900;
+}
+/* ── Pro glyph names → their nearest Free equivalent ──────────────────────────
+ *
+ * The `--fa: '\f059'` rule above is the LAST resort: it keeps an unknown glyph
+ * legible as a question mark instead of collapsing the layout. But a wall of
+ * question marks is its own kind of broken-looking, and several of the Pro
+ * names our example integrations use have an obvious Free counterpart that
+ * carries the same meaning.
+ *
+ * Aliasing those by codepoint here is strictly better than the question mark
+ * and strictly honest about what it is: an APPROXIMATION for the Free build.
+ * `fa-cloud` is not `fa-clouds` and `fa-sun` is not `fa-sun-bright` — in
+ * production, where Fusion loads Font Awesome Pro, the real Pro rule is (0,1,0)
+ * and lives in an unlayered vendor sheet, so it wins over the `i.fa-*` selectors
+ * below and the authored Pro glyph renders exactly as designed. Nothing here
+ * changes what a correctly licensed host shows.
+ *
+ * Keep this list to names our own bundled examples actually reference; it is a
+ * courtesy for the demo surfaces, not a general-purpose Pro→Free shim. */
+i.fa-sun-bright {
+  --fa: '\f185'; /* fa-sun */
+}
+i.fa-moon-stars {
+  --fa: '\f186'; /* fa-moon */
+}
+i.fa-cloud-fog {
+  --fa: '\f75f'; /* fa-smog */
+}
+i.fa-cloud-drizzle {
+  --fa: '\f73d'; /* fa-cloud-rain */
+}
+i.fa-cloud-showers {
+  --fa: '\f740'; /* fa-cloud-showers-heavy */
+}
+i.fa-clouds {
+  --fa: '\f0c2'; /* fa-cloud */
+}
+i.fa-clouds-sun {
+  --fa: '\f6c4'; /* fa-cloud-sun */
+}
+i.fa-clouds-moon {
+  --fa: '\f6c3'; /* fa-cloud-moon */
+}
+i.fa-cloud-question {
+  --fa: '\f059'; /* fa-circle-question */
+}
+i.fa-sparkles {
+  --fa: '\e2ca'; /* fa-wand-magic-sparkles */
+}
+@layer base {
+  body {
+    @apply bg-background text-foreground;
+    font-feature-settings:
+      'rlig' 1,
+      'calt' 1;
+  }
+  *,
+  ::after,
+  ::before,
+  ::backdrop,
+  ::file-selector-button {
+    border-color: var(--border, currentColor);
+  }
+  input::placeholder,
+  textarea::placeholder {
+    color: theme(--color-muted-foreground);
+  }
+  @media (prefers-reduced-motion: reduce) {
+    *,
+    ::before,
+    ::after {
+      animation-duration: 0.01ms !important;
+      animation-iteration-count: 1 !important;
+      transition-duration: 0.01ms !important;
+    }
+  }
+}
+/*
+ * Mirrors the host: shadcn inputs default to a transparent fill, which
+ * disappears against the off-white page background.
+ */
+input.border-input,
+textarea.border-input {
+  background-color: var(--card);
+}

package/package.json ADDED Viewed

@@ -0,0 +1,101 @@
+{
+  "name": "@ekanos/harness",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "The Ekanos integration dev harness — every surface of an integration rendered in real Fusion chrome, from fixtures, with no Supabase, auth or network.",
+  "license": "MIT",
+  "bugs": {
+    "email": "npm@govastly.com"
+  },
+  "sideEffects": [
+    "**/*.css",
+    "**/i18n.js"
+  ],
+  "ekanos": {
+    "shellContract": 1
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "default": "./dist/registry.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./app": {
+      "types": "./dist/app.d.ts",
+      "default": "./dist/app.js"
+    },
+    "./routes": {
+      "types": "./dist/routes.d.ts",
+      "default": "./dist/routes.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./mocks/team-account-workspace": {
+      "types": "./dist/mocks/team-account-workspace.d.ts",
+      "default": "./dist/mocks/team-account-workspace.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fortawesome/fontawesome-free": "^7.3.1",
+    "i18next": "25.10.10",
+    "next-themes": "0.4.6",
+    "react-i18next": "^16.6.6",
+    "tw-animate-css": "1.4.0"
+  },
+  "peerDependencies": {
+    "@ekanos/sdk": "^0.1.2",
+    "@ekanos/ui": "^0.1.2",
+    "@tanstack/react-query": "^5.101.4",
+    "next": "^16.0.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "tailwindcss": "^4.0.0"
+  },
+  "devDependencies": {
+    "@ekanos/sdk": "0.1.2",
+    "@ekanos/ui": "0.1.2",
+    "@kit/eslint-config": "0.2.0",
+    "@kit/prettier-config": "0.1.0",
+    "@kit/tsconfig": "0.1.0",
+    "@tailwindcss/postcss": "4.3.3",
+    "@tanstack/react-query": "5.102.8",
+    "@types/node": "25.0.1",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.5",
+    "next": "16.3.3",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "tailwindcss": "4.3.3",
+    "tsup": "8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "4.1.10",
+    "zod": "3.25.76"
+  },
+  "prettier": "@kit/prettier-config",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/*"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json && node scripts/rewrite-esm-specifiers.mjs && node scripts/build-css.mjs",
+    "clean": "git clean -xdf .turbo node_modules dist",
+    "format": "prettier --check \"**/*.{ts,tsx,mjs}\"",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config vitest.config.ts",
+    "pack:test": "node scripts/pack-test.mjs"
+  }
+}