goscript 0.2.0 → 0.2.1

package/dist/gs/sync/atomic/doc_64.gs.js.map

@@ -1 +1 @@
-{"version":3,"file":"doc_64.gs.js","sourceRoot":"","sources":["../../../../gs/sync/atomic/doc_64.gs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doc_64.gs.js","sourceRoot":"","sources":["../../../../gs/sync/atomic/doc_64.gs.ts"],"names":[],"mappings":"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"}

package/gs/builtin/hostio.test.ts

@@ -195,6 +195,22 @@ describe('hostio text writes', () => {
     expect(getHostRuntime().nodeFS).toBeNull()
     expect(consoleLog).toHaveBeenCalledWith('browser')
   })
+
+  it('writes stdout and stderr file descriptors to console in browser-like hosts', () => {
+    const consoleLog = vi.spyOn(console, 'log').mockImplementation(() => {})
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+    delete (globalThis as any).Deno
+    delete (globalThis as any).process
+    resetHostRuntimeForTests()
+
+    const runtime = getHostRuntime()
+    expect(runtime.writeFD(1, new Uint8Array([111, 107, 10]))).toBe(3)
+    expect(runtime.writeFD(2, new Uint8Array([101, 114, 114, 10]))).toBe(4)
+
+    expect(consoleLog).toHaveBeenCalledWith('ok')
+    expect(consoleError).toHaveBeenCalledWith('err')
+  })
 })
 
 describe('hostio isMainScript', () => {

package/gs/builtin/hostio.ts

@@ -104,6 +104,7 @@ export type MainScriptMeta = {
 }
 
 const encoder = new TextEncoder()
+const decoder = new TextDecoder()
 
 function getDynamicRequire(): ((specifier: string) => unknown) | null {
   try {
@@ -342,6 +343,12 @@ function detectHostRuntime(): HostRuntime {
         buffer,
       )
     }
+    if (fd === 1 || fd === 2) {
+      fallbackConsoleWriter(fd === 2 ? 'error' : 'log')(
+        decoder.decode(buffer),
+      )
+      return buffer.length
+    }
     throw new HostUnsupportedError()
   }
   const writeStdoutText: HostTextWrite = (data: string) => {

package/gs/builtin/runtime-contract.test.ts

@@ -17,6 +17,7 @@ import {
   int,
   arrayPointerFromIndexRef,
   indexAddress,
+  indexByteAddress,
   indexRef,
   interfaceValue,
   len,
@@ -62,6 +63,7 @@ import {
   uintShr,
   unref,
   unsupportedPointerRef,
+  unsafePointerRef,
   varRef,
 } from './index.js'
 
@@ -423,6 +425,16 @@ describe('builtin runtime contract helpers', () => {
     arrayView[2] = 19
     expect((byteBacking as Uint8Array)[3]).toBe(19)
 
+    const words = [0x11223344, 0]
+    const wordBytes = arrayPointerFromIndexRef(indexRef(words, 0), 8, 4, 1)
+    const byteView = pointerValue(wordBytes) as number[]
+    expect(byteView[0]).toBe(0x44)
+    expect(byteView[3]).toBe(0x11)
+    byteView[4] = 0xaa
+    expect(words[1]).toBe(0xaa)
+    wordBytes.value = [1, 2, 3, 4]
+    expect(words[0]).toBe(0x04030201)
+
     shortBytes![0] = 14
     expect(bytesToUint8Array(shortBytes)).toEqual(new Uint8Array([14, 0]))
 
@@ -473,6 +485,22 @@ describe('builtin runtime contract helpers', () => {
     expect(indexAddress(other, 0)).not.toBe(indexAddress(left, 0))
   })
 
+  it('resolves unsafe byte addresses within numeric slice elements', () => {
+    const words = makeSlice<number>(2, undefined, 'number')
+    const first = indexByteAddress(words, 0, 8)
+    const second = indexByteAddress(words, 1, 8)
+
+    expect(second - first).toBe(8)
+    unsafePointerRef<number>(first + 1).value = 0x12
+    unsafePointerRef<number>(first + 7).value = 0x80
+    expect(unsafePointerRef<number>(first + 1).value).toBe(0x12)
+    expect(unsafePointerRef<number>(first + 7).value).toBe(0x80)
+    expect(words![0]).toBe(0x8000000000001200n as unknown as number)
+
+    unsafePointerRef<number>(second).value = 0x34
+    expect(words![1]).toBe(0x34)
+  })
+
   it('exposes owned pointer handles for addressable collection elements', () => {
     const values = [1, 2, 3, 4]
     const second = indexRef(values, 1)

package/gs/builtin/slice.ts

@@ -76,6 +76,14 @@ interface GoSliceObject<T> {
 const addressStride = 0x100000000
 let nextAddressBase = 1
 const addressBases = new WeakMap<object, number>()
+const byteAddressBases = new WeakMap<object, number>()
+const byteAddressSources = new globalThis.Map<number, ByteAddressSource>()
+
+interface ByteAddressSource {
+  byteLength: number
+  getByte(offset: number): number
+  setByte(offset: number, value: number): void
+}
 
 /**
  * SliceProxy is a proxy object for complex slices
@@ -129,9 +137,7 @@ function wrapSliceProxy<T>(proxy: SliceProxy<T>): SliceProxy<T> {
         if (index < meta.length) {
           return meta.backing[meta.offset + index]
         }
-        throw new Error(
-          `Slice index out of range: ${index} >= ${meta.length}`,
-        )
+        throw new Error(`Slice index out of range: ${index} >= ${meta.length}`)
       }
 
       if (prop === 'length') {
@@ -153,9 +159,7 @@ function wrapSliceProxy<T>(proxy: SliceProxy<T>): SliceProxy<T> {
           target[index] = value // Also update the proxy target for consistency
           return true
         }
-        throw new Error(
-          `Slice index out of range: ${index} >= ${meta.length}`,
-        )
+        throw new Error(`Slice index out of range: ${index} >= ${meta.length}`)
       }
 
       if (prop === 'length' || prop === '__meta__') {
@@ -329,7 +333,12 @@ export const makeSlice = <T>(
       return new Uint8Array(length) as Slice<T>
     }
 
-    return byteSliceView(new Uint8Array(actualCapacity), 0, length, actualCapacity) as Slice<T>
+    return byteSliceView(
+      new Uint8Array(actualCapacity),
+      0,
+      length,
+      actualCapacity,
+    ) as Slice<T>
   }
 
   const actualCapacity = capacity === undefined ? length : capacity
@@ -535,8 +544,7 @@ export function goSlice<T>( // T can be number for Uint8Array case
   if (s instanceof Uint8Array) {
     const meta = byteSliceMeta(s)
     const metaBacking = meta?.backing as unknown
-    const backing =
-      metaBacking instanceof Uint8Array ? metaBacking : s
+    const backing = metaBacking instanceof Uint8Array ? metaBacking : s
     const baseOffset = meta?.offset ?? 0
     const baseCapacity = meta?.capacity ?? s.length
     const actualLow = low ?? 0
@@ -1003,8 +1011,7 @@ export function append<T>(
 function appendByteSlice(slice: Uint8Array, elements: any[]): Uint8Array {
   const meta = byteSliceMeta(slice)
   const metaBacking = meta?.backing as unknown
-  const backing =
-    metaBacking instanceof Uint8Array ? metaBacking : slice
+  const backing = metaBacking instanceof Uint8Array ? metaBacking : slice
   const offset = meta?.offset ?? 0
   const oldLength = slice.length
   const oldCapacity = meta?.capacity ?? oldLength
@@ -1032,12 +1039,18 @@ function byteElementLength(item: any): number {
     return len(item as Slice<any>)
   }
   if (typeof item !== 'number') {
-    throw new Error('Cannot produce Uint8Array: appended elements contain non-numbers.')
+    throw new Error(
+      'Cannot produce Uint8Array: appended elements contain non-numbers.',
+    )
   }
   return 1
 }
 
-function writeByteElements(dst: Uint8Array, offset: number, elements: any[]): void {
+function writeByteElements(
+  dst: Uint8Array,
+  offset: number,
+  elements: any[],
+): void {
   let cursor = offset
   for (const item of elements) {
     if (item instanceof Uint8Array) {
@@ -1060,7 +1073,9 @@ function writeByteElements(dst: Uint8Array, offset: number, elements: any[]): vo
       continue
     }
     if (typeof item !== 'number') {
-      throw new Error('Cannot produce Uint8Array: appended elements contain non-numbers.')
+      throw new Error(
+        'Cannot produce Uint8Array: appended elements contain non-numbers.',
+      )
     }
     dst[cursor] = item
     cursor++
@@ -1394,6 +1409,8 @@ export function sliceFromOwnedPointer<T>(
 export function arrayPointerFromIndexRef<T>(
   ref: VarRef<T>,
   length: number,
+  sourceElementByteSize = 1,
+  targetElementByteSize = sourceElementByteSize,
 ): VarRef<Slice<T> | T[] | Uint8Array> {
   const collection = ref.__goCollection as
     | Slice<T>
@@ -1406,12 +1423,25 @@ export function arrayPointerFromIndexRef<T>(
     )
   }
   const index = ref.__goIndex ?? 0
-  return varRef(
-    goSlice(collection as any, index, index + length) as
-      | Slice<T>
-      | T[]
-      | Uint8Array,
-  )
+  const view =
+    targetElementByteSize === 1 && sourceElementByteSize > 1 ?
+      byteArrayFromAddress(
+        indexByteAddress(collection, index, sourceElementByteSize),
+        length,
+      )
+    : (goSlice(collection as any, index, index + length) as
+        | Slice<T>
+        | T[]
+        | Uint8Array)
+  return {
+    get value() {
+      return view as Slice<T> | T[] | Uint8Array
+    },
+    set value(value: Slice<T> | T[] | Uint8Array) {
+      copy(view as any, value as any)
+    },
+    __isVarRef: true,
+  }
 }
 
 /**
@@ -1460,6 +1490,181 @@ export function indexAddress<T>(
   return base + backingIndex
 }
 
+function uintElementValue(value: unknown, byteSize: number): bigint {
+  const bits = BigInt(byteSize * 8)
+  if (typeof value === 'bigint') {
+    return BigInt.asUintN(Number(bits), value)
+  }
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    return BigInt.asUintN(Number(bits), BigInt(Math.trunc(value)))
+  }
+  return 0n
+}
+
+function uintElementResult(value: bigint, byteSize: number): number {
+  const normalized = BigInt.asUintN(byteSize * 8, value)
+  if (normalized <= BigInt(Number.MAX_SAFE_INTEGER)) {
+    return Number(normalized)
+  }
+  return normalized as unknown as number
+}
+
+function byteAddressBase(backing: object, source: ByteAddressSource): number {
+  let base = byteAddressBases.get(backing)
+  if (base === undefined) {
+    base = nextAddressBase * addressStride
+    nextAddressBase++
+    byteAddressBases.set(backing, base)
+  }
+  byteAddressSources.set(base, source)
+  return base
+}
+
+function numericByteSource(
+  backing: number[],
+  elementByteSize: number,
+): ByteAddressSource {
+  const byteSize = Math.max(1, Math.trunc(elementByteSize))
+  return {
+    byteLength: backing.length * byteSize,
+    getByte(offset: number): number {
+      const elementIndex = Math.trunc(offset / byteSize)
+      const byteOffset = offset % byteSize
+      const value = uintElementValue(backing[elementIndex], byteSize)
+      return Number((value >> BigInt(byteOffset * 8)) & 0xffn)
+    },
+    setByte(offset: number, value: number): void {
+      const elementIndex = Math.trunc(offset / byteSize)
+      const byteOffset = offset % byteSize
+      const shift = BigInt(byteOffset * 8)
+      const mask = 0xffn << shift
+      const current = uintElementValue(backing[elementIndex], byteSize)
+      const next = (current & ~mask) | ((BigInt(value) & 0xffn) << shift)
+      backing[elementIndex] = uintElementResult(next, byteSize)
+    },
+  }
+}
+
+/**
+ * indexByteAddress returns a byte-addressed synthetic address for unsafe
+ * uintptr arithmetic rooted at a slice or array element.
+ */
+export function indexByteAddress<T>(
+  collection: Slice<T> | T[] | Uint8Array,
+  index: number,
+  elementByteSize: number,
+): number {
+  if (collection === null || collection === undefined) {
+    throw new Error('runtime error: index on nil or undefined collection')
+  }
+
+  if (collection instanceof Uint8Array) {
+    if (index < 0 || index >= collection.length) {
+      throw new Error(
+        `runtime error: index out of range [${index}] with length ${collection.length}`,
+      )
+    }
+    const view = new Uint8Array(collection.buffer)
+    const base = byteAddressBase(collection.buffer, {
+      byteLength: view.length,
+      getByte(offset: number): number {
+        return view[offset]
+      },
+      setByte(offset: number, value: number): void {
+        view[offset] = value
+      },
+    })
+    return base + collection.byteOffset + index
+  }
+
+  if (isComplexSlice(collection)) {
+    if (index < 0 || index >= collection.__meta__.length) {
+      throw new Error(
+        `runtime error: index out of range [${index}] with length ${collection.__meta__.length}`,
+      )
+    }
+    const backing = collection.__meta__.backing as unknown as number[]
+    const byteSize = Math.max(1, Math.trunc(elementByteSize))
+    const base = byteAddressBase(backing, numericByteSource(backing, byteSize))
+    return base + (collection.__meta__.offset + index) * byteSize
+  }
+
+  if (Array.isArray(collection)) {
+    if (index < 0 || index >= collection.length) {
+      throw new Error(
+        `runtime error: index out of range [${index}] with length ${collection.length}`,
+      )
+    }
+    const byteSize = Math.max(1, Math.trunc(elementByteSize))
+    const base = byteAddressBase(
+      collection,
+      numericByteSource(collection as unknown as number[], byteSize),
+    )
+    return base + index * byteSize
+  }
+
+  throw new Error('runtime error: index on unsupported type')
+}
+
+/**
+ * unsafePointerRef resolves a byte-addressed synthetic unsafe pointer created
+ * by indexByteAddress back to an addressable byte reference.
+ */
+export function unsafePointerRef<T>(address: number | bigint): VarRef<T> {
+  const numericAddress = Number(address)
+  const base = Math.floor(numericAddress / addressStride) * addressStride
+  const source = byteAddressSources.get(base)
+  if (source === undefined) {
+    throw new Error(
+      'unsafe pointer dereference is not supported in JavaScript/TypeScript',
+    )
+  }
+  const offset = numericAddress - base
+  if (offset < 0 || offset >= source.byteLength) {
+    throw new Error('runtime error: unsafe pointer address out of range')
+  }
+  return {
+    get value(): T {
+      return source.getByte(offset) as T
+    },
+    set value(value: T) {
+      source.setByte(offset, value as number)
+    },
+    __isVarRef: true,
+  }
+}
+
+function byteArrayFromAddress(
+  address: number | bigint,
+  length: number,
+): number[] {
+  const start = Number(address)
+  const target = new Array<number>(length)
+  return new Proxy(target, {
+    get(arrayTarget, prop, receiver) {
+      const index = sliceIndexProperty(prop)
+      if (index >= 0) {
+        if (index >= length) {
+          throw new Error(`Slice index out of range: ${index} >= ${length}`)
+        }
+        return unsafePointerRef<number>(start + index).value
+      }
+      return Reflect.get(arrayTarget, prop, receiver)
+    },
+    set(arrayTarget, prop, value, receiver) {
+      const index = sliceIndexProperty(prop)
+      if (index >= 0) {
+        if (index >= length) {
+          throw new Error(`Slice index out of range: ${index} >= ${length}`)
+        }
+        unsafePointerRef<number>(start + index).value = value
+        return true
+      }
+      return Reflect.set(arrayTarget, prop, value, receiver)
+    },
+  })
+}
+
 /**
  * Converts a string to an array of Unicode code points (runes).
  * @param str The input string.

package/gs/github.com/aperturerobotics/protobuf-go-lite/index.test.ts

@@ -38,6 +38,8 @@ import {
   EqualVTSliceImplicit,
   type EqualVT,
   IsEqualVTSlice,
+  MarshalBoundMessageVT,
+  MarshalBoundMessageToSizedBufferVT,
   SizeBoolNonZero,
   SizeBoolPacked,
   SizeBoolPtr,
@@ -76,6 +78,7 @@ import {
   SizeZigzagSlice,
   SizeZigzagValue,
   Skip,
+  UnmarshalBoundMessageVT,
 } from './index.js'
 
 class TestValue {
@@ -146,6 +149,115 @@ class TestCloneMessage implements CloneMessage {
   }
 }
 
+class BrokenBoundMessage {}
+
+;(BrokenBoundMessage as any).__protobufTypeScriptMessage = {
+  typeName: 'test.BrokenBoundMessage',
+  fields: { list: () => [] },
+  fromBinary: () => ({}),
+  toBinary: () => {
+    throw new Error('invalid uint 32: undefined')
+  },
+}
+
+class BytesBoundMessage {
+  Config: $.Slice<number>
+
+  constructor(config: $.Slice<number>) {
+    this.Config = config
+  }
+}
+
+;(BytesBoundMessage as any).__protobufTypeScriptMessage = {
+  typeName: 'test.BytesBoundMessage',
+  fields: {
+    list: () => [{ localName: 'config', kind: 'scalar', T: 12 }],
+  },
+  fromBinary: () => ({}),
+  toBinary: (value: { config?: Uint8Array }) => {
+    expect(value.config).toBeInstanceOf(Uint8Array)
+    expect(Array.from(value.config ?? [])).toEqual([1, 2, 3])
+    return new Uint8Array([9])
+  },
+}
+
+class TimestampBoundMessage {
+  public get Seconds(): number {
+    return this._fields.Seconds.value
+  }
+  public set Seconds(value: number) {
+    this._fields.Seconds.value = value
+  }
+
+  public get Nanos(): number {
+    return this._fields.Nanos.value
+  }
+  public set Nanos(value: number) {
+    this._fields.Nanos.value = value
+  }
+
+  public _fields: {
+    Seconds: $.VarRef<number>
+    Nanos: $.VarRef<number>
+  }
+
+  constructor(init?: Partial<{ Seconds?: number; Nanos?: number }>) {
+    this._fields = {
+      Seconds: $.varRef(init?.Seconds ?? 0),
+      Nanos: $.varRef(init?.Nanos ?? 0),
+    }
+  }
+}
+
+const timestampMessageType = {
+  typeName: 'google.protobuf.Timestamp',
+  fields: {
+    list: () => [
+      { localName: 'seconds', kind: 'scalar' },
+      { localName: 'nanos', kind: 'scalar' },
+    ],
+  },
+}
+
+class TimestampParentBoundMessage {
+  public get Timestamp(): TimestampBoundMessage | null {
+    return this._fields.Timestamp.value
+  }
+  public set Timestamp(value: TimestampBoundMessage | null) {
+    this._fields.Timestamp.value = value
+  }
+
+  public _fields: {
+    Timestamp: $.VarRef<TimestampBoundMessage | null>
+  }
+
+  constructor(init?: Partial<{ Timestamp?: TimestampBoundMessage | null }>) {
+    this._fields = {
+      Timestamp: $.varRef(init?.Timestamp ?? null),
+    }
+  }
+}
+
+;(TimestampParentBoundMessage as any).__protobufTypeScriptMessage = {
+  typeName: 'test.TimestampParentBoundMessage',
+  fields: {
+    list: () => [
+      {
+        localName: 'timestamp',
+        kind: 'message',
+        T: timestampMessageType,
+      },
+    ],
+  },
+  fromBinary: () => ({
+    timestamp: new Date(Date.UTC(2026, 4, 31, 12, 34, 56, 789)),
+  }),
+  toBinary: () => new Uint8Array(),
+}
+;(TimestampParentBoundMessage as any).__protobufTypeScriptFields = {
+  timestamp: TimestampBoundMessage,
+}
+
 describe('protobuf-go-lite EqualVT helpers', () => {
   it('accepts compiler-emitted runtime type arguments', () => {
     const equal = CompareEqualVT<TestValue>({
@@ -245,6 +357,56 @@ describe('protobuf-go-lite runtime interfaces', () => {
   })
 })
 
+describe('protobuf-go-lite TypeScript binding helpers', () => {
+  it('adds message type context to binary marshal errors', () => {
+    const [, err] = MarshalBoundMessageVT(
+      BrokenBoundMessage as any,
+      new BrokenBoundMessage(),
+    )
+
+    expect(err?.Error()).toBe(
+      'marshal test.BrokenBoundMessage: invalid uint 32: undefined',
+    )
+  })
+
+  it('normalizes Go byte slices before binary marshal', () => {
+    const [bytes, err] = MarshalBoundMessageVT(
+      BytesBoundMessage as any,
+      new BytesBoundMessage([1, 2, 3]),
+    )
+
+    expect(err).toBeNull()
+    expect(Array.from(bytes ?? [])).toEqual([9])
+  })
+
+  it('returns bytes written after marshaling into a sized buffer', () => {
+    const target = new Uint8Array([0, 0, 0])
+    const [n, err] = MarshalBoundMessageToSizedBufferVT(
+      BytesBoundMessage as any,
+      new BytesBoundMessage([1, 2, 3]),
+      target,
+    )
+
+    expect(err).toBeNull()
+    expect(n).toBe(1)
+    expect(Array.from(target)).toEqual([0, 0, 9])
+  })
+
+  it('hydrates protobuf-es-lite timestamp Date fields into Go timestamp structs', () => {
+    const target = new TimestampParentBoundMessage()
+
+    const err = UnmarshalBoundMessageVT(
+      TimestampParentBoundMessage as any,
+      target,
+      new Uint8Array(),
+    )
+
+    expect(err).toBeNull()
+    expect(target.Timestamp?.Seconds).toBe(1780230896)
+    expect(target.Timestamp?.Nanos).toBe(789000000)
+  })
+})
+
 describe('protobuf-go-lite wire helpers', () => {
   it('encodes and decodes varints', () => {
     const buf = new Uint8Array(4)