@signhify/web 0.0.0-stage → 0.3.2

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# @signhify/web
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Web components and UI primitives for Signhify documentation and landing experiences.
+
+## Features
+
+- **TerminalPreview**: Interactive terminal simulator demonstrating agent workflows and streaming execution in web browsers.
+- **InstallCommandBar**: One-click install snippet copy bar supporting npm, Homebrew, curl, and PowerShell commands.
+
+## License
+
+MIT

package/dist/__tests__/terminal-preview.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-preview.test.d.ts.map

package/dist/__tests__/terminal-preview.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-preview.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/terminal-preview.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/terminal-preview.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect } from 'vitest';
+import { generateTerminalPreviewMarkup, MOCK_SESSION_FIXTURE } from '../components/TerminalPreview.js';
+// The fixture is a real transcript captured from the mock provider:
+//   SIGNHIFY_MOCK_PROVIDER=1 node packages/cli/dist/index.js \
+//     run "Does <script>& x>y pipeline work?" --output json
+const fixture = MOCK_SESSION_FIXTURE;
+describe('generateTerminalPreviewMarkup', () => {
+    it('renders every fixture transcript line', () => {
+        const markup = generateTerminalPreviewMarkup({ transcript: fixture });
+        // Fixture content is escaped in output, so compare against the escaped form.
+        const escape = (value) => value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
+        for (const line of fixture) {
+            expect(markup).toContain(escape(line.content));
+        }
+        expect(markup).toContain('data-role="user"');
+        expect(markup).toContain('data-role="assistant"');
+    });
+    it('escapes <, >, & in transcript content (no injection)', () => {
+        const markup = generateTerminalPreviewMarkup({ transcript: fixture });
+        // Hostile chars from the real prompt must be escaped, not raw.
+        expect(markup).not.toContain('<script>');
+        expect(markup).toContain('&lt;script&gt;');
+        expect(markup).toContain('&amp;');
+        expect(markup).toContain('&gt;');
+    });
+    it('bar content rides on trusted props, not transcript input', () => {
+        const markup = generateTerminalPreviewMarkup({
+            mode: 'plan',
+            activeRouter: 'groq-cloud (fallback)',
+            contextUsagePct: 41,
+            transcript: [],
+        });
+        expect(markup).toContain('PLAN');
+        expect(markup).toContain('groq-cloud (fallback)');
+        expect(markup).toContain('Context: 41%');
+    });
+});
+//# sourceMappingURL=terminal-preview.test.js.map

package/dist/__tests__/terminal-preview.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-preview.test.js","sourceRoot":"","sources":["../../src/__tests__/terminal-preview.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAEvG,oEAAoE;AACpE,+DAA+D;AAC/D,4DAA4D;AAC5D,MAAM,OAAO,GAAG,oBAAoB,CAAC;AAErC,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,6BAA6B,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtE,6EAA6E;QAC7E,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAC/B,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAEjF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,6BAA6B,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtE,+DAA+D;QAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,6BAA6B,CAAC;YAC3C,IAAI,EAAE,MAAM;YACZ,YAAY,EAAE,uBAAuB;YACrC,eAAe,EAAE,EAAE;YACnB,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/components/InstallCommandBar.d.ts

@@ -0,0 +1,4 @@
+export type PackageManager = 'curl' | 'powershell' | 'npm' | 'pnpm' | 'bun';
+export declare const INSTALL_COMMANDS: Record<PackageManager, string>;
+export declare function getInstallCommand(pm: PackageManager): string;
+//# sourceMappingURL=InstallCommandBar.d.ts.map

package/dist/components/InstallCommandBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallCommandBar.d.ts","sourceRoot":"","sources":["../../src/components/InstallCommandBar.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAM3D,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAE5D"}

package/dist/components/InstallCommandBar.js

@@ -0,0 +1,11 @@
+export const INSTALL_COMMANDS = {
+    curl: 'curl -fsSL https://signhify-cli.vercel.app/install.sh | bash',
+    powershell: 'irm https://signhify-cli.vercel.app/install.ps1 | iex',
+    npm: 'npm install -g @signhify/cli',
+    pnpm: 'pnpm add -g @signhify/cli',
+    bun: 'bun add -g @signhify/cli',
+};
+export function getInstallCommand(pm) {
+    return INSTALL_COMMANDS[pm] || INSTALL_COMMANDS.curl;
+}
+//# sourceMappingURL=InstallCommandBar.js.map

package/dist/components/InstallCommandBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallCommandBar.js","sourceRoot":"","sources":["../../src/components/InstallCommandBar.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,IAAI,EAAE,8DAA8D;IACpE,UAAU,EAAE,uDAAuD;IACnE,GAAG,EAAE,8BAA8B;IACnC,IAAI,EAAE,2BAA2B;IACjC,GAAG,EAAE,0BAA0B;CAChC,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,EAAkB;IAClD,OAAO,gBAAgB,CAAC,EAAE,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC;AACvD,CAAC"}

package/dist/components/TerminalPreview.d.ts

@@ -0,0 +1,14 @@
+export interface TerminalTranscriptLine {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface TerminalPreviewProps {
+    title?: string;
+    mode?: 'build' | 'plan';
+    activeRouter?: string;
+    contextUsagePct?: number;
+    transcript?: TerminalTranscriptLine[];
+}
+export declare const MOCK_SESSION_FIXTURE: TerminalTranscriptLine[];
+export declare function generateTerminalPreviewMarkup(props?: TerminalPreviewProps): string;
+//# sourceMappingURL=TerminalPreview.d.ts.map

package/dist/components/TerminalPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalPreview.d.ts","sourceRoot":"","sources":["../../src/components/TerminalPreview.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACvC;AASD,eAAO,MAAM,oBAAoB,EAAE,sBAAsB,EAGxD,CAAC;AAYF,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAyBlF"}

package/dist/components/TerminalPreview.js

@@ -0,0 +1,45 @@
+// Fixture transcript from a real capture:
+//   SIGNHIFY_MOCK_PROVIDER=1 node packages/cli/dist/index.js \
+//     run "Does <script>& x>y pipeline work?" --output json
+// The user line is the CLI-reported task; the assistant line is the mock
+// adapter's fixed response (packages/providers/src/adapter.ts). The hostile
+// characters come straight from the user prompt, which is why the escaping
+// below is testable against real input rather than a synthetic string.
+export const MOCK_SESSION_FIXTURE = [
+    { role: 'user', content: 'Does <script>& x>y pipeline work?' },
+    { role: 'assistant', content: 'Task completed successfully by mock provider.' },
+];
+// Attribute context only — never interpolates raw content into tags.
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&amp;') // ampersand first so entities survive
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+export function generateTerminalPreviewMarkup(props) {
+    const mode = props?.mode ?? 'build';
+    const router = props?.activeRouter ?? '9router (port 20128)';
+    const usage = props?.contextUsagePct ?? 62;
+    const transcript = props?.transcript ?? [];
+    const transcriptMarkup = transcript
+        .map((line) => {
+        const attrs = `data-role="${escapeHtml(line.role)}"`;
+        return `  <div class="tp-line" ${attrs}>${escapeHtml(line.content)}</div>`;
+    })
+        .join('\n');
+    return `
+<div class="terminal-preview" data-mode="${mode}" data-router="${router}">
+  <div class="terminal-bar">
+    <span class="badge ${mode}">${mode.toUpperCase()}</span>
+    <span class="router-info">${router}</span>
+    <span class="context-meter">Context: ${usage}%</span>
+  </div>
+  <div class="terminal-transcript">
+${transcriptMarkup}
+  </div>
+</div>
+  `.trim();
+}
+//# sourceMappingURL=TerminalPreview.js.map

package/dist/components/TerminalPreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalPreview.js","sourceRoot":"","sources":["../../src/components/TerminalPreview.ts"],"names":[],"mappings":"AAaA,0CAA0C;AAC1C,+DAA+D;AAC/D,4DAA4D;AAC5D,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mCAAmC,EAAE;IAC9D,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,+CAA+C,EAAE;CAChF,CAAC;AAEF,qEAAqE;AACrE,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAE,sCAAsC;SAChE,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAA4B;IACxE,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,OAAO,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,EAAE,YAAY,IAAI,sBAAsB,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,EAAE,eAAe,IAAI,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,KAAK,EAAE,UAAU,IAAI,EAAE,CAAC;IAE3C,MAAM,gBAAgB,GAAG,UAAU;SAChC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,cAAc,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QACrD,OAAO,0BAA0B,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC7E,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;2CACkC,IAAI,kBAAkB,MAAM;;yBAE9C,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE;gCACpB,MAAM;2CACK,KAAK;;;EAG9C,gBAAgB;;;GAGf,CAAC,IAAI,EAAE,CAAC;AACX,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { type TerminalPreviewProps, generateTerminalPreviewMarkup, } from './components/TerminalPreview.js';
+export { type PackageManager, INSTALL_COMMANDS, getInstallCommand, } from './components/InstallCommandBar.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,KAAK,cAAc,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { generateTerminalPreviewMarkup, } from './components/TerminalPreview.js';
+export { INSTALL_COMMANDS, getInstallCommand, } from './components/InstallCommandBar.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAEL,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC"}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@signhify/web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.2",
+  "description": "Signhify Web Platform and UI preview components",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"const {rmSync,existsSync}=require('fs');['dist','*.tsbuildinfo'].forEach(p=>{if(existsSync(p))rmSync(p,{recursive:true,force:true})})\""
+  },
+  "dependencies": {
+    "@signhify/core": "^0.3.2",
+    "@signhify/providers": "^0.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}