tw-framework 0.2.3__py3-none-any.whl

tw_framework/tree_shaking.py

@@ -0,0 +1,48 @@
+"""
+Tree shaking for TW Framework.
+
+Removes unused components, CSS, JavaScript, assets, and imports.
+"""
+
+import logging
+import os
+from typing import Dict, List, Set
+
+from . import compiler
+
+logger = logging.getLogger(__name__)
+
+
+def shake_project(project_root: str) -> Dict[str, List[str]]:
+    """Analyze the project and return lists of unused items."""
+    unused = {
+        "components": [],
+        "css": [],
+        "js": [],
+        "assets": [],
+        "imports": [],
+    }
+
+    # Discover all pages and their used components
+    pages = compiler.discover_pages()
+    used_components: Set[str] = set()
+    for page in pages:
+        raw = compiler.read_text_file(page["path"])
+        directives = compiler.extract_directives_from_source(raw, compiler.HOME_DIR)
+        for comp_name in directives.get("imports", []):
+            used_components.add(comp_name)
+
+    # Find all component files
+    components_dir = compiler.COMPONENTS_DIR
+    if os.path.isdir(components_dir):
+        for fname in os.listdir(components_dir):
+            if fname.endswith(".tw"):
+                comp_name = fname[:-3]
+                if comp_name not in used_components:
+                    unused["components"].append(comp_name)
+
+    # TODO: Add CSS, JS, assets, and import analysis
+    return unused
+
+
+__all__ = ["shake_project"]

tw_framework/twm_parser.py

@@ -0,0 +1,274 @@
+from __future__ import annotations
+
+import re
+from typing import Dict, List, Tuple
+
+
+_IDENT_RE = re.compile(r"^[A-Za-z_$][A-Za-z0-9_$]*$")
+
+# Supports:
+#   export async function name(...) { ... }
+#   async function name(...) { ... }
+#   export function name(...) { ... }
+#   function name(...) { ... }
+#   export async fn name(...) { ... }
+#   async fn name(...) { ... }
+#   export fn name(...) { ... }
+#   fn name(...) { ... }
+_FUNC_HEADER_RE = re.compile(
+    r"""
+    (?P<prefix>\bexport\b\s+)?(?P<async>\basync\b\s+)?(?P<kw>\bfunction\b|\bfn\b)\s+
+    (?P<name>[A-Za-z_$][A-Za-z0-9_$]*)\s*
+    (?P<params>\([^)]*\))?\s*
+    \{
+    """,
+    re.VERBOSE,
+)
+
+
+class TWMParseError(Exception):
+    pass
+
+
+def _scan_matching_brace(source: str, open_brace_index: int) -> int:
+    """
+    Returns index of the matching closing brace `}` for the `{` at open_brace_index.
+    Implements JS-like string/comment awareness so braces inside strings/comments
+    don't affect nesting.
+    """
+    if open_brace_index < 0 or open_brace_index >= len(source) or source[open_brace_index] != "{":
+        raise TWMParseError("Internal error: expected `{` at open brace index")
+
+    i = open_brace_index + 1
+    depth = 1
+    mode = "code"  # code|string_d|string_s|template|line_comment|block_comment
+
+    while i < len(source):
+        ch = source[i]
+
+        if mode == "line_comment":
+            if ch == "\n":
+                mode = "code"
+            i += 1
+            continue
+
+        if mode == "block_comment":
+            if ch == "*" and i + 1 < len(source) and source[i + 1] == "/":
+                i += 2
+                mode = "code"
+                continue
+            i += 1
+            continue
+
+        if mode in {"string_d", "string_s"}:
+            if ch == "\\":
+                i += 2
+                continue
+            if (mode == "string_d" and ch == '"') or (mode == "string_s" and ch == "'"):
+                mode = "code"
+            i += 1
+            continue
+
+        if mode == "template":
+            if ch == "\\":
+                i += 2
+                continue
+            if ch == "`":
+                mode = "code"
+            i += 1
+            continue
+
+        # mode == "code"
+        if ch == "/" and i + 1 < len(source) and source[i + 1] == "/":
+            mode = "line_comment"
+            i += 2
+            continue
+        if ch == "/" and i + 1 < len(source) and source[i + 1] == "*":
+            mode = "block_comment"
+            i += 2
+            continue
+        if ch == '"':
+            mode = "string_d"
+            i += 1
+            continue
+        if ch == "'":
+            mode = "string_s"
+            i += 1
+            continue
+        if ch == "`":
+            mode = "template"
+            i += 1
+            continue
+
+        if ch == "{":
+            depth += 1
+            i += 1
+            continue
+        if ch == "}":
+            depth -= 1
+            if depth == 0:
+                return i
+            i += 1
+            continue
+
+        i += 1
+
+    raise TWMParseError("Unterminated `{ ... }` block in `.twm` source")
+
+
+def parse_twm_functions(source: str) -> List[Dict[str, str]]:
+    """
+    Minimal `.twm` surface:
+    - `.twm` files are declarative: top-level code is NOT allowed.
+    - Only function declarations are supported in the MVP.
+    """
+    src = str(source or "")
+    functions: List[Dict[str, str]] = []
+
+    consumed_spans: List[Tuple[int, int]] = []
+    for match in _FUNC_HEADER_RE.finditer(src):
+        name = match.group("name")
+        params = match.group("params") or "()"
+        if not _IDENT_RE.match(name):
+            raise TWMParseError(f"Invalid function name: {name!r}")
+
+        # Find the exact opening brace for this match.
+        open_brace = src.find("{", match.start())
+        close_brace = _scan_matching_brace(src, open_brace)
+        body = src[open_brace + 1 : close_brace]
+
+        functions.append(
+            {
+                "name": name,
+                "params": params,
+                "body": body,
+                "async": bool(match.group("async")),
+            }
+        )
+        consumed_spans.append((match.start(), close_brace + 1))
+
+    # Enforce "no top-level execution": after removing function spans, remaining
+    # source must be only whitespace/comments.
+    scratch = list(src)
+    for start, end in consumed_spans:
+        for i in range(start, end):
+            scratch[i] = " "
+    remainder = "".join(scratch).strip()
+    if remainder:
+        # Allow top-level comments (line + block) and whitespace.
+        # This is safe here because function bodies were already stripped out,
+        # so this pass only affects truly top-level text.
+        remainder = re.sub(r"//.*?$", "", remainder, flags=re.MULTILINE)
+        remainder = re.sub(r"/\*.*?\*/", "", remainder, flags=re.DOTALL)
+        remainder = remainder.strip()
+    if remainder:
+        raise TWMParseError(
+            "Top-level statements are not allowed in `.twm`. "
+            "Only `function`/`fn` declarations are supported so modules never auto-execute."
+        )
+
+    return functions
+
+
+def compile_twm_module_to_js(source: str, *, module_id: str) -> str:
+    funcs = parse_twm_functions(source)
+    lines: List[str] = []
+    lines.append(f"// TW module: {module_id}")
+    for fn in funcs:
+        name = fn["name"]
+        params = fn["params"]
+        body = fn["body"]
+        async_prefix = "async " if fn.get("async") else ""
+        lines.append(f"{async_prefix}function {name}{params}{{{body}\n}}")
+        lines.append(f"window.__twRegister('{_js_string(name)}', {name});")
+        lines.append("")
+    return "\n".join(lines)
+
+
+def compile_twm_module_to_cjs(source: str, *, module_id: str) -> str:
+    """
+    Compile `.twm` into a CommonJS module for server-side execution (Node.js).
+
+    Important:
+    - `.twm` already forbids top-level statements, so generating a Node module
+      is safe from accidental auto-execution.
+    - This output does NOT use `window` / browser globals.
+    """
+    funcs = parse_twm_functions(source)
+    lines: List[str] = []
+    lines.append(f"// TW server module: {module_id}")
+    lines.append("'use strict';")
+    lines.append("")
+    for fn in funcs:
+        name = fn["name"]
+        params = fn["params"]
+        body = fn["body"]
+        async_prefix = "async " if fn.get("async") else ""
+        lines.append(f"{async_prefix}function {name}{params}{{{body}\n}}")
+        lines.append(f"exports.{name} = {name};")
+        lines.append("")
+    return "\n".join(lines)
+
+
+def build_page_twm_bundle_js(
+    sources: List[Dict[str, str]],
+    *,
+    page_source_path: str = "",
+) -> str:
+    """
+    Produces a per-page JS bundle that:
+    - creates the module registry
+    - registers functions from loaded `.twm` files
+    - registers functions from local `SCRIPT { ... }` blocks
+    """
+    parts: List[str] = []
+    parts.append("(function(){")
+    parts.append("  window.__twRegistry = window.__twRegistry || Object.create(null);")
+    parts.append("  window.__twRegister = window.__twRegister || function(name, fn){")
+    parts.append("    if (!name) return;")
+    parts.append("    window.__twRegistry[name] = fn;")
+    parts.append("  };")
+    parts.append("  window.__twInvoke = window.__twInvoke || function(name, event){")
+    parts.append("    try {")
+    parts.append("      var fn = window.__twRegistry && window.__twRegistry[name];")
+    parts.append("      if (typeof fn === 'function') return fn(event);")
+    parts.append("      var g = window[name];")
+    parts.append("      if (typeof g === 'function') return g(event);")
+    parts.append("      console.warn('[tw] Missing handler:', name);")
+    parts.append("    } catch (e) {")
+    parts.append("      console.error('[tw] Handler error:', name, e);")
+    parts.append("    }")
+    parts.append("  };")
+    if page_source_path:
+        parts.append(f"  // Source page: {page_source_path}")
+    parts.append("")
+
+    for item in sources or []:
+        if item.get("kind") == "file":
+            path = item.get("path") or ""
+            with open(path, "r", encoding="utf-8") as f:
+                src = f.read()
+            parts.append(compile_twm_module_to_js(src, module_id=path))
+            parts.append("")
+            continue
+        if item.get("kind") == "inline":
+            src = item.get("source") or ""
+            parts.append(compile_twm_module_to_js(src, module_id="<inline SCRIPT>"))
+            parts.append("")
+            continue
+
+    parts.append("})();")
+    return "\n".join(parts)
+
+
+def _js_string(value: str) -> str:
+    return str(value).replace("\\", "\\\\").replace("'", "\\'")
+
+
+__all__ = [
+    "TWMParseError",
+    "build_page_twm_bundle_js",
+    "compile_twm_module_to_cjs",
+    "compile_twm_module_to_js",
+    "parse_twm_functions",
+]

tw_framework-0.2.3.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: tw-framework
+Version: 0.2.3
+Summary: TW framework CLI with create, dev, build, and deploy commands
+Author: TW Framework
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"

tw_framework-0.2.3.dist-info/RECORD

@@ -0,0 +1,51 @@
+tw_framework/__init__.py,sha256=ocJAQdW_NYoTvGg4z8Qxg3TAZTof43UG5EzxT5zt7-w,396
+tw_framework/advanced_diagnostics.py,sha256=ZhPoULtguXa4WxdsGoPo4InRTaqrc9RKtj4puEy1rls,633
+tw_framework/asset_optimizer.py,sha256=bLsSXLxEQyp0IBO_kg0BevkraQkFb9laG_ATE4aVaf0,763
+tw_framework/ast_nodes.py,sha256=Fb-Quwlm8GFYBiEmP37c0eYWvHd_tVrIyY97_GbQTto,8982
+tw_framework/build.py,sha256=-70Nlcd92XL4sGBIgXo8qYa4ki7rUmz3gmKpa0CT_JY,150
+tw_framework/build_performance.py,sha256=tMFUHkmbRtQ_FWgSMU18G5i5L_Cs8CSUlYsSk39t9y4,720
+tw_framework/build_report.py,sha256=SRQHDF-BxFkjdqjMPKg5bDcGMxHh0OSnpfF1_6fLUgs,2933
+tw_framework/cli.py,sha256=DrMKsOk17wNRHy-82Gef_t1oDPg8GZk2J-sH3vODz9Y,42759
+tw_framework/code_splitting.py,sha256=3cajdS38eiWzEPaEWDpaRxOlCK1GAz4wmD0jJk8ds7I,2490
+tw_framework/common.py,sha256=2irzk5G6s_Ezn9VGSezjqErKcP_eZuZHg2qBK0almsg,598
+tw_framework/compiler.py,sha256=5NQ_kYKrfh8mYX851NAgSWpisRu4S8HQoevqwDfuQ0s,179647
+tw_framework/compiler_stats.py,sha256=8Ccp8eVkOwVAkklBwb9moECMxjuF0FuWfIfXpItgNYI,1441
+tw_framework/dead_code.py,sha256=ALwJQzPuXAOIpyrUMA4S99HAS8D0iwOwk8rnXjKxJ2o,1093
+tw_framework/dependency_graph.py,sha256=qXWrLXRtZ7DYzQKch8vuqaLiCwU3e4Rw1TEFA2wiCls,3156
+tw_framework/deploy.py,sha256=t1bBX-rR72ftcTbpv9-wr2AB7qfuEJEpvqqdwIDzNC0,158
+tw_framework/dev.py,sha256=jXydz5JWS6HnH9OTrsOE1esywuAqlZuoKpl8NJWAaVs,177
+tw_framework/diagnostics.py,sha256=1DnxEuN2sIfL8KoEXQfkAmL_E2Y11JHL2V4OUMw5UkU,3238
+tw_framework/dynamic_imports.py,sha256=3wwiZDRCZuKY9u6cl1EAi6nkp1YRP9bNkLq7Yktd7eY,1903
+tw_framework/error_formatter.py,sha256=-iKlFhBoDhupWmQomHhrNE5D8NiKR1b_JIJExEYzeuQ,1750
+tw_framework/framework.py,sha256=mZBjq4vYRWbpdm0buIrqjrXFFfkqj4ssaNeG2srHehg,135149
+tw_framework/hydration.py,sha256=6fgmE4ptmYLmduvIsUo__M5OiHpC6cZniL1T65agy1g,4580
+tw_framework/incremental_cache.py,sha256=wNumlfjtgyzgZXfsp-S-BLxF4O6GVPrSs2LoZoXJQZg,1459
+tw_framework/interpreter.py,sha256=K3N4zkVfsgPtMicpAAUL5Gl9OLqUrM3EeolfltI6fZc,1869
+tw_framework/ir.py,sha256=9y209G73Up3e7fgzo71UMUcJaRr09EsbNoD4ZdrtmiE,4770
+tw_framework/lexer.py,sha256=B9H26-kaq3e7MWeGCJozGKUJZb5PAYQYBgHtp53jEfQ,1106
+tw_framework/lowering.py,sha256=0AyikxKo089RGkLfmI_DvT3kkBhi31RO37OZV6fs1NI,2573
+tw_framework/parser.py,sha256=xqRcnYzkhd3YRcepotXbnHiMfR7Ht7qNILuyvzUimXU,5604
+tw_framework/partial_rebuild.py,sha256=sx9yIsKDg3V2kKBYMlouWHCd8mMeOI7lj5JeaUDCIGs,685
+tw_framework/performance_analyzer.py,sha256=Isj-eXU_7wfug8Vn6_DUL_rSd0Ld-ONxR2N4NyOc1so,916
+tw_framework/plugin_runtime.py,sha256=3fFuQuiOb15os-n6ToE--L9-d6jtMxrmBTNlzmXNcSk,6956
+tw_framework/production_optimizer.py,sha256=kGaY9kjXn9AQoZV922xklJq9_KMA2NwsFzAGmReTNxI,2944
+tw_framework/reactivity.py,sha256=4zwUL7GgAJAN6Ih1ZulkQ2biMKT9BLjH7T1KZnhDNeM,12986
+tw_framework/render_css.py,sha256=R6UIoI-9cCtKlP0n3oQy1Nvh8wwp-cwOpNkJ5smO-a4,526
+tw_framework/render_html.py,sha256=1JtEyU2KWAPZM3AcRRhU6bJ0Er0fvaYOIYLM8Nbbq5s,10495
+tw_framework/route_optimizer.py,sha256=f33Jswk_Ir-K-RNb4fm3uKT0m0Osfid5I92BXP84puA,1062
+tw_framework/router.py,sha256=v2IKV1RwuDsJl8sKC69oPBHg0u-aIr-oXtA2ZvPuatY,164
+tw_framework/runtime_model.py,sha256=AMBoEnKZZMGim02ZnQiC5JykPxGoCZILySDWjMuyTXc,726
+tw_framework/runtime_values.py,sha256=zJyiZyc-m43CmaIJLZjQCmQzJhp7eh722FFGAx3BAmw,929
+tw_framework/semantic.py,sha256=HBsEeX8Fn0ah6MRuRSsEo7uOvfNAoRt1UuAnfCkm7Dw,6883
+tw_framework/server.py,sha256=Na6h1J-2SWgqovb-1HM7_p_R8lFZS1rK1ub6HVcobAQ,22883
+tw_framework/signature.py,sha256=tsF1pN9tdTGrt2s2VLaLFpeoFLwasf9Md4S3l2YIyIQ,2058
+tw_framework/static_dynamic_auto.py,sha256=1PNGbhItvcwtU12Vglqx-TngYiIxCTaGXuHHuCr-R18,908
+tw_framework/streaming.py,sha256=nz0qHeL3KNQi5kaWRdkVLEPhHsM0ud9yblEPcjUv9j8,5530
+tw_framework/test_build_cli_pytest.py,sha256=fcc2oHNwlYidg5PMflTvyzgD8ZbJq0xxXgZdDZ10NBw,35065
+tw_framework/tree_shaking.py,sha256=v9S4c86IxxIMRPJjUqHEMPMKPBIaOA5G9efni5CZvHk,1327
+tw_framework/twm_parser.py,sha256=NEeORHowG6d-7GSgYYdLSTuQb7_V0U4a6gS_cdXdAFo,8805
+tw_framework-0.2.3.dist-info/METADATA,sha256=Z0DN_V2ZgV98K0wRdKVoF-V1qQ2gqrq8BapFhnohmj0,232
+tw_framework-0.2.3.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+tw_framework-0.2.3.dist-info/entry_points.txt,sha256=q_xnwoJ_004m94C-VXA7oBQ4JjlplL7sIvHRXjTyviw,45
+tw_framework-0.2.3.dist-info/top_level.txt,sha256=yhYT7MZtaMnbwNbT9vFmjyGikzheb1-Gk-gGUOcNv6k,13
+tw_framework-0.2.3.dist-info/RECORD,,

tw_framework-0.2.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tw_framework-0.2.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tw = tw_framework.cli:main

tw_framework-0.2.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+tw_framework