@issuegraph/editor 0.1.0

package/dist/firstpass/words.d.ts

@@ -0,0 +1,105 @@
+/**
+ * The words. Supplied by the host, never by this package.
+ *
+ * Same contract `reevaluate/words.ts` and `picker/words.ts` already carry here,
+ * and this surface has the strongest claim on it of the three: what is being
+ * worded is a QUESTION about a relationship, asked of an owner who is about to
+ * answer sixty of them at speed. A phrase written in would be an English clause
+ * in the one place the design says the reader most needs to be sure what they
+ * are agreeing to.
+ *
+ * REQUIRED, NOT DEFAULTED, on the same reasoning `StoreConfig.derive` is
+ * required: a default vocabulary is a second implementation of the thing the
+ * host was asked to supply, and a language choice this package is not entitled
+ * to make. A host that ships a default gets one it cannot theme away and cannot
+ * translate.
+ *
+ * ## Progress is worded by the host too, and that is not an oversight
+ *
+ * §17e is emphatic that "100% encoded is never the goal and the workspace never
+ * implies it is". The number is safe — {@link ./queue.ts queueProgress} cannot
+ * compute the wrong denominator — but the SENTENCE around it is where the
+ * implication would creep back in: "12 of 64 complete" reads as a target where
+ * "12 of 64 answered" reads as an activity. That is a wording decision with a
+ * design consequence, which is exactly the kind this package hands over rather
+ * than makes.
+ */
+import type { Answer } from './queue.ts';
+export interface FirstPassWords {
+    /**
+     * The accessible name of the surface as a whole.
+     *
+     * REQUIRED, and it is the one entry here that exists because of what
+     * `render.ts` REFUSES to do. That module declines to draw a heading, on the
+     * grounds that a heading level is a claim about the HOST's document outline
+     * which a package rendered into an unknown page cannot make. That reasoning
+     * is sound and unchanged — but a `<section>` with neither a heading nor a
+     * label is exposed to a screen reader navigating by landmarks as an unnamed
+     * generic region, so the refusal was quietly costing the reader the ability
+     * to find this surface at all.
+     *
+     * An `aria-label` is the half the package CAN supply without making that
+     * claim: it names the region without asserting where it sits in an outline.
+     * The word is the host's, for the same reason every other word here is.
+     */
+    readonly label: string;
+    /**
+     * One label per answer.
+     *
+     * `Record<Answer, string>` rather than a partial map: an answer with no word
+     * would render a bare control, and the reader would be one keystroke from
+     * consenting to something unlabelled. Adding an answer fails a host's build
+     * here, which is where it can be fixed.
+     */
+    readonly answers: Readonly<Record<Answer, string>>;
+    /**
+     * Names the group of answer controls, for assistive technology.
+     *
+     * ITS OWN ENTRY rather than reusing {@link evidence}, which an earlier
+     * revision did: a group of buttons labelled "Why" tells a screen-reader user
+     * that the three controls are the evidence, which is the opposite of what
+     * they are. The two blocks sit next to each other and name different things,
+     * so they need different words — and a shared one is the sort of label that
+     * looks fine in markup and is wrong only when read aloud.
+     */
+    readonly answersLabel: string;
+    /** The undo control. */
+    readonly undo: string;
+    /**
+     * Names the evidence block — what the host calls the reasons it offered.
+     *
+     * The evidence ITEMS are the host's own sentences already
+     * ({@link ./candidates.ts CandidateEvidence}); this words the container they
+     * sit in, which is the only part of that block this package draws.
+     */
+    readonly evidence: string;
+    /**
+     * Words the progress indicator, given the two numbers.
+     *
+     * A FUNCTION rather than a template string, because the grammar around a
+     * count is not substitutable across languages — plural forms, number
+     * agreement and word order all depend on the values themselves. A
+     * `"{answered} of {found}"` field would work in English and quietly produce
+     * wrong grammar everywhere else, which is the failure this package hands the
+     * whole decision over to avoid.
+     */
+    readonly progress: (answered: number, found: number) => string;
+    /**
+     * Shown when every candidate has been answered.
+     *
+     * NOT AN EMPTY STATE — the finding, in the sense `reevaluate/words.ts` uses
+     * the distinction. A finished first pass is the design's success condition,
+     * and §17e insists it be reachable rather than asymptotic.
+     */
+    readonly finished: string;
+    /**
+     * Shown when the host found no candidates at all.
+     *
+     * DISTINCT FROM {@link finished}, and the distinction matters more than it
+     * looks: "there was nothing to encode" and "you encoded everything" are
+     * different facts about the backlog, and collapsing them would tell an owner
+     * whose detector is misconfigured that they were done.
+     */
+    readonly noCandidates: string;
+}
+//# sourceMappingURL=words.d.ts.map

package/dist/firstpass/words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../../src/firstpass/words.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD;;;;;;;;;OASG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/dist/firstpass/words.js

@@ -0,0 +1,28 @@
+/**
+ * The words. Supplied by the host, never by this package.
+ *
+ * Same contract `reevaluate/words.ts` and `picker/words.ts` already carry here,
+ * and this surface has the strongest claim on it of the three: what is being
+ * worded is a QUESTION about a relationship, asked of an owner who is about to
+ * answer sixty of them at speed. A phrase written in would be an English clause
+ * in the one place the design says the reader most needs to be sure what they
+ * are agreeing to.
+ *
+ * REQUIRED, NOT DEFAULTED, on the same reasoning `StoreConfig.derive` is
+ * required: a default vocabulary is a second implementation of the thing the
+ * host was asked to supply, and a language choice this package is not entitled
+ * to make. A host that ships a default gets one it cannot theme away and cannot
+ * translate.
+ *
+ * ## Progress is worded by the host too, and that is not an oversight
+ *
+ * §17e is emphatic that "100% encoded is never the goal and the workspace never
+ * implies it is". The number is safe — {@link ./queue.ts queueProgress} cannot
+ * compute the wrong denominator — but the SENTENCE around it is where the
+ * implication would creep back in: "12 of 64 complete" reads as a target where
+ * "12 of 64 answered" reads as an activity. That is a wording decision with a
+ * design consequence, which is exactly the kind this package hands over rather
+ * than makes.
+ */
+export {};
+//# sourceMappingURL=words.js.map

package/dist/firstpass/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../../src/firstpass/words.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}

package/dist/index.d.ts

@@ -0,0 +1,150 @@
+/**
+ * `@issuegraph/editor` — everything that mutates an Issuegraph document.
+ *
+ * Layer 2 of the three-layer seam. Its whole contract is a composition:
+ *
+ *     composes  @issuegraph/viewer  (layer 1) — the node, edge and badge grammar
+ *     composes  @issuegraph/store            — the document, the edit set, the port
+ *     never     fetching, auth, persistence, or a write of its own
+ *
+ * An edit is a `Proposal` handed to the store, which dispatches it to the host's
+ * injected `DataSource`. The editor performs none of that itself, which is what
+ * lets it be published: what editing drags in — auth, network, the
+ * fail-or-conflict state machine — is host-shaped and injected.
+ *
+ * ## The seam, and why it is a test rather than a sentence
+ *
+ * Layer 1 and layer 2 ship as separate packages, so the boundary between them is
+ * no longer enforced by a repository line. The design says so in as many words:
+ * the seam "stops being enforced by construction and becomes discipline — layer 2
+ * composes layer 1 through its public surface and never reaches past it."
+ *
+ * Discipline that nothing checks is a comment. The check is in
+ * `eslint.config.mjs`, over the AST: every import of a sibling package must be
+ * its BARE specifier, and `require()` is banned outright because it is the one
+ * call that walks past every import rule. A reach into
+ * `@issuegraph/viewer/src/...` fails lint rather than a code review that might
+ * not happen, and `scripts/eslint-rules.test.mjs` proves the rules fire by
+ * running them against deliberate violations.
+ *
+ * The same config carries the purity claim for this package and the viewer — no
+ * fetch, no storage, no credentials, no Node builtin. `purity.test.ts` keeps the
+ * half no static rule can do: it loads every shipped module with the browser
+ * globals removed, which is what catches a computed access like
+ * `globalThis['fet' + 'ch']`.
+ *
+ * ## The one declared crossing
+ *
+ * The `together-with` connector lives in the VIEWER, not here. A `together-with`
+ * edge must be individually selectable, retypeable and deletable, and an
+ * enclosure has no edge to click — so the connector is a hit target, and only
+ * the layer that computes the layout knows where its endpoints are. Adding it
+ * from out here would mean re-deriving positions layer 1 already has, which is
+ * the drifting second implementation the package split exists to avoid.
+ *
+ * It is written down as a declared crossing rather than discovered later. Treat
+ * it as the precedent for DECLARING a crossing, never as permission for more.
+ *
+ * ## The surface
+ *
+ * The SCALE LADDER, the AUDIT, the RE-EVALUATE SURFACE, the EDGE
+ * MUTATION-STATE OVERLAYS, the TYPE PICKER, the CREATE PATHS, the FIRST PASS
+ * and the THREE-ZONE WORKSPACE that assembles them. This file's shape is
+ * settled: the workspace was the change that decided it.
+ *
+ * The first pass is the first thing here to take a PORT of its own. The create
+ * paths take a target from the host because searching a backlog needs the
+ * backlog; the first pass goes further and takes the whole question set,
+ * because the evidence §17e describes — two bodies referencing one path, a
+ * comment linking an issue — is not derivable from a `GraphDocument` at all. A
+ * heuristic shipped in here would be an un-themeable product opinion inside a
+ * published package, which is the same reason the store fetches nothing.
+ *
+ * The workspace is the assembly leaf, and what it adds is a SEAM rather than
+ * another surface: `renderWorkspace` composes the rail, the ladder and the
+ * audit through the same public entry points a host would use, so nothing here
+ * is re-derived. The two facts it owns are the ones no single leaf could:
+ *
+ *   - ONE SELECTION crosses all three zones. §17b makes `selected` the only edge
+ *     state that also filters the inspector, so the workspace holds exactly one
+ *     value and the zones read it. Three synchronised copies is the shape it
+ *     exists to prevent.
+ *   - THE RAIL IS VIRTUALISED AND THE CANVAS REFUSES, and assembling them must
+ *     not average the two (§17f). The rail's MODEL stays complete at any backlog
+ *     size while its WINDOW is bounded; the ladder keeps the whole document, so
+ *     its budget does not follow the reader's scroll position.
+ *
+ * It is also where the deferred positioning from the leaves below lands: the
+ * audit's left-bar is applied by walking the rail's `ElementSpec` tree, which is
+ * how a mark reaches a row the viewer drew without this package ever splicing a
+ * rendered string.
+ *
+ * The create paths are the first thing here to be shaped by a requirement that
+ * three surfaces be EQUIVALENT rather than merely present. They gather the same
+ * three facts in different orders, so the draft is modelled as a set of slots
+ * rather than a sequence of steps, and there is exactly one emitter — which is
+ * what makes "the inspector is not a fallback" structural instead of a promise.
+ * The only thing that genuinely differs between them is where the picker is
+ * drawn, and that is geometry rather than state.
+
+ *
+ * The picker is the first thing here to compose @issuegraph/core directly. The
+ * split between directed and symmetric relationships is a fact about the
+ * FORMAT, and core owns it; a local list out here would be the drifting second
+ * implementation the package family removes everywhere else. Core is the layer
+ * both siblings already sit on, and the seam refuses a sibling's SUBPATH rather
+ * than its bare specifier, so reaching for the shared foundation is not
+ * reaching past a surface.
+ *
+ * The re-evaluate surface is the first thing here to compose the STORE as well
+ * as the viewer — it presents `diffOrder`'s output and computes no diff of its
+ * own — and the first to require words from its host rather than writing them.
+ *
+ * The overlays are the first to compose the store's PROJECTION, and they draw
+ * only what reuses a path's own position: a halo, a ghost, a dash. Anything
+ * needing a new position — the chips, the ✕, the inline reason, a conflict's
+ * second version — is declared as a mark for the layer that computed the
+ * layout. The workspace is that layer, and it landed.
+ *
+ * A published package can add an export later and can never take one back, so
+ * nothing is exported before something is owed.
+ *
+ * @see https://github.com/autnmy/issuegraph/blob/main/SPEC.md
+ */
+export type { AuditClass, AuditClassSpec, AuditFinding, AuditGraph, AuditInput, AuditSeverity, EncodingRefusal, } from './audit/findings.ts';
+export { AUDIT_CLASSES, AUDIT_CLASS_SPECS, auditDocument } from './audit/findings.ts';
+export type { AuditHeaderOptions, AuditOverlay, AuditRow } from './audit/surface.ts';
+export { AUDIT_COUNT_ATTRIBUTE, AUDIT_FILTER_ATTRIBUTE, AUDIT_SEVERITY_ATTRIBUTE, auditFilterKeeps, auditOverlay, auditRowAttributes, renderAuditHeader, } from './audit/surface.ts';
+export { auditStylesheet } from './audit/styles.ts';
+export { INITIAL_SCALE_STATE, type ScaleCommand, type ScaleState, scaleReducer, } from './scale/commands.ts';
+export { type IsolatedChip, type ScaleCapsule, type ScaleLadder, type ScaleMatch, type ScaleRefusal, type ScaleRoute, type ScaleRouteKind, type ScaleSearch, type ScaleTier, scaleLadder, } from './scale/ladder.ts';
+export { type ScaleLadderOptions, type ScaleLadderResult, renderScaleLadder, } from './scale/render.ts';
+export { scaleLadderStylesheet } from './scale/styles.ts';
+export { OVERLAY_TREATMENTS, STATE_ATTRIBUTE, type EdgeOverlay, type OverlayAffordance, type OverlayDash, type OverlayMark, type OverlayStroke, type OverlayTreatment, overlayFor, overlayLabel, treatmentForState, } from './overlay/grammar.ts';
+export { OVERLAY_CLASS, type AttachResult, type OverlayOptions, attachEdgeOverlays, renderOverlayMark, } from './overlay/render.ts';
+export { edgeOverlayStylesheet } from './overlay/styles.ts';
+export { type DirectionStatement, type FlipControl, type KindOption, type PickerView, pickerView, } from './picker/view.ts';
+export { type PickerWords } from './picker/words.ts';
+export { type PickerOptions, type PickerResult, renderPicker, } from './picker/render.ts';
+export { pickerStylesheet } from './picker/styles.ts';
+export { type CreateCommand, type CreateDraft, type CreateResult, IDLE_CREATE_DRAFT, createReducer, } from './create/draft.ts';
+export { type CreateInteraction, type KeyIntent, type KeyPress, type KeyboardContext, keyIntent, } from './create/keys.ts';
+export { type Bounds, type PickerPlacement, type Point, type Size, pickerPlacement, } from './create/placement.ts';
+export { type ChangeFacet, type ChangeSummary, type PlacedChip, type ReevaluateView, type SummaryPart, CHANGE_FACETS, reevaluateView, summaryOf, } from './reevaluate/view.ts';
+export { type ChangeWords } from './reevaluate/words.ts';
+export { type ReevaluateOptions, type ReevaluateResult, renderReevaluate, } from './reevaluate/render.ts';
+export { reevaluateStylesheet } from './reevaluate/styles.ts';
+export type { Candidate, CandidateEvidence, CandidateId, CandidateSource, } from './firstpass/candidates.ts';
+export { type Answer, type Answered, type QueueCommand, type QueueProgress, type QueueResult, type QueueState, currentCandidate, isAnswered, openQueue, queueProgress, queueReducer, skippedCandidates, } from './firstpass/queue.ts';
+export { type BatchDirection, type BatchOutcome, type BatchPlan, type BatchRefusal, type BatchRequest, type BatchSettlement, planBatch, resumeBatch, } from './firstpass/batch.ts';
+export { type FirstPassContext, type FirstPassInteraction, type FirstPassIntent, firstPassIntent, } from './firstpass/keys.ts';
+export { type FirstPassQuestion, type FirstPassView, firstPassView, } from './firstpass/view.ts';
+export { type FirstPassWords } from './firstpass/words.ts';
+export { ANSWERED_ATTRIBUTE, ANSWER_ATTRIBUTE, COMMAND_ATTRIBUTE, EVIDENCE_TOKEN_ATTRIBUTE, FOUND_ATTRIBUTE, type FirstPassOptions, type FirstPassResult, renderFirstPass, } from './firstpass/render.ts';
+export { firstPassStylesheet } from './firstpass/styles.ts';
+export { type SelectionCommand, type WorkspaceSelection, INITIAL_SELECTION, selectedEdgeId, selectedKey, selectionReducer, } from './workspace/selection.ts';
+export { type RailWindow, type RailWindowOptions, RAIL_WINDOW, railWindow, } from './workspace/rail.ts';
+export { type InspectorPosition, type InspectorRelationship, type InspectorView, inspectorView, } from './workspace/inspector.ts';
+export { type Zone, type WorkspaceOptions, type WorkspaceResult, type WorkspaceView, type WorkspaceWords, ZONES, renderWorkspace, } from './workspace/render.ts';
+export { workspaceStylesheet } from './workspace/styles.ts';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgHG;AAEH,YAAY,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEtF,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EACL,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,UAAU,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,KAAK,IAAI,EACT,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,aAAa,EACb,cAAc,EACd,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,SAAS,EACT,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,WAAW,EACX,UAAU,GACX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,KAAK,IAAI,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,EACL,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,147 @@
+/**
+ * `@issuegraph/editor` — everything that mutates an Issuegraph document.
+ *
+ * Layer 2 of the three-layer seam. Its whole contract is a composition:
+ *
+ *     composes  @issuegraph/viewer  (layer 1) — the node, edge and badge grammar
+ *     composes  @issuegraph/store            — the document, the edit set, the port
+ *     never     fetching, auth, persistence, or a write of its own
+ *
+ * An edit is a `Proposal` handed to the store, which dispatches it to the host's
+ * injected `DataSource`. The editor performs none of that itself, which is what
+ * lets it be published: what editing drags in — auth, network, the
+ * fail-or-conflict state machine — is host-shaped and injected.
+ *
+ * ## The seam, and why it is a test rather than a sentence
+ *
+ * Layer 1 and layer 2 ship as separate packages, so the boundary between them is
+ * no longer enforced by a repository line. The design says so in as many words:
+ * the seam "stops being enforced by construction and becomes discipline — layer 2
+ * composes layer 1 through its public surface and never reaches past it."
+ *
+ * Discipline that nothing checks is a comment. The check is in
+ * `eslint.config.mjs`, over the AST: every import of a sibling package must be
+ * its BARE specifier, and `require()` is banned outright because it is the one
+ * call that walks past every import rule. A reach into
+ * `@issuegraph/viewer/src/...` fails lint rather than a code review that might
+ * not happen, and `scripts/eslint-rules.test.mjs` proves the rules fire by
+ * running them against deliberate violations.
+ *
+ * The same config carries the purity claim for this package and the viewer — no
+ * fetch, no storage, no credentials, no Node builtin. `purity.test.ts` keeps the
+ * half no static rule can do: it loads every shipped module with the browser
+ * globals removed, which is what catches a computed access like
+ * `globalThis['fet' + 'ch']`.
+ *
+ * ## The one declared crossing
+ *
+ * The `together-with` connector lives in the VIEWER, not here. A `together-with`
+ * edge must be individually selectable, retypeable and deletable, and an
+ * enclosure has no edge to click — so the connector is a hit target, and only
+ * the layer that computes the layout knows where its endpoints are. Adding it
+ * from out here would mean re-deriving positions layer 1 already has, which is
+ * the drifting second implementation the package split exists to avoid.
+ *
+ * It is written down as a declared crossing rather than discovered later. Treat
+ * it as the precedent for DECLARING a crossing, never as permission for more.
+ *
+ * ## The surface
+ *
+ * The SCALE LADDER, the AUDIT, the RE-EVALUATE SURFACE, the EDGE
+ * MUTATION-STATE OVERLAYS, the TYPE PICKER, the CREATE PATHS, the FIRST PASS
+ * and the THREE-ZONE WORKSPACE that assembles them. This file's shape is
+ * settled: the workspace was the change that decided it.
+ *
+ * The first pass is the first thing here to take a PORT of its own. The create
+ * paths take a target from the host because searching a backlog needs the
+ * backlog; the first pass goes further and takes the whole question set,
+ * because the evidence §17e describes — two bodies referencing one path, a
+ * comment linking an issue — is not derivable from a `GraphDocument` at all. A
+ * heuristic shipped in here would be an un-themeable product opinion inside a
+ * published package, which is the same reason the store fetches nothing.
+ *
+ * The workspace is the assembly leaf, and what it adds is a SEAM rather than
+ * another surface: `renderWorkspace` composes the rail, the ladder and the
+ * audit through the same public entry points a host would use, so nothing here
+ * is re-derived. The two facts it owns are the ones no single leaf could:
+ *
+ *   - ONE SELECTION crosses all three zones. §17b makes `selected` the only edge
+ *     state that also filters the inspector, so the workspace holds exactly one
+ *     value and the zones read it. Three synchronised copies is the shape it
+ *     exists to prevent.
+ *   - THE RAIL IS VIRTUALISED AND THE CANVAS REFUSES, and assembling them must
+ *     not average the two (§17f). The rail's MODEL stays complete at any backlog
+ *     size while its WINDOW is bounded; the ladder keeps the whole document, so
+ *     its budget does not follow the reader's scroll position.
+ *
+ * It is also where the deferred positioning from the leaves below lands: the
+ * audit's left-bar is applied by walking the rail's `ElementSpec` tree, which is
+ * how a mark reaches a row the viewer drew without this package ever splicing a
+ * rendered string.
+ *
+ * The create paths are the first thing here to be shaped by a requirement that
+ * three surfaces be EQUIVALENT rather than merely present. They gather the same
+ * three facts in different orders, so the draft is modelled as a set of slots
+ * rather than a sequence of steps, and there is exactly one emitter — which is
+ * what makes "the inspector is not a fallback" structural instead of a promise.
+ * The only thing that genuinely differs between them is where the picker is
+ * drawn, and that is geometry rather than state.
+
+ *
+ * The picker is the first thing here to compose @issuegraph/core directly. The
+ * split between directed and symmetric relationships is a fact about the
+ * FORMAT, and core owns it; a local list out here would be the drifting second
+ * implementation the package family removes everywhere else. Core is the layer
+ * both siblings already sit on, and the seam refuses a sibling's SUBPATH rather
+ * than its bare specifier, so reaching for the shared foundation is not
+ * reaching past a surface.
+ *
+ * The re-evaluate surface is the first thing here to compose the STORE as well
+ * as the viewer — it presents `diffOrder`'s output and computes no diff of its
+ * own — and the first to require words from its host rather than writing them.
+ *
+ * The overlays are the first to compose the store's PROJECTION, and they draw
+ * only what reuses a path's own position: a halo, a ghost, a dash. Anything
+ * needing a new position — the chips, the ✕, the inline reason, a conflict's
+ * second version — is declared as a mark for the layer that computed the
+ * layout. The workspace is that layer, and it landed.
+ *
+ * A published package can add an export later and can never take one back, so
+ * nothing is exported before something is owed.
+ *
+ * @see https://github.com/autnmy/issuegraph/blob/main/SPEC.md
+ */
+export { AUDIT_CLASSES, AUDIT_CLASS_SPECS, auditDocument } from "./audit/findings.js";
+export { AUDIT_COUNT_ATTRIBUTE, AUDIT_FILTER_ATTRIBUTE, AUDIT_SEVERITY_ATTRIBUTE, auditFilterKeeps, auditOverlay, auditRowAttributes, renderAuditHeader, } from "./audit/surface.js";
+export { auditStylesheet } from "./audit/styles.js";
+export { INITIAL_SCALE_STATE, scaleReducer, } from "./scale/commands.js";
+export { scaleLadder, } from "./scale/ladder.js";
+export { renderScaleLadder, } from "./scale/render.js";
+export { scaleLadderStylesheet } from "./scale/styles.js";
+export { OVERLAY_TREATMENTS, STATE_ATTRIBUTE, overlayFor, overlayLabel, treatmentForState, } from "./overlay/grammar.js";
+export { OVERLAY_CLASS, attachEdgeOverlays, renderOverlayMark, } from "./overlay/render.js";
+export { edgeOverlayStylesheet } from "./overlay/styles.js";
+export { pickerView, } from "./picker/view.js";
+export {} from "./picker/words.js";
+export { renderPicker, } from "./picker/render.js";
+export { pickerStylesheet } from "./picker/styles.js";
+export { IDLE_CREATE_DRAFT, createReducer, } from "./create/draft.js";
+export { keyIntent, } from "./create/keys.js";
+export { pickerPlacement, } from "./create/placement.js";
+export { CHANGE_FACETS, reevaluateView, summaryOf, } from "./reevaluate/view.js";
+export {} from "./reevaluate/words.js";
+export { renderReevaluate, } from "./reevaluate/render.js";
+export { reevaluateStylesheet } from "./reevaluate/styles.js";
+export { currentCandidate, isAnswered, openQueue, queueProgress, queueReducer, skippedCandidates, } from "./firstpass/queue.js";
+export { planBatch, resumeBatch, } from "./firstpass/batch.js";
+export { firstPassIntent, } from "./firstpass/keys.js";
+export { firstPassView, } from "./firstpass/view.js";
+export {} from "./firstpass/words.js";
+export { ANSWERED_ATTRIBUTE, ANSWER_ATTRIBUTE, COMMAND_ATTRIBUTE, EVIDENCE_TOKEN_ATTRIBUTE, FOUND_ATTRIBUTE, renderFirstPass, } from "./firstpass/render.js";
+export { firstPassStylesheet } from "./firstpass/styles.js";
+export { INITIAL_SELECTION, selectedEdgeId, selectedKey, selectionReducer, } from "./workspace/selection.js";
+export { RAIL_WINDOW, railWindow, } from "./workspace/rail.js";
+export { inspectorView, } from "./workspace/inspector.js";
+export { ZONES, renderWorkspace, } from "./workspace/render.js";
+export { workspaceStylesheet } from "./workspace/styles.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgHG;AAWH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGtF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EACL,mBAAmB,EAGnB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAUL,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAGL,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,eAAe,EAOf,UAAU,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EAGb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAKL,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAoB,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAGL,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAIL,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAKL,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAKL,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAML,aAAa,EACb,cAAc,EACd,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAoB,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAGL,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAU9D,OAAO,EAOL,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAOL,SAAS,EACT,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAIL,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAGL,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAuB,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EAGf,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAGL,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAGL,WAAW,EACX,UAAU,GACX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAIL,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAML,KAAK,EACL,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}