File Coverage

blib/lib/TUI/toolkit.pm
Criterion Covered Total %
statement 6 6 100.0
branch n/a
condition n/a
subroutine 2 2 100.0
pod n/a
total 8 8 100.0


line stmt bran cond sub pod time code
1             package TUI::toolkit;
2 2     2   3665 use strict;
  2         4  
  2         75  
3 2     2   9 use warnings;
  2         3  
  2         172  
4            
5             our $VERSION = '2.0.0';
6            
7             =encoding utf8
8            
9             =head1 NAME
10            
11             TUI::toolkit - Unified OO facade for the TUI::Vision framework
12            
13             =head1 SYNOPSIS
14            
15             use TUI::toolkit;
16            
17             # Placeholder module.
18             # The full OO toolkit will be migrated from TV::toolkit.
19            
20             =head1 DESCRIPTION
21            
22             TUI::toolkit provides a unified object system facade for the
23             TUI::Vision framework. It corresponds to the functionality of
24             C and offers a consistent set of OO features regardless of
25             which backend toolkit is available.
26            
27             C dynamically selected an OO backend from:
28            
29             =over 4
30            
31             =item * Moos
32             Minimalistic attribute and method generator.
33            
34             =item * Moo
35             Lightweight meta-object system.
36            
37             =item * Moose
38             Full-featured meta-object system.
39            
40             =item * fields
41             Classic Perl fields-based objects.
42            
43             =item * UNIVERSAL::Object
44             Modern, minimal object base class.
45            
46             =item * LOP fallback
47             A small internal object layer used when no other toolkit is available.
48            
49             =back
50            
51             It also provided:
52            
53             =over 4
54            
55             =item * C
56             Attribute declaration.
57            
58             =item * C
59             Simple inheritance.
60            
61             =item * Automatic constructor generation.
62            
63             =item * Optional C method.
64            
65             =item * A C method that dispatches C in MRO order.
66            
67             =item * Backend-specific patches (e.g. Moos C argument normalization).
68            
69             =back
70            
71             This stub does not implement any of these features yet.
72             It exists solely to reserve the namespace for the upcoming migration.
73            
74             =head1 ROADMAP
75            
76             =over 4
77            
78             =item * Phase 2
79             Migration of the full TV::toolkit implementation.
80            
81             =item * Phase 3
82             Integration with TUI::Objects and TUI::Views.
83            
84             =item * Phase 4
85             Unified attribute and constructor model for all TUI classes.
86            
87             =item * Phase 5
88             Optional type system integration and compile-time field validation.
89            
90             =back
91            
92             =head1 AUTHOR
93            
94             J. Schneider
95            
96             =cut
97            
98             1;