@woven-canvas/core 1.0.5 → 1.0.9

package/README.md

@@ -27,7 +27,7 @@ loop();
 
 ## Documentation
 
-For full API documentation, see the [documentation site](https://wovencanvas.dev).
+For full API documentation, see [woven-canvas.dev](https://woven-canvas.dev).
 
 ## License
 

package/build/_tsup-dts-rollup.d.cts

@@ -169,7 +169,9 @@ declare const BlockDef: z.ZodObject<{
     }>>;
     canRotate: z.ZodDefault<z.ZodBoolean>;
     canScale: z.ZodDefault<z.ZodBoolean>;
+    snappable: z.ZodDefault<z.ZodBoolean>;
     interactable: z.ZodDefault<z.ZodBoolean>;
+    excludeFromRankBounds: z.ZodDefault<z.ZodBoolean>;
     connectors: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         terminals: z.ZodDefault<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
@@ -214,6 +216,7 @@ declare const BlockSchema: {
     rank: StringFieldBuilder;
     resizeMode: EnumFieldBuilder<"default" | "scale" | "text" | "free" | "groupOnly">;
     parentId: RefFieldBuilder;
+    layerId: RefFieldBuilder;
 };
 
 declare const blockSystem: EditorSystem;
@@ -270,6 +273,8 @@ declare function canBlockScale(ctx: Context, tag: string): boolean;
 export { canBlockScale }
 export { canBlockScale as canBlockScale_alias_1 }
 
+export declare function canBlockSnap(ctx: Context, tag: string): boolean;
+
 declare const canSeeBlocksSystem: EditorSystem;
 export { canSeeBlocksSystem }
 export { canSeeBlocksSystem as canSeeBlocksSystem_alias_1 }
@@ -382,7 +387,6 @@ export { Connector as Connector_alias_1 }
 export { Connector as Connector_alias_2 }
 
 export { Context }
-export { Context as Context_alias_1 }
 
 declare const Controls: ControlsDef;
 export { Controls }
@@ -447,6 +451,26 @@ declare const CorePluginOptionsSchema: z.ZodObject<{
 export { CorePluginOptionsSchema }
 export { CorePluginOptionsSchema as CorePluginOptionsSchema_alias_1 }
 
+declare function createBlock(ctx: Context, block: CreateBlockInput): EntityId;
+export { createBlock }
+export { createBlock as createBlock_alias_1 }
+export { createBlock as createBlock_alias_2 }
+
+declare interface CreateBlockInput {
+    tag: string;
+    position: Vec2;
+    size?: Vec2;
+    rotateZ?: number;
+    flip?: [boolean, boolean];
+    resizeMode?: ResizeMode;
+    parentId?: EntityId | null;
+    layerId?: EntityId | null;
+    rank?: string;
+}
+export { CreateBlockInput }
+export { CreateBlockInput as CreateBlockInput_alias_1 }
+export { CreateBlockInput as CreateBlockInput_alias_2 }
+
 declare function createCorePlugin(options?: CorePluginOptionsInput): EditorPlugin<CorePluginOptions>;
 export { createCorePlugin }
 export { createCorePlugin as createCorePlugin_alias_1 }
@@ -632,9 +656,12 @@ declare class Editor {
     constructor(domElement: HTMLElement | null, optionsInput?: EditorOptionsInput);
     private get ctx();
     initialize(): Promise<void>;
+    loadFont(name: string): Promise<void>;
+    isFontLoaded(name: string): boolean;
     tick(): Promise<void>;
     nextTick(callback: (ctx: Context) => void): () => void;
     command<T>(def: CommandDef<T>, ...args: T extends void ? [] : [T]): void;
+    get readonly(): boolean;
     subscribe(query: QueryDef, callback: QueryCallback): () => void;
     _getContext(): Context;
     attachDom(domElement: HTMLElement): void;
@@ -707,7 +734,9 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         resizeMode?: "scale" | "text" | "free" | "groupOnly" | undefined;
         canRotate?: boolean | undefined;
         canScale?: boolean | undefined;
+        snappable?: boolean | undefined;
         interactable?: boolean | undefined;
+        excludeFromRankBounds?: boolean | undefined;
         connectors?: {
             enabled?: boolean | undefined;
             terminals?: [number, number][] | undefined;
@@ -723,7 +752,9 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         resizeMode?: "scale" | "text" | "free" | "groupOnly" | undefined;
         canRotate?: boolean | undefined;
         canScale?: boolean | undefined;
+        snappable?: boolean | undefined;
         interactable?: boolean | undefined;
+        excludeFromRankBounds?: boolean | undefined;
         connectors?: {
             enabled?: boolean | undefined;
             terminals?: [number, number][] | undefined;
@@ -785,6 +816,7 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         wheelTool?: string | undefined;
         modWheelTool?: string | undefined;
     }>>;
+    readonly: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 
 declare interface EditorPlugin<TResources = unknown> {
@@ -822,6 +854,7 @@ declare interface EditorResources {
     singletonsByName: Map<string, AnyCanvasSingletonDef>;
     componentsById: Map<number, AnyCanvasComponentDef>;
     singletonsById: Map<number, AnyCanvasSingletonDef>;
+    readonly: boolean;
 }
 export { EditorResources }
 export { EditorResources as EditorResources_alias_1 }
@@ -922,8 +955,10 @@ export { FontFamilyInput }
 export { FontFamilyInput as FontFamilyInput_alias_1 }
 
 declare class FontLoader {
-    private loadedFonts;
+    private loaded;
+    private inFlight;
     loadFonts(families: FontFamily[]): Promise<void>;
+    loadFont(family: FontFamily): Promise<void>;
     private buildGoogleFontsUrl;
     private loadSingleFont;
     private getFontLoadPromises;
@@ -1127,6 +1162,7 @@ declare class HitGeometryDef extends CanvasComponentDef<typeof HitGeometrySchema
     getArcAt(ctx: Context, entityId: EntityId, index: number): Arc;
     setArcAt(ctx: Context, entityId: EntityId, index: number, arc: Arc): void;
     containsPointWorld(ctx: Context, entityId: EntityId, point: Vec2): boolean;
+    private fillWorldPolygon;
     intersectsAabbWorld(ctx: Context, entityId: EntityId, aabb: Aabb_2): boolean;
     getExtremaWorld(ctx: Context, entityId: EntityId): Vec2[];
     addCapsule(ctx: Context, entityId: EntityId, capsule: Capsule): void;
@@ -1135,6 +1171,7 @@ declare class HitGeometryDef extends CanvasComponentDef<typeof HitGeometrySchema
     addArc(ctx: Context, entityId: EntityId, arc: Arc): void;
     addArcUv(ctx: Context, entityId: EntityId, uvA: Vec2, uvB: Vec2, uvC: Vec2, worldThickness: number): void;
     addArcWorld(ctx: Context, entityId: EntityId, worldA: Vec2, worldB: Vec2, worldC: Vec2, worldThickness: number): void;
+    setPolygonUv(ctx: Context, entityId: EntityId, uvPoints: Vec2[]): void;
     clear(ctx: Context, entityId: EntityId): void;
 }
 
@@ -1143,6 +1180,8 @@ declare const HitGeometrySchema: {
     capsuleCount: NumberFieldBuilder<"uint16">;
     hitArcs: BufferFieldBuilder<"float32">;
     arcCount: NumberFieldBuilder<"uint16">;
+    hitPolygon: BufferFieldBuilder<"float32">;
+    polygonPointCount: NumberFieldBuilder<"uint16">;
 };
 
 declare const hoverCursorSystem: EditorSystem;
@@ -1223,6 +1262,15 @@ export { isHeldByRemote }
 export { isHeldByRemote as isHeldByRemote_alias_1 }
 export { isHeldByRemote as isHeldByRemote_alias_2 }
 
+declare function isLayerInteractive(ctx: Context, layerId: EntityId | null): boolean;
+export { isLayerInteractive }
+export { isLayerInteractive as isLayerInteractive_alias_1 }
+export { isLayerInteractive as isLayerInteractive_alias_2 }
+
+declare function isReadonly(ctx: Context): boolean;
+export { isReadonly }
+export { isReadonly as isReadonly_alias_1 }
+
 declare const Key: {
     readonly A: number;
     readonly B: number;
@@ -1388,6 +1436,17 @@ declare const keyboardSystem: EditorSystem;
 export { keyboardSystem }
 export { keyboardSystem as keyboardSystem_alias_1 }
 
+declare const Layer: CanvasComponentDef<    {
+parentId: RefFieldBuilder;
+rank: StringFieldBuilder;
+label: StringFieldBuilder;
+locked: BooleanFieldBuilder;
+hidden: BooleanFieldBuilder;
+}, "layer">;
+export { Layer }
+export { Layer as Layer_alias_1 }
+export { Layer as Layer_alias_2 }
+
 declare interface MachineResult<TState, TContext> {
     value: TState;
     context: TContext;
@@ -1407,6 +1466,11 @@ export { MAX_HIT_CAPSULES }
 export { MAX_HIT_CAPSULES as MAX_HIT_CAPSULES_alias_1 }
 export { MAX_HIT_CAPSULES as MAX_HIT_CAPSULES_alias_2 }
 
+declare const MAX_HIT_POLYGON_POINTS = 128;
+export { MAX_HIT_POLYGON_POINTS }
+export { MAX_HIT_POLYGON_POINTS as MAX_HIT_POLYGON_POINTS_alias_1 }
+export { MAX_HIT_POLYGON_POINTS as MAX_HIT_POLYGON_POINTS_alias_2 }
+
 declare const Mouse: MouseDef;
 export { Mouse }
 export { Mouse as Mouse_alias_1 }
@@ -1470,6 +1534,13 @@ declare function parsePlugin(input: EditorPluginInput): EditorPlugin;
 export { parsePlugin }
 export { parsePlugin as parsePlugin_alias_1 }
 
+declare const PlaceBlockEvent: CommandDef<    {
+entityId: EntityId;
+}>;
+export { PlaceBlockEvent }
+export { PlaceBlockEvent as PlaceBlockEvent_alias_1 }
+export { PlaceBlockEvent as PlaceBlockEvent_alias_2 }
+
 declare const Pointer: PointerDef;
 export { Pointer }
 export { Pointer as Pointer_alias_1 }
@@ -1666,6 +1737,11 @@ export { resolveEmbedUrl }
 export { resolveEmbedUrl as resolveEmbedUrl_alias_1 }
 export { resolveEmbedUrl as resolveEmbedUrl_alias_2 }
 
+declare function resolveLayerRank(ctx: Context, entityId: EntityId): string;
+export { resolveLayerRank }
+export { resolveLayerRank as resolveLayerRank_alias_1 }
+export { resolveLayerRank as resolveLayerRank_alias_2 }
+
 declare function resolveRefFields(ctx: Context, entityId: EntityId, componentDef: {
     schema: ComponentSchema_2;
     write: (ctx: Context, entityId: EntityId) => Record<string, unknown>;
@@ -1868,6 +1944,7 @@ declare interface SortableBlock {
     rank: string;
     stratum: Stratum;
     parentId: unknown;
+    layerRank?: string;
 }
 export { SortableBlock }
 export { SortableBlock as SortableBlock_alias_1 }

package/build/_tsup-dts-rollup.d.ts

@@ -169,7 +169,9 @@ declare const BlockDef: z.ZodObject<{
     }>>;
     canRotate: z.ZodDefault<z.ZodBoolean>;
     canScale: z.ZodDefault<z.ZodBoolean>;
+    snappable: z.ZodDefault<z.ZodBoolean>;
     interactable: z.ZodDefault<z.ZodBoolean>;
+    excludeFromRankBounds: z.ZodDefault<z.ZodBoolean>;
     connectors: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         terminals: z.ZodDefault<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
@@ -214,6 +216,7 @@ declare const BlockSchema: {
     rank: StringFieldBuilder;
     resizeMode: EnumFieldBuilder<"default" | "scale" | "text" | "free" | "groupOnly">;
     parentId: RefFieldBuilder;
+    layerId: RefFieldBuilder;
 };
 
 declare const blockSystem: EditorSystem;
@@ -270,6 +273,8 @@ declare function canBlockScale(ctx: Context, tag: string): boolean;
 export { canBlockScale }
 export { canBlockScale as canBlockScale_alias_1 }
 
+export declare function canBlockSnap(ctx: Context, tag: string): boolean;
+
 declare const canSeeBlocksSystem: EditorSystem;
 export { canSeeBlocksSystem }
 export { canSeeBlocksSystem as canSeeBlocksSystem_alias_1 }
@@ -382,7 +387,6 @@ export { Connector as Connector_alias_1 }
 export { Connector as Connector_alias_2 }
 
 export { Context }
-export { Context as Context_alias_1 }
 
 declare const Controls: ControlsDef;
 export { Controls }
@@ -447,6 +451,26 @@ declare const CorePluginOptionsSchema: z.ZodObject<{
 export { CorePluginOptionsSchema }
 export { CorePluginOptionsSchema as CorePluginOptionsSchema_alias_1 }
 
+declare function createBlock(ctx: Context, block: CreateBlockInput): EntityId;
+export { createBlock }
+export { createBlock as createBlock_alias_1 }
+export { createBlock as createBlock_alias_2 }
+
+declare interface CreateBlockInput {
+    tag: string;
+    position: Vec2;
+    size?: Vec2;
+    rotateZ?: number;
+    flip?: [boolean, boolean];
+    resizeMode?: ResizeMode;
+    parentId?: EntityId | null;
+    layerId?: EntityId | null;
+    rank?: string;
+}
+export { CreateBlockInput }
+export { CreateBlockInput as CreateBlockInput_alias_1 }
+export { CreateBlockInput as CreateBlockInput_alias_2 }
+
 declare function createCorePlugin(options?: CorePluginOptionsInput): EditorPlugin<CorePluginOptions>;
 export { createCorePlugin }
 export { createCorePlugin as createCorePlugin_alias_1 }
@@ -632,9 +656,12 @@ declare class Editor {
     constructor(domElement: HTMLElement | null, optionsInput?: EditorOptionsInput);
     private get ctx();
     initialize(): Promise<void>;
+    loadFont(name: string): Promise<void>;
+    isFontLoaded(name: string): boolean;
     tick(): Promise<void>;
     nextTick(callback: (ctx: Context) => void): () => void;
     command<T>(def: CommandDef<T>, ...args: T extends void ? [] : [T]): void;
+    get readonly(): boolean;
     subscribe(query: QueryDef, callback: QueryCallback): () => void;
     _getContext(): Context;
     attachDom(domElement: HTMLElement): void;
@@ -707,7 +734,9 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         resizeMode?: "scale" | "text" | "free" | "groupOnly" | undefined;
         canRotate?: boolean | undefined;
         canScale?: boolean | undefined;
+        snappable?: boolean | undefined;
         interactable?: boolean | undefined;
+        excludeFromRankBounds?: boolean | undefined;
         connectors?: {
             enabled?: boolean | undefined;
             terminals?: [number, number][] | undefined;
@@ -723,7 +752,9 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         resizeMode?: "scale" | "text" | "free" | "groupOnly" | undefined;
         canRotate?: boolean | undefined;
         canScale?: boolean | undefined;
+        snappable?: boolean | undefined;
         interactable?: boolean | undefined;
+        excludeFromRankBounds?: boolean | undefined;
         connectors?: {
             enabled?: boolean | undefined;
             terminals?: [number, number][] | undefined;
@@ -785,6 +816,7 @@ export declare const EditorOptionsSchema: z.ZodObject<{
         wheelTool?: string | undefined;
         modWheelTool?: string | undefined;
     }>>;
+    readonly: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 
 declare interface EditorPlugin<TResources = unknown> {
@@ -822,6 +854,7 @@ declare interface EditorResources {
     singletonsByName: Map<string, AnyCanvasSingletonDef>;
     componentsById: Map<number, AnyCanvasComponentDef>;
     singletonsById: Map<number, AnyCanvasSingletonDef>;
+    readonly: boolean;
 }
 export { EditorResources }
 export { EditorResources as EditorResources_alias_1 }
@@ -922,8 +955,10 @@ export { FontFamilyInput }
 export { FontFamilyInput as FontFamilyInput_alias_1 }
 
 declare class FontLoader {
-    private loadedFonts;
+    private loaded;
+    private inFlight;
     loadFonts(families: FontFamily[]): Promise<void>;
+    loadFont(family: FontFamily): Promise<void>;
     private buildGoogleFontsUrl;
     private loadSingleFont;
     private getFontLoadPromises;
@@ -1127,6 +1162,7 @@ declare class HitGeometryDef extends CanvasComponentDef<typeof HitGeometrySchema
     getArcAt(ctx: Context, entityId: EntityId, index: number): Arc;
     setArcAt(ctx: Context, entityId: EntityId, index: number, arc: Arc): void;
     containsPointWorld(ctx: Context, entityId: EntityId, point: Vec2): boolean;
+    private fillWorldPolygon;
     intersectsAabbWorld(ctx: Context, entityId: EntityId, aabb: Aabb_2): boolean;
     getExtremaWorld(ctx: Context, entityId: EntityId): Vec2[];
     addCapsule(ctx: Context, entityId: EntityId, capsule: Capsule): void;
@@ -1135,6 +1171,7 @@ declare class HitGeometryDef extends CanvasComponentDef<typeof HitGeometrySchema
     addArc(ctx: Context, entityId: EntityId, arc: Arc): void;
     addArcUv(ctx: Context, entityId: EntityId, uvA: Vec2, uvB: Vec2, uvC: Vec2, worldThickness: number): void;
     addArcWorld(ctx: Context, entityId: EntityId, worldA: Vec2, worldB: Vec2, worldC: Vec2, worldThickness: number): void;
+    setPolygonUv(ctx: Context, entityId: EntityId, uvPoints: Vec2[]): void;
     clear(ctx: Context, entityId: EntityId): void;
 }
 
@@ -1143,6 +1180,8 @@ declare const HitGeometrySchema: {
     capsuleCount: NumberFieldBuilder<"uint16">;
     hitArcs: BufferFieldBuilder<"float32">;
     arcCount: NumberFieldBuilder<"uint16">;
+    hitPolygon: BufferFieldBuilder<"float32">;
+    polygonPointCount: NumberFieldBuilder<"uint16">;
 };
 
 declare const hoverCursorSystem: EditorSystem;
@@ -1223,6 +1262,15 @@ export { isHeldByRemote }
 export { isHeldByRemote as isHeldByRemote_alias_1 }
 export { isHeldByRemote as isHeldByRemote_alias_2 }
 
+declare function isLayerInteractive(ctx: Context, layerId: EntityId | null): boolean;
+export { isLayerInteractive }
+export { isLayerInteractive as isLayerInteractive_alias_1 }
+export { isLayerInteractive as isLayerInteractive_alias_2 }
+
+declare function isReadonly(ctx: Context): boolean;
+export { isReadonly }
+export { isReadonly as isReadonly_alias_1 }
+
 declare const Key: {
     readonly A: number;
     readonly B: number;
@@ -1388,6 +1436,17 @@ declare const keyboardSystem: EditorSystem;
 export { keyboardSystem }
 export { keyboardSystem as keyboardSystem_alias_1 }
 
+declare const Layer: CanvasComponentDef<    {
+parentId: RefFieldBuilder;
+rank: StringFieldBuilder;
+label: StringFieldBuilder;
+locked: BooleanFieldBuilder;
+hidden: BooleanFieldBuilder;
+}, "layer">;
+export { Layer }
+export { Layer as Layer_alias_1 }
+export { Layer as Layer_alias_2 }
+
 declare interface MachineResult<TState, TContext> {
     value: TState;
     context: TContext;
@@ -1407,6 +1466,11 @@ export { MAX_HIT_CAPSULES }
 export { MAX_HIT_CAPSULES as MAX_HIT_CAPSULES_alias_1 }
 export { MAX_HIT_CAPSULES as MAX_HIT_CAPSULES_alias_2 }
 
+declare const MAX_HIT_POLYGON_POINTS = 128;
+export { MAX_HIT_POLYGON_POINTS }
+export { MAX_HIT_POLYGON_POINTS as MAX_HIT_POLYGON_POINTS_alias_1 }
+export { MAX_HIT_POLYGON_POINTS as MAX_HIT_POLYGON_POINTS_alias_2 }
+
 declare const Mouse: MouseDef;
 export { Mouse }
 export { Mouse as Mouse_alias_1 }
@@ -1470,6 +1534,13 @@ declare function parsePlugin(input: EditorPluginInput): EditorPlugin;
 export { parsePlugin }
 export { parsePlugin as parsePlugin_alias_1 }
 
+declare const PlaceBlockEvent: CommandDef<    {
+entityId: EntityId;
+}>;
+export { PlaceBlockEvent }
+export { PlaceBlockEvent as PlaceBlockEvent_alias_1 }
+export { PlaceBlockEvent as PlaceBlockEvent_alias_2 }
+
 declare const Pointer: PointerDef;
 export { Pointer }
 export { Pointer as Pointer_alias_1 }
@@ -1666,6 +1737,11 @@ export { resolveEmbedUrl }
 export { resolveEmbedUrl as resolveEmbedUrl_alias_1 }
 export { resolveEmbedUrl as resolveEmbedUrl_alias_2 }
 
+declare function resolveLayerRank(ctx: Context, entityId: EntityId): string;
+export { resolveLayerRank }
+export { resolveLayerRank as resolveLayerRank_alias_1 }
+export { resolveLayerRank as resolveLayerRank_alias_2 }
+
 declare function resolveRefFields(ctx: Context, entityId: EntityId, componentDef: {
     schema: ComponentSchema_2;
     write: (ctx: Context, entityId: EntityId) => Record<string, unknown>;
@@ -1868,6 +1944,7 @@ declare interface SortableBlock {
     rank: string;
     stratum: Stratum;
     parentId: unknown;
+    layerRank?: string;
 }
 export { SortableBlock }
 export { SortableBlock as SortableBlock_alias_1 }