@flyingrobots/bijou 7.0.0 → 7.1.0

package/README.md

@@ -78,6 +78,8 @@ fake duplication rather than a real second API.
 
 ### Theme Authoring
 - **`extendTheme()`**: Build a custom theme from a known-good preset.
+- **`defineThemeSafePairs()`**: Declare reusable foreground/background
+  contrast matrices for `doctorTheme()` and inspector surfaces.
 - **`doctorTheme()`**: Structured checks for invalid colors, weak contrast,
   and suspicious token reuse.
 - **`themeContrastRatio()`**: Deterministic foreground/background contrast

package/dist/core/graphql-bijou-block.d.ts

@@ -0,0 +1,94 @@
+import { type UiLayoutIntent, type UiSceneIr, type UiSceneLoweringOptions, type UiSceneLowerMode, type UiSourceMapEntry, type UiStyleRef, type UiTargetProfile, type UiTextRef } from './ui-scene-ir.js';
+export declare const BIJOU_BLOCK_ARTIFACT_VERSION: "bijou-block/1";
+export declare const GRAPHQL_BIJOU_BLOCK_DEBUG_SUMMARY_VERSION: "graphql-bijou-block-debug/1";
+export type BijouBlockArtifactVersion = typeof BIJOU_BLOCK_ARTIFACT_VERSION;
+export type GraphqlBijouBlockDebugSummaryVersion = typeof GRAPHQL_BIJOU_BLOCK_DEBUG_SUMMARY_VERSION;
+export interface CompileGraphqlBijouBlockOptions {
+    readonly sourceName?: string;
+}
+export interface BijouBlockFieldAction {
+    readonly id: string;
+    readonly command: string;
+    readonly keybindings: readonly string[];
+}
+export interface BijouBlockFieldBinding {
+    readonly id: string;
+    readonly targetProperty: string;
+    readonly source: {
+        readonly kind: 'state' | 'query' | 'computed';
+        readonly path: string;
+    };
+    readonly when?: string;
+}
+export interface BijouBlockGroup {
+    readonly id: string;
+    readonly label?: string;
+    readonly source: string;
+    readonly layout: UiLayoutIntent;
+}
+export interface BijouBlockField {
+    readonly fieldName: string;
+    readonly nodeId: string;
+    readonly groupId?: string;
+    readonly graphqlType: string;
+    readonly source: string;
+    readonly layout: UiLayoutIntent;
+    readonly text: UiTextRef;
+    readonly style?: UiStyleRef;
+    readonly action?: BijouBlockFieldAction;
+    readonly binding?: BijouBlockFieldBinding;
+}
+export interface BijouBlockArtifact {
+    readonly artifactVersion: BijouBlockArtifactVersion;
+    readonly id: string;
+    readonly component: string;
+    readonly sourceTypeName: string;
+    readonly sourceName: string;
+    readonly sourceHash: string;
+    readonly rootNodeId: string;
+    readonly groups: readonly BijouBlockGroup[];
+    readonly fields: readonly BijouBlockField[];
+    readonly targetProfiles: readonly UiTargetProfile[];
+}
+export interface GraphqlBijouBlockDebugGroupFact {
+    readonly id: string;
+    readonly label?: string;
+    readonly source: string;
+    readonly childNodeIds: readonly string[];
+}
+export interface GraphqlBijouBlockDebugFieldFact {
+    readonly fieldName: string;
+    readonly nodeId: string;
+    readonly groupId?: string;
+    readonly source: string;
+    readonly i18nKey?: string;
+    readonly tokenRefs: readonly string[];
+    readonly actionId?: string;
+    readonly bindingId?: string;
+}
+export interface GraphqlBijouBlockDebugLowerModeFact {
+    readonly mode: UiSceneLowerMode;
+    readonly surfaceHash: string;
+    readonly rows: readonly string[];
+}
+export interface GraphqlBijouBlockDebugSummary {
+    readonly summaryVersion: GraphqlBijouBlockDebugSummaryVersion;
+    readonly artifactVersion: BijouBlockArtifactVersion;
+    readonly artifactId: string;
+    readonly artifactHash: string;
+    readonly sceneHash: string;
+    readonly summaryHash: string;
+    readonly rootNodeId: string;
+    readonly groups: readonly GraphqlBijouBlockDebugGroupFact[];
+    readonly fields: readonly GraphqlBijouBlockDebugFieldFact[];
+    readonly sourceMap: readonly UiSourceMapEntry[];
+    readonly i18nKeys: readonly string[];
+    readonly tokenRefs: readonly string[];
+    readonly actionIds: readonly string[];
+    readonly bindingIds: readonly string[];
+    readonly lowerModes: readonly GraphqlBijouBlockDebugLowerModeFact[];
+}
+export declare function compileGraphqlBijouBlock(source: string, options?: CompileGraphqlBijouBlockOptions): BijouBlockArtifact;
+export declare function lowerBijouBlockToUiScene(artifact: BijouBlockArtifact): UiSceneIr;
+export declare function createGraphqlBijouBlockDebugSummary(artifact: BijouBlockArtifact, options?: UiSceneLoweringOptions): GraphqlBijouBlockDebugSummary;
+//# sourceMappingURL=graphql-bijou-block.d.ts.map

package/dist/core/graphql-bijou-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-bijou-block.d.ts","sourceRoot":"","sources":["../../src/core/graphql-bijou-block.ts"],"names":[],"mappings":"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"}

package/dist/core/graphql-bijou-block.js

@@ -0,0 +1,570 @@
+import { UI_SCENE_IR_VERSION, hashUiSceneValue, lowerUiSceneToTerminalProof, } from './ui-scene-ir.js';
+export const BIJOU_BLOCK_ARTIFACT_VERSION = 'bijou-block/1';
+export const GRAPHQL_BIJOU_BLOCK_DEBUG_SUMMARY_VERSION = 'graphql-bijou-block-debug/1';
+const DEFAULT_SOURCE_NAME = 'inline.graphql';
+const DEBUG_LOWER_MODES = ['normal', 'node-ids', 'i18n-keys', 'token-refs'];
+const IDENTIFIER_PATTERN = '[A-Za-z_][A-Za-z0-9_]*';
+const FIELD_PATTERN = new RegExp(`^(${IDENTIFIER_PATTERN})\\s*:\\s*([A-Za-z0-9_!\\[\\]]+)(.*)$`);
+const TYPE_PATTERN = new RegExp(`^type\\s+(${IDENTIFIER_PATTERN})\\b(.*)$`);
+const DIRECTIVE_PATTERN = new RegExp(`@(${IDENTIFIER_PATTERN})\\s*\\(((?:[^()"\\\\]|"(?:[^"\\\\]|\\\\.)*")*)\\)`, 'g');
+const ARG_PATTERN = new RegExp(`(${IDENTIFIER_PATTERN})\\s*:\\s*("(?:[^"\\\\]|\\\\.)*"|-?\\d+)`, 'g');
+export function compileGraphqlBijouBlock(source, options = {}) {
+    const sourceName = normalizeSourceName(options.sourceName ?? DEFAULT_SOURCE_NAME);
+    const parsed = parseConstrainedGraphqlBijouBlock(source);
+    const blockDirective = directiveByName(parsed.typeDirectives, 'bijouBlock');
+    const blockId = blockDirective == null ? undefined : optionalStringArg(blockDirective, 'id');
+    const component = blockDirective == null ? undefined : optionalStringArg(blockDirective, 'component');
+    if (blockId == null || component == null) {
+        throw new Error('GraphQL Bijou block source must include @bijouBlock(id:, component:).');
+    }
+    const targetProfiles = targetProfilesFor(parsed.typeDirectives);
+    const groups = groupsFor(parsed.typeDirectives, parsed.typeName, sourceName);
+    const fields = parsed.fields.map((field) => bijouBlockFieldFor(field, parsed.typeName, sourceName));
+    const rootNodeId = `${blockId}.root`;
+    assertUniqueBlockIdentities(groups, fields, rootNodeId);
+    const artifactBody = {
+        artifactVersion: BIJOU_BLOCK_ARTIFACT_VERSION,
+        id: blockId,
+        component,
+        sourceTypeName: parsed.typeName,
+        sourceName,
+        rootNodeId,
+        groups,
+        fields,
+        targetProfiles,
+    };
+    return {
+        ...artifactBody,
+        sourceHash: hashUiSceneValue(artifactBody),
+    };
+}
+export function lowerBijouBlockToUiScene(artifact) {
+    const groups = artifact.groups ?? [];
+    assertUniqueBlockIdentities(groups, artifact.fields, artifact.rootNodeId);
+    const nodes = [
+        {
+            id: artifact.rootNodeId,
+            kind: 'group',
+            component: artifact.component,
+            children: rootChildNodeIds(groups, artifact.fields),
+            metadata: {
+                artifactVersion: artifact.artifactVersion,
+                sourceTypeName: artifact.sourceTypeName,
+            },
+        },
+    ];
+    const actions = [];
+    const bindings = [];
+    const tokenUses = [];
+    const i18nUses = [];
+    const sourceMap = [];
+    for (const group of groups) {
+        nodes.push(nodeForGroup(artifact, group));
+        sourceMap.push({ nodeId: group.id, source: group.source });
+    }
+    for (const field of artifact.fields) {
+        nodes.push(nodeForField(artifact, field));
+        sourceMap.push({ nodeId: field.nodeId, source: field.source });
+        appendTokenUses(tokenUses, field);
+        appendI18nUse(i18nUses, field.nodeId, field.text);
+        if (field.action != null) {
+            actions.push({
+                id: field.action.id,
+                command: field.action.command,
+                keybindings: field.action.keybindings,
+                label: field.text,
+                targetNodeId: field.nodeId,
+            });
+            appendI18nUse(i18nUses, field.action.id, field.text, 'action');
+        }
+        if (field.binding != null) {
+            bindings.push({
+                id: field.binding.id,
+                targetNodeId: field.nodeId,
+                targetProperty: field.binding.targetProperty,
+                source: field.binding.source,
+                when: field.binding.when,
+            });
+        }
+    }
+    return {
+        irVersion: UI_SCENE_IR_VERSION,
+        id: artifact.id,
+        sourceHash: artifact.sourceHash,
+        rootNodeId: artifact.rootNodeId,
+        nodes,
+        bindings,
+        actions,
+        tokenUses,
+        i18nUses,
+        sourceMap,
+        targetProfiles: artifact.targetProfiles,
+        portability: { level: 'portable' },
+    };
+}
+export function createGraphqlBijouBlockDebugSummary(artifact, options = {}) {
+    const scene = lowerBijouBlockToUiScene(artifact);
+    const body = {
+        summaryVersion: GRAPHQL_BIJOU_BLOCK_DEBUG_SUMMARY_VERSION,
+        artifactVersion: artifact.artifactVersion,
+        artifactId: artifact.id,
+        artifactHash: hashUiSceneValue(artifact),
+        sceneHash: hashUiSceneValue(scene),
+        rootNodeId: artifact.rootNodeId,
+        groups: debugGroupFacts(artifact),
+        fields: artifact.fields.map(debugFieldFact),
+        sourceMap: scene.sourceMap,
+        i18nKeys: sortedUniqueStrings(scene.i18nUses.map((use) => use.key)),
+        tokenRefs: sortedUniqueStrings(scene.tokenUses.map((use) => use.token)),
+        actionIds: sortedUniqueStrings(scene.actions.map((action) => action.id)),
+        bindingIds: sortedUniqueStrings(scene.bindings.map((binding) => binding.id)),
+        lowerModes: DEBUG_LOWER_MODES.map((mode) => {
+            const proof = lowerUiSceneToTerminalProof(scene, {
+                ...options,
+                lowerMode: mode,
+            });
+            return {
+                mode,
+                surfaceHash: proof.lowering.surfaceHash,
+                rows: surfaceRows(proof.lowering.surface),
+            };
+        }),
+    };
+    return {
+        ...body,
+        summaryHash: hashUiSceneValue({ ...body, summaryHash: undefined }),
+    };
+}
+function parseConstrainedGraphqlBijouBlock(source) {
+    const typeDirectiveTexts = [];
+    const fields = [];
+    let typeName;
+    let insideType = false;
+    let currentField;
+    for (const rawLine of source.replace(/\r\n?/g, '\n').split('\n')) {
+        const trimmed = stripGraphqlLineComment(rawLine).trim();
+        if (trimmed.length === 0) {
+            continue;
+        }
+        if (typeName == null) {
+            const match = TYPE_PATTERN.exec(trimmed);
+            if (match == null) {
+                continue;
+            }
+            typeName = match[1];
+            const rest = match[2] ?? '';
+            typeDirectiveTexts.push(rest);
+            insideType = rest.includes('{');
+            continue;
+        }
+        if (!insideType) {
+            typeDirectiveTexts.push(trimmed);
+            insideType = trimmed.includes('{');
+            continue;
+        }
+        if (trimmed.startsWith('}')) {
+            if (currentField != null) {
+                fields.push(fieldFromDraft(currentField));
+                currentField = undefined;
+            }
+            break;
+        }
+        const fieldMatch = FIELD_PATTERN.exec(trimmed);
+        if (fieldMatch != null) {
+            if (currentField != null) {
+                fields.push(fieldFromDraft(currentField));
+            }
+            currentField = {
+                fieldName: fieldMatch[1],
+                graphqlType: fieldMatch[2],
+                directiveTexts: [fieldMatch[3] ?? ''],
+            };
+            continue;
+        }
+        if (trimmed.startsWith('@') && currentField != null) {
+            currentField.directiveTexts.push(trimmed);
+        }
+    }
+    if (typeName == null) {
+        throw new Error('GraphQL Bijou block source must include a type definition.');
+    }
+    if (currentField != null) {
+        fields.push(fieldFromDraft(currentField));
+    }
+    return {
+        typeName,
+        typeDirectives: parseDirectives(typeDirectiveTexts.join('\n')),
+        fields,
+    };
+}
+function fieldFromDraft(draft) {
+    return {
+        fieldName: draft.fieldName,
+        graphqlType: draft.graphqlType,
+        directives: parseDirectives(draft.directiveTexts.join('\n')),
+    };
+}
+function parseDirectives(source) {
+    const directives = [];
+    for (const match of source.matchAll(DIRECTIVE_PATTERN)) {
+        directives.push({
+            name: match[1],
+            args: parseDirectiveArgs(match[2] ?? ''),
+        });
+    }
+    return directives;
+}
+function parseDirectiveArgs(source) {
+    const args = {};
+    for (const match of source.matchAll(ARG_PATTERN)) {
+        const key = match[1];
+        const rawValue = match[2];
+        args[key] = rawValue.startsWith('"') ? parseQuotedArg(rawValue) : Number(rawValue);
+    }
+    return args;
+}
+function parseQuotedArg(rawValue) {
+    try {
+        return JSON.parse(rawValue);
+    }
+    catch {
+        throw new Error(`Invalid GraphQL Bijou block string argument: ${rawValue}`);
+    }
+}
+function bijouBlockFieldFor(field, typeName, sourceName) {
+    const textDirective = requireDirective(field, 'bijouText');
+    const i18nDirective = requireDirective(field, 'bijouI18n');
+    const tokenDirective = directiveByName(field.directives, 'bijouToken');
+    const actionDirective = directiveByName(field.directives, 'bijouAction');
+    const bindingDirective = directiveByName(field.directives, 'bijouBind');
+    const nodeId = requiredStringArg(textDirective, 'id', `@bijouText on ${field.fieldName} must include id:.`);
+    return {
+        fieldName: field.fieldName,
+        nodeId,
+        groupId: optionalStringArg(textDirective, 'group'),
+        graphqlType: field.graphqlType,
+        source: `${sourceName}#type.${typeName}.field.${field.fieldName}`,
+        layout: layoutFor(textDirective),
+        text: {
+            kind: 'i18n',
+            key: requiredStringArg(i18nDirective, 'key', `@bijouI18n on ${field.fieldName} must include key:.`),
+            fallback: requiredStringArg(i18nDirective, 'fallback', `@bijouI18n on ${field.fieldName} must include fallback:.`),
+        },
+        style: tokenDirective == null ? undefined : styleFor(tokenDirective),
+        action: actionDirective == null ? undefined : actionFor(actionDirective),
+        binding: bindingDirective == null ? undefined : bindingFor(bindingDirective),
+    };
+}
+function groupsFor(directives, typeName, sourceName) {
+    return directivesByName(directives, 'bijouGroup').map((directive) => {
+        const id = requiredStringArg(directive, 'id', '@bijouGroup must include id:.');
+        const label = optionalStringArg(directive, 'label');
+        const group = {
+            id,
+            source: `${sourceName}#type.${typeName}.group.${id}`,
+            layout: layoutFor(directive),
+        };
+        if (label != null) {
+            group.label = label;
+        }
+        return group;
+    });
+}
+function rootChildNodeIds(groups, fields) {
+    if (groups.length === 0) {
+        return fields.map((field) => field.nodeId);
+    }
+    return [
+        ...groups.map((group) => group.id),
+        ...fields.flatMap((field) => field.groupId == null ? [field.nodeId] : []),
+    ];
+}
+function nodeForGroup(artifact, group) {
+    const node = {
+        id: group.id,
+        kind: 'group',
+        component: artifact.component,
+        parentId: artifact.rootNodeId,
+        children: artifact.fields
+            .filter((field) => field.groupId === group.id)
+            .map((field) => field.nodeId),
+        layout: group.layout,
+        metadata: metadataForGroup(group),
+    };
+    return node;
+}
+function metadataForGroup(group) {
+    const metadata = {
+        graphqlGroup: group.id,
+    };
+    if (group.label != null) {
+        metadata['label'] = group.label;
+    }
+    return metadata;
+}
+function nodeForField(artifact, field) {
+    const node = {
+        id: field.nodeId,
+        kind: 'text',
+        component: artifact.component,
+        parentId: field.groupId ?? artifact.rootNodeId,
+        layout: field.layout,
+        text: field.text,
+        style: field.style,
+        actions: field.action == null ? undefined : [field.action.id],
+        metadata: {
+            graphqlField: field.fieldName,
+            graphqlType: field.graphqlType,
+        },
+    };
+    return node;
+}
+function targetProfilesFor(directives) {
+    const targetDirective = requireDirective({ fieldName: 'type', directives }, 'bijouTarget', 'GraphQL Bijou block source must include @bijouTarget(kind:, cols:, rows:).');
+    const kind = requiredStringArg(targetDirective, 'kind', '@bijouTarget must include kind:.');
+    if (kind !== 'bijou-terminal') {
+        throw new Error(`Unsupported GraphQL Bijou block target kind: ${kind}`);
+    }
+    return [
+        {
+            kind,
+            cols: requiredPositiveIntegerArg(targetDirective, 'cols', '@bijouTarget bijou-terminal must include positive cols:.'),
+            rows: requiredPositiveIntegerArg(targetDirective, 'rows', '@bijouTarget bijou-terminal must include positive rows:.'),
+        },
+    ];
+}
+function layoutFor(directive) {
+    const layout = {};
+    copyOptionalIntegerArg(directive, layout, 'x');
+    copyOptionalIntegerArg(directive, layout, 'y');
+    copyOptionalIntegerArg(directive, layout, 'width');
+    copyOptionalIntegerArg(directive, layout, 'height');
+    return layout;
+}
+function styleFor(directive) {
+    const style = {};
+    const fg = optionalStringArg(directive, 'fg');
+    const bg = optionalStringArg(directive, 'bg');
+    const border = optionalStringArg(directive, 'border');
+    if (fg != null) {
+        style.fg = { token: fg };
+    }
+    if (bg != null) {
+        style.bg = { token: bg };
+    }
+    if (border != null) {
+        style.border = { token: border };
+    }
+    return style;
+}
+function actionFor(directive) {
+    const id = requiredStringArg(directive, 'id', '@bijouAction must include id:.');
+    const command = requiredStringArg(directive, 'command', '@bijouAction must include command:.');
+    const key = optionalStringArg(directive, 'key');
+    return {
+        id,
+        command,
+        keybindings: key == null ? [] : [key],
+    };
+}
+function bindingFor(directive) {
+    const kind = requiredStringArg(directive, 'kind', '@bijouBind must include kind:.');
+    if (kind !== 'state' && kind !== 'query' && kind !== 'computed') {
+        throw new Error(`Unsupported @bijouBind kind: ${kind}`);
+    }
+    return {
+        id: requiredStringArg(directive, 'id', '@bijouBind must include id:.'),
+        targetProperty: optionalStringArg(directive, 'targetProperty') ?? 'text',
+        source: {
+            kind,
+            path: requiredStringArg(directive, 'path', '@bijouBind must include path:.'),
+        },
+        when: optionalStringArg(directive, 'when'),
+    };
+}
+function requireDirective(owner, name, message) {
+    const directive = directiveByName(owner.directives, name);
+    if (directive == null) {
+        throw new Error(message ?? `GraphQL Bijou block field ${owner.fieldName} must include @${name}(...).`);
+    }
+    return directive;
+}
+function directiveByName(directives, name) {
+    const matches = directives.filter((directive) => directive.name === name);
+    if (matches.length > 1) {
+        throw new Error(`GraphQL Bijou block source has duplicate @${name} directives.`);
+    }
+    return matches[0];
+}
+function directivesByName(directives, name) {
+    return directives.filter((directive) => directive.name === name);
+}
+function requiredStringArg(directive, name, message) {
+    const value = optionalStringArg(directive, name);
+    if (value == null) {
+        throw new Error(message);
+    }
+    return value;
+}
+function optionalStringArg(directive, name) {
+    const value = directive.args[name];
+    return typeof value === 'string' ? value : undefined;
+}
+function requiredPositiveIntegerArg(directive, name, message) {
+    const value = optionalIntegerArg(directive, name);
+    if (value == null || value <= 0) {
+        throw new Error(message);
+    }
+    return value;
+}
+function optionalIntegerArg(directive, name) {
+    const value = directive.args[name];
+    return typeof value === 'number' && Number.isInteger(value) ? value : undefined;
+}
+function copyOptionalIntegerArg(directive, layout, name) {
+    const value = optionalIntegerArg(directive, name);
+    if (value != null) {
+        layout[name] = value;
+    }
+}
+function appendTokenUses(tokenUses, field) {
+    if (field.style?.fg?.token != null) {
+        tokenUses.push({ nodeId: field.nodeId, slot: 'fg', token: field.style.fg.token });
+    }
+    if (field.style?.bg?.token != null) {
+        tokenUses.push({ nodeId: field.nodeId, slot: 'bg', token: field.style.bg.token });
+    }
+    if (field.style?.border?.token != null) {
+        tokenUses.push({ nodeId: field.nodeId, slot: 'border', token: field.style.border.token });
+    }
+}
+function appendI18nUse(i18nUses, id, text, kind = 'node') {
+    if (text.kind !== 'i18n') {
+        return;
+    }
+    i18nUses.push(kind === 'node'
+        ? { nodeId: id, key: text.key }
+        : { actionId: id, key: text.key });
+}
+function assertUniqueBlockIdentities(groups, fields, rootNodeId) {
+    assertUniqueValues(fields.map((field) => field.fieldName), 'field name');
+    assertUniqueValues(groups.map((group) => group.id), 'group id');
+    assertUniqueValues([rootNodeId, ...groups.map((group) => group.id), ...fields.map((field) => field.nodeId)], 'node id');
+    const groupIds = new Set(groups.map((group) => group.id));
+    for (const field of fields) {
+        if (field.groupId != null && !groupIds.has(field.groupId)) {
+            throw new Error(`GraphQL Bijou block field ${field.fieldName} references missing group: ${field.groupId}`);
+        }
+    }
+    assertUniqueValues(fields.flatMap((field) => field.action == null ? [] : [field.action.id]), 'action id');
+    assertUniqueValues(fields.flatMap((field) => field.binding == null ? [] : [field.binding.id]), 'binding id');
+}
+function debugGroupFacts(artifact) {
+    const groups = artifact.groups ?? [];
+    return groups.map((group) => {
+        const fact = {
+            id: group.id,
+            source: group.source,
+            childNodeIds: artifact.fields
+                .filter((field) => field.groupId === group.id)
+                .map((field) => field.nodeId),
+        };
+        if (group.label != null) {
+            fact.label = group.label;
+        }
+        return fact;
+    });
+}
+function debugFieldFact(field) {
+    const fact = {
+        fieldName: field.fieldName,
+        nodeId: field.nodeId,
+        source: field.source,
+        tokenRefs: styleTokenRefs(field.style),
+    };
+    if (field.groupId != null) {
+        fact.groupId = field.groupId;
+    }
+    if (field.text.kind === 'i18n') {
+        fact.i18nKey = field.text.key;
+    }
+    if (field.action != null) {
+        fact.actionId = field.action.id;
+    }
+    if (field.binding != null) {
+        fact.bindingId = field.binding.id;
+    }
+    return fact;
+}
+function styleTokenRefs(style) {
+    return sortedUniqueStrings([
+        style?.fg?.token,
+        style?.bg?.token,
+        style?.border?.token,
+    ].filter((token) => token != null));
+}
+function surfaceRows(surface) {
+    const rows = [];
+    for (let y = 0; y < surface.height; y++) {
+        let row = '';
+        for (let x = 0; x < surface.width; x++) {
+            const cell = surface.get(x, y);
+            row += cell.empty ? ' ' : cell.char;
+        }
+        rows.push(row.trimEnd());
+    }
+    return rows;
+}
+function sortedUniqueStrings(values) {
+    return [...new Set(values)].sort(compareCodeUnits);
+}
+function compareCodeUnits(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function assertUniqueValues(values, label) {
+    const seen = new Set();
+    for (const value of values) {
+        if (seen.has(value)) {
+            throw new Error(`Duplicate GraphQL Bijou block ${label}: ${value}`);
+        }
+        seen.add(value);
+    }
+}
+function normalizeSourceName(sourceName) {
+    const trimmed = sourceName.trim();
+    if (trimmed.length === 0) {
+        throw new Error('GraphQL Bijou block sourceName cannot be empty.');
+    }
+    if (trimmed.startsWith('/')
+        || trimmed.startsWith('\\\\')
+        || trimmed.startsWith('//')
+        || /^[A-Za-z]:[\\/]/.test(trimmed)
+        || trimmed.includes('\0')) {
+        throw new Error('GraphQL Bijou block sourceName must be a relative or logical name.');
+    }
+    return trimmed;
+}
+function stripGraphqlLineComment(line) {
+    let quoted = false;
+    let escaped = false;
+    for (let index = 0; index < line.length; index++) {
+        const char = line[index];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (char === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (char === '"') {
+            quoted = !quoted;
+            continue;
+        }
+        if (!quoted && char === '#') {
+            return line.slice(0, index);
+        }
+    }
+    return line;
+}
+//# sourceMappingURL=graphql-bijou-block.js.map