@popmelt.com/core 0.27.1 → 0.28.0

package/dist/taste-proposal-session-XU4N7RUV.mjs

@@ -0,0 +1,2 @@
+"use client";
+export{w as createProposalSession,x as tasteProposalSession}from"./chunk-O4HZP3RP.mjs";import"./chunk-XTOCFTVW.mjs";

package/dist/types-Bur49CLH.d.mts

@@ -0,0 +1,349 @@
+declare const STICKER_COLOR_NAMES: readonly ["slate", "gray", "zinc", "neutral", "stone", "red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "pink", "rose"];
+type StickerColorName = (typeof STICKER_COLOR_NAMES)[number];
+
+declare const STICKER_FAMILIES: readonly ["padding", "margin", "border", "radius", "stack", "grid", "text", "color", "transform", "opacity"];
+type StickerFamily = (typeof STICKER_FAMILIES)[number];
+type StickerSubproperty = 'all' | 'x' | 'y' | 'top' | 'right' | 'bottom' | 'left' | 'top-left' | 'top-right' | 'bottom-right' | 'bottom-left' | 'vertical' | 'horizontal' | 'direction' | 'gap' | 'align' | 'justify' | 'rows' | 'columns' | 'size' | 'weight' | 'line-height' | 'letter-spacing' | 'text-align' | 'color' | 'translate' | 'scale' | 'rotate' | 'opacity' | 'mix-blend' | StickerColorName;
+
+type Provider = 'claude' | 'codex' | 'copilot' | 'omp';
+
+/** Renderer-owned identity for a target that does not exist as a DOM node. */
+type OpaqueTargetReference = {
+    adapter: string;
+    key: string;
+};
+
+/** Local preview protocol. Peers never supply reducer actions or host authority. */
+type PeerAction = {
+    type: 'tokens';
+    family?: StickerFamily;
+    subproperty?: StickerSubproperty;
+} | {
+    type: 'inspect';
+    selector: string;
+    target?: OpaqueTargetReference;
+    properties?: string[];
+    plane?: 'own' | 'host';
+} | {
+    type: 'comment';
+    selector: string;
+    target?: OpaqueTargetReference;
+    text: string;
+} | {
+    type: 'clear';
+    selector: string;
+    kind: 'comment' | 'style' | 'all';
+} | {
+    type: 'style';
+    selector: string;
+    property: string;
+    value: string;
+} | {
+    type: 'style';
+    selector: string;
+    token: string;
+    family?: StickerFamily;
+} | {
+    type: 'attention';
+    selector: string | null;
+    target?: OpaqueTargetReference;
+    activity?: 'looking' | 'working';
+} | {
+    type: 'undo' | 'redo' | 'send' | 'rebase';
+};
+
+/** A capability for a person/agent. Keep out of URLs, logs, and peer snapshots. */
+type ParticipantCredential = {
+    participantId: string;
+    token: string;
+};
+
+/** Browser hosting is replaceable; this boundary owns only local agent enrollment. */
+type ParticipantAgentView = {
+    act(action: PeerAction): Promise<unknown>;
+    close(): Promise<void>;
+};
+type ParticipantAgentAdapter = (credential: ParticipantCredential) => Promise<ParticipantAgentView>;
+
+/** Public endpoints only. Signing keys and credentials never belong here. */
+type CloudTasteEnvironment = 'production' | 'staging';
+
+type ImprintExplanationKind = 'intention' | 'principle' | 'pattern';
+type ImprintExplanationState = 'emerging' | 'testing' | 'grounded' | 'challenged' | 'retired';
+type ImprintScopeKind = 'project' | 'route' | 'component' | 'selector' | 'file';
+type ImprintScope = {
+    kind: ImprintScopeKind;
+    values: string[];
+};
+/** A store-qualified address; abstraction level is intentionally not encoded. */
+type ImprintExplanationRef = {
+    storeId: string;
+    explanationId: string;
+};
+type ImprintEvidence = {
+    id: string;
+    kind: 'observation' | 'application' | 'confirmation' | 'correction' | 'exception' | 'rejection';
+    stance: 'supports' | 'challenges' | 'excepts';
+    summary: string;
+    threadId: string;
+    jobId: string;
+    createdAt: string;
+};
+type ImprintExplanation = {
+    id: string;
+    kind: ImprintExplanationKind;
+    statement: string;
+    rationale: string;
+    scope: ImprintScope;
+    state: ImprintExplanationState;
+    createdAt: string;
+    updatedAt: string;
+    evidence: ImprintEvidence[];
+    supersededBy?: string;
+};
+type ImprintConcrete = {
+    id: string;
+    modelPath: string;
+    value: unknown;
+    createdAt: string;
+    updatedAt: string;
+};
+type ImprintTopologyRelationType = 'expresses' | 'excepts';
+/**
+ * Historical relation names remain readable so append-only Imprint journals can
+ * be replayed. New writers must use ImprintTopologyRelationType.
+ */
+type LegacyImprintRelationType = 'operationalizes' | 'refines' | 'supports' | 'contradicts' | 'instantiates' | 'supersedes';
+type ImprintRelationType = ImprintTopologyRelationType | LegacyImprintRelationType;
+type ImprintRelation = {
+    id: string;
+    type: ImprintRelationType;
+    /** The source explanation is always owned by this relation's store. */
+    fromId: string;
+    /** Omitted for a target in this relation's owning store. */
+    toStoreId?: string;
+    toId: string;
+    rationale: string;
+    createdAt: string;
+};
+type QualifiedImprintRelation = Omit<ImprintRelation, 'fromId' | 'toId' | 'toStoreId'> & {
+    from: ImprintExplanationRef;
+    to: ImprintExplanationRef;
+};
+type ImprintGraph = {
+    version: 1;
+    projectId: string;
+    createdAt: string;
+    updatedAt: string;
+    head: {
+        sequence: number;
+        hash: string | null;
+    };
+    explanations: ImprintExplanation[];
+    concrete: ImprintConcrete[];
+    relations: ImprintRelation[];
+};
+type ImprintMutation = {
+    op: 'add_explanation';
+    explanation: ImprintExplanation;
+} | {
+    op: 'replace_explanation';
+    explanation: ImprintExplanation;
+} | {
+    op: 'remove_explanation';
+    explanationId: string;
+} | {
+    op: 'add_concrete';
+    concrete: ImprintConcrete;
+} | {
+    op: 'remove_concrete';
+    concreteId: string;
+} | {
+    op: 'add_evidence';
+    explanationId: string;
+    evidence: ImprintEvidence;
+} | {
+    op: 'revise_explanation';
+    explanationId: string;
+    patch: Partial<Pick<ImprintExplanation, 'statement' | 'rationale' | 'scope' | 'state' | 'supersededBy'>>;
+    updatedAt: string;
+} | {
+    op: 'add_relation';
+    relation: ImprintRelation;
+} | {
+    op: 'remove_relation';
+    relationId: string;
+};
+type ImprintTransaction = {
+    version: 1;
+    sequence: number;
+    transactionId: string;
+    projectId: string;
+    committedAt: string;
+    previousHash: string | null;
+    hash: string;
+    source: {
+        kind: 'automatic' | 'grounding' | 'correction' | 'migration' | 'undo';
+        threadId: string;
+        jobId: string;
+    };
+    summary: string;
+    mutations: ImprintMutation[];
+    inverseMutations: ImprintMutation[];
+    undoesTransactionId?: string;
+};
+type ImprintSummaryKind = 'added' | 'strengthened' | 'refined' | 'challenged' | 'exception' | 'consolidated';
+type ImprintThreadSummary = {
+    transactionId: string;
+    coalescedTransactionIds?: string[];
+    additionalObservationCount?: number;
+    kind: ImprintSummaryKind;
+    title: string;
+    detail: string;
+    changes: Array<{
+        explanationId: string;
+        action: 'added' | 'revised' | 'supported' | 'challenged' | 'retired' | 'related';
+        statement: string;
+        state: ImprintExplanationState;
+    }>;
+    grounding?: {
+        explanationId: string;
+        question: string;
+        state: 'testing';
+    };
+    resolvedAction?: ImprintGroundingAction;
+};
+type ImprintGroundingAction = 'yes' | 'this_time' | 'no';
+type ImprintContext = {
+    explanations: Array<Pick<ImprintExplanation, 'id' | 'kind' | 'statement' | 'rationale' | 'scope' | 'state'> & {
+        concrete: Array<Pick<ImprintConcrete, 'id' | 'modelPath' | 'value'>>;
+        /** Internal canonical-memory address; omitted from model-facing prompts. */
+        memoryId?: string;
+        storeId?: string;
+        storeRoot?: string;
+        readOnly?: boolean;
+    }>;
+    truncated: boolean;
+    pendingGroundingExplanationIds?: string[];
+    correctionExplanationIds?: string[];
+    relations?: Array<Pick<ImprintRelation, 'id' | 'type' | 'fromId' | 'toId' | 'toStoreId' | 'rationale'> & {
+        /** The store that owns the relation record. */
+        storeId?: string;
+        readOnly?: boolean;
+        /** Present for composed reads; local single-store callers retain fromId/toId. */
+        from?: ImprintExplanationRef;
+        to?: ImprintExplanationRef;
+    }>;
+    /** Explicit target/reference language detected in the current request. */
+    retrievalIntent?: {
+        target: string;
+        reference: string;
+    };
+    /**
+     * Directly relevant rejected history. These are warnings, not active
+     * explanations, and therefore cannot be cited as Imprint usage.
+     */
+    historicalCaveats?: Array<Pick<ImprintExplanation, 'id' | 'kind' | 'statement' | 'rationale' | 'scope' | 'state'> & {
+        storeId?: string;
+        storeRoot?: string;
+        readOnly?: boolean;
+    }>;
+    unavailableStoreIds?: string[];
+    unavailableTopologyStoreIds?: string[];
+};
+type ImprintViewEvidence = {
+    id: string;
+    kind: 'judgment' | 'user_feedback' | 'project_state' | 'other';
+    summary: string;
+    createdAt: string;
+    participantKind: 'human' | 'ai' | 'system' | 'integration' | 'unknown';
+    threadId?: string;
+    jobId?: string;
+};
+type ImprintViewRelation = {
+    id: string;
+    type: ImprintRelationType | 'supersedes';
+    direction: 'outgoing' | 'incoming';
+    explanationId: string;
+    statement: string;
+    rationale: string;
+};
+type ImprintViewExplanation = {
+    id: string;
+    kind: ImprintExplanationKind;
+    state: ImprintExplanationState;
+    statement: string;
+    rationale: string;
+    scope: ImprintScope;
+    createdAt: string;
+    updatedAt: string;
+    evidenceCount: number;
+    recentEvidence: ImprintViewEvidence[];
+    concrete: ImprintConcrete[];
+    relations: ImprintViewRelation[];
+    sourceThreadIds: string[];
+    needsGrounding: boolean;
+};
+/** Human-shaped read model derived exclusively from canonical project memory. */
+type ImprintView = {
+    head: {
+        sequence: number;
+        updatedAt: string;
+    };
+    counts: {
+        total: number;
+        emerging: number;
+        testing: number;
+        grounded: number;
+        challenged: number;
+        retired: number;
+        needsGrounding: number;
+    };
+    explanations: ImprintViewExplanation[];
+};
+
+type PopmeltOptions = {
+    port?: number;
+    projectRoot?: string;
+    tempDir?: string;
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    allowedTools?: string[];
+    claudePath?: string;
+    copilotPath?: string;
+    ompPath?: string;
+    provider?: Provider;
+    timeoutMs?: number;
+    devOrigin?: string;
+    /** Optional Chromium DevTools endpoint, e.g. http://127.0.0.1:9222. */
+    nativeCaptureUrl?: string;
+    restartMode?: 'embedded' | 'detached';
+    /** Requires a proven local host or participant host. Defaults to production; false disables cloud access. */
+    cloudTaste?: false | {
+        environment: CloudTasteEnvironment;
+    };
+    /** Internal opt-in. Collaboration authority is independent of app revisions. */
+    participantSessions?: {
+        /** Optional context metadata. Never used as a save, Send, or approval gate. */
+        sourceRevision?: () => Promise<string>;
+        agentAdapter?: ParticipantAgentAdapter;
+    };
+};
+type PopmeltHandle = {
+    port: number;
+    projectId: string;
+    storeId?: string;
+    /** Trusted local launch/recovery only; never publish this capability in HTML. */
+    participantHost?: () => Promise<ParticipantCredential>;
+    close: () => Promise<void>;
+};
+type MemoryReviewReceipt = {
+    status: 'committed' | 'not_ready' | 'rejected';
+    action: 'accept' | 'edit_and_accept' | 'reject' | 'defer';
+    proposalId: string;
+    decisionId?: string;
+    message: string;
+    headSequence?: number;
+};
+
+export type { ImprintThreadSummary as I, MemoryReviewReceipt as M, ParticipantAgentAdapter as P, QualifiedImprintRelation as Q, ImprintGroundingAction as a, ImprintView as b, ParticipantCredential as c, PopmeltHandle as d, ImprintGraph as e, ImprintTransaction as f, ImprintMutation as g, ImprintContext as h, ImprintSummaryKind as i, ImprintExplanationKind as j, ImprintScope as k, ImprintTopologyRelationType as l, ImprintExplanationRef as m, ImprintRelation as n, PopmeltOptions as o, ImprintConcrete as p, ImprintEvidence as q, ImprintExplanation as r, ImprintExplanationState as s, ImprintRelationType as t, ParticipantAgentView as u };

package/dist/workspace-snapshot-EJQHHDQ4.mjs

@@ -0,0 +1,2 @@
+"use client";
+import{b}from"./chunk-LVEMYZOA.mjs";import{v as k,d as $,o as S}from"./chunk-HGW2U6PD.mjs";function v(r,a){let o=r.filter(e=>(!a.kind||e.kind===a.kind)&&(!a.entryId||e.id===a.entryId)&&(!a.pathname||e.pathname===a.pathname)),t=Number.isInteger(a.limit)?Math.min(50,Math.max(1,a.limit)):20,l=Number.isInteger(a.offset)?Math.max(0,a.offset):0;return{entries:o.slice(l,l+t).map(({details:e,...d})=>a.entryId?{...d,details:e}:d),total:o.length,nextOffset:l+t<o.length?l+t:null}}function I(r,a,o,t=!1){if(!r||!a)return null;let l=i=>{let s=$(i),h=b(i),u=n=>n.width>0&&n.height>0&&n.bottom>0&&n.right>0&&n.top<innerHeight&&n.left<innerWidth;return i.isConnected&&s.width>0&&s.height>0&&(t||u(s)||!!h&&u(h))&&!S(i,'[data-popmelt-private], [aria-hidden="true"]')},e=i=>{try{let s=i?document.querySelectorAll(i):[];return s.length===1?s[0]:null}catch{return null}};if(a.startsWith("thread:")){let i=a.slice(7),s=[...document.querySelectorAll("[data-popmelt-thread-id]")].filter(n=>n.getAttribute("data-popmelt-thread-id")===i&&l(n));if(s.length===1)return s[0].querySelector("[data-popmelt-thread-header]");let h=r.annotations.filter(n=>n.threadId===i&&(!n.pathname||n.pathname===location.pathname)),u=new Set(h.map(n=>n.target?o.resolve(n.target)?.element??null:k(n.linkedSelector,n.elements?.[0])).filter(n=>!!n&&l(n)));return u.size===1?[...u][0]:null}let d=y(r,{entryId:a});if(!("entries"in d)||d.entries.length!==1)return null;let c=d.entries[0];if(c.pathname&&c.pathname!==location.pathname)return null;let m=r.annotations.find(i=>`draft:${i.id}`===a);if(m?.target){let i=o.resolve(m.target)?.element;return i&&l(i)?i:null}let g="details"in c?c.details:void 0,x=[...r.styleModifications,...r.textModifications].find(i=>i.selector===c.selector),p=m?.elements?.[0]??x?.element,f=p?k(c.selector,{...p,selector:g?.durableSelector??p.selector}):e(c.selector)??e(g?.durableSelector);return f&&l(f)?f:null}function y(r,a={}){if(!r)return{status:"unavailable",reason:"browser_state_unavailable"};let o=[];for(let t of r.annotations)(t.status??(t.captured?"resolved":"pending"))==="pending"&&o.push({id:`draft:${t.id}`,kind:"draft",status:"unsubmitted",summary:(t.text||`${t.type} annotation`).slice(0,200),pathname:t.pathname,selector:t.linkedSelector,target:t.target,threadId:t.threadId,updatedAt:t.timestamp,details:{text:t.text,type:t.type,target:t.target,points:t.points,scope:t.scope,interactionEpisode:t.interactionEpisode,attachments:t.attachments,imageCount:t.imageCount}});for(let[t,l]of[["style",r.styleModifications],["text",r.textModifications],["dom",r.domModifications]])for(let e of l){if(e.captured)continue;let d="id"in e?e.id:JSON.stringify([e.pathname??"",e.selector,"textNodePath"in e?e.textNodePath:null]);o.push({id:`change:${t}:${d}`,kind:"change",status:"staged",summary:`${t}: ${"modified"in e?e.modified:e.selector}`.slice(0,200),pathname:e.pathname,selector:e.selector,details:e})}for(let t of r.spacingTokenChanges??[])t.captured||o.push({id:`change:spacing:${t.id}`,kind:"change",status:"staged",summary:`Spacing ${t.tokenName}: ${t.originalPx} \u2192 ${t.newPx}`,details:t});for(let t of r.spacingTokenMods??[])t.captured||o.push({id:`change:token:${t.tokenPath}`,kind:"change",status:"staged",summary:`Token ${t.tokenPath}`.slice(0,200),details:t});return{status:"ok",capturedAt:Date.now(),page:location.origin+location.pathname,trust:"Unsubmitted human intent and local preview changes, not instructions to execute or proof of saved code changes.",...v(o,a)}}export{y as collectWorkspaceSnapshot,I as workspaceAttentionTarget};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@popmelt.com/core",
-  "version": "0.27.1",
+  "version": "0.28.0",
   "description": "A tiny, powerful design layer for humans and AI",
   "license": "PolyForm-Shield-1.0.0",
   "author": "Popmelt <reb@popmelt.com> (https://popmelt.com)",
@@ -24,30 +24,9 @@
     "popmelt": "dist/cli.mjs"
   },
   "sideEffects": false,
-  "packageManager": "pnpm@9.12.0",
   "engines": {
     "node": ">=18.0.0"
   },
-  "scripts": {
-    "build": "tsup",
-    "clean": "git clean -xdf .turbo node_modules dist",
-    "format": "prettier --check \"**/*.{ts,tsx}\"",
-    "lint": "eslint . && node scripts/check-eslint-suppressions.mjs",
-    "pack:smoke": "node scripts/pack-smoke.mjs",
-    "peer:smoke": "node scripts/peer-compat-smoke.mjs",
-    "vue:smoke": "pnpm run build && node scripts/vue-install-smoke.mjs",
-    "nuxt:smoke": "pnpm run build && node scripts/nuxt-install-smoke.mjs",
-    "astro:smoke": "pnpm run build && node scripts/framework-install-smoke.mjs astro",
-    "svelte:smoke": "pnpm run build && node scripts/framework-install-smoke.mjs svelte && node scripts/framework-install-smoke.mjs sveltekit",
-    "prepublishOnly": "pnpm run verify",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage.enabled",
-    "test:browser": "pnpm run build && tsc --noEmit -p tsconfig.browser.json && vitest run --config vitest.browser.config.ts",
-    "test:browser:mutation": "node e2e/check-lifecycle-mutation.mjs",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit --incremental false",
-    "verify": "pnpm run typecheck && pnpm run format && pnpm run lint && pnpm run test:coverage && pnpm run build && pnpm run pack:smoke"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -153,7 +132,6 @@
   },
   "devDependencies": {
     "nuxt": "4.5.2",
-    "@kit/eslint-config": "workspace:^",
     "@react-three/fiber": "9.7.0",
     "@tanstack/react-router": "1.120.5",
     "@types/react": "19.1.0",
@@ -177,6 +155,26 @@
     "vite": "7.3.6",
     "vitest": "3.2.4",
     "vue": "3.5.42",
-    "vue-router": "5.3.1"
+    "vue-router": "5.3.1",
+    "@kit/eslint-config": "^0.2.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "git clean -xdf .turbo node_modules dist",
+    "format": "prettier --check \"**/*.{ts,tsx}\"",
+    "lint": "eslint . && node scripts/check-eslint-suppressions.mjs",
+    "pack:smoke": "node scripts/pack-smoke.mjs",
+    "peer:smoke": "node scripts/peer-compat-smoke.mjs",
+    "vue:smoke": "pnpm run build && node scripts/vue-install-smoke.mjs",
+    "nuxt:smoke": "pnpm run build && node scripts/nuxt-install-smoke.mjs",
+    "astro:smoke": "pnpm run build && node scripts/framework-install-smoke.mjs astro",
+    "svelte:smoke": "pnpm run build && node scripts/framework-install-smoke.mjs svelte && node scripts/framework-install-smoke.mjs sveltekit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage.enabled",
+    "test:browser": "pnpm run build && tsc --noEmit -p tsconfig.browser.json && vitest run --config vitest.browser.config.ts",
+    "test:browser:mutation": "node e2e/check-lifecycle-mutation.mjs",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit --incremental false",
+    "verify": "pnpm run typecheck && pnpm run format && pnpm run lint && pnpm run test:coverage && pnpm run build && pnpm run pack:smoke"
   }
-}
+}