pixifact 0.2.1 → 0.3.0

package/dist/compiler/pixiNodeSchema.d.ts

@@ -1,5 +1,5 @@
 import type { SceneTemplatePrimitiveType, SceneTemplateValue } from './spec.js';
-export type PixiSceneNodeType = Extract<SceneTemplatePrimitiveType, 'Container' | 'Sprite' | 'NineSliceSprite' | 'TilingSprite' | 'Text' | 'BitmapText' | 'HTMLText' | 'Graphics' | 'Rect' | 'Image' | 'NineImage' | 'TileImage' | 'GridContainer' | 'HBoxContainer' | 'ScrollContainer' | 'VBoxContainer'>;
+export type PixiSceneNodeType = Extract<SceneTemplatePrimitiveType, 'Group' | 'Container' | 'Sprite' | 'NineSliceSprite' | 'TilingSprite' | 'Text' | 'BitmapText' | 'HTMLText' | 'Graphics' | 'Rect' | 'Image' | 'NineImage' | 'TileImage' | 'GridContainer' | 'HBoxContainer' | 'ScrollContainer' | 'VBoxContainer'>;
 export type PixiSceneFieldType = 'string' | 'number' | 'boolean' | 'color' | 'enum';
 export type PixiScenePropGroup = 'transform' | 'display' | 'sprite' | 'nineSlice' | 'tiling' | 'text' | 'graphics' | 'stack' | 'props';
 export interface PixiSceneFieldSchema {
@@ -33,7 +33,7 @@ export declare const pixiSceneScrollProps: readonly ["direction", "scrollX", "sc
 export declare const pixiSceneTextStyleProps: readonly ["fontSize", "fontFamily", "fontWeight", "fill"];
 export declare const pixiSceneSpriteLikeProps: readonly ["texture", "anchorX", "anchorY", "tint", "texture", "fit", "anchorX", "anchorY", "tint", "texture", "leftWidth", "rightWidth", "topHeight", "bottomHeight", "anchorX", "anchorY", "tint", "texture", "tilePositionX", "tilePositionY", "tileScaleX", "tileScaleY", "tileRotation", "anchorX", "anchorY", "tint", "leftWidth", "rightWidth", "topHeight", "bottomHeight", "tilePositionX", "tilePositionY", "tileScaleX", "tileScaleY", "tileRotation"];
 export declare const pixiSceneKnownProps: readonly ["x", "y", "width", "height", "scaleX", "scaleY", "rotation", "pivotX", "pivotY", "skewX", "skewY", "left", "right", "top", "bottom", "horizontal", "vertical", "alpha", "visible", "zIndex", "eventMode", "cursor", "label", "texture", "anchorX", "anchorY", "tint", "texture", "fit", "anchorX", "anchorY", "tint", "texture", "leftWidth", "rightWidth", "topHeight", "bottomHeight", "anchorX", "anchorY", "tint", "texture", "tilePositionX", "tilePositionY", "tileScaleX", "tileScaleY", "tileRotation", "anchorX", "anchorY", "tint", "leftWidth", "rightWidth", "topHeight", "bottomHeight", "tilePositionX", "tilePositionY", "tileScaleX", "tileScaleY", "tileRotation", "text", "fontSize", "fontFamily", "fontWeight", "fill", "shape", "radius", "fill", "fillAlpha", "strokeColor", "strokeWidth", "strokeAlpha", "fillColor", "fillAlpha", "strokeColor", "strokeAlpha", "strokeWidth", "radius", "columns", "gap", "gapX", "gapY", "alignX", "alignY", "justify", "direction", "scrollX", "scrollY"];
-export declare const pixiSceneAddableNodeTypes: readonly ["GridContainer", "HBoxContainer", "ScrollContainer", "VBoxContainer", "Container", "Sprite", "NineSliceSprite", "TilingSprite", "Text", "BitmapText", "HTMLText", "Graphics", "Rect", "Image", "NineImage", "TileImage"];
+export declare const pixiSceneAddableNodeTypes: readonly ["Group", "GridContainer", "HBoxContainer", "ScrollContainer", "VBoxContainer", "Container", "Sprite", "NineSliceSprite", "TilingSprite", "Text", "BitmapText", "HTMLText", "Graphics", "Rect", "Image", "NineImage", "TileImage"];
 export declare const pixiSceneNodePropGroupOrder: readonly ["stack", "sprite", "nineSlice", "tiling", "text", "graphics", "props"];
 export declare function pixiSceneNodeSchema(type: PixiSceneNodeType): PixiSceneNodeSchema;
 export declare function isPixiSceneNodeType(type: SceneTemplatePrimitiveType): type is PixiSceneNodeType;

package/dist/compiler/pixiNodeSchema.js

@@ -155,6 +155,7 @@ export const pixiSceneKnownProps = [
     ...pixiSceneScrollProps,
 ];
 export const pixiSceneAddableNodeTypes = [
+    'Group',
     'GridContainer',
     'HBoxContainer',
     'ScrollContainer',
@@ -243,6 +244,15 @@ const pixiSceneFieldSchemas = {
     scrollY: { key: 'scrollY', type: 'number' },
 };
 const pixiSceneNodeSchemas = {
+    Group: {
+        type: 'Group',
+        acceptsChildren: true,
+        defaults: {
+            width: 100,
+            height: 100,
+        },
+        groups: {},
+    },
     Container: {
         type: 'Container',
         acceptsChildren: true,

package/dist/compiler/sceneValidation.js

@@ -149,7 +149,7 @@ function validatePixiNode(node, path, existingAssets) {
             prop: 'children',
             expected: 'no child nodes',
             actual: `${node.children.length} ${node.children.length === 1 ? 'child node' : 'child nodes'}`,
-            hint: `${node.type} is a leaf drawing node. Wrap it and sibling content in a Container or Group Scene.`,
+            hint: `${node.type} is a leaf drawing node. Wrap it and sibling content in a <Container> or <Group>.`,
         });
     }
     const knownProps = new Set([

package/dist/compiler/scriptInterfaceExtractor.js

@@ -28,6 +28,9 @@ function extractSceneScriptClasses(source, fileName, options) {
             }
             continue;
         }
+        if (isSceneClass && sceneConstructorHasParameters(statement)) {
+            throw new Error(`@scene class "${className}" must not declare constructor parameters. Use @prop() or an explicit method after construction.`);
+        }
         const props = {};
         const events = {};
         const slots = {};
@@ -258,6 +261,9 @@ function hasSceneDecorator(node) {
     }
     return true;
 }
+function sceneConstructorHasParameters(node) {
+    return node.members.some((member) => ts.isConstructorDeclaration(member) && member.parameters.length > 0);
+}
 function parentClassNameOf(node) {
     const heritage = node.heritageClauses?.find((item) => item.token === ts.SyntaxKind.ExtendsKeyword);
     const parent = heritage?.types[0]?.expression;

package/dist/compiler/spec.d.ts

@@ -1,4 +1,4 @@
-export type SceneTemplatePrimitiveType = 'Container' | 'Sprite' | 'Text' | 'Graphics' | 'Rect' | 'Image' | 'NineImage' | 'TileImage' | 'BitmapText' | 'HTMLText' | 'Mesh' | 'NineSliceSprite' | 'TilingSprite' | 'DOMContainer' | 'GridContainer' | 'HBoxContainer' | 'ScrollContainer' | 'VBoxContainer';
+export type SceneTemplatePrimitiveType = 'Group' | 'Container' | 'Sprite' | 'Text' | 'Graphics' | 'Rect' | 'Image' | 'NineImage' | 'TileImage' | 'BitmapText' | 'HTMLText' | 'Mesh' | 'NineSliceSprite' | 'TilingSprite' | 'DOMContainer' | 'GridContainer' | 'HBoxContainer' | 'ScrollContainer' | 'VBoxContainer';
 export type SceneTemplateScalarValue = string | number | boolean;
 export type SceneTemplateStructValue = Record<string, SceneTemplateScalarValue>;
 export type SceneTemplateValue = SceneTemplateScalarValue | SceneTemplateStructValue;

package/dist/compiler/templateParser.js

@@ -1,6 +1,7 @@
 import { pixiSceneFieldSchema } from './pixiNodeSchema.js';
 import { builtinSceneAssetId, isBuiltinSceneName } from './builtinScenes.js';
 const pixiTypes = new Set([
+    'Group',
     'Container',
     'Sprite',
     'Text',

package/dist/compiler/typescriptCompiler.js

@@ -6,7 +6,7 @@ const spriteProps = new Set(pixiSceneSpriteLikeProps);
 const graphicsProps = new Set(pixiSceneGraphicsProps);
 const rectProps = new Set(pixiSceneRectProps);
 const textStyleProps = new Set(pixiSceneTextStyleProps);
-const runtimeNodeTypes = new Set(['GridContainer', 'HBoxContainer', 'ScrollContainer', 'VBoxContainer', 'Rect', 'Image', 'NineImage', 'TileImage']);
+const runtimeNodeTypes = new Set(['Group', 'GridContainer', 'HBoxContainer', 'ScrollContainer', 'VBoxContainer', 'Rect', 'Image', 'NineImage', 'TileImage']);
 const runtimeNodeProps = new Set(['columns', 'gap', 'gapX', 'gapY', 'alignX', 'alignY', 'justify', 'direction', 'scrollX', 'scrollY']);
 export function compileSceneTemplateToTs(template, options = {}) {
     const context = new CompileContext(template, options);
@@ -77,7 +77,7 @@ class CompileContext {
                 ...[...this.#imports].filter((item) => item !== 'Container').sort(),
                 ...[...this.#pixiImports].sort(),
             ])];
-        const runtimeImports = ['Group', ...[...this.#pixiRuntimeImports].sort()];
+        const runtimeImports = [...new Set(['Group', ...[...this.#pixiRuntimeImports].sort()])];
         const lines = [`import { ${imports.join(', ')} } from 'pixi.js';`, `import { ${runtimeImports.join(', ')} } from 'pixifact/runtime';`];
         for (const [texture, variable] of this.#textureImportEntries()) {
             lines.push(`import ${variable} from ${JSON.stringify(this.options.textureImports?.[texture])};`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixifact",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Pixifact 2D UI 和轻量游戏 Scene 语义框架。",
   "packageManager": "bun@1.3.13",
   "main": "./dist/index.js",