@smoothbricks/lmao 0.2.2 → 0.2.3

package/dist/lib/codegen/spanLoggerClosureMaterializer.js

@@ -0,0 +1,447 @@
+//#region smoo/lmao!n/codegen-spanlogger.closure
+/**
+ * Closure-composed (no-eval) materializer for state-bound SpanLogger classes.
+ *
+ * Production workerd forbids code generation from strings (EvalError), so the
+ * compiled renderer in spanLoggerGenerator.ts cannot run there. This module
+ * assembles the SAME class shape from per-field closures instead of source
+ * text, mirroring arrow-builder's closureMaterializers.ts:
+ * - one shared prototype per schema/config plan,
+ * - methods installed with { value, writable: true, configurable: true, enumerable: false },
+ * - accessors installed with { get, configurable: true, enumerable: false },
+ * - constructors assign instance properties in the same order (V8 hidden classes).
+ *
+ * Every closure body mirrors the compiled class member it replaces, including
+ * evaluation order (append -> message write -> fields), guard conditions, and
+ * thrown error messages that callers observe.
+ */
+import { ENTRY_TYPE_DEBUG, ENTRY_TYPE_ERROR, ENTRY_TYPE_FF_ACCESS, ENTRY_TYPE_FF_USAGE, ENTRY_TYPE_INFO, ENTRY_TYPE_TRACE, ENTRY_TYPE_WARN, } from '../schema/systemSchema.js';
+function isIndexWritable(value) {
+    return typeof value === 'object' && value !== null;
+}
+function laneOf(value) {
+    if (isIndexWritable(value))
+        return value;
+    throw new TypeError('Expected an indexable column lane');
+}
+function bitmapOf(value) {
+    if (value instanceof Uint8Array)
+        return value;
+    throw new TypeError('Expected a Uint8Array bitmap lane');
+}
+function isRangeFillable(value) {
+    return typeof value === 'object' && value !== null && typeof Reflect.get(value, 'fill') === 'function';
+}
+function fillableOf(value) {
+    if (isRangeFillable(value))
+        return value;
+    throw new TypeError('Expected a fillable column lane');
+}
+/** Dynamic `this.with(...)` dispatch (the compiled methods call through `this`). */
+function callFluentWith(self, attributes) {
+    const withFn = self.with;
+    if (typeof withFn !== 'function')
+        throw new TypeError('SpanLogger.with is not callable');
+    withFn.call(self, attributes);
+}
+const METHOD_DESCRIPTOR = { writable: true, configurable: true, enumerable: false };
+const ACCESSOR_DESCRIPTOR = { configurable: true, enumerable: false };
+// ============================================================================
+// Schema column fluent setters (state-bound mirror of the base ColumnWriter
+// setters after the `this._buffer` -> `this._state._buffer` and
+// `this._writeIndex` -> `(this._state._buffer._writeIndex - 1)` rewrites)
+// ============================================================================
+function makeStateBoundSetter(column) {
+    const { name, schemaType, mode } = column;
+    // Preallocated setters write through the raw backing properties; eager and
+    // lazy setters go through the buffer's public getters (which allocate lazy
+    // columns on first access).
+    const nullsKey = mode === 'preallocated' ? `_${name}_nulls` : `${name}_nulls`;
+    const valuesKey = mode === 'preallocated' ? `_${name}_values` : `${name}_values`;
+    const hasNulls = mode !== 'eager';
+    const lookupKey = `_${name}_enumLookup`;
+    const enumValuesKey = `${name}_enumValues`;
+    if (schemaType === 'boolean') {
+        if (hasNulls) {
+            return function (value) {
+                const buf = this._state._buffer;
+                const idx = buf._writeIndex - 1;
+                const byteIdx = idx >>> 3;
+                const bitMask = 1 << (idx & 7);
+                bitmapOf(buf[nullsKey])[byteIdx] |= bitMask;
+                const values = bitmapOf(buf[valuesKey]);
+                if (value)
+                    values[byteIdx] |= bitMask;
+                else
+                    values[byteIdx] &= ~bitMask;
+                return this;
+            };
+        }
+        return function (value) {
+            const buf = this._state._buffer;
+            const idx = buf._writeIndex - 1;
+            const byteIdx = idx >>> 3;
+            const bitMask = 1 << (idx & 7);
+            const values = bitmapOf(buf[valuesKey]);
+            if (value)
+                values[byteIdx] |= bitMask;
+            else
+                values[byteIdx] &= ~bitMask;
+            return this;
+        };
+    }
+    if (schemaType === 'enum') {
+        // Base enum setter. Reachable only for enum fields absent from
+        // enumLookup.ordered (the fluent enum overrides shadow it otherwise) —
+        // the compiled class throws there too because its constructor-built
+        // `_<name>_enumLookup` Maps were dropped with the state-bound rewrite.
+        const makeEnumWrite = (writeNulls) => function (value) {
+            const buf = this._state._buffer;
+            const idx = buf._writeIndex - 1;
+            const lookup = this[lookupKey];
+            if (!(lookup instanceof Map)) {
+                throw new TypeError(`Enum lookup ${lookupKey} is not initialized (buffer has no enumValues).`);
+            }
+            const enumIndex = lookup.get(value);
+            if (enumIndex === undefined) {
+                const enumValues = buf[enumValuesKey];
+                throw new Error(`Invalid enum value "${value}" for field "${name}". Valid values: ${Array.isArray(enumValues) ? enumValues.join(', ') : ''}`);
+            }
+            if (writeNulls)
+                bitmapOf(buf[nullsKey])[idx >>> 3] |= 1 << (idx & 7);
+            laneOf(buf[valuesKey])[idx] = enumIndex;
+            return this;
+        };
+        return makeEnumWrite(hasNulls);
+    }
+    if (schemaType === 'binary') {
+        // Shallow-freeze binary payload objects (mirrors the compiled binary setter).
+        const freezeBinaryValue = (value) => {
+            if (typeof value === 'object' && value !== null && !(value instanceof Uint8Array))
+                Object.freeze(value);
+        };
+        if (hasNulls) {
+            return function (value) {
+                const buf = this._state._buffer;
+                const idx = buf._writeIndex - 1;
+                freezeBinaryValue(value);
+                bitmapOf(buf[nullsKey])[idx >>> 3] |= 1 << (idx & 7);
+                laneOf(buf[valuesKey])[idx] = value;
+                return this;
+            };
+        }
+        return function (value) {
+            const buf = this._state._buffer;
+            const idx = buf._writeIndex - 1;
+            freezeBinaryValue(value);
+            laneOf(buf[valuesKey])[idx] = value;
+            return this;
+        };
+    }
+    if (hasNulls) {
+        return function (value) {
+            const buf = this._state._buffer;
+            const idx = buf._writeIndex - 1;
+            bitmapOf(buf[nullsKey])[idx >>> 3] |= 1 << (idx & 7);
+            laneOf(buf[valuesKey])[idx] = value;
+            return this;
+        };
+    }
+    return function (value) {
+        const buf = this._state._buffer;
+        const idx = buf._writeIndex - 1;
+        laneOf(buf[valuesKey])[idx] = value;
+        return this;
+    };
+}
+// ============================================================================
+// SpanLogger materializer
+// ============================================================================
+/**
+ * Materialize a state-bound SpanLogger class from a plan without string
+ * codegen. Same observable behavior as the compiled renderer. Returned as
+ * `unknown` to flow through the same constructor type guard as the compiled
+ * factory (isSpanLoggerConstructor).
+ */
+export function materializeSpanLoggerClass(plan) {
+    const { helpers, enumLookup } = plan;
+    const family = plan.messageLayoutFamily;
+    const physical = plan.messagePhysicalLayout;
+    class GeneratedSpanLogger {
+        constructor(state) {
+            this._state = state;
+        }
+    }
+    const proto = GeneratedSpanLogger.prototype;
+    const defineMethod = (name, value) => {
+        Object.defineProperty(proto, name, { ...METHOD_DESCRIPTOR, value });
+    };
+    // --------------------------------------------------------------------------
+    // Message writes per layout family / physical layout
+    // --------------------------------------------------------------------------
+    /** Operational entry (info/warn/error): normalized message + optional fields. */
+    const makeOperationalLogMethod = (entryType) => {
+        if (family === 'static-only') {
+            return function () {
+                this._state._appendWriterEntry(entryType);
+                throw new TypeError('Dynamic log write reached a static-only callsite plan');
+            };
+        }
+        return function (message, fields) {
+            const state = this._state;
+            const idx = state._appendWriterEntry(entryType);
+            laneOf(state._buffer.message_values)[idx] = helpers.normalizeOperationalTemplate(message);
+            if (fields !== undefined) {
+                callFluentWith(this, fields);
+            }
+            return this;
+        };
+    };
+    /** Plain entry (debug/trace): raw message, no fields argument. */
+    const makePlainLogMethod = (entryType) => {
+        if (family === 'static-only') {
+            return function () {
+                this._state._appendWriterEntry(entryType);
+                throw new TypeError('Dynamic log write reached a static-only callsite plan');
+            };
+        }
+        return function (message) {
+            const state = this._state;
+            const idx = state._appendWriterEntry(entryType);
+            laneOf(state._buffer.message_values)[idx] = message;
+            return this;
+        };
+    };
+    /** Static template entry (_infoTemplate & co.) per physical layout. */
+    const makeTemplateLogMethod = (entryType) => {
+        if (family === 'dynamic-only') {
+            return function () {
+                this._state._appendWriterEntry(entryType);
+                throw new TypeError('Static log write reached a dynamic-only callsite plan');
+            };
+        }
+        switch (physical) {
+            case 'current':
+                return function (vocabularyIndex) {
+                    const state = this._state;
+                    const idx = state._appendWriterEntry(entryType);
+                    const localMessageId = state._physicalLayoutPlan.encodeLocalMessage(vocabularyIndex);
+                    if (localMessageId === 0) {
+                        laneOf(state._buffer.message_values)[idx] = helpers.decodeVocabularyMessage(state._buffer._vocabularyGeneration, vocabularyIndex);
+                    }
+                    else {
+                        laneOf(state._buffer._messageIds)[idx] = localMessageId;
+                    }
+                    return this;
+                };
+            case 'specialized':
+                return function (vocabularyIndex) {
+                    const state = this._state;
+                    const idx = state._appendWriterEntry(entryType);
+                    laneOf(state._buffer._logHeaders)[idx] = vocabularyIndex + 1;
+                    return this;
+                };
+            case 'packed':
+                return function (vocabularyIndex) {
+                    const state = this._state;
+                    const idx = state._appendWriterEntry(entryType);
+                    if (vocabularyIndex > 0x00fffffe)
+                        throw new RangeError('Packed message dense index exceeds 0xFFFFFE');
+                    laneOf(state._buffer._rowHeaders)[idx] = (((vocabularyIndex + 1) << 8) | entryType) >>> 0;
+                    return this;
+                };
+        }
+    };
+    /** Row-lane setter for fixed system columns (line, error_code, ...). */
+    const makeRowLaneSetter = (valuesKey, nullsKey) => function (value) {
+        const buf = this._state._buffer;
+        const idx = buf._writeIndex - 1;
+        const values = buf[valuesKey];
+        if (values) {
+            laneOf(values)[idx] = value;
+            const nulls = buf[nullsKey];
+            if (nulls) {
+                helpers.setNullBit(bitmapOf(nulls), idx);
+            }
+        }
+        return this;
+    };
+    // --------------------------------------------------------------------------
+    // Prototype assembly — SAME member order as the compiled class body, so
+    // name collisions shadow identically (schema setters first, extension
+    // methods next, enum fluent overrides last).
+    // --------------------------------------------------------------------------
+    for (const column of plan.columns) {
+        defineMethod(column.name, makeStateBoundSetter(column));
+    }
+    defineMethod('info', makeOperationalLogMethod(ENTRY_TYPE_INFO));
+    defineMethod('_infoTemplate', makeTemplateLogMethod(ENTRY_TYPE_INFO));
+    defineMethod('debug', makePlainLogMethod(ENTRY_TYPE_DEBUG));
+    defineMethod('_debugTemplate', makeTemplateLogMethod(ENTRY_TYPE_DEBUG));
+    defineMethod('warn', makeOperationalLogMethod(ENTRY_TYPE_WARN));
+    defineMethod('_warnTemplate', makeTemplateLogMethod(ENTRY_TYPE_WARN));
+    defineMethod('error', makeOperationalLogMethod(ENTRY_TYPE_ERROR));
+    defineMethod('_errorTemplate', makeTemplateLogMethod(ENTRY_TYPE_ERROR));
+    defineMethod('trace', makePlainLogMethod(ENTRY_TYPE_TRACE));
+    defineMethod('_traceTemplate', makeTemplateLogMethod(ENTRY_TYPE_TRACE));
+    defineMethod('with', function (attributes) {
+        for (const key in attributes) {
+            const value = attributes[key];
+            if (value === null || value === undefined) {
+                continue;
+            }
+            const setter = this[key];
+            if (typeof setter === 'function') {
+                setter.call(this, value);
+            }
+        }
+        return this;
+    });
+    defineMethod('ffAccess', family === 'static-only'
+        ? function () {
+            this._state._appendWriterEntry(ENTRY_TYPE_FF_ACCESS);
+            throw new TypeError('Feature flag write reached a static-only callsite plan');
+        }
+        : function (flagName, value) {
+            const state = this._state;
+            const idx = state._appendWriterEntry(ENTRY_TYPE_FF_ACCESS);
+            laneOf(state._buffer.message_values)[idx] = flagName;
+            const ffValues = state._buffer.ff_value_values;
+            if (ffValues) {
+                const strValue = value === null || value === undefined ? 'null' : String(value);
+                laneOf(ffValues)[idx] = strValue;
+                const ffNulls = state._buffer.ff_value_nulls;
+                if (ffNulls) {
+                    helpers.setNullBit(bitmapOf(ffNulls), idx);
+                }
+            }
+        });
+    defineMethod('ffUsage', family === 'static-only'
+        ? function () {
+            this._state._appendWriterEntry(ENTRY_TYPE_FF_USAGE);
+            throw new TypeError('Feature flag write reached a static-only callsite plan');
+        }
+        : function (flagName, context) {
+            const state = this._state;
+            const idx = state._appendWriterEntry(ENTRY_TYPE_FF_USAGE);
+            laneOf(state._buffer.message_values)[idx] = flagName;
+            if (context) {
+                callFluentWith(this, context);
+            }
+            return this;
+        });
+    defineMethod('line', makeRowLaneSetter('line_values', 'line_nulls'));
+    defineMethod('error_code', makeRowLaneSetter('error_code_values', 'error_code_nulls'));
+    defineMethod('exception_stack', makeRowLaneSetter('exception_stack_values', 'exception_stack_nulls'));
+    defineMethod('ff_value', makeRowLaneSetter('ff_value_values', 'ff_value_nulls'));
+    defineMethod('uint64_value', makeRowLaneSetter('uint64_value_values', 'uint64_value_nulls'));
+    Object.defineProperty(proto, 'scope', {
+        ...ACCESSOR_DESCRIPTOR,
+        get() {
+            return this._state._buffer._scopeValues;
+        },
+    });
+    defineMethod('_setScope', function (attributes) {
+        const buf = this._state._buffer;
+        const current = buf._scopeValues || {};
+        const next = { ...current };
+        for (const key of Object.keys(attributes)) {
+            const value = attributes[key];
+            if (value === null) {
+                delete next[key];
+            }
+            else if (value !== undefined) {
+                next[key] = value;
+            }
+        }
+        buf._scopeValues = Object.freeze(next);
+    });
+    defineMethod('_prefillScopedAttributesOn', makePrefillScopedAttributes(plan));
+    // Fluent enum overrides: convert the declared enum string to its
+    // schema-order index (shadow the base enum setters, exactly like the
+    // compiled class where they appear last in the class body).
+    for (const { fieldName } of enumLookup.ordered) {
+        const encode = enumLookup.byField[fieldName].encode;
+        defineMethod(fieldName, function (value) {
+            const idx = encode(value);
+            const buf = this._state._buffer;
+            const write = buf[fieldName];
+            if (typeof write !== 'function')
+                throw new TypeError(`Span buffer has no ${fieldName} setter method`);
+            write.call(buf, buf._writeIndex - 1, idx);
+            return this;
+        });
+    }
+    return GeneratedSpanLogger;
+}
+function makeColumnPrefill(column, encode, helpers) {
+    const { name, schemaType } = column;
+    // Binary columns are not scope-fillable (object payloads can't be bulk-filled)
+    if (schemaType === 'binary')
+        return undefined;
+    const rawValuesKey = `_${name}_values`;
+    const valuesKey = `${name}_values`;
+    const nullsKey = `${name}_nulls`;
+    // Boolean uses bit-packed storage - bulk fill using helper
+    if (schemaType === 'boolean') {
+        return (buffer, startIdx, endIdx) => {
+            const scopeValue = buffer._scopeValues?.[name];
+            if (scopeValue !== null && scopeValue !== undefined && buffer[rawValuesKey] !== undefined) {
+                helpers.fillBooleanBitmapRange(bitmapOf(buffer[valuesKey]), startIdx, endIdx, Boolean(scopeValue));
+                helpers.fillNullBitmapRange(bitmapOf(buffer[nullsKey]), startIdx, endIdx);
+            }
+        };
+    }
+    // For string arrays (category/text), use manual loop instead of fill()
+    if (schemaType === 'category' || schemaType === 'text') {
+        return (buffer, startIdx, endIdx) => {
+            const scopeValue = buffer._scopeValues?.[name];
+            if (scopeValue !== null && scopeValue !== undefined && buffer[rawValuesKey] !== undefined) {
+                const values = laneOf(buffer[valuesKey]);
+                for (let i = startIdx; i < endIdx; i++) {
+                    values[i] = scopeValue;
+                }
+                helpers.fillNullBitmapRange(bitmapOf(buffer[nullsKey]), startIdx, endIdx);
+            }
+        };
+    }
+    // Enum values are encoded to their schema-order index before filling
+    if (schemaType === 'enum' && encode !== undefined) {
+        return (buffer, startIdx, endIdx) => {
+            const scopeValue = buffer._scopeValues?.[name];
+            if (scopeValue !== null && scopeValue !== undefined && buffer[rawValuesKey] !== undefined) {
+                fillableOf(buffer[valuesKey]).fill(encode(scopeValue), startIdx, endIdx);
+                helpers.fillNullBitmapRange(bitmapOf(buffer[nullsKey]), startIdx, endIdx);
+            }
+        };
+    }
+    return (buffer, startIdx, endIdx) => {
+        const scopeValue = buffer._scopeValues?.[name];
+        if (scopeValue !== null && scopeValue !== undefined && buffer[rawValuesKey] !== undefined) {
+            fillableOf(buffer[valuesKey]).fill(scopeValue, startIdx, endIdx);
+            helpers.fillNullBitmapRange(bitmapOf(buffer[nullsKey]), startIdx, endIdx);
+        }
+    };
+}
+function makePrefillScopedAttributes(plan) {
+    const { helpers, enumLookup } = plan;
+    const orderedEnumFields = new Set(enumLookup.ordered.map(({ fieldName }) => fieldName));
+    const prefills = [];
+    for (const column of plan.columns) {
+        const encode = orderedEnumFields.has(column.name) ? enumLookup.byField[column.name].encode : undefined;
+        const prefill = makeColumnPrefill(column, encode, helpers);
+        if (prefill !== undefined)
+            prefills.push(prefill);
+    }
+    // Initial buffer: rows 0-1 reserved for span-start/end, data starts at _writeIndex=2
+    // Overflow buffer: no reserved rows, data starts at _writeIndex=0
+    // Use buffer._writeIndex as startIdx to handle both cases correctly
+    return (buffer) => {
+        const startIdx = buffer._writeIndex;
+        const endIdx = buffer._capacity;
+        for (let i = 0; i < prefills.length; i++) {
+            prefills[i](buffer, startIdx, endIdx);
+        }
+    };
+}
+//#endregion smoo/lmao!n/codegen-spanlogger.closure

package/dist/lib/codegen/spanLoggerGenerator.d.ts

@@ -15,15 +15,20 @@
  *
  * SpanLogger starts with _writeIndex = 1, so first _nextRow() makes it 2.
  */
-import { type ColumnWriter } from '@smoothbricks/arrow-builder';
+import { type SchemaEnumLookupDescriptor } from '../enumMetadata.js';
+import type { MessageLayoutFamily, MessagePhysicalLayout } from '../runtimeHint.js';
 import type { InferSchema, LogSchema } from '../schema/types.js';
-import type { AnySpanBuffer, SpanBuffer } from '../types.js';
+import type { AnySpanBuffer } from '../types.js';
+import type { VocabularyGeneration } from '../vocabularyRegistry.js';
+import type { WriterState } from './fixedPositionWriterGenerator.js';
 /**
  * Helper functions injected into generated SpanLogger code.
  * Singleton - same object shared by all generated SpanLogger classes.
  */
 export declare const SPAN_LOGGER_HELPERS: {
+    normalizeOperationalTemplate: (template: string) => string;
     setNullBit: (bitmap: Uint8Array, idx: number) => void;
+    decodeVocabularyMessage: (generation: VocabularyGeneration, denseIndex: number) => string;
     fillNullBitmapRange: (bitmap: Uint8Array, startIdx: number, endIdx: number) => void;
     fillBooleanBitmapRange: (bitmap: Uint8Array, startIdx: number, endIdx: number, value: boolean) => void;
 };
@@ -34,12 +39,17 @@ export declare const SPAN_LOGGER_HELPERS: {
 export interface BaseSpanLogger<T extends LogSchema> {
     /** Log info-level message */
     info(message: string): FluentLogEntry<T>;
+    info(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     /** Log debug-level message */
     debug(message: string): FluentLogEntry<T>;
     /** Log warning message */
     warn(message: string): FluentLogEntry<T>;
+    warn(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     /** Log error message */
     error(message: string): FluentLogEntry<T>;
+    error(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
+    /** Log trace-level message */
+    trace(message: string): FluentLogEntry<T>;
 }
 /**
  * Fluent interface returned by log methods (info, debug, warn, error, trace).
@@ -63,9 +73,12 @@ export type FluentLogEntry<T extends LogSchema> = {
     /** Set uint64 value for this entry */
     uint64_value(value: bigint): FluentLogEntry<T>;
     info(message: string): FluentLogEntry<T>;
+    info(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     debug(message: string): FluentLogEntry<T>;
     warn(message: string): FluentLogEntry<T>;
+    warn(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     error(message: string): FluentLogEntry<T>;
+    error(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     trace(message: string): FluentLogEntry<T>;
 } & {
     [K in keyof InferSchema<T>]: (value: InferSchema<T>[K]) => FluentLogEntry<T>;
@@ -81,35 +94,39 @@ export type FluentLogEntry<T extends LogSchema> = {
  * This is the FULL type returned by createSpanLogger().
  * Users see SpanLogger<T> which hides internal methods.
  */
-export type SpanLoggerImpl<T extends LogSchema> = ColumnWriter<T> & {
+export type SpanLoggerImpl<T extends LogSchema> = {
     info(message: string): FluentLogEntry<T>;
+    info(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     debug(message: string): FluentLogEntry<T>;
     warn(message: string): FluentLogEntry<T>;
+    warn(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     error(message: string): FluentLogEntry<T>;
+    error(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     trace(message: string): FluentLogEntry<T>;
+    _infoTemplate(vocabularyIndex: number): FluentLogEntry<T>;
+    _debugTemplate(vocabularyIndex: number): FluentLogEntry<T>;
+    _warnTemplate(vocabularyIndex: number): FluentLogEntry<T>;
+    _errorTemplate(vocabularyIndex: number): FluentLogEntry<T>;
+    _traceTemplate(vocabularyIndex: number): FluentLogEntry<T>;
     readonly scope: Readonly<Record<string, unknown>>;
     _setScope(attributes: ScopeUpdate<T>): void;
+    _prefillScopedAttributesOn(buffer: AnySpanBuffer): void;
+} & {
+    [K in keyof InferSchema<T>]: (value: InferSchema<T>[K]) => FluentLogEntry<T>;
 };
+export type SpanLoggerConstructor<T extends LogSchema> = new (state: WriterState) => SpanLoggerImpl<T>;
 export type ScopeUpdate<T extends LogSchema> = {
     [K in keyof InferSchema<T>]?: InferSchema<T>[K] | null;
 };
 /**
- * Create SpanLogger class constructor from schema.
- * This is the cold-path function called at module creation time.
- *
- * SpanLogger extends ColumnWriter and adds:
- * - info(), debug(), warn(), error() methods for log entries
- * - _setScope() for setting scoped attributes
- * - _getNextBuffer() override for SpanBuffer creation on overflow
- *
- * Note: Fluent attribute setters are inherited from ColumnWriter and write at _writeIndex.
- */
-export declare function createSpanLoggerClass<T extends LogSchema>(schema: T): new (buffer: AnySpanBuffer) => SpanLoggerImpl<T>;
-/**
- * Create a SpanLogger instance for the given buffer.
+ * Create the state-only SpanLogger constructor selected for one schema/layout family.
  *
- * @param schema - Tag attribute schema
- * @param buffer - SpanBuffer to write to
+ * Selects the materializer via activeMaterializerMode(): the compiled renderer
+ * (string codegen) where `new Function` is allowed, the closure-composed
+ * materializer where it is forbidden (e.g. workerd). Cache keys are
+ * mode-prefixed so a forced override never returns the other mode's class.
  */
-export declare function createSpanLogger<T extends LogSchema>(schema: T, buffer: SpanBuffer<T>): SpanLoggerImpl<T>;
+export declare function createSpanLoggerClass<T extends LogSchema>(schema: T, messageLayoutFamily?: MessageLayoutFamily, messagePhysicalLayout?: MessagePhysicalLayout, eagerColumns?: readonly string[], enumLookup?: SchemaEnumLookupDescriptor): SpanLoggerConstructor<T>;
+/** Create a SpanLogger bound to an existing SpanContext writer state. */
+export declare function createSpanLogger<T extends LogSchema>(schema: T, state: WriterState): SpanLoggerImpl<T>;
 //# sourceMappingURL=spanLoggerGenerator.d.ts.map

package/dist/lib/codegen/spanLoggerGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spanLoggerGenerator.d.ts","sourceRoot":"","sources":["../../../src/lib/codegen/spanLoggerGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,6BAA6B,CAAC;AAWrC,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQ7D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE;IAChC,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,mBAAmB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpF,sBAAsB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAkGxG,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,SAAS;IACjD,6BAA6B;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACzC,8BAA8B;IAC9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1C,0BAA0B;IAC1B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACzC,wBAAwB;IACxB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,IAAI;IAChD,6CAA6C;IAC7C,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC7D;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC5C,oCAAoC;IACpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC5C,yCAAyC;IACzC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAClD,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3C,sCAAsC;IACtC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAG/C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;CAC3C,GAAG;KACD,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC;CAC7E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG;IAClE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI;KAC5C,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;CACvD,CAAC;AA8bF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,SAAS,EACvD,MAAM,EAAE,CAAC,GACR,KACD,MAAM,EAAE,aAAa,KAClB,cAAc,CAAC,CAAC,CAAC,CAwBrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAGzG"}
+{"version":3,"file":"spanLoggerGenerator.d.ts","sourceRoot":"","sources":["../../../src/lib/codegen/spanLoggerGenerator.ts"],"names":[],"mappings":"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"}