@modular-circuit/ir 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -689,12 +689,14 @@ interface IR_Port extends IR_GraphItem {
     type: PortType | string;
 }
 
+type ModuleCircuitId = string;
+declare const block_is_associated_with_concrete_module: (block_type: IR_Block["type"]) => block_type is ModuleCircuitId;
 interface IR_Block extends IR_GraphItem {
     name?: string;
     /**
-     * 模块类型
+     * 模块类型(索引)，可以是作者+名称，或者直接就是模块ID
      */
-    type: ModuleName;
+    type: ModuleName | ModuleCircuitId;
     /**
      * 模块摆到画布上之后的ID
      */
@@ -709,6 +711,21 @@ interface IR_GND extends PowerBase {
     param?: GroundParam;
 }
 
+/**
+ * @since 0.1.1 Port generated by AI or manual mock data
+ */
+interface AbstractPort extends IR_GraphItem {
+    port: PortLike | string;
+}
+
+/**
+ * @since 0.1.1 Block generated by AI or manual mock data
+ */
+interface AbstractBlock extends IR_GraphItem {
+    name: string;
+    ports: AbstractPort[];
+}
+
 interface IR_Junction extends IR_GraphItem {
 }
 
@@ -724,9 +741,10 @@ interface IR_PowerSym extends PowerBase {
 interface IR_Wire extends IR_GraphItem, Connection {
 }
 
+type IR_BLOCK_T = IR_Block | AbstractBlock;
 interface IR_Graph extends IR_GraphItem {
     name?: string;
-    blocks?: IR_Block[];
+    blocks?: IR_BLOCK_T[];
     wires?: IR_Wire[];
     gnd?: IR_GND[];
     pwr?: IR_PowerSym[];
@@ -734,6 +752,8 @@ interface IR_Graph extends IR_GraphItem {
     junctions?: IR_Junction[];
 }
 
+declare const block_is_abstract: (block: IR_BLOCK_T) => block is AbstractBlock;
+
 declare const MODULAR_CIRCUIT_SCH_EXT = "modular_circuit";
 
-export { type Arc, type BASE_SYMBOL, type Bezier, type BlockBase, type BlockPort, type BomItem, type Bus, type BusAlias, type BusEntry, type Circle, type Component, type ComponentProperty, type ConcreteBlockDesign, type Design, type DesignPort, type Drawing, type EDA_DESIGN, type EDA_ITEM, type EDA_PORT_ANNOTATION, type EDA_PORT_ELECTRICAL_ANNOT, type EDA_TEXT, type EMBEDDED_FILE, type EMBEDDED_FILES, type Effects, FILE_TYPE, type Fill, type Font, type GeneralModuleDesign, type GlobalLabel, type GraphicItem, type HierarchicalLabel, type IR_Block, type IR_GND, type IR_Graph, type IR_GraphItem, type IR_Junction, type IR_Label, type IR_Port, type IR_PowerSym, type IR_Wire, type Junction, type Justify, KICAD_GND_NAME, type KiCadBlock, type LABEL_META, type LIB_SYMBOL, type LIB_SYMBOLS, type LabelType, MODULAR_CIRCUIT_EXT, MODULAR_CIRCUIT_SCH_EXT, type ModuleBlock, type ModuleBom, type ModuleCircuit, type ModuleDesignBase, type ModuleIndex, type ModuleName, type ModuleResolver, type ModuleSpec, type NetLabel, type NoConnect, type PIN_ALTERNATE, type PIN_DEFINITION, type PIN_DISPLAY_OPT, type PIN_INSTANCE, PORT_ANNOT_TYPE, type Paper, PaperSize, type PaperSizeName, type Polyline, type Project, type ProjectDesign, type PublishedProjectDesign, type Rectangle, type ReusableDesign, type RuntimeModuleCircuit, type SCHEMATIC, type SCH_FIELD, type SCH_IMAGE, type SCH_ITEM, type SCH_ITEM_PROPERTY, type SCH_LABEL, type SCH_LINE, type SCH_SHEET, type SCH_SHEET_INSTANCE, type SCH_SHEET_PIN, type SCH_SYMBOL, type SCH_SYMBOL_META, type SCH_SYMBOL_PROPERTIES, type SCH_TEXT, type SCH_TEXT_BOX, type SERIALIZABLE, SHAPE_T, SHEET_FIELD_TYPE, type SYMBOL_INSTANCE, type SheetInstance, type SheetInstances, type Stroke, type Tag, type TextBox, type TitleBlock, parse_eda_annotation };
+export { type AbstractBlock, type AbstractPort, type Arc, type BASE_SYMBOL, type Bezier, type BlockBase, type BlockPort, type BomItem, type Bus, type BusAlias, type BusEntry, type Circle, type Component, type ComponentProperty, type ConcreteBlockDesign, type Design, type DesignPort, type Drawing, type EDA_DESIGN, type EDA_ITEM, type EDA_PORT_ANNOTATION, type EDA_PORT_ELECTRICAL_ANNOT, type EDA_TEXT, type EMBEDDED_FILE, type EMBEDDED_FILES, type Effects, FILE_TYPE, type Fill, type Font, type GeneralModuleDesign, type GlobalLabel, type GraphicItem, type HierarchicalLabel, type IR_BLOCK_T, type IR_Block, type IR_GND, type IR_Graph, type IR_GraphItem, type IR_Junction, type IR_Label, type IR_Port, type IR_PowerSym, type IR_Wire, type Junction, type Justify, KICAD_GND_NAME, type KiCadBlock, type LABEL_META, type LIB_SYMBOL, type LIB_SYMBOLS, type LabelType, MODULAR_CIRCUIT_EXT, MODULAR_CIRCUIT_SCH_EXT, type ModuleBlock, type ModuleBom, type ModuleCircuit, type ModuleCircuitId, type ModuleDesignBase, type ModuleIndex, type ModuleName, type ModuleResolver, type ModuleSpec, type NetLabel, type NoConnect, type PIN_ALTERNATE, type PIN_DEFINITION, type PIN_DISPLAY_OPT, type PIN_INSTANCE, PORT_ANNOT_TYPE, type Paper, PaperSize, type PaperSizeName, type Polyline, type Project, type ProjectDesign, type PublishedProjectDesign, type Rectangle, type ReusableDesign, type RuntimeModuleCircuit, type SCHEMATIC, type SCH_FIELD, type SCH_IMAGE, type SCH_ITEM, type SCH_ITEM_PROPERTY, type SCH_LABEL, type SCH_LINE, type SCH_SHEET, type SCH_SHEET_INSTANCE, type SCH_SHEET_PIN, type SCH_SYMBOL, type SCH_SYMBOL_META, type SCH_SYMBOL_PROPERTIES, type SCH_TEXT, type SCH_TEXT_BOX, type SERIALIZABLE, SHAPE_T, SHEET_FIELD_TYPE, type SYMBOL_INSTANCE, type SheetInstance, type SheetInstances, type Stroke, type Tag, type TextBox, type TitleBlock, block_is_abstract, block_is_associated_with_concrete_module, parse_eda_annotation };

package/dist/index.d.ts

@@ -689,12 +689,14 @@ interface IR_Port extends IR_GraphItem {
     type: PortType | string;
 }
 
+type ModuleCircuitId = string;
+declare const block_is_associated_with_concrete_module: (block_type: IR_Block["type"]) => block_type is ModuleCircuitId;
 interface IR_Block extends IR_GraphItem {
     name?: string;
     /**
-     * 模块类型
+     * 模块类型(索引)，可以是作者+名称，或者直接就是模块ID
      */
-    type: ModuleName;
+    type: ModuleName | ModuleCircuitId;
     /**
      * 模块摆到画布上之后的ID
      */
@@ -709,6 +711,21 @@ interface IR_GND extends PowerBase {
     param?: GroundParam;
 }
 
+/**
+ * @since 0.1.1 Port generated by AI or manual mock data
+ */
+interface AbstractPort extends IR_GraphItem {
+    port: PortLike | string;
+}
+
+/**
+ * @since 0.1.1 Block generated by AI or manual mock data
+ */
+interface AbstractBlock extends IR_GraphItem {
+    name: string;
+    ports: AbstractPort[];
+}
+
 interface IR_Junction extends IR_GraphItem {
 }
 
@@ -724,9 +741,10 @@ interface IR_PowerSym extends PowerBase {
 interface IR_Wire extends IR_GraphItem, Connection {
 }
 
+type IR_BLOCK_T = IR_Block | AbstractBlock;
 interface IR_Graph extends IR_GraphItem {
     name?: string;
-    blocks?: IR_Block[];
+    blocks?: IR_BLOCK_T[];
     wires?: IR_Wire[];
     gnd?: IR_GND[];
     pwr?: IR_PowerSym[];
@@ -734,6 +752,8 @@ interface IR_Graph extends IR_GraphItem {
     junctions?: IR_Junction[];
 }
 
+declare const block_is_abstract: (block: IR_BLOCK_T) => block is AbstractBlock;
+
 declare const MODULAR_CIRCUIT_SCH_EXT = "modular_circuit";
 
-export { type Arc, type BASE_SYMBOL, type Bezier, type BlockBase, type BlockPort, type BomItem, type Bus, type BusAlias, type BusEntry, type Circle, type Component, type ComponentProperty, type ConcreteBlockDesign, type Design, type DesignPort, type Drawing, type EDA_DESIGN, type EDA_ITEM, type EDA_PORT_ANNOTATION, type EDA_PORT_ELECTRICAL_ANNOT, type EDA_TEXT, type EMBEDDED_FILE, type EMBEDDED_FILES, type Effects, FILE_TYPE, type Fill, type Font, type GeneralModuleDesign, type GlobalLabel, type GraphicItem, type HierarchicalLabel, type IR_Block, type IR_GND, type IR_Graph, type IR_GraphItem, type IR_Junction, type IR_Label, type IR_Port, type IR_PowerSym, type IR_Wire, type Junction, type Justify, KICAD_GND_NAME, type KiCadBlock, type LABEL_META, type LIB_SYMBOL, type LIB_SYMBOLS, type LabelType, MODULAR_CIRCUIT_EXT, MODULAR_CIRCUIT_SCH_EXT, type ModuleBlock, type ModuleBom, type ModuleCircuit, type ModuleDesignBase, type ModuleIndex, type ModuleName, type ModuleResolver, type ModuleSpec, type NetLabel, type NoConnect, type PIN_ALTERNATE, type PIN_DEFINITION, type PIN_DISPLAY_OPT, type PIN_INSTANCE, PORT_ANNOT_TYPE, type Paper, PaperSize, type PaperSizeName, type Polyline, type Project, type ProjectDesign, type PublishedProjectDesign, type Rectangle, type ReusableDesign, type RuntimeModuleCircuit, type SCHEMATIC, type SCH_FIELD, type SCH_IMAGE, type SCH_ITEM, type SCH_ITEM_PROPERTY, type SCH_LABEL, type SCH_LINE, type SCH_SHEET, type SCH_SHEET_INSTANCE, type SCH_SHEET_PIN, type SCH_SYMBOL, type SCH_SYMBOL_META, type SCH_SYMBOL_PROPERTIES, type SCH_TEXT, type SCH_TEXT_BOX, type SERIALIZABLE, SHAPE_T, SHEET_FIELD_TYPE, type SYMBOL_INSTANCE, type SheetInstance, type SheetInstances, type Stroke, type Tag, type TextBox, type TitleBlock, parse_eda_annotation };
+export { type AbstractBlock, type AbstractPort, type Arc, type BASE_SYMBOL, type Bezier, type BlockBase, type BlockPort, type BomItem, type Bus, type BusAlias, type BusEntry, type Circle, type Component, type ComponentProperty, type ConcreteBlockDesign, type Design, type DesignPort, type Drawing, type EDA_DESIGN, type EDA_ITEM, type EDA_PORT_ANNOTATION, type EDA_PORT_ELECTRICAL_ANNOT, type EDA_TEXT, type EMBEDDED_FILE, type EMBEDDED_FILES, type Effects, FILE_TYPE, type Fill, type Font, type GeneralModuleDesign, type GlobalLabel, type GraphicItem, type HierarchicalLabel, type IR_BLOCK_T, type IR_Block, type IR_GND, type IR_Graph, type IR_GraphItem, type IR_Junction, type IR_Label, type IR_Port, type IR_PowerSym, type IR_Wire, type Junction, type Justify, KICAD_GND_NAME, type KiCadBlock, type LABEL_META, type LIB_SYMBOL, type LIB_SYMBOLS, type LabelType, MODULAR_CIRCUIT_EXT, MODULAR_CIRCUIT_SCH_EXT, type ModuleBlock, type ModuleBom, type ModuleCircuit, type ModuleCircuitId, type ModuleDesignBase, type ModuleIndex, type ModuleName, type ModuleResolver, type ModuleSpec, type NetLabel, type NoConnect, type PIN_ALTERNATE, type PIN_DEFINITION, type PIN_DISPLAY_OPT, type PIN_INSTANCE, PORT_ANNOT_TYPE, type Paper, PaperSize, type PaperSizeName, type Polyline, type Project, type ProjectDesign, type PublishedProjectDesign, type Rectangle, type ReusableDesign, type RuntimeModuleCircuit, type SCHEMATIC, type SCH_FIELD, type SCH_IMAGE, type SCH_ITEM, type SCH_ITEM_PROPERTY, type SCH_LABEL, type SCH_LINE, type SCH_SHEET, type SCH_SHEET_INSTANCE, type SCH_SHEET_PIN, type SCH_SYMBOL, type SCH_SYMBOL_META, type SCH_SYMBOL_PROPERTIES, type SCH_TEXT, type SCH_TEXT_BOX, type SERIALIZABLE, SHAPE_T, SHEET_FIELD_TYPE, type SYMBOL_INSTANCE, type SheetInstance, type SheetInstances, type Stroke, type Tag, type TextBox, type TitleBlock, block_is_abstract, block_is_associated_with_concrete_module, parse_eda_annotation };

package/dist/index.js

@@ -28,6 +28,8 @@ __export(index_exports, {
   PaperSize: () => PaperSize,
   SHAPE_T: () => SHAPE_T,
   SHEET_FIELD_TYPE: () => SHEET_FIELD_TYPE,
+  block_is_abstract: () => block_is_abstract,
+  block_is_associated_with_concrete_module: () => block_is_associated_with_concrete_module,
   parse_eda_annotation: () => parse_eda_annotation
 });
 module.exports = __toCommonJS(index_exports);
@@ -108,6 +110,16 @@ function parse_eda_annotation(eda_annotation) {
   return { pin_type: import_electronics_model.ELECTRICAL_PINTYPE.PT_POWER_IN, port_annot_type: 2 /* GLOBAL_POWER_PIN */ };
 }
 
+// src/graph/ir_block.ts
+var block_is_associated_with_concrete_module = (block_type) => {
+  return typeof block_type === "string";
+};
+
+// src/graph/utils/block_is_abstract.ts
+var block_is_abstract = (block) => {
+  return !("type" in block);
+};
+
 // src/constraints/index.ts
 var MODULAR_CIRCUIT_SCH_EXT = "modular_circuit";
 // Annotate the CommonJS export names for ESM import in node:
@@ -120,5 +132,7 @@ var MODULAR_CIRCUIT_SCH_EXT = "modular_circuit";
   PaperSize,
   SHAPE_T,
   SHEET_FIELD_TYPE,
+  block_is_abstract,
+  block_is_associated_with_concrete_module,
   parse_eda_annotation
 });

package/dist/index.mjs

@@ -74,6 +74,16 @@ function parse_eda_annotation(eda_annotation) {
   return { pin_type: ELECTRICAL_PINTYPE.PT_POWER_IN, port_annot_type: 2 /* GLOBAL_POWER_PIN */ };
 }
 
+// src/graph/ir_block.ts
+var block_is_associated_with_concrete_module = (block_type) => {
+  return typeof block_type === "string";
+};
+
+// src/graph/utils/block_is_abstract.ts
+var block_is_abstract = (block) => {
+  return !("type" in block);
+};
+
 // src/constraints/index.ts
 var MODULAR_CIRCUIT_SCH_EXT = "modular_circuit";
 export {
@@ -85,5 +95,7 @@ export {
   PaperSize,
   SHAPE_T,
   SHEET_FIELD_TYPE,
+  block_is_abstract,
+  block_is_associated_with_concrete_module,
   parse_eda_annotation
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modular-circuit/ir",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Intermediate representation of the modular circuit",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -8,8 +8,7 @@
   "exports": {
     ".": {
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     }
   },
   "files": [
@@ -27,7 +26,7 @@
     "typescript": "^5.4.5"
   },
   "dependencies": {
-    "@modular-circuit/electronics-model": "0.1.0"
+    "@modular-circuit/electronics-model": "0.1.1"
   },
   "scripts": {
     "clean": "rimraf dist",