aspid-id-struct

aspid-id-struct

Generate the boilerplate consumers need to add a new project-wide id type backed by Aspid.FastTools.Ids.

When this skill applies

Trigger when the user asks for any of:

• "create an id struct for X" / "add a unique id for X"
• "make X a project-wide id" / "stable int id for X"
• "register X in IdRegistry"
• references to [UniqueId], IId, IdRegistry, or IdStructGenerator

Do not trigger for plain integer enums, Guid, or non-Aspid id systems.

What the user gets

The package's IdStructGenerator does the heavy lifting. The user only writes a partial struct that implements IId. The generator emits:

• private int _id; (serialized field)
• public int Id => _id;
• editor-only __stringId (drives the registry-aware drawer)

Generated file naming: {StructName}.IId.g.cs.

Steps

1. Pick a name and namespace

If the user did not give a name, suggest one based on the domain (ItemId, EnemyId, AbilityId, SfxId). Confirm before writing.

The struct must live in a runtime assembly (player-build), i.e. not under Editor/ and not in an Aspid.FastTools.Unity.Editor-style asmdef.

2. Write the struct

using Aspid.FastTools.Ids;

namespace Game.Items
{
    public partial struct ItemId : IId { }
}

Required properties:

• partial — without it the generator emits nothing.
• Implements IId — the generator checks AllInterfaces for Aspid.FastTools.Ids.IId.
• Public visibility is recommended; internal works if the consumer is the same assembly.

Do not add _id field, Id property, or any other body member — they are generated.

3. Create the registry asset

Tell the user to create the asset in the editor:

Assets → Create → Aspid → Id Registry

Each IId struct binds to exactly one IdRegistry asset. The package's IdRegistryResolver enforces uniqueness at lookup time. If the user already has a registry for this struct, they should reuse it; the editor drawer will warn on duplicates.