sandstone 1.0.0 → 1.0.1

package/src/commands/implementations/player/waypoint.ts

@@ -1,4 +1,4 @@
-import type { BASIC_COLORS, SingleEntityArgumentOf } from 'sandstone/arguments'
+import type { SingleEntityArgumentOf, TextColor } from 'sandstone/arguments'
 import type { Macroable, WaypointStyleClass } from 'sandstone/core'
 import { CommandNode } from 'sandstone/core/nodes'
 import { targetParser } from 'sandstone/variables/parsers'
@@ -39,7 +39,7 @@ export class WaypointModifyArguments<MACRO extends boolean> extends CommandArgum
    *
    * @param name One of the 16 standard Minecraft color names.
    */
-  color(name: Macroable<Exclude<BASIC_COLORS, 'reset'>, MACRO>): FinalCommandOutput
+  color(name: Macroable<Exclude<TextColor, 'reset'>, MACRO>): FinalCommandOutput
 
   /**
    * Resets the waypoint color to its default (randomly chosen by the game, or the entity's team color).
@@ -67,7 +67,7 @@ export class WaypointModifyArguments<MACRO extends boolean> extends CommandArgum
    */
   color(type: 'rgb%', color: [number, number, number]): FinalCommandOutput
 
-  color(type: Macroable<BASIC_COLORS | 'hex' | 'rgb' | 'rgb%', MACRO>, color?: Macroable<number | string | [number, number, number], MACRO>) {
+  color(type: Macroable<TextColor | 'reset' | 'hex' | 'rgb' | 'rgb%', MACRO>, color?: Macroable<number | string | [number, number, number], MACRO>) {
     if (type === 'hex') {
       if (typeof color !== 'number') {
         return this.finalCommand(['color', 'hex', color])

package/src/commands/implementations/world/item.ts

@@ -5,14 +5,18 @@ import type {
   RootNBT,
   EntitySlotSelector,
   ContainerSlotSelector,
+  MCDocToJSON,
+  SymbolDataComponent,
+  NBTObject,
 } from 'sandstone/arguments'
 import type { ItemModifierClass, Macroable } from 'sandstone/core'
 import { CommandNode } from 'sandstone/core/nodes'
-import type { LiteralUnion } from 'sandstone/utils'
+import type { LiteralUnion, MemberModifiers } from 'sandstone/utils'
 import { nbtResolver } from 'sandstone/variables'
 import { coordinatesParser, targetParser } from 'sandstone/variables/parsers'
 import type { FinalCommandOutput } from '../../helpers'
 import { CommandArguments } from '../../helpers'
+import { componentPatchStringifier } from '../player/give';
 
 export class ItemCommandNode extends CommandNode {
   command = 'item' as const
@@ -34,17 +38,17 @@ export class ItemSourceCommand<MACRO extends boolean> extends CommandArguments {
    */
   with(
     item: Macroable<Registry['minecraft:item'], MACRO>,
-    nbt: Macroable<RootNBT, MACRO>,
+    components: Macroable<MemberModifiers<MCDocToJSON<SymbolDataComponent>>, MACRO>,
     count: Macroable<number, MACRO>,
   ): FinalCommandOutput
 
   with(
     item: Macroable<Registry['minecraft:item'], MACRO>,
-    countOrNBT?: Macroable<number | RootNBT, MACRO>,
+    countOrNBT?: Macroable<number | MemberModifiers<MCDocToJSON<SymbolDataComponent>>, MACRO>,
     count?: Macroable<number, MACRO>,
   ) {
     if (typeof countOrNBT === 'object') {
-      return this.finalCommand(['with', `${item}${nbtResolver(countOrNBT)}`, count])
+      return this.finalCommand(['with', `${item}${componentPatchStringifier(countOrNBT as any)}`, count])
     }
     return this.finalCommand(['with', item, countOrNBT])
   }
@@ -58,7 +62,7 @@ export class ItemSourceCommand<MACRO extends boolean> extends CommandArguments {
     block: (
       pos: Macroable<Coordinates<MACRO>, MACRO>,
       slot: Macroable<LiteralUnion<ContainerSlotSelector>, MACRO>,
-      modifier?: Macroable<string | ItemModifierClass, MACRO>,
+      modifier?: Macroable<`${any}${string}` | ItemModifierClass, MACRO>,
     ) => this.finalCommand(['from', 'block', pos, slot, modifier]),
 
     /**
@@ -69,7 +73,7 @@ export class ItemSourceCommand<MACRO extends boolean> extends CommandArguments {
     entity: (
       targets: Macroable<MultipleEntitiesArgument<MACRO>, MACRO>,
       slot: Macroable<LiteralUnion<EntitySlotSelector>, MACRO>,
-      modifier?: Macroable<string | ItemModifierClass, MACRO>,
+      modifier?: Macroable<`${any}${string}` | ItemModifierClass, MACRO>,
     ) => this.finalCommand(['from', 'entity', targetParser(targets), slot, modifier]),
   }
 }
@@ -95,7 +99,7 @@ export class ItemCommand<MACRO extends boolean> extends CommandArguments {
     block: (
       pos: Macroable<Coordinates<MACRO>, MACRO>,
       slot: Macroable<LiteralUnion<ContainerSlotSelector>, MACRO>,
-      modifier: Macroable<string | ItemModifierClass, MACRO>,
+      modifier: Macroable<`${any}${string}` | ItemModifierClass, MACRO>,
     ) => this.finalCommand(['modify', 'block', coordinatesParser(pos), slot, modifier]),
 
     /**
@@ -106,7 +110,7 @@ export class ItemCommand<MACRO extends boolean> extends CommandArguments {
     entity: (
       targets: Macroable<MultipleEntitiesArgument<MACRO>, MACRO>,
       slot: Macroable<LiteralUnion<EntitySlotSelector>, MACRO>,
-      modifier: Macroable<string | ItemModifierClass, MACRO>,
+      modifier: Macroable<`${any}${string}` | ItemModifierClass, MACRO>,
     ) => this.finalCommand(['modify', 'entity', targetParser(targets), slot, modifier]),
   }
 

package/src/core/Macro.ts

@@ -100,6 +100,8 @@ export class DataPointPickClass extends MacroArgument {
 }
 
 export class ConditionalDataPointPickClass extends DataPointPickClass implements ConditionClass {
+  declare readonly __conditionClassBrand: true
+
   /**
    * @internal
    */

package/src/core/mcmeta.ts

@@ -3,7 +3,7 @@ import AdmZip from 'adm-zip'
 import fs from 'fs-extra'
 import lodash from 'lodash'
 import { getSandstoneContext } from 'sandstone/context'
-import { fetch, safeWrite } from 'sandstone/utils'
+import { safeWrite } from 'sandstone/utils'
 
 export type MCMetaBranches = 'assets' | 'atlas' | 'data' | 'registries' | 'summary'
 
@@ -46,7 +46,7 @@ export class MCMetaCache {
     this.version = manifest.version
 
     const getZip = async (branch: string) =>
-      new AdmZip(await (await fetch(`https://github.com${this.base}archive/refs/heads/${branch}.zip`)).buffer())
+      new AdmZip(Buffer.from(await (await fetch(`https://github.com${this.base}archive/refs/heads/${branch}.zip`)).arrayBuffer()))
 
     if (!(await fs.pathExists(this.lockFile))) {
       if (manifest.files.length > 10) {
@@ -58,12 +58,18 @@ export class MCMetaCache {
         for await (const [file, text] of Object.entries(manifest.files)) {
           const _path = file.split('/')
 
-          let contents: Buffer | string = await new Promise((res) => {
-            archives[_path[0]].readFileAsync(_path.slice(1).join('/'), (data) => res(data as Buffer))
+          let contents: Buffer<ArrayBufferLike> | string = await new Promise((res, rej) => {
+            archives[_path[0]].readFileAsync(_path.slice(1).join('/'), (data) => {
+              if (data === null) {
+                rej('[mcmeta] adm-zip got null')
+              } else {
+                res(data)
+              }
+            })
           })
 
           if (text) {
-            contents = contents.toString('utf-8')
+            contents = contents.toString()
           }
 
           await safeWrite(path.join(this.path, file), contents as any)
@@ -103,12 +109,18 @@ export class MCMetaCache {
           for await (const [file, text] of Object.entries(manifest.files)) {
             const _path = file.split('/')
 
-            let contents: Buffer | string = await new Promise((res) => {
-              archives[_path[0]].readFileAsync(_path.slice(1).join('/'), (data) => res(data as Buffer))
+            let contents: Buffer<ArrayBufferLike> | string = await new Promise((res, rej) => {
+              archives[_path[0]].readFileAsync(_path.slice(1).join('/'), (data) => {
+                if (data === null) {
+                  rej('[mcmeta] adm-zip got null')
+                } else {
+                  res(data)
+                }
+              })
             })
 
             if (text) {
-              contents = contents.toString('utf-8')
+              contents = contents.toString()
             }
 
             await safeWrite(path.join(this.path, file), contents as any)
@@ -139,12 +151,18 @@ export class MCMetaCache {
                 archives[branch] = await getZip(branch)
               }
 
-              let contents: Buffer | string = await new Promise((res) => {
-                archives[branch].readFileAsync(_path.slice(1).join('/'), (data) => res(data as Buffer))
+              let contents: Buffer<ArrayBufferLike> | string = await new Promise((res, rej) => {
+                archives[branch].readFileAsync(_path.slice(1).join('/'), (data) => {
+                  if (data === null) {
+                    rej('[mcmeta] adm-zip got null')
+                  } else {
+                    res(data)
+                  }
+                })
               })
 
               if (text) {
-                contents = contents.toString('utf-8')
+                contents = contents.toString()
               }
 
               await safeWrite(path.join(this.path, file), contents as any)
@@ -233,7 +251,7 @@ export class MCMetaCache {
 
     const req = await fetch(`https://raw.githubusercontent.com${this.base}${branch}/${relativePath}`)
 
-    const file = await (text ? req.text() : req.buffer())
+    const file = text ? await req.text() : Buffer.from(await req.arrayBuffer())
 
     const finalPath = path.join(this.path, fullPath)
 

package/src/core/resources/custom.ts

@@ -77,7 +77,7 @@ export abstract class CustomResourceClass extends ResourceClass<CustomResourceNo
     ).join('/')}`
   }
 
-  getValue(): string | Buffer | Promise<Buffer> {
+  getValue(): string | ArrayBuffer | Buffer | Promise<ArrayBuffer | Buffer | string> {
     throw new Error(`Custom Resource '${this.type}' getValue function is not defined!`)
   }
 

package/src/core/resources/datapack/advancement.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type MultiplePlayersArgumentOf, type SymbolResource } from 'sandstone/arguments'
+import { type MCDocToJSON, RESOURCE_PATHS, type MultiplePlayersArgumentOf, type SymbolResource } from 'sandstone/arguments'
 import type { ConditionClass } from 'sandstone/variables'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
@@ -19,16 +19,21 @@ export class AdvancementNode extends ContainerNode implements ResourceNode<Advan
   getValue = () => jsonStringify(this.resource.advancementJSON, this.resource._resourceType as keyof typeof RESOURCE_PATHS)
 }
 
-export type AdvancementClassArguments<AdvancementJSON extends SymbolResource['advancement'] | undefined = undefined> = {
+export type AdvancementClassArguments<AdvancementJSON extends MCDocToJSON<SymbolResource['advancement']> | undefined = undefined> = {
   /**
-   * The advancement's JSON.
+   * The advancement's JSON. NBT primitive classes (`NBTInt`, `NBTFloat`, ...)
+   * are deep-replaced with plain `number` (and `NBTIntArray` etc. with
+   * `number[]`) via `MCDocToJSON`, so you can write raw numeric literals
+   * instead of `NBT.int(5)`.
    */
   json: AdvancementJSON
 } & ResourceClassArguments<'default'>
 
-export class AdvancementClass<AdvancementJSON extends SymbolResource['advancement'] | undefined = undefined>
+export class AdvancementClass<AdvancementJSON extends MCDocToJSON<SymbolResource['advancement']> | undefined = undefined>
   extends ResourceClass<AdvancementNode>
   implements ConditionClass {
+  declare readonly __conditionClassBrand: true
+
   static readonly resourceType = 'advancement'
 
   public advancementJSON: AdvancementClassArguments<AdvancementJSON>['json']

package/src/core/resources/datapack/bannerPattern.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -22,7 +22,7 @@ export type BannerPatternClassArguments = {
   /**
    * The banner pattern's JSON.
    */
-  json: SymbolResource[(typeof BannerPatternClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof BannerPatternClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class BannerPatternClass extends ResourceClass<BannerPatternNode> {

package/src/core/resources/datapack/chatType.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -22,7 +22,7 @@ export type ChatTypeClassArguments = {
   /**
    * The chat type's JSON.
    */
-  json: SymbolResource[(typeof ChatTypeClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof ChatTypeClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class ChatTypeClass extends ResourceClass<ChatTypeNode> {

package/src/core/resources/datapack/damageType.ts

@@ -1,8 +1,8 @@
 /* eslint-disable max-len */
 
-import { RESOURCE_PATHS, type Coordinates, type SingleEntityArgument, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type Coordinates, type SingleEntityArgument, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import type { SetType } from 'sandstone/utils'
-import type { ComponentClass } from 'sandstone/variables'
+import type { TextComponentClass } from 'sandstone/variables'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -30,7 +30,7 @@ export type DamageTypeClassArguments = {
   /**
    * The damage type's JSON.
    */
-  json: SymbolResource[(typeof DamageTypeClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof DamageTypeClass)['resourceType']]>
 } & ResourceClassArguments<'default'> & {
     /**
      * Optional. Automatically adds damage type to minecraft damage type group tag flags.
@@ -38,7 +38,9 @@ export type DamageTypeClassArguments = {
     flags?: (SetType<typeof TAG_DAMAGE_TYPES_SET> | 'bypasses_cooldown')[] // Haha funny bypasses_cooldown doesn't show up in the server reports
   }
 
-export class DamageTypeClass extends ResourceClass<DamageTypeNode> implements ComponentClass {
+export class DamageTypeClass extends ResourceClass<DamageTypeNode> implements TextComponentClass {
+  declare readonly __textComponentClassBrand: true
+
   static readonly resourceType = 'damage_type' as const
 
   public damageTypeJSON: DamageTypeClassArguments['json']
@@ -132,7 +134,7 @@ export class DamageTypeClass extends ResourceClass<DamageTypeNode> implements Co
   }
 
   /** @internal */
-  _toChatComponent = () => ({ translate: this.translationKey })
+  _toChatComponent = () => ({ translate: this.translationKey as `${string}:${string}` })
 
   toString = () => this.name
 }

package/src/core/resources/datapack/dialog.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -22,7 +22,7 @@ export type DialogClassArguments = {
   /**
    * The dialog's JSON.
    */
-  json: SymbolResource[(typeof DialogClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof DialogClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class DialogClass extends ResourceClass<DialogNode> {

package/src/core/resources/datapack/enchantment.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -26,7 +26,7 @@ export type EnchantmentClassArguments = {
   /**
    * The enchantment's JSON.
    */
-  json: SymbolResource[(typeof EnchantmentClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof EnchantmentClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class EnchantmentClass extends ResourceClass<EnchantmentNode> {
@@ -72,7 +72,7 @@ export type EnchantmentProviderClassArguments = {
   /**
    * The enchantment provider's JSON.
    */
-  json: SymbolResource[(typeof EnchantmentProviderClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof EnchantmentProviderClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class EnchantmentProviderClass extends ResourceClass<EnchantmentProviderNode> {

package/src/core/resources/datapack/gametest.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -26,7 +26,7 @@ export type TestEnvironmentClassArguments = {
   /**
    * The test environment's JSON.
    */
-  json: SymbolResource[(typeof TestEnvironmentClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof TestEnvironmentClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class TestEnvironmentClass extends ResourceClass<TestEnvironmentNode> {
@@ -72,7 +72,7 @@ export type TestInstanceClassArguments = {
   /**
    * The test instance's JSON.
    */
-  json: SymbolResource[(typeof TestInstanceClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof TestInstanceClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class TestInstanceClass extends ResourceClass<TestInstanceNode> {

package/src/core/resources/datapack/instrument.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -22,7 +22,7 @@ export type InstrumentClassArguments = {
   /**
    * The instrument's JSON.
    */
-  json: SymbolResource[(typeof InstrumentClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof InstrumentClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class InstrumentClass extends ResourceClass<InstrumentNode> {

package/src/core/resources/datapack/itemModifier.ts

@@ -4,7 +4,7 @@ import {
   type Coordinates,
   type ENTITY_SLOTS,
   type MultipleEntitiesArgument,
-  type SymbolResource,
+  type MCDocToJSON, type SymbolResource,
 } from 'sandstone/arguments'
 import { targetParser } from 'sandstone/variables/parsers'
 import { ContainerNode } from '../../nodes'
@@ -26,13 +26,13 @@ export class ItemModifierNode extends ContainerNode implements ResourceNode<Item
   getValue = () => jsonStringify(this.resource.itemModifierJSON, this.resource._resourceType as keyof typeof RESOURCE_PATHS)
 }
 
-type ItemModifierJSON = SymbolResource['item_modifier']
+type ItemModifierJSON = MCDocToJSON<SymbolResource['item_modifier']>
 
 export type ItemModifierClassArguments = {
   /**
    * The item modifier's JSON.
    */
-  json: SymbolResource[(typeof ItemModifierClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof ItemModifierClass)['resourceType']]>
 } & ResourceClassArguments<'list'>
 
 type Modifier = ItemModifierJSON | ItemModifierClass

package/src/core/resources/datapack/jukeboxSong.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -22,7 +22,7 @@ export type JukeboxSongClassArguments = {
   /**
    * The jukebox song's JSON.
    */
-  json: SymbolResource[(typeof JukeboxSongClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof JukeboxSongClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class JukeboxSongClass extends ResourceClass<JukeboxSongNode> {

package/src/core/resources/datapack/lootTable.ts

@@ -5,7 +5,7 @@ import {
   type ENTITY_SLOTS,
   type MultipleEntitiesArgument,
   type MultiplePlayersArgumentOf,
-  type SymbolResource,
+  type MCDocToJSON, type SymbolResource,
 } from 'sandstone/arguments'
 import type { LiteralUnion } from 'sandstone/utils'
 import { ContainerNode } from '../../nodes'
@@ -31,7 +31,7 @@ export type LootTableClassArguments = {
   /**
    * The loot table's JSON.
    */
-  json: SymbolResource[(typeof LootTableClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof LootTableClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class LootTableClass extends ResourceClass<LootTableNode> {

package/src/core/resources/datapack/mcfunction.ts

@@ -479,13 +479,6 @@ export class _RawMCFunctionClass<
 
     this.node.body.splice(start, removeItems === 'auto' ? fullBody.length : removeItems, ...fullBody)
   }
-
-  /**
-   * @internal
-   */
-  toNBT() {
-    return this.name
-  }
 }
 
 export const MCFunctionClass = makeClassCallable(_RawMCFunctionClass)

package/src/core/resources/datapack/predicate.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import type { ConditionClass } from 'sandstone/variables'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
@@ -19,18 +19,20 @@ export class PredicateNode extends ContainerNode implements ResourceNode<Predica
   getValue = () => jsonStringify(this.resource.predicateJSON, this.resource._resourceType as keyof typeof RESOURCE_PATHS)
 }
 
-type PredicateJSON = NonNullable<SymbolResource['predicate']>
+type PredicateJSON = NonNullable<MCDocToJSON<SymbolResource['predicate']>>
 
 export type PredicateClassArguments = {
   /**
    * The predicate's JSON.
    */
-  json: SymbolResource[(typeof PredicateClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof PredicateClass)['resourceType']]>
 } & ResourceClassArguments<'list'>
 
 type Predicate = PredicateJSON | PredicateClass
 
 export class PredicateClass extends ResourceClass<PredicateNode> implements ListResource, ConditionClass {
+  declare readonly __conditionClassBrand: true
+
   static readonly resourceType = 'predicate' as const
 
   public predicateJSON: NonNullable<PredicateClassArguments['json']>

package/src/core/resources/datapack/recipe.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource, type MultiplePlayersArgumentOf } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource, type MultiplePlayersArgumentOf } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -22,7 +22,7 @@ export type RecipeClassArguments = {
   /**
    * The recipe's JSON.
    */
-  json: SymbolResource[(typeof RecipeClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof RecipeClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class RecipeClass extends ResourceClass<RecipeNode> {

package/src/core/resources/datapack/structure.ts

@@ -82,7 +82,7 @@ type VariableInsertion = Score | DataPointClass<'storage'>
 export class StructureClass extends ResourceClass<StructureNode> {
   static readonly resourceType = 'structure' as const
 
-  structureBuffer?: Promise<Buffer>
+  structureBuffer?: Promise<ArrayBuffer | Buffer>
 
   structureNBT?: StructureNBT
 
@@ -106,7 +106,7 @@ export class StructureClass extends ResourceClass<StructureNode> {
       } else if (args.structure.structureBuffer) {
         this.structureBuffer = args.structure.structureBuffer
       } else {
-        this.structureBuffer = args.structure.structure() as Promise<Buffer>
+        this.structureBuffer = args.structure.structure() as Promise<ArrayBuffer | Buffer>
       }
     } else if (Array.isArray(args.structure)) {
       this.structureNBT = this.arrayToNBT(args.structure)
@@ -117,7 +117,7 @@ export class StructureClass extends ResourceClass<StructureNode> {
     this.handleConflicts()
   }
 
-  structure(): StructureNBT | Promise<Buffer> {
+  structure(): StructureNBT | Promise<ArrayBuffer | Buffer> {
     if (this.structureNBT) {
       return this.structureNBT
     }
@@ -130,7 +130,7 @@ export class StructureClass extends ResourceClass<StructureNode> {
   }
 
   async readBuffer() {
-    this.structureNBT = await decodeStructure(await (this.structureBuffer as Promise<Buffer>))
+    this.structureNBT = await decodeStructure(await (this.structureBuffer as Promise<ArrayBuffer | Buffer>))
   }
 
   async array(): Promise<[[[StructureEntry]]]> {
@@ -457,7 +457,7 @@ function encodeStructure(nbt: StructureNBT) {
   )
 }
 
-async function decodeStructure(buffer: Buffer) {
+async function decodeStructure(buffer: ArrayBuffer | Buffer) {
   const nbt = await prismarine.parse(buffer)
 
   return prismarine.simplify(nbt.parsed) as StructureNBT

package/src/core/resources/datapack/tag.ts

@@ -139,6 +139,8 @@ type Resource<T extends LiteralUnion<REGISTRIES>> = Add<
 export class TagClass<REGISTRY extends LiteralUnion<REGISTRIES>>
   extends ResourceClass
   implements ListResource, ConditionClass, NBTSerializable {
+  declare readonly __conditionClassBrand: true
+
   static readonly resourceType = 'tag' as const
 
   readonly type: REGISTRY
@@ -146,6 +148,12 @@ export class TagClass<REGISTRY extends LiteralUnion<REGISTRIES>>
   readonly tagJSON: NonNullable<TagJSON<REGISTRY>>
 
   constructor(sandstoneCore: SandstoneCore, type: REGISTRY, name: string, args: TagClassArguments<REGISTRY>) {
+    if (type === ('entity' as REGISTRY)) {
+      console.warn(
+        `[TagClass] Tag type 'entity' is not a valid Minecraft tag registry. Did you mean 'entity_type'?`
+      )
+    }
+
     super(
       sandstoneCore,
       { packType: sandstoneCore.pack.dataPack(), extension: 'json' },
@@ -224,10 +232,6 @@ export class TagClass<REGISTRY extends LiteralUnion<REGISTRIES>>
     return this.name
   }
 
-  toNBT() {
-    return this.name
-  }
-
   /**
    * @internal
    */

package/src/core/resources/datapack/timeline.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -26,7 +26,7 @@ export type TimelineClassArguments = {
   /**
    * The timeline's JSON.
    */
-  json: SymbolResource[(typeof TimelineClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof TimelineClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class TimelineClass extends ResourceClass<TimelineNode> {
@@ -72,7 +72,7 @@ export type WorldClockClassArguments = {
   /**
    * The world clock's JSON.
    */
-  json: SymbolResource[(typeof WorldClockClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof WorldClockClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class WorldClockClass extends ResourceClass<WorldClockNode> {

package/src/core/resources/datapack/trialSpawner.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -22,7 +22,7 @@ export type TrialSpawnerClassArguments = {
   /**
    * The trial spawner configuration's JSON.
    */
-  json: SymbolResource[(typeof TrialSpawnerClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof TrialSpawnerClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class TrialSpawnerClass extends ResourceClass<TrialSpawnerNode> {

package/src/core/resources/datapack/trimMaterial.ts

@@ -1,4 +1,4 @@
-import { RESOURCE_PATHS, type SymbolResource } from 'sandstone/arguments'
+import { RESOURCE_PATHS, type MCDocToJSON, type SymbolResource } from 'sandstone/arguments'
 import { ContainerNode } from '../../nodes'
 import type { SandstoneCore } from '../../sandstoneCore'
 import type { ResourceClassArguments, ResourceNode } from '../resource'
@@ -23,7 +23,7 @@ export type TrimMaterialClassArguments = {
   /**
    * The trim material's JSON.
    */
-  json: SymbolResource[(typeof TrimMaterialClass)['resourceType']]
+  json: MCDocToJSON<SymbolResource[(typeof TrimMaterialClass)['resourceType']]>
 } & ResourceClassArguments<'default'>
 
 export class TrimMaterialClass extends ResourceClass<TrimMaterialNode> {