2026-06-01 05:21:23 +00:00
92 changed files with 556 additions and 1 deletions
@@ -1,3 +1,9 @@
+<!--
+Description: Project documentation for setup, deployment, and operational guidance.
+Inside functions: N/A - documentation content.
+Developer : Qin Yue @ 2026
+Organization : OptiHK Limited
+-->
 # mxPIC EDA Intranet Deployment

 ## Start on the office LAN
@@ -1,3 +1,9 @@
+<!--
+Description: Project documentation for setup, deployment, and operational guidance.
+Inside functions: N/A - documentation content.
+Developer : Qin Yue @ 2026
+Organization : OptiHK Limited
+-->
 # mxpic_EDA
 The EDA coding for the layout for optihk
 # requirements
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: EC_SiN400_1310_1p0dB_L635_A0_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: SQLite database initialization and persistence helpers for users, projects, cells, and project metadata.
+# Inside functions: connect_db, init_db, get_user, get_user_profile, get_user_auth_by_id, update_user_occupation, update_user_password, add_user_log, list_user_logs
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 # backend/database.py
 import sqlite3
 import os
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Directory configuration metadata used to locate PDK and project resources.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 level : 4

 root :  
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Backend integration wrapper for project GDS generation and build result handling.
+# Inside functions: build_project_gds, _build_with_mxpic_router, _load_project_cells, _ordered_cell_names, _cells_have_links, _build_with_gdstk, _import_public_gds, _build_with_nazca, _safe_cell_name, _library_cell_by_name, _number
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 import math
 import os
 import sys
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Layout preview helpers for generating SVG previews from saved layout YAML.
+# Inside functions: create_layout_svg_from_gds, _create_with_gdstk, _build_gdstk_cell, _resolve_child_cell, _import_gds_cell, _create_with_nazca, _load_local_layout, _safe_cell_name, _library_cell_by_name, _number
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 import os
 from typing import Dict, Optional

@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Role-aware PDK access control utilities for resolving which PDK roots a user or project may use.
+# Inside functions: normalize_user_group, pdk_root_for_group, pdk_root_for_session, prefer_full_gds_for_session, create_export_path, cleanup_expired_exports
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 import os
 import time
 import shutil
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK registry scanning helpers for finding component YAML/GDS assets and building library trees.
+# Inside functions: __init__, resolve, _find_yaml, _find_gds, _load_yaml, _inside_root
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 import os
 from dataclasses import dataclass
 from typing import Optional
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Routed layout preview helpers that invoke the routing/build flow and return preview artifacts.
+# Inside functions: create_routed_layout_svg, layout_has_links
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 import os
 import sys
 import tempfile
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Flask backend API server for authentication, project management, PDK library access, layout preview, and GDS build endpoints.
+# Inside functions: no_cache_response, login_required_json, wrapper, request_ip, record_action, safe_name, user_layout_root, project_root, cell_file_path, cell_svg_path, cell_routes_path, write_route_points_sidecar, project_gds_path, technology_manifest_path_for_project, current_pdk_root, current_pdk_registry, scoped_pdk_root_for_project, pdk_root_for_request_project, project_meta_path, read_project_meta
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------

 import os
 import re
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Technology manifest loading and fallback helpers for routing layers and cross-section defaults.
+# Inside functions: technology_manifest_path, read_technology_manifest
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 import os

 import yaml
@@ -1,3 +1,9 @@
+/*
+ * Description: Shared browser helper library for canvas geometry, component metadata normalization, route styling, YAML export, and validation.
+ * Inside functions: createForgeArguments, getTechnologyManifest, getXsectionInfo, createRouteSettings, updateRouteField, updateRouteXsection, routeStyleForSettings, isForgeComponent, isBasicComponent, createBasicSettings, normalizeAngle, portSideFromAngle, roundPercent, fallbackPercent, positiveNumber, normalizeBoxSize, chooseCategoryComponent, normalizeCanvasSize, clampPositionToCanvas, transformBoxCorner
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 (function (root, factory) {
  const helpers = factory();
  if (typeof module === 'object' && module.exports) {
@@ -1,4 +1,11 @@
 <!DOCTYPE html>
+
+<!--
+Description: Main MXPIC EDA canvas UI with React Flow editing, project pages, routing, layout build controls, and inspector panels.
+Inside functions: fetchIcon, RotatableNode, PortNode, AnchorNode, RightPanel, findComponentPath, loadProject, handleBasicConnection, buildElementNodesFromYaml.
+Developer : Qin Yue @ 2026
+Organization : OptiHK Limited
+-->
 <html lang="en">

 {% raw %}
@@ -5051,7 +5058,7 @@
      const onDrop = useCallback((event) => {
        event.preventDefault();
        const rawData = event.dataTransfer.getData('application/reactflow');
-        console.log("? DROP EVENT: Received raw data ->", rawData);
+        console.log("???DROP EVENT: Received raw data ->", rawData);
        if (!rawData) return;
        let parsedData;
        try {
@@ -1,4 +1,11 @@
 <!DOCTYPE html>
+
+<!--
+Description: Project dashboard page for listing, creating, opening, and managing user projects.
+Inside functions: addLog, applyTheme, openProject, loadProfile, loadProjects, loadTechnologies
+Developer : Qin Yue @ 2026
+Organization : OptiHK Limited
+-->
 <html lang="en">

 <head>
@@ -1,4 +1,11 @@
 <!DOCTYPE html>
+
+<!--
+Description: Login page for authenticating users before entering the MXPIC EDA workspace.
+Inside functions: applyTheme
+Developer : Qin Yue @ 2026
+Organization : OptiHK Limited
+-->
 <html lang="en">
 <head>
    <meta charset="UTF-8">
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZI_SiN400_Si220_PIN_mod_1310_L1300_QY_202603
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeA1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeA2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeA3_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeA4_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeA5_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeE1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeE2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeE3_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeE4_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeG1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeG2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeG3_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeG4_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeZ1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeZ2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeZ3_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_1600G_L3000_GSSG_TRAIL_TypeZ4_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeR1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeR2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeT1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeT2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeT3_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeT4_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeT5_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeV1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeV2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeW1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeW2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeW3_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeW4_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeX1_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeX2_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeX3_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeX4_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: MZM_800G_L3000_GSSG_TRAIL_TypeX5_QY_v1_20260303
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: INDC_200pH_SiNPP_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: RFPAD_GSSG_P625_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: Spec_PADs_ABCD_292_P125_250_W80_80_QY_20260324
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: RES_30OHM_NPP_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: RES_35OHM_NPP_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: RES_40OHM_NPP_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: RES_50OHM_NPP_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: QC_MARKER_QY_202603
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: Silterra_EMO1_Optihk_LOGO_QY
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: SiN_EUB_1310_H400_w2500_L45_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: SiN_EUB_1310_H400_w3000_L45_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: Si_EUB_1310_H220_w2000_L50_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: Si_EUB_1310_H220_w380_2000_L50_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: DC_SiN400_99_1_1310_jyh_quantex_202603
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: EC_SiN400_1310_0p5dB_L935_A0_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: EC_SiN400_1310_0p5dB_L935_A8_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: EC_SiN400_1310_1p0dB_L635_A0_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: EC_SiN400_1310_1p0dB_L635_A8_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: 1x2MMI_1310nm_TE_Silterra_202603_ZKY_v2
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: 2x2MMI_1310nm_TE_Silterra_202603_ZKY
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: PD_1310_Monitor_Si220_Ge500_NPN_XHN_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: WG_TERM_SiN220_1310_w380_t150_QY_202606
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: WG_TERM_SiN400_1310_w700_t150_QY_202606
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: Si_Strip_Rib_TRX_w380
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: HT_150R_SiPPP_L500_100OHM_DUMMY_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: HT_150R_SiPPP_L500_100OHM_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: HT_150R_TiN_L200_200OHM_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: HT_150R_TiN_L500_200OHM_DUMMY_QY_202604
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: PDK component metadata describing photonic/electronic cell assets, pins, geometry, layers, and library classification.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 name: VOA_Si220_1310_L1050_QY_202603
 foundry: Silterra
 process: EMO1_2ML_Cu_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Technology manifest defining routing types, cross-sections, layer mappings, and default routing settings.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 schema_version: 1.0.0
 foundry: Silterra
 technology: EMO1_2ML_CU_Al_RDL
@@ -1,3 +1,9 @@
+# -----------------------------------------------------------------------------
+# Description: Directory configuration metadata used to locate Silterra PDK library groups and component resources.
+# Inside functions: N/A - declarative YAML metadata/configuration.
+# Developer : Qin Yue @ 2026
+# Organization : OptiHK Limited
+# -----------------------------------------------------------------------------
 level: 4
 root:
  - PDKs:
@@ -1,3 +1,9 @@
+<#
+Description: PowerShell utility script for launching the intranet/server workflow.
+Inside functions: N/A - procedural PowerShell startup commands.
+Developer : Qin Yue @ 2026
+Organization : OptiHK Limited
+#>
 $ErrorActionPreference = "Stop"

 if (-not $env:MXPIC_SECRET_KEY) {
@@ -1,3 +1,9 @@
+/*
+ * Description: Static and helper regression tests for MXPIC EDA frontend/backend integration contracts.
+ * Inside functions: N/A - assertion-based test/module script.
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 const assert = require('assert');
 const fs = require('fs');
 const path = require('path');
@@ -1,3 +1,9 @@
+/*
+ * Description: Static and helper regression tests for MXPIC EDA frontend/backend integration contracts.
+ * Inside functions: N/A - assertion-based test/module script.
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 const assert = require('assert');
 const fs = require('fs');
 const path = require('path');
@@ -1,3 +1,9 @@
+/*
+ * Description: Static and helper regression tests for MXPIC EDA frontend/backend integration contracts.
+ * Inside functions: N/A - assertion-based test/module script.
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 const assert = require('assert');
 const helpers = require('../frontend/canvas-helpers.js');

@@ -1,3 +1,9 @@
+/*
+ * Description: Static and helper regression tests for MXPIC EDA frontend/backend integration contracts.
+ * Inside functions: N/A - assertion-based test/module script.
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 const assert = require('assert');
 const fs = require('fs');
 const path = require('path');
@@ -1,3 +1,9 @@
+/*
+ * Description: Static and helper regression tests for MXPIC EDA frontend/backend integration contracts.
+ * Inside functions: N/A - assertion-based test/module script.
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 const assert = require('assert');
 const fs = require('fs');
 const path = require('path');
@@ -1,3 +1,9 @@
+/*
+ * Description: Static and helper regression tests for MXPIC EDA frontend/backend integration contracts.
+ * Inside functions: N/A - assertion-based test/module script.
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 const assert = require('assert');
 const fs = require('fs');
 const path = require('path');
@@ -1,3 +1,9 @@
+/*
+ * Description: Static and helper regression tests for MXPIC EDA frontend/backend integration contracts.
+ * Inside functions: N/A - assertion-based test/module script.
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 const assert = require('assert');
 const fs = require('fs');
 const path = require('path');
@@ -1,3 +1,9 @@
+/*
+ * Description: Static and helper regression tests for MXPIC EDA frontend/backend integration contracts.
+ * Inside functions: N/A - assertion-based test/module script.
+ * Developer : Qin Yue @ 2026
+ * Organization : OptiHK Limited
+ */
 const assert = require('assert');
 const fs = require('fs');
 const path = require('path');