@woven-canvas/core 1.0.6 → 1.0.10

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,6 +169,7 @@ 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<{
@@ -215,6 +216,7 @@ declare const BlockSchema: {
     rank: StringFieldBuilder;
     resizeMode: EnumFieldBuilder<"default" | "scale" | "text" | "free" | "groupOnly">;
     parentId: RefFieldBuilder;
+    layerId: RefFieldBuilder;
 };
 
 declare const blockSystem: EditorSystem;
@@ -271,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 }
@@ -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,6 +656,8 @@ 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;
@@ -708,6 +734,7 @@ 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?: {
@@ -725,6 +752,7 @@ 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?: {
@@ -927,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;
@@ -1132,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;
@@ -1140,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;
 }
 
@@ -1148,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;
@@ -1228,6 +1262,11 @@ 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 }
@@ -1397,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;
@@ -1416,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 }
@@ -1479,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 }
@@ -1675,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>;
@@ -1877,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,6 +169,7 @@ 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<{
@@ -215,6 +216,7 @@ declare const BlockSchema: {
     rank: StringFieldBuilder;
     resizeMode: EnumFieldBuilder<"default" | "scale" | "text" | "free" | "groupOnly">;
     parentId: RefFieldBuilder;
+    layerId: RefFieldBuilder;
 };
 
 declare const blockSystem: EditorSystem;
@@ -271,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 }
@@ -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,6 +656,8 @@ 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;
@@ -708,6 +734,7 @@ 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?: {
@@ -725,6 +752,7 @@ 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?: {
@@ -927,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;
@@ -1132,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;
@@ -1140,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;
 }
 
@@ -1148,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;
@@ -1228,6 +1262,11 @@ 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 }
@@ -1397,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;
@@ -1416,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 }
@@ -1479,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 }
@@ -1675,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>;
@@ -1877,6 +1944,7 @@ declare interface SortableBlock {
     rank: string;
     stratum: Stratum;
     parentId: unknown;
+    layerRank?: string;
 }
 export { SortableBlock }
 export { SortableBlock as SortableBlock_alias_1 }