Deploying to gh-pages from @ cappuccino/cappuccino@dec05699f3 🚀

Resources/TextEditor/DocumentWindowController.j

@@ -0,0 +1,126 @@
+/*
+ * DocumentWindowController.j
+ * TextEditor
+ *
+ * Copyright (c) 2026 David Richardson
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+@import <Foundation/Foundation.j>
+@import <AppKit/AppKit.j>
+
+@import "LoremIpsum.j"
+
+
+/*
+    The smallest size, in points, to which the user can resize a document
+    window. The size includes the title bar, the toolbar and the ruler, so
+    the values leave room for a few lines of text below them.
+
+    These values are provisional. Adjust them as the window gains more
+    content, such as an inspector pane.
+*/
+var DocumentWindowMinimumWidth  = 360.0,
+    DocumentWindowMinimumHeight = 240.0;
+
+
+/*!
+    Owns DocumentWindow.cib. The window's delegate outlet is connected to
+    File's Owner in DocumentWindow.xib, so this controller is the window's
+    delegate. windowDidLoad assigns it again, so the delegate is set even if
+    the connection is missing from the xib.
+*/
+@implementation DocumentWindowController : CPWindowController <CPWindowDelegate>
+{
+    /*
+        The text view inside the window's scroll view. The outlet is connected
+        to the text view in DocumentWindow.xib.
+    */
+    @outlet CPTextView  textView;
+}
+
+- (id)init
+{
+    return [self initWithWindowCibName:@"DocumentWindow"];
+}
+
+- (void)windowDidLoad
+{
+    [super windowDidLoad];
+
+    [[self window] setDelegate:self];
+
+    /*
+        Show a horizontal ruler above the text.
+
+        A ruler is not a separate control. It belongs to the scroll view that
+        encloses the text view, and the text view keeps its markers in step
+        with the tab stops and indents of the paragraph at the selection.
+
+        In Interface Builder the text view's "Uses Ruler" setting turns this
+        on, but nib2cib does not yet carry the ruler settings into the cib,
+        so the ruler is set up here in code.
+    */
+    var scrollView = [textView enclosingScrollView];
+
+    [scrollView setHasHorizontalRuler:YES];
+    [scrollView setRulersVisible:YES];
+}
+
+/*!
+    Inserts the placeholder text from LoremIpsum at the text view's selection,
+    replacing any selected text.
+
+    The Edit menu item in MainMenu.xib sends this action to First Responder.
+    The menu does not know about any document. AppKit passes the action along
+    the responder chain of the key window, then of the main window: the text
+    view, its superviews, the window, and then this controller, which is the
+    window's next responder. So the text goes into the active document's
+    window, and AppKit disables the menu item when no document window is
+    active.
+
+    insertText: changes the text the same way typing does. It registers the
+    change with the document's undo manager, so Edit > Undo removes the
+    inserted text.
+*/
+- (@action)insertLoremIpsum:(id)aSender
+{
+    [textView insertText:[LoremIpsum text]];
+}
+
+/*!
+    Keeps the window at or above its minimum size while the user resizes it.
+
+    This is a CPWindowDelegate method. The window calls it with the size it
+    is about to take, and uses the size that this method returns. Returning
+    a larger size than the one proposed stops the window from shrinking past
+    the minimum, while it still follows the pointer in every other direction.
+
+    A fixed minimum could also be set on the window in Interface Builder.
+    The delegate method is used here because it can compute the minimum, for
+    example from the content of the window.
+*/
+- (CGSize)windowWillResize:(CPWindow)aWindow toSize:(CGSize)aSize
+{
+    return CGSizeMake(Math.max(aSize.width, DocumentWindowMinimumWidth),
+                      Math.max(aSize.height, DocumentWindowMinimumHeight));
+}
+
+@end