@flyingrobots/bijou 7.2.0 → 8.0.0-rc.1

package/dist/core/standard-blocks/render.part03.d.ts

@@ -0,0 +1,15 @@
+import type { BindingFact } from '../binding.js';
+import { type BlockRenderInput, type BlockRenderResult } from '../block-metadata.js';
+import type { Surface } from '../../ports/surface.js';
+import type { RenderSection } from './render.part01.js';
+export declare function slotValueText(value: unknown): string | undefined;
+declare function renderSection(id: string, label: string, value: unknown, required: boolean): RenderSection;
+declare function ownSlotValue(slots: Readonly<Record<string, unknown>> | undefined, key: string): unknown;
+interface RenderedBlockOptions {
+    readonly output: string | Surface;
+    readonly facts: readonly BindingFact[];
+}
+declare function renderedBlockResult(options: RenderedBlockOptions): BlockRenderResult<string | Surface>;
+export declare function renderAppShellBlock(input: BlockRenderInput): BlockRenderResult<string | Surface>;
+export { ownSlotValue, renderSection, renderedBlockResult };
+//# sourceMappingURL=render.part03.d.ts.map

package/dist/core/standard-blocks/render.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.part03.d.ts","sourceRoot":"","sources":["../../../src/core/standard-blocks/render.part03.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAqB,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAwBhE;AA2BD,iBAAS,aAAa,CACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,OAAO,GAChB,aAAa,CAaf;AAED,iBAAS,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhG;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED,iBAAS,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,iBAAiB,CAAC,MAAM,GAAG,OAAO,CAAC,CAM/F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,MAAM,GAAG,OAAO,CAAC,CAkBhG;AAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/core/standard-blocks/render.part03.js

@@ -0,0 +1,96 @@
+import { isBlockDefinition } from '../block-metadata.js';
+import { isPlainRecord } from './schema-utils.js';
+import { normalizeOutputMode, renderAccessibleSections, renderPipeSections, renderSurfaceBounds, renderVisualSectionsSurface } from './render.part01.js';
+import { isSurfaceSlotValue, renderFacts, surfaceSlotText } from './render.part02.js';
+export function slotValueText(value) {
+    if (value == null) {
+        return undefined;
+    }
+    if (isSurfaceSlotValue(value)) {
+        return surfaceSlotText(value);
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((item) => slotValueText(item))
+            .filter((item) => item !== undefined && item.trim() !== '');
+        return parts.length === 0 ? undefined : parts.join('; ');
+    }
+    if (isBlockDefinition(value)) {
+        return value.metadata.blockName;
+    }
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (typeof value === 'object')
+        return recordSlotText(value);
+    return undefined;
+}
+function recordSlotText(value) {
+    if (!isPlainRecord(value)) {
+        return undefined;
+    }
+    const entries = Object.entries(Object.getOwnPropertyDescriptors(value))
+        .flatMap(([key, descriptor]) => {
+        if (!('value' in descriptor)) {
+            return [];
+        }
+        const text = slotValueText(descriptor.value);
+        return text === undefined ? [] : [`${key}: ${text}`];
+    });
+    return entries.length === 0 ? undefined : entries.join('; ');
+}
+function slotValueVisualContent(value, textContent) {
+    if (isSurfaceSlotValue(value)) {
+        return value;
+    }
+    return textContent;
+}
+function renderSection(id, label, value, required) {
+    const content = slotValueText(value);
+    const visualContent = slotValueVisualContent(value, content);
+    const present = content !== undefined || visualContent !== undefined;
+    const fallbackContent = required ? `(missing required ${id})` : '';
+    return Object.freeze({
+        id,
+        label,
+        content: content ?? fallbackContent,
+        visualContent: visualContent ?? fallbackContent,
+        required,
+        present,
+    });
+}
+function ownSlotValue(slots, key) {
+    if (!isPlainRecord(slots)) {
+        return undefined;
+    }
+    const descriptor = Object.getOwnPropertyDescriptor(slots, key);
+    return descriptor !== undefined && 'value' in descriptor ? descriptor.value : undefined;
+}
+function renderedBlockResult(options) {
+    const facts = Object.freeze(options.facts.map((fact) => Object.freeze({ ...fact })));
+    return Object.freeze({
+        output: options.output,
+        facts,
+    });
+}
+export function renderAppShellBlock(input) {
+    const mode = normalizeOutputMode(input.mode);
+    const sections = [
+        renderSection('navigation', 'Navigation', ownSlotValue(input.slots, 'navigation'), false),
+        renderSection('content', 'Content', ownSlotValue(input.slots, 'content'), true),
+        renderSection('inspector', 'Inspector', ownSlotValue(input.slots, 'inspector'), false),
+        renderSection('status', 'Status', ownSlotValue(input.slots, 'status'), false),
+        renderSection('overlays', 'Overlays', ownSlotValue(input.slots, 'overlays'), false),
+    ].filter((section) => section.required || section.present);
+    return renderedBlockResult({
+        output: mode === 'accessible'
+            ? renderAccessibleSections('AppShell', sections)
+            : mode === 'pipe'
+                ? renderPipeSections('AppShell', sections)
+                : renderVisualSectionsSurface('AppShell', sections, renderSurfaceBounds(input)),
+        facts: renderFacts('AppShell', sections, 'region', mode),
+    });
+}
+export { ownSlotValue, renderSection, renderedBlockResult };
+//# sourceMappingURL=render.part03.js.map

package/dist/core/standard-blocks/render.part03.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.part03.js","sourceRoot":"","sources":["../../../src/core/standard-blocks/render.part03.ts"],"names":[],"mappings":"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"}

package/dist/core/standard-blocks/render.part04.d.ts

@@ -0,0 +1,14 @@
+import type { BlockRenderInput, BlockRenderResult } from '../block-metadata.js';
+import type { Surface } from '../../ports/surface.js';
+import type { StandardBlockName } from './types.js';
+export declare function renderReaderSurfaceBlock(input: BlockRenderInput): BlockRenderResult<string | Surface>;
+export declare function renderInspectorPanelBlock(input: BlockRenderInput): BlockRenderResult<string | Surface>;
+interface StandardSectionSpec {
+    readonly id: string;
+    readonly label: string;
+    readonly required: boolean;
+    readonly description?: string;
+}
+export declare function renderStandardSectionBlock(input: BlockRenderInput, blockName: StandardBlockName, sectionSpecs: readonly StandardSectionSpec[]): BlockRenderResult<string | Surface>;
+export {};
+//# sourceMappingURL=render.part04.d.ts.map

package/dist/core/standard-blocks/render.part04.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.part04.d.ts","sourceRoot":"","sources":["../../../src/core/standard-blocks/render.part04.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,MAAM,GAAG,OAAO,CAAC,CAgBrG;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,MAAM,GAAG,OAAO,CAAC,CAgBtG;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,SAAS,mBAAmB,EAAE,GAC3C,iBAAiB,CAAC,MAAM,GAAG,OAAO,CAAC,CAmBrC"}

package/dist/core/standard-blocks/render.part04.js

@@ -0,0 +1,50 @@
+import { normalizeOutputMode, renderAccessibleSections, renderPipeSections, renderSurfaceBounds, renderVisualSectionsSurface } from './render.part01.js';
+import { renderFacts } from './render.part02.js';
+import { ownSlotValue, renderSection, renderedBlockResult } from './render.part03.js';
+export function renderReaderSurfaceBlock(input) {
+    const mode = normalizeOutputMode(input.mode);
+    const sections = [
+        renderSection('navigation', 'Navigation', ownSlotValue(input.slots, 'navigation'), false),
+        renderSection('content', 'Content', ownSlotValue(input.slots, 'content'), true),
+        renderSection('outline', 'Outline', ownSlotValue(input.slots, 'outline'), false),
+    ].filter((section) => section.required || section.present);
+    return renderedBlockResult({
+        output: mode === 'accessible'
+            ? renderAccessibleSections('ReaderSurface', sections)
+            : mode === 'pipe'
+                ? renderPipeSections('ReaderSurface', sections)
+                : renderVisualSectionsSurface('ReaderSurface', sections, renderSurfaceBounds(input)),
+        facts: renderFacts('ReaderSurface', sections, 'slot', mode),
+    });
+}
+export function renderInspectorPanelBlock(input) {
+    const mode = normalizeOutputMode(input.mode);
+    const sections = [
+        renderSection('selection', 'Selection', ownSlotValue(input.slots, 'selection'), true),
+        renderSection('details', 'Details', ownSlotValue(input.slots, 'details'), false),
+        renderSection('actions', 'Actions', ownSlotValue(input.slots, 'actions'), false),
+    ].filter((section) => section.required || section.present);
+    return renderedBlockResult({
+        output: mode === 'accessible'
+            ? renderAccessibleSections('InspectorPanel', sections)
+            : mode === 'pipe'
+                ? renderPipeSections('InspectorPanel', sections)
+                : renderVisualSectionsSurface('InspectorPanel', sections, renderSurfaceBounds(input)),
+        facts: renderFacts('InspectorPanel', sections, 'slot', mode),
+    });
+}
+export function renderStandardSectionBlock(input, blockName, sectionSpecs) {
+    const mode = normalizeOutputMode(input.mode);
+    const sections = sectionSpecs
+        .map((section) => renderSection(section.id, section.label, ownSlotValue(input.slots, section.id), section.required))
+        .filter((section) => section.required || section.present);
+    return renderedBlockResult({
+        output: mode === 'accessible'
+            ? renderAccessibleSections(blockName, sections)
+            : mode === 'pipe'
+                ? renderPipeSections(blockName, sections)
+                : renderVisualSectionsSurface(blockName, sections, renderSurfaceBounds(input)),
+        facts: renderFacts(blockName, sections, 'slot', mode),
+    });
+}
+//# sourceMappingURL=render.part04.js.map

package/dist/core/standard-blocks/render.part04.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.part04.js","sourceRoot":"","sources":["../../../src/core/standard-blocks/render.part04.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEzJ,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,MAAM,UAAU,wBAAwB,CAAC,KAAuB;IAC9D,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAA6B;QACzC,aAAa,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,KAAK,CAAC;QACzF,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC;QAC/E,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC;KACjF,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,OAAO,mBAAmB,CAAC;QACzB,MAAM,EAAE,IAAI,KAAK,YAAY;YAC3B,CAAC,CAAC,wBAAwB,CAAC,eAAe,EAAE,QAAQ,CAAC;YACrD,CAAC,CAAC,IAAI,KAAK,MAAM;gBACf,CAAC,CAAC,kBAAkB,CAAC,eAAe,EAAE,QAAQ,CAAC;gBAC/C,CAAC,CAAC,2BAA2B,CAAC,eAAe,EAAE,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACxF,KAAK,EAAE,WAAW,CAAC,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAuB;IAC/D,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAA6B;QACzC,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC;QACrF,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC;QAChF,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC;KACjF,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,OAAO,mBAAmB,CAAC;QACzB,MAAM,EAAE,IAAI,KAAK,YAAY;YAC3B,CAAC,CAAC,wBAAwB,CAAC,gBAAgB,EAAE,QAAQ,CAAC;YACtD,CAAC,CAAC,IAAI,KAAK,MAAM;gBACf,CAAC,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,QAAQ,CAAC;gBAChD,CAAC,CAAC,2BAA2B,CAAC,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACzF,KAAK,EAAE,WAAW,CAAC,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;KAC7D,CAAC,CAAC;AACL,CAAC;AASD,MAAM,UAAU,0BAA0B,CACxC,KAAuB,EACvB,SAA4B,EAC5B,YAA4C;IAE5C,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,YAAY;SAC1B,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAC7B,OAAO,CAAC,EAAE,EACV,OAAO,CAAC,KAAK,EACb,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,EACrC,OAAO,CAAC,QAAQ,CACjB,CAAC;SACD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5D,OAAO,mBAAmB,CAAC;QACzB,MAAM,EAAE,IAAI,KAAK,YAAY;YAC3B,CAAC,CAAC,wBAAwB,CAAC,SAAS,EAAE,QAAQ,CAAC;YAC/C,CAAC,CAAC,IAAI,KAAK,MAAM;gBACf,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC;gBACzC,CAAC,CAAC,2BAA2B,CAAC,SAAS,EAAE,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAClF,KAAK,EAAE,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;KACtD,CAAC,CAAC;AACL,CAAC"}

package/dist/core/standard-blocks/schema-helpers.d.ts

@@ -12,7 +12,7 @@ export declare function bindStandardSectionSchemaData(blockName: StandardBlockNa
     input: {
         slots: Record<string, unknown>;
     };
-    facts: import("../mode-lowering.js").ModeLoweringFact[];
+    facts: import("../mode-lowering.part01.js").ModeLoweringFact[];
 };
 export {};
 //# sourceMappingURL=schema-helpers.d.ts.map

package/dist/core/text/grapheme-plain.d.ts

@@ -0,0 +1,25 @@
+export interface SanitizePlainTerminalTextOptions {
+    /**
+     * Preserve literal newlines after sanitization.
+     *
+     * Plain inline content should usually leave this disabled so newlines cannot
+     * escape into single-line surfaces or terminal payloads unexpectedly.
+     */
+    readonly preserveNewlines?: boolean;
+    /** Replacement used when flattening one or more newlines. Defaults to a space. */
+    readonly newlineReplacement?: string;
+    /** Replacement width for literal tabs before flattening. Defaults to 2 spaces. */
+    readonly tabWidth?: number;
+}
+/**
+ * Default boundary for untrusted plain text that will become cells or inline
+ * terminal payloads.
+ *
+ * This strips destructive control sequences, normalizes tabs, and flattens
+ * multiline input unless the caller explicitly opts into preserving newlines.
+ * Callers that intentionally preserve styling should use
+ * {@link sanitizeTerminalText} with allow flags or route through
+ * `parseAnsiToSurface()`.
+ */
+export declare function sanitizePlainTerminalText(str: string, options?: SanitizePlainTerminalTextOptions): string;
+//# sourceMappingURL=grapheme-plain.d.ts.map

package/dist/core/text/grapheme-plain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grapheme-plain.d.ts","sourceRoot":"","sources":["../../../src/core/text/grapheme-plain.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gCAAgC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,kFAAkF;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,gCAAqC,GAC7C,MAAM,CAMR"}

package/dist/core/text/grapheme-plain.js

@@ -0,0 +1,20 @@
+import { sanitizeTerminalText } from './grapheme.part02.js';
+/**
+ * Default boundary for untrusted plain text that will become cells or inline
+ * terminal payloads.
+ *
+ * This strips destructive control sequences, normalizes tabs, and flattens
+ * multiline input unless the caller explicitly opts into preserving newlines.
+ * Callers that intentionally preserve styling should use
+ * {@link sanitizeTerminalText} with allow flags or route through
+ * `parseAnsiToSurface()`.
+ */
+export function sanitizePlainTerminalText(str, options = {}) {
+    const preserveNewlines = options.preserveNewlines ?? false;
+    const newlineReplacement = options.newlineReplacement ?? ' ';
+    const text = sanitizeTerminalText(str, { tabWidth: options.tabWidth });
+    if (preserveNewlines)
+        return text;
+    return text.replace(/\n+/g, newlineReplacement);
+}
+//# sourceMappingURL=grapheme-plain.js.map

package/dist/core/text/grapheme-plain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grapheme-plain.js","sourceRoot":"","sources":["../../../src/core/text/grapheme-plain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAgB5D;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,UAA4C,EAAE;IAE9C,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,KAAK,CAAC;IAC3D,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,GAAG,CAAC;IAC7D,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvE,IAAI,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAClD,CAAC"}

package/dist/core/text/grapheme.d.ts

@@ -1,138 +1,8 @@
-/**
- * Grapheme cluster utilities for correct Unicode text measurement.
- *
- * Uses `Intl.Segmenter` for proper grapheme cluster iteration and a compact
- * lookup for East Asian Wide / emoji display widths.
- */
-/**
- * Determine whether a Unicode code point occupies two terminal columns.
- *
- * Covers:
- * - CJK Unified Ideographs (U+4E00–U+9FFF)
- * - CJK Extension A (U+3400–U+4DBF)
- * - CJK Extension B–I (U+20000–U+3FFFF)
- * - CJK Compatibility Ideographs (U+F900–U+FAFF)
- * - Fullwidth Forms (U+FF01–U+FF60, U+FFE0–U+FFE6)
- * - CJK Radicals / Kangxi (U+2E80–U+2FDF)
- * - CJK Symbols and Punctuation (U+3000–U+303F)
- * - Enclosed CJK Letters (U+3200–U+33FF)
- * - CJK Compatibility (U+FE30–U+FE4F)
- * - Hangul Syllables (U+AC00–U+D7A3)
- * - Emoji (most U+1F000+)
- *
- * @param cp - Unicode code point to test.
- * @returns `true` if the code point renders as two columns wide.
- */
-export declare function isWideChar(cp: number): boolean;
-/**
- * Split a string into an array of grapheme clusters.
- *
- * Each element is a single user-perceived character (handles combining
- * marks, ZWJ sequences, flag pairs, skin tones, etc.).
- *
- * @param str - Input string to segment.
- * @returns Array of grapheme cluster strings.
- */
-export declare function segmentGraphemes(str: string): string[];
-/**
- * Pattern matching ANSI SGR escape sequences (e.g. `\x1b[31m`).
- *
- * Exported for reuse by text utilities that need to strip terminal
- * style escapes before measuring or clipping visible content.
- */
-export declare const ANSI_SGR_RE: RegExp;
-/**
- * Pattern matching OSC 8 hyperlink control sequences.
- *
- * This strips the invisible open/close control segments while preserving the
- * visible linked text between them.
- */
-export declare const ANSI_OSC8_RE: RegExp;
-/**
- * Pattern matching broad ANSI control sequences (CSI, OSC, DCS, APC, etc.).
- *
- * Used for sanitizing untrusted terminal text at string-entry boundaries.
- * SGR and OSC 8 sequences can be temporarily preserved by higher-level helpers
- * when a caller intentionally opts into styled parsing.
- */
-export declare const ANSI_CONTROL_SEQUENCE_RE: RegExp;
-export interface SanitizeTerminalTextOptions {
-    /** Preserve ANSI SGR styling escapes such as `\x1b[31m`. */
-    readonly allowAnsiStyling?: boolean;
-    /** Preserve OSC 8 hyperlink control sequences. */
-    readonly allowHyperlinks?: boolean;
-    /** Replacement width for literal tabs. Defaults to 2 spaces. */
-    readonly tabWidth?: number;
-}
-/**
- * Strip all ANSI SGR escape sequences from a string.
- *
- * @param str - Input string potentially containing ANSI codes.
- * @returns The string with all ANSI SGR sequences removed.
- */
-export declare function stripAnsi(str: string): string;
-/**
- * Sanitize raw terminal text before it crosses into the surface model.
- *
- * Removes destructive ANSI/control sequences and normalizes tabs/newlines so
- * untrusted content cannot inject cursor movement or clear-screen behavior when
- * later rendered back out through {@link surfaceToString} or the diff writer.
- *
- * By default this removes all ANSI sequences. Callers that intentionally parse
- * styled content can preserve SGR and/or OSC 8 sequences with the option flags.
- */
-export declare function sanitizeTerminalText(str: string, options?: SanitizeTerminalTextOptions): string;
-export interface SanitizePlainTerminalTextOptions {
-    /**
-     * Preserve literal newlines after sanitization.
-     *
-     * Plain inline content should usually leave this disabled so newlines cannot
-     * escape into single-line surfaces or terminal payloads unexpectedly.
-     */
-    readonly preserveNewlines?: boolean;
-    /** Replacement used when flattening one or more newlines. Defaults to a space. */
-    readonly newlineReplacement?: string;
-    /** Replacement width for literal tabs before flattening. Defaults to 2 spaces. */
-    readonly tabWidth?: number;
-}
-/**
- * Default boundary for untrusted plain text that will become cells or inline
- * terminal payloads.
- *
- * This strips destructive control sequences, normalizes tabs, and flattens
- * multiline input unless the caller explicitly opts into preserving newlines.
- * Callers that intentionally preserve styling should use
- * {@link sanitizeTerminalText} with allow flags or route through
- * `parseAnsiToSurface()`.
- */
-export declare function sanitizePlainTerminalText(str: string, options?: SanitizePlainTerminalTextOptions): string;
-/**
- * Compute the terminal display width of a single grapheme cluster.
- *
- * The width is determined by the widest code point in the cluster:
- * - East Asian Wide / Fullwidth characters → 2
- * - Emoji (U+1F300+) → 2
- * - Everything else (ASCII, Latin, combining marks, etc.) → 1
- *
- * Zero-width characters (combining marks, ZWJ, variation selectors)
- * don't add width on their own — they're part of the cluster.
- *
- * @param grapheme - A single grapheme cluster string.
- * @returns Display width: 1 for narrow characters, 2 for wide/emoji.
- */
-export declare function graphemeClusterWidth(grapheme: string): number;
-/**
- * Compute the terminal display width of a string.
- *
- * Strip ANSI escape sequences, segment into grapheme clusters,
- * and sum display widths. Correctly handles:
- * - Multi-codepoint emoji (flags, ZWJ families, skin tones)
- * - East Asian Wide characters (CJK, fullwidth forms)
- * - Combining marks (accented characters)
- * - ANSI escape sequences (ignored)
- *
- * @param str - Input string, may contain ANSI escape sequences.
- * @returns Total display width in terminal columns.
- */
-export declare function graphemeWidth(str: string): number;
+export { isWideChar } from './grapheme.part01.js';
+export type { SanitizeTerminalTextOptions } from './grapheme.part02.js';
+export { segmentGraphemes, ANSI_SGR_RE, ANSI_OSC8_RE, ANSI_CONTROL_SEQUENCE_RE, stripAnsi, sanitizeTerminalText, } from './grapheme.part02.js';
+export type { SanitizePlainTerminalTextOptions } from './grapheme-plain.js';
+export { sanitizePlainTerminalText } from './grapheme-plain.js';
+export { graphemeClusterWidth } from './grapheme.part03.js';
+export { graphemeWidth } from './grapheme.part04.js';
 //# sourceMappingURL=grapheme.d.ts.map

package/dist/core/text/grapheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grapheme.d.ts","sourceRoot":"","sources":["../../../src/core/text/grapheme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAmD9C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOtD;AAMD;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,QAAmB,CAAC;AAE5C;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,QAAyC,CAAC;AAEnE;;;;;;GAMG;AAEH,eAAO,MAAM,wBAAwB,QAAmG,CAAC;AAEzI,MAAM,WAAW,2BAA2B;IAC1C,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,kDAAkD;IAClD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,2BAAgC,GACxC,MAAM,CAoBR;AAED,MAAM,WAAW,gCAAgC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,kFAAkF;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,gCAAqC,GAC7C,MAAM,CAMR;AAmCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwB7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUjD"}
+{"version":3,"file":"grapheme.d.ts","sourceRoot":"","sources":["../../../src/core/text/grapheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,wBAAwB,EACxB,SAAS,EACT,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}